Datalad-next

💫 Enhancements and new features

- A new patch set break up the implementation of `clone_dataset()`
into its procedural components, and makes it more accessible for
extension patches. There are no behavior changes associated with
this internal reorganization.

🐛 Bug Fixes

- Fixed datalad-push always reporting success when pushing to
an export remote.
Fixes https://github.com/datalad/datalad-next/issues/88 via
https://github.com/datalad/datalad-next/pull/93 (by bpoldrack)

- Token secrets entered for GitHub-like sibling creation are now stored by
default under a name matching the API endpoint hostname (e.g.
'api.github.com'), rather than a confusing and conflict-prone 'None'.
Using the `--credential` option, an alternative name can be given, as before.
Fixes https://github.com/datalad/datalad-next/issues/97 via
https://github.com/datalad/datalad-next/pull/98 (by mih)

💫 Enhancements and new features

- The `configuration` command now indicates the absence of a particular
configuration setting queried via `get` with a `status='impossible'`
result. This change enables the distinction of an unset configuration
item from an item set to an empty string with the default
CLI result renderer.
Fixes https://github.com/datalad/datalad/issues/6851 via
https://github.com/datalad/datalad-next/pull/87 by mih

- The default of the configuration item `datalad.annex.retry`
(in effect when not explicitly configured otherwise) is changed
from `3` to `1`. This prevents a set of performance and user experience
issues resulting from, e.g., repeated download attempts, even
when no change in outcome can be expected (e.g., a wrong or
no credential supplied). This change can cause a loss of robustness
in download behavior for services that indeed experience spurious
failures. Its is recommended to specifically parametrize such command
calls (e.g., downloads in CI runs) with an appropriate configuration
override.
Fixes https://github.com/datalad/datalad/issues/6969 and
https://github.com/datalad/datalad/issues/6509 (by mih)

- New `tree` command for traversing a directory hierarchy.
Like the UNIX equivalent, it can visualize a directory tree.
Additionally, it annotates the output with DataLad-related
information, like the location of dataset, and their nesting
depth. Besides visualization, `tree` also reports structured
data in the form of result records that enable other applications
to use `tree` for gathering data from the file system.
Fixes https://github.com/datalad/datalad-next/issues/78 via
https://github.com/datalad/datalad-next/pull/92 (by catetrai)

📝 Documentation

- Add an example of adding a `user_password`-type credentials, with a
given `user` property, to the examples in the `credentials`
command. https://github.com/datalad/datalad-next/pull/103 (by mslw)

💫 Enhancements and new features

- The `configuration` command no longer requires a datasets to be present
for a `get` operation to retrieve a configuration item from scope `global`.
Fixes [6864](https://github.com/datalad/datalad/issues/6854) via
[86](https://github.com/datalad/datalad-next/pull/86) (by mih)

🐛 Bug Fixes

- Fix a missing import in the credential retrieval for GitHub-like sibling
creation, which made it impossible to discover credentials without
providing an explicit credential name.

💫 Enhancements and new features

- `datalad-annex::` Git remote helper now uses `git annex transferkey` instead
of `fsck` to "probe" for `XDLRA` repository keys. This avoid problems due to
a behavior change in git-annex 10.20220525, and can also speed-up operation for
slow special remotes, by avoiding a dedicated probe-request.
[76](https://github.com/datalad/datalad-next/pull/76) (by mih)
- `datalad-annex::` Git remote helper now fully compatible with the Windows
platform, by working around [a git-annex
issue](https://git-annex.branchable.com/bugs/Fails_to_drop_key_on_windows___40__Access_denied__41__)
[77](https://github.com/datalad/datalad-next/pull/77) (by mih)

🐛 Bug Fixes

- Prevent docstring duplication in patched `push` command
[71](https://github.com/datalad/datalad-next/pull/71) (by mih)

📝 Documentation

- Bibliographic information on authorship was added
[80](https://github.com/datalad/datalad-next/pull/80) (by mslw)

🛡 Tests

- The test battery is now using `pytest`. This change required bumping the
dependency on DataLad to version 0.17.0.
[73](https://github.com/datalad/datalad-next/pull/73) (by mih)

🏠 Internal

- Reduced code duplication by consolidating on a common helper for sibling
identification, now available from DataLad 0.17.0
[82](https://github.com/datalad/datalad-next/pull/82) (by adswa)

Authors: 3

- Michael Hanke (mih)
- Michał Szczepanik (mslw)
- Adina Wagner (adswa)

💫 Enhancements and new features

- Make push avoid refspec handling for special remote push targets. See PR
https://github.com/datalad/datalad-next/pull/64 for details on the associated
behavior changes that are introduced with this new patch.