EchoProcess + Support UOMs + Support BBOX

[fmigneault]

Changes

• Add weaver.formats.ContentEncoding with handlers for common encoding manipulation from input values.
• Add |oapecho| to the list of weaver.processes.builtin definitions with its CWL representation and complementary OGC API - Processes reference implementation details. This Process will be automatically deployed at API startup, and is employed to validate multiple parsing combinations of execution I/O values and encodings (fixes #379).
• Add support of OGC BoundingBox definition (bbox and crs fields) as Process execution input value with appropriate schema validation (fixes #51).
• Add support of Unit of Measure (UoM) definition (measurement and uom fields) as Process execution input value with appropriate schema validation (fixes`#430).
• Add create_metalink utility function to facilitate generation of a .meta4 or .metalink file definition from a list of file link references (relates to #25).

Fixes

• Fix weaver.wps_restapi.swagger_definitions.ExecuteInputValues deserialization that sometimes silently dropped invalid JSON-formatted inputs that did not fulfill schema validation. This was caused by a side effect regarding how weaver.wps_restapi.colander_extras.VariableSchemaNode handled "unknown" JSON properties from submitted content. In cases where required Process inputs were causing the invalid schema, Job execution would be aborted and the error would be reported due to "missing" inputs. However, if the JSON failing schema validation happened to be nested under an optional input definition, the Job execution could have resumed silently by omitting this input's value propagation to the downstream CWL, WPS or OGC API - Processes implementation, which could make it use an alternative default value than the real input that was submitted for the Job.
• Fix schema name representation employed in generated colander.Invalid error when a schema validation failed, in order to better represent deeply nested schema using multiple oneOf, anyOf, allOf schema nodes. Using colander.Invalid.asdict, each dictionary key now properly indicates the specific path of sub-nodes with their relevant schema validation error.
• Fix variable schema node names to provide a {SchemaName}<{VariableName}> representation, such that it can be more easily identified. Schema nodes with a variable (i.e.: schema under additionalProperties) previously only indicated {VariableName}, which made it complicated to follow reference schema classes that formed the error path. Each of the evaluated fields against each possible variable schema will now report their corresponding nested schema validation error as {SchemaName}<{VariableName}>({field}) such that results can be understood.
• Fix execution input reference (i.e.: using href) dropping a schema URL reference if provided explicitly. This parameter now remains within the produced content passed to the Job, and forwarded to a remote Process if applicable, but no further schema validation is accomplished with the value in schema for the moment.
• Fix ContentType.IMAGE_OGC_GEOTIFF using invalid media-type name (missing i in image).
• Fix Job input validation stripping additional parameters from provided Media-Type, potentially causing mismatching Content-Type validation against the corresponding Process description inputs. Types should now match exactly the original Process definition, including any additional parameters and sub-types.
• Fix resolution of anyOf schema raising colander.Invalid even when the property was marked as optional using missing=colander.drop.
• Fix $schema of OGC nameReferenceType being reported under every dataType of literalDataDomains for literal I/O of Process descriptions. The reference is not only included in the OpenAPI definition as intended.

References

• Relates to https://github.com/opengeospatial/ogcapi-processes/pull/329
• Relates to https://github.com/opengeospatial/ogcapi-processes/issues/319
• Depends on https://github.com/geopython/pywps/pull/686
• Depends on https://github.com/geopython/pywps/pull/689 (pywps==4.6.0)
• Depends on https://github.com/geopython/OWSLib/pull/897
• Depends on https://github.com/geopython/OWSLib/pull/898 (owslib==0.30.0)
• Depends on https://github.com/crim-ca/weaver/pull/586 due to pywps and owslib updates.
• Resolves #51
• Resolves #379
• Resolves #430
• Closes #541
• Closes #577

To Do

• [x] Fix issues related to https://github.com/crim-ca/weaver/issues/587 (blocked by upstream dependencies)

[codecov[bot]]

Codecov Report

Attention: 61 lines in your changes are missing coverage. Please review.

Comparison is base (9b76b22) 85.17% compared to head (60d1c08) 85.64%. Report is 2 commits behind head on master.

Files	Patch %	Lines
weaver/processes/convert.py	86.42%	10 Missing and 9 partials :warning:
weaver/formats.py	89.91%	6 Missing and 6 partials :warning:
weaver/processes/execution.py	86.11%	5 Missing and 5 partials :warning:
weaver/processes/wps_package.py	91.76%	1 Missing and 6 partials :warning:
weaver/wps_restapi/colander_extras.py	89.06%	2 Missing and 5 partials :warning:
weaver/wps_restapi/jobs/utils.py	55.55%	3 Missing and 1 partial :warning:
weaver/processes/builtin/__init__.py	94.11%	0 Missing and 1 partial :warning:
weaver/utils.py	97.50%	0 Missing and 1 partial :warning:

Additional details and impacted files

```diff @@ Coverage Diff @@ ## master #580 +/- ## ========================================== + Coverage 85.17% 85.64% +0.46% ========================================== Files 79 79 Lines 18036 18543 +507 Branches 2731 2838 +107 ========================================== + Hits 15363 15882 +519 + Misses 1942 1925 -17 - Partials 731 736 +5 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.