Skip to content

v1.0.1 - Brand new CLI!
Compare
Choose a tag to compare
@jsheunis jsheunis released this 04 Sep 12:09
· 183 commits to main since this release
v1.0.1
400e4ca

1.0.1 (Fri Sept 1 2023) -- Brand new CLI!

Summary

This is the first major release update since the initial release,
mainly due to breaking changes in the command line interface.

Most of the changes were included in #309,
summarised as:

  • update API to entrypoint per command: create, add, validate, serve, get, set, remove, translate, workflow
  • introduce datalad-next dependency, at first for constraint system but in future for whatever functionality is useful
  • refactor most of the code related to the main commands

Some of the important changes to take note of:

  • Validation is now done according to the schema of a specific catalog (now located at path-to-catalog/schema/*), where previously validation was always done according to the latest schema of the installed package version (which is now the fallback).
  • Metadata can be passed to any catalog command that takes it as in argument, in different formats: json lines from STDIN, JSON-serialized string, and a file with JSON lines.
  • pytest fixtures are now located in tests/fixtures.py and exposed to all tests
  • catalog-get|set provides an extensible set of commands for configuring a catalog and reporting its properties
  • the handling of config files is refactored:
    • The main changes relate to how/when a config file is provided.
    • Previously, config files were specified during instantiation of the WebCatalog class, and a whole lot of obscure code was necessary to determine how this config applies to the catalog or dataset level.
    • The refactored code receives the config file via the Create() and Add() commands or via the WebCatalog.create() or Node.add_attributes() python methods.
    • Now, WebCatalog can be instantiated with location alone (no 'action' necessary anymore, and no config_file)
    • Now, config is set on WebCatalog or Node instances after/during running their respective create() methods and not during instantiation
  • Translation functionality is refactored, and requires updated to existing translators:
    • With the new catalog argument, translation occurs to the specific schema version of the catalog (if supported by an available translator); if the catalog argument is not supplied, the expected schema version is the latest supported by the package installation.
    • The translator matching process is streamlined by keeping track of previously matched and instantiated translators
    • Functionality to get the supported schema version, source name, and source version have been moved to the translator base class in order to support the abovementioned changes. This means existing and new translators will have to override these functions.

💫 Enhancements and new features

  • Something is now better than before, e.g. test. #pr (by @jsheunis)

  • ENH: add a "request access" button for a dataset. PR #235 (by @jsheunis)

  • NF: Adds metadata translation functionality in dedicated class. PR #246 (by @jsheunis)

  • ENH: don't install jq dependency on windows. PR #248 (by @jsheunis)

  • ENH: refactoring config, extractors_used. PR #237 (by @jsheunis)

  • ENH+BUG: Improving translators and catalog generation. PR #269 (by @jsheunis)

  • Frontend maintenance. PR #272 (by @jsheunis)

  • ENH+NF: add javascript customization options via config. PR #283 (by @jsheunis)

  • ENH: Translator edits. PR #277 (by @jsheunis)

  • UX: improve user experience when browsing. PR #289 (by @jsheunis)

  • Bids translator - fix name & license reporting. PR #286 (by @mslw)

  • ENH: URL parameterization. PR #295 (by @jsheunis)

  • RF: move from single entrypoint API to entrypoint per command. PR #309 (by @jsheunis)

  • 1.0.0 release. PR #334 (by @jsheunis)

🪓 Deprecations and removals

  • BF: Remove imports of datalad.metadata. PR #240 (by @mslw)

🐛 Bug Fixes

  • BUG/ENH/UX: lots of JS tweaks. PR #299 (by @jsheunis)
  • [BF] Small fixes to latest cli commands. PR #333 (by @jsheunis)
  • Fix datacite_gin publication doi translation. PR #325 (by @mslw)

📝 Documentation

  • DOC: update pipeline docs to agree with latest version of meta-conduct use. PR #258 (by @jsheunis)
  • ENH: adds acknowledgements to readme and docs. PR #308 (by @jsheunis)

🏠 Internal

🛡 Tests

Authors: 4

Contributors

yarikoptic, jwodder, and jsheunis
Assets 2
Loading