api: add seeding endpoint

[diegodelemos]

• (addresses api: add seed analysis output endpoint #13)

Signed-off-by: Diego Rodriguez diego.rodriguez@cern.ch

[hjhsalo]

Some comments of style and language used. Nothing that prevents merging so, LGTM

Disclaimer: Just reviewed code. Didn't test with live REANA Cluster.

[hjhsalo]

Maybe

This resource expects a file that is to be placed in the analysis workspace identified by the UUID analysis_id.

(to be placed --> is to be placed)

[hjhsalo]

This is not really part of the PR but in reana_server/api_client.py#L35 there is:

spec_file_path = os.path.join(
    pkg_resources.resource_filename('reana_server',
                                    'openapi_connections'),
  spec_file)

It is PEP8-compliant, but I missed the spec_file part while skimming through the file so maybe it should changed a bit to improve readibility?
Something like this perhaps?:

spec_file_path = os.path.join(
                    pkg_resources.
                    resource_filename(
                        'reana_server',
                        'openapi_connections'),
                    spec_file)

or

spec_file_path = os.path.join(
            pkg_resources.
            resource_filename(
                'reana_server',
                'openapi_connections'),
            spec_file)

[hjhsalo]

Maybe change this in reana_server/rest/analyses.py#L115:

This resource is expecting JSON data with all the necessary
information to instantiate a yadage workflow.

(informations --> information)

[hjhsalo]

In reana_server/rest/analyses.py#L33:

@blueprint.route('/analyses', methods=['GET'])
def get_analyses():  # noqa
    r"""Get all analyses.
    ---
    get:
      summary: Returns list of all analyses.
      description: >-
        This resource return all analyses in JSON format.

Term all analyses is not very clear.
But to be honest, I don't know if this is any better:
Returns list of all analyses (running, finished, waiting) in REANA cluster.

Or maybe it can be opened in the description part just below this one.

Are there more states for an analysis than running, finished, waiting?