Squashed commit of the following:

commit 0d19eed
Merge: bfeaa45 84d672a
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Thu Feb 10 15:29:49 2022 +0100

    Merge pull request psychoinformatics-de#32 from datalad/docs-explainer

    Add documentation explainer

commit bfeaa45
Merge: 1929a22 8e9bcbc
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Thu Feb 10 15:27:24 2022 +0100

    Merge pull request psychoinformatics-de#30 from datalad/mslw-patch-1

    Replace _metalad with _helloworld for easier grepping

commit 84d672a
Author: Stephan Heunis <s.heunis@fz-juelich.de>
Date:   Thu Feb 10 15:08:57 2022 +0100

    add documentation explainer

commit 8e9bcbc
Author: Michał Szczepanik <m.szczepanik@fz-juelich.de>
Date:   Wed Feb 9 16:23:38 2022 +0100

    Replace _metalad with _helloworld for easier grepping

commit 1929a22
Merge: ec54055 7b77859
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jan 24 10:29:45 2022 +0100

    Merge pull request psychoinformatics-de#29 from datalad/rf-tst

    Round of fixes and updates

commit 7b77859
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jan 24 10:12:46 2022 +0100

    Minimal codeclimate config

commit 37b0606
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jan 24 10:10:59 2022 +0100

    More applicable command template

    With the command being in a dedicated file.

    Now also include standard logger naming suggestions.

    Fixes datalad/datalad-extension-template#27

commit 4aa498d
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jan 24 09:52:49 2022 +0100

    Document what needs to be done for installing a git-annex snapshot

    Fixed datalad/datalad-extension-template#22

commit 7aea7b2
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jan 24 09:50:18 2022 +0100

    Update codecov setup to match datalad-core

    Fixes datalad/datalad-extension-template#24

commit ec54055
Merge: f6ef763 a3b022c
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Tue Jan 11 17:22:44 2022 +0100

    Merge pull request psychoinformatics-de#28 from datalad/bf-version

    Make version detection robust to GIT_DIR specification

commit a3b022c
Author: Chris Markiewicz <effigies@gmail.com>
Date:   Tue Jan 11 10:37:27 2022 +0100

    Make version detection robust to GIT_DIR specification

    Analog fix to datalad/datalad#6341

commit f6ef763
Merge: b04f268 48addfb
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Tue Jan 11 10:35:22 2022 +0100

    Merge pull request psychoinformatics-de#26 from datalad/no-setup-requires

    Stop using `setup_requires`

commit b04f268
Merge: cb64d9b 99a960f
Author: Yaroslav Halchenko <debian@onerussian.com>
Date:   Mon Oct 25 11:15:25 2021 -0400

    Merge pull request psychoinformatics-de#25 from datalad/no-distutils

    Stop using distutils

commit 48addfb
Author: John T. Wodder II <git@varonathe.org>
Date:   Mon Oct 25 09:20:18 2021 -0400

    Stop using `setup_requires`

commit 99a960f
Author: John T. Wodder II <git@varonathe.org>
Date:   Mon Oct 25 08:49:30 2021 -0400

    Stop using distutils in _datalad_buildsupport

commit c294de8
Author: John T. Wodder II <git@varonathe.org>
Date:   Mon Oct 25 08:48:42 2021 -0400

    Keep versioneer.py from using distutils

commit cb64d9b
Merge: 8b6234b f05a10b
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Oct 1 11:01:30 2021 +0200

    Merge pull request psychoinformatics-de#23 from datalad/bdist-wheel

    Fix bdist_wheel command in Makefile

commit f05a10b
Author: John T. Wodder II <git@varonathe.org>
Date:   Thu Sep 30 09:19:39 2021 -0400

    Fix bdist_wheel command in Makefile

commit 8b6234b
Merge: c4c4f52 88aeff2
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 29 08:08:12 2021 +0200

    Merge pull request psychoinformatics-de#21 from datalad/testrequires

    Discontinue use of tests_require

commit 88aeff2
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 29 08:02:58 2021 +0200

    Discontinue use of tests_require

    To achieve compatibility with some of datalad's default CI setups.

commit c4c4f52
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Thu Apr 15 10:20:40 2021 +0200

    Disable smart quoting for valid manpages in HTML docs

commit 34aa9b7
Merge: 0d4f35f edec51f
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 22 14:48:33 2021 +0200

    Merge pull request psychoinformatics-de#19 from datalad/buildsupport

    Buildsupport update

commit edec51f
Merge: 0d4f35f 9975f82
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 22 14:41:40 2021 +0200

    Update DataLad build helper

commit 0d4f35f
Merge: 022720b afc8586
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 22 11:04:42 2021 +0200

    Merge pull request psychoinformatics-de#18 from datalad/appveyor-updates

    Appveyor updates

commit afc8586
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 22 10:57:41 2021 +0200

    Do apt-get update before apt-get install

    Analog change to an update necessary in -ukbiobank that makes sense in
    general.

    Fixes datalad/datalad-extension-template#13

commit 2b59d6a
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 22 10:55:37 2021 +0200

    Bump git-annex version for testing to a recent release

    Matching the one used in datalad-core

commit 022720b
Merge: 64d185d 3cbd005
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 22 10:49:42 2021 +0200

    Merge pull request psychoinformatics-de#14 from datalad/fix-manifest

    Add missing/necessary files to sdists

commit 64d185d
Merge: e90593e 448eb72
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 22 10:44:32 2021 +0200

    Merge pull request psychoinformatics-de#16 from datalad/mv-entry-points

    Move entry points declaration to setup.cfg

commit e90593e
Merge: ec853dc a6e5add
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 22 10:41:27 2021 +0200

    Merge pull request psychoinformatics-de#15 from datalad/no-universal

    Remove `--universal` flag

commit ec853dc
Merge: 0098853 200030b
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 22 10:38:30 2021 +0200

    Merge pull request psychoinformatics-de#17 from datalad/versioneer

    Versioneer needs more history to do its job

commit 200030b
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Sep 22 10:33:54 2021 +0200

    Versioneer needs more history to do its job

commit 448eb72
Author: John T. Wodder II <git@varonathe.org>
Date:   Wed Sep 15 12:50:54 2021 -0400

    Move entry points declaration to setup.cfg

commit a6e5add
Author: John T. Wodder II <git@varonathe.org>
Date:   Wed Sep 15 12:47:19 2021 -0400

    Remove `--universal` flag

commit 3cbd005
Author: John T. Wodder II <git@varonathe.org>
Date:   Wed Sep 15 12:37:40 2021 -0400

    Add necessary files to sdists

commit 9975f82
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Thu Apr 15 08:15:27 2021 +0200

    BF: We only have lower-case command names

    In a command suite that only defines the class name of a command,
    and no explicit cmdline name, no manpage would be built, because
    the test against the parser content would look like

      `Ls != ls`

    This change enforces lower-case for autogenerated command names.

commit 0098853
Merge: 7078c9d 4d2c049
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Sat Apr 10 12:29:35 2021 +0200

    Merge pull request psychoinformatics-de#12 from datalad/rf-36

    Update workflow to minimal supported Python version (3.6)

commit 4d2c049
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Sat Apr 10 12:23:25 2021 +0200

    Update workflow to minimal supported Python version (3.6)

commit 7078c9d
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Tue Mar 23 07:29:08 2021 +0100

    Use Debian snapshots as a stable place for packages

commit 4827d99
Merge: 4ad6769 899e9ba
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Thu Mar 11 17:13:11 2021 +0100

    Merge pull request psychoinformatics-de#11 from datalad/tst-coverage

    Working coverage submission across all platforms

commit 899e9ba
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Thu Mar 11 16:51:09 2021 +0100

    Working coverage submission across all platforms

commit 4ad6769
Merge: 616ea72 1260e41
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Thu Mar 11 09:08:29 2021 +0100

    Merge pull request psychoinformatics-de#10 from datalad/typos

    Minor fixup of wording for command_suite

commit 1260e41
Author: Yaroslav Halchenko <debian@onerussian.com>
Date:   Tue Mar 2 18:30:12 2021 -0500

    Minor fixup of wording for command_suite

commit 616ea72
Merge: a4a5749 7d8c9aa
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Tue Mar 2 08:20:57 2021 +0100

    Merge pull request psychoinformatics-de#9 from datalad/installer

    Use released version of datalad-installer

commit 7d8c9aa
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Tue Mar 2 07:40:52 2021 +0100

    Use released version of datalad-installer

    - get rid of custom git-annex installer script on windows,
      use the official implementation instead
    - add support for requesting a specific installer version
      via ENV variable DATALAD_INSTALLER_VERSION, go with "latest"
      by default. Requesting an unavailable installer version will
      make the build error.

commit a4a5749
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jan 25 08:12:45 2021 +0100

    TST: Switch default test setup to appveyor

    Following changes in datalad-core as well as other extensions.

commit f304d45
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Tue Jun 16 13:46:11 2020 +0200

    Fix for consistency

commit 1fb2ed6
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 17:42:00 2020 +0200

    Prevent inclusion of build helpers into binary packages

commit ce8e7f0
Merge: 0924ab1 cd61512
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 13:08:29 2020 +0200

    Add DataLad build helper

commit cd61512
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 13:08:29 2020 +0200

    Squashed '_datalad_buildsupport/' content from commit 023a1b7

    git-subtree-dir: _datalad_buildsupport
    git-subtree-split: 023a1b7

commit 0924ab1
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 13:07:44 2020 +0200

    Minor name change

    Avoids conflict with code in datalad-core and matches source repo name.

commit 80bf197
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 09:01:18 2020 +0200

    Rename file to get a more obvious label

commit 1cfca1d
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 09:00:06 2020 +0200

    Extend README with practical info

commit 49817c6
Merge: a20b711 73a7485
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 08:57:28 2020 +0200

    Merge pull request psychoinformatics-de#7 from datalad/readme

    Community related pointers for the README

commit 73a7485
Author: Adina Wagner <adina.wagner@t-online.de>
Date:   Wed Jun 10 13:28:40 2020 +0200

    add a minimal zenodo.json file

commit 28b0f30
Author: Adina Wagner <adina.wagner@t-online.de>
Date:   Wed Jun 10 13:29:27 2020 +0200

    add archival and community related pointers to the README

commit a20b711
Merge: ea1ed84 12a5a2d
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 08:42:44 2020 +0200

    Merge pull request psychoinformatics-de#6 from datalad/build_helpers

    Build and render manpages -- using common build helpers

commit 12a5a2d
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 08:25:24 2020 +0200

    Remove leftover broken devel requirement

commit dbd12d1
Merge: da5b936 023a1b7
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 08:19:45 2020 +0200

    Add DataLad build helper

    git-subtree-dir: _datalad_build_support
    git-subtree-mainline: da5b936
    git-subtree-split: 023a1b7

commit da5b936
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Jun 12 17:32:04 2020 +0200

    Add makefile target for updating the DataLad build helpers

commit 023a1b7
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 08:16:13 2020 +0200

    BF: Read package metadata directly from setup.cfg

    The distribution object does not seem to see it (at least not
    under all circumstances).

commit fd99b4e
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Mon Jun 15 08:15:09 2020 +0200

    RF: Remove helpers that are not needed for extensions

    DataLad core can add its own ones again, but it is not worth imposing
    the code on all extensions.

commit ba57510
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Jun 12 17:35:46 2020 +0200

    Enable building manpages for extensions

    With the ability to point to a specific command suite.

    The rest is just about making datalad core not break.

commit 343b9a0
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Jun 12 17:21:01 2020 +0200

    Start with a copy from datalad@afa682550ee742d69853f69165c0f37c5f4b5f05

commit 5d64f44
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Thu Jun 11 12:41:43 2020 +0200

    Build and render manpages

commit ea1ed84
Merge: a836e6b 1a56499
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 16:24:09 2020 +0200

    Merge pull request psychoinformatics-de#5 from mih/master

    Modernization

commit 1a56499
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 12:17:29 2020 +0200

    Make more datalad-friendly by prevent annex creation on datalad-save

commit 915818a
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 12:15:06 2020 +0200

    Remove needless setup complication

commit 90debfc
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 12:14:50 2020 +0200

    Fix badge name

commit ec78dfd
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 11:30:11 2020 +0200

    Added top-level Makefile with release-to-pypi helper

commit e8d69fb
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 09:33:58 2020 +0200

    Update README with more status badges

commit c34760b
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 10:57:46 2020 +0200

    Github action to build the docs

commit 24199ea
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 10:34:50 2020 +0200

    Sphinx-doc scaffold

commit 514d343
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 10:30:52 2020 +0200

    Add workflow for testing on windows

commit 61163c7
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 08:20:01 2020 +0200

    Standardize on requirement-devel.txt

commit cc7ed24
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 07:59:48 2020 +0200

    Add github workflow for testing on a crippled filesystem

commit f2b2a6c
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 07:56:23 2020 +0200

    Ignore pip metadata dumps and other stuff

commit 8e0ace0
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 07:48:54 2020 +0200

    [DATALAD RUNCMD] Install/enable versioneer

    === Do not change lines below ===
    {
     "chain": [],
     "cmd": "versioneer install",
     "exit": 0,
     "extra_inputs": [],
     "inputs": [],
     "outputs": [],
     "pwd": "."
    }
    ^^^ Do not change lines above ^^^

commit f44d7e2
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 09:34:46 2020 +0200

    Add missing __init__.py to get tests installed correctly

commit d94fb13
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 07:46:56 2020 +0200

    Simplify Travis setup

    No PY2, more up-to-date PY3 versions

commit edfe14a
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 07:41:07 2020 +0200

    Fixup and expand metadata in setup.cfg and for setup.py

    Sensible default setup for dependencies and testing. Should enable
    to just drop in some code, rename the package and run.

commit d0eec9f
Author: Adina Wagner <adina.wagner@t-online.de>
Date:   Tue Jun 9 10:52:48 2020 +0200

    add initial configuration for versioneer setup

commit 63e9a48
Author: Adina Wagner <adina.wagner@t-online.de>
Date:   Tue Jun 9 10:46:34 2020 +0200

    modernize setup according to https://github.com/datalad/datalad-ukbiobank

commit a836e6b
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Jun 10 08:05:04 2020 +0200

    Dummy workflow

commit 78de6c3
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Oct 12 07:55:25 2018 +0200

    TST: Swap out directmode tests for v6 tests

commit 75b6fa4
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Oct 12 06:52:49 2018 +0200

    Standard gitignore

commit 2bc890e
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Oct 12 06:52:29 2018 +0200

    Improve standard setup

commit 8da041a
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Apr 6 11:20:12 2018 +0200

    RF: Extension naming conventions

commit c971b18
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Mar 30 16:50:11 2018 +0200

    TST: Reenable wtf, after datalad got fixed

commit 92f22c3
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Mar 30 11:13:05 2018 +0200

    RF: Standardize on datalad_ module prefix (fixes psychoinformatics-degh-1)

commit cc63930
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Mar 30 09:39:20 2018 +0200

    Deal with Datalad bug

commit 839f728
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Mar 30 09:31:55 2018 +0200

    Install the package

commit 486cfa7
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Fri Mar 30 09:25:19 2018 +0200

    RF: Comply with datalads current ad-hoc naming conventions

commit 9351f99
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Thu Mar 29 20:45:47 2018 +0200

    TST: Basic test of whether datalad can see this extension

commit 9bc499d
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Thu Mar 29 20:33:10 2018 +0200

    TST: Trimmed travis setup from the mothership

commit 4ee24c4
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Mar 28 16:49:08 2018 +0200

    DOC: Basic README

commit 831e6c5
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Mar 28 16:09:14 2018 +0200

    DOC: Annotate setup.py

commit 7c5a645
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Mar 28 16:04:48 2018 +0200

    DOC: more complete basic info

commit 82300f6
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Mar 28 16:00:50 2018 +0200

    DOC: Some insight into the command implementation

commit 387333b
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Mar 28 15:49:56 2018 +0200

    Declare dependency on datalad

    Should be versioned, but needs to wait for a release.

commit 00e1754
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Mar 28 15:19:01 2018 +0200

    Demo of a minimalistic DataLad extension module

commit be4df7f
Author: Michael Hanke <michael.hanke@gmail.com>
Date:   Wed Mar 28 14:12:07 2018 +0200

    first commit

.appveyor.yml

@@ -1,7 +1,9 @@
-# The aim of this test setup is to create a "native" platform experience, using
-# as few cross-platform helper tools as possible.
+# This CI setup provides a largely homogeneous configuration across all
+# major platforms (Windows, MacOS, and Linux). The aim of this test setup is
+# to create a "native" platform experience, using as few cross-platform
+# helper tools as possible.
 #
-# A virtualenv is used for testing. The effective virtual env
+# On Linux/Mac a virtualenv is used for testing. The effective virtual env
 # is available under ~/VENV.
 #
 # All workers support remote login. Login details are shown at the top of each
@@ -24,7 +26,6 @@
 # make repository clone cheap
 shallow_clone: true
 
-
 environment:
   DATALAD_TESTS_SSH: 1
 
@@ -36,15 +37,15 @@ environment:
       APPVEYOR_BUILD_WORKER_IMAGE: Ubuntu2004
       INSTALL_SYSPKGS: python3-virtualenv
       # system git-annex is way too old, use better one
-      INSTALL_GITANNEX: git-annex -m deb-url --url http://ftp.us.debian.org/debian/pool/main/g/git-annex/git-annex_8.20201127-1_amd64.deb
+      INSTALL_GITANNEX: git-annex -m deb-url --url http://snapshot.debian.org/archive/debian/20210906T204127Z/pool/main/g/git-annex/git-annex_8.20210903-1_amd64.deb
+      CODECOV_BINARY: https://uploader.codecov.io/latest/linux/codecov
 
 
 # it is OK to specify paths that may not exist for a particular test run
 cache:
   # pip cache
   - /home/appveyor/.cache/pip -> .appveyor.yml
 
-
 # turn of support for MS project build support (not needed)
 build: off
 
@@ -73,26 +74,42 @@ install:
   # use of python/pip executables below
   - sh: "[ \"x$PY\" != x ] && . ${HOME}/venv${PY}/bin/activate || virtualenv -p 3 ${HOME}/dlvenv && . ${HOME}/dlvenv/bin/activate; ln -s \"$VIRTUAL_ENV\" \"${HOME}/VENV\""
   - cmd: "set PATH=C:\\Python%PY%;C:\\Python%PY%\\Scripts;%PATH%"
+  # deploy the datalad installer, override version via DATALAD_INSTALLER_VERSION
+  - cmd:
+      IF DEFINED DATALAD_INSTALLER_VERSION (
+      python -m pip install "datalad-installer%DATALAD_INSTALLER_VERSION%"
+      ) ELSE (
+      python -m pip install datalad-installer
+      )
+  - sh: python -m pip install datalad-installer${DATALAD_INSTALLER_VERSION:-}
   # Missing system software
-  - sh: "[ -n \"$INSTALL_SYSPKGS\" ] && ( [ \"x${APPVEYOR_BUILD_WORKER_IMAGE}\" = \"xmacOS\" ] && brew install -q ${INSTALL_SYSPKGS} || sudo apt-get install --no-install-recommends -y ${INSTALL_SYSPKGS} ) || true"
+  - sh: "[ -n \"$INSTALL_SYSPKGS\" ] && ( [ \"x${APPVEYOR_BUILD_WORKER_IMAGE}\" = \"xmacOS\" ] && brew install -q ${INSTALL_SYSPKGS} || { sudo apt-get update -y && sudo apt-get install --no-install-recommends -y ${INSTALL_SYSPKGS}; } ) || true"
+  # Install git-annex on windows, otherwise INSTALL_SYSPKGS can be used
   # deploy git-annex, if desired
-  - sh: "[ -n \"${INSTALL_GITANNEX}\" ] && python datalad_installer.py ${INSTALL_GITANNEX}"
+  - cmd: IF DEFINED INSTALL_GITANNEX datalad-installer --sudo ok %INSTALL_GITANNEX%
+  - sh: "[ -n \"${INSTALL_GITANNEX}\" ] && datalad-installer --sudo ok ${INSTALL_GITANNEX}"
+  # in case of a snapshot installation, use the following approach to adjust
+  # the PATH as necessary
+  #- sh: "[ -n \"${INSTALL_GITANNEX}\" ] && datalad-installer -E ${HOME}/dlinstaller_env.sh --sudo ok ${INSTALL_GITANNEX}"
+  # add location of datalad installer results to PATH
+  #- sh: "[ -f ${HOME}/dlinstaller_env.sh ] && . ${HOME}/dlinstaller_env.sh || true"
 
 
 #before_build:
 #
 
 
 build_script:
-  - pip install -r requirements-devel.txt
-  - pip install .
+  - python -m pip install -r requirements-devel.txt
+  - python -m pip install .
 
 
 #after_build:
 #
 
 
 before_test:
+  # simple call to see if datalad and git-annex are installed properly
   - datalad wtf
 
 
@@ -101,17 +118,16 @@ test_script:
   - cmd: md __testhome__
   - sh: mkdir __testhome__
   - cd __testhome__
-    # run test selecion (--traverse-namespace needed from Python 3.8 onwards)
-  - cmd: python -m nose --traverse-namespace -s -v -A "not (turtle)" --with-cov --cover-package datalad_debian %DTS%
-  - sh:  python -m nose --traverse-namespace -s -v -A "not (turtle)" --with-cov --cover-package datalad_debian ${DTS}
+  # run test selecion (--traverse-namespace needed from Python 3.8 onwards)
+  - cmd: python -m nose --traverse-namespace -s -v -A "not (turtle)" --with-cov --cover-package datalad_helloworld %DTS%
+  - sh:  python -m nose --traverse-namespace -s -v -A "not (turtle)" --with-cov --cover-package datalad_helloworld ${DTS}
 
 
 after_test:
-  # prepare coverage.xml in a separate invocation.
-  # if invoked directly with nose - do not include test_ files themselves
   - python -m coverage xml
-  - sh: bash <(curl -s https://codecov.io/bash)
-
+  - sh: "curl -Os $CODECOV_BINARY"
+  - sh: chmod +x codecov
+  - sh: ./codecov
 
 #on_success:
 #
@@ -123,4 +139,4 @@ after_test:
 
 on_finish:
   # conditionally block the exit of a CI run for direct debugging
-  - sh: while [ -f ~/BLOCK ]; do sleep 5; done
+  - sh: while [ -f ~/BLOCK ]; do sleep 5; done

.codeclimate.yml

@@ -0,0 +1,17 @@
+version: "2"
+checks:
+  file-lines:
+    config:
+      threshold: 500
+plugins:
+  bandit:
+    enabled: true
+    checks:
+      assert_used:
+        enabled: false
+exclude_patterns:
+- "_datalad_buildsupport/"
+- "versioneer.py"
+- "*/_version.py"
+- "tools/"
+- "**/tests/"

.gitattributes

@@ -1 +1,2 @@
 datalad_debian/_version.py export-subst
+

MANIFEST.in

@@ -1,2 +1,5 @@
-include versioneer.py
-include datalad_debian/_version.py
+include CONTRIBUTORS LICENSE versioneer.py
+graft _datalad_buildsupport
+graft docs
+prune docs/build
+global-exclude *.py[cod]

Makefile

@@ -9,8 +9,7 @@ clean:
 release-pypi:
 	# avoid upload of stale builds
 	test ! -e dist
-	$(PYTHON) setup.py sdist
-	python setup.py bdist_wheel --universal
+	$(PYTHON) setup.py sdist bdist_wheel
 	twine upload dist/*
 
 update-buildsupport:

README.md

@@ -1,3 +1,5 @@
+<<<<<<< HEAD
 # DataLad extension for working with Debian packages and package repositories
 
 [![Build status](https://ci.appveyor.com/api/projects/status/au70ke2hrnfk73c1/branch/master?svg=true)](https://ci.appveyor.com/project/mih/datalad-debian/branch/master) [![codecov.io](https://codecov.io/github/psychoinformatics-de/datalad-debian/coverage.svg?branch=master)](https://codecov.io/github/psychoinformatics-de/datalad-debian?branch=master) [![docs](https://github.com/psychoinformatics-de/datalad-debian/workflows/docs/badge.svg)](https://github.com/psychoinformatics-de/datalad-debian/actions?query=workflow%3Adocs)
+

_datalad_buildsupport/formatters.py

@@ -251,7 +251,7 @@ def _mk_options(self, parser):
 
     def _format_action(self, action):
         # determine the required width and the entry label
-        action_header = self._format_action_invocation(action, doubledash='-\\\\-')
+        action_header = self._format_action_invocation(action)
 
         if action.help:
             help_text = self._expand_help(action)

_datalad_buildsupport/setup.py

@@ -9,12 +9,12 @@
 import datetime
 import os
 
-from distutils.core import Command
-from distutils.errors import DistutilsOptionError
+
 from os.path import (
     dirname,
     join as opj,
 )
+from setuptools import Command, DistutilsOptionError
 from setuptools.config import read_configuration
 
 import versioneer
@@ -75,7 +75,7 @@ def finalize_options(self):
             mod_name, suite_name = self.cmdsuite.split(':')
             mod = __import__(mod_name, fromlist=mod_name.split('.'))
             suite = getattr(mod, suite_name)
-            self.cmdlist = [c[2] if len(c) > 2 else c[1].replace('_', '-')
+            self.cmdlist = [c[2] if len(c) > 2 else c[1].replace('_', '-').lower()
                             for c in suite[1]]
 
         self.announce('Writing man page(s) to %s' % self.manpath)

docs/Makefile

@@ -87,9 +87,9 @@ qthelp:
 	@echo
 	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
 	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/datalad_metalad.qhcp"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/datalad_helloworld.qhcp"
 	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/datalad_metalad.qhc"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/datalad_helloworld.qhc"
 
 applehelp:
 	$(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp
@@ -104,8 +104,8 @@ devhelp:
 	@echo
 	@echo "Build finished."
 	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/datalad_metalad"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/datalad_metalad"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/datalad_helloworld"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/datalad_helloworld"
 	@echo "# devhelp"
 
 epub:

docs/README.md

@@ -0,0 +1,35 @@
+## Editing, building, and publishing extension documentation
+
+
+The `datalad-extension-template` uses [Sphinx](https://www.sphinx-doc.org/en/master/index.html#) for document generation
+and suggests using [Read the Docs](https://docs.readthedocs.io/en/stable/) for automatic documentation building, versioning, and hosting.
+
+Once you are ready to document your extension software, take note of the following:
+
+### Document editing
+
+Edit your `docs/source/index.rst` file using [reStructuredText](https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html),
+which is the default plaintext markup language used by Sphinx. Add further documentation as needed.
+
+### Local testing
+
+For testing locally whether your documentation builds and renders correctly, first install the developer requirements from the repository's root directory:
+```
+pip install -r requirements-devel.txt
+```
+
+Then build the documentation locally:
+```
+make -C docs html
+```
+
+Navigate to `docs/build/` and open `index.html` in your browser to view your documentation.
+
+### Remote building and testing
+
+The GitHub Action workflow located at `.github/workflows/docbuild.yml` will run on a push or pull request to your GitHub repository's master/main branch. This builds the documentation remotely and serves as an automated documentation test.
+
+### Publishing your documentation
+
+- If you maintain your extension yourself *outside of the scope of the DataLad GitHub organization*, you can follow [these instructions](https://docs.readthedocs.io/en/stable/integrations.html) for integrating your version control system (such as GitHub) with Read the Docs.
+- If your extension is *maintained by the DataLad developer team*, please create an issue asking for help with the setup.

docs/source/conf.py

@@ -1,6 +1,10 @@
 # -*- coding: utf-8 -*-
 #
+<<<<<<< HEAD
 # datalad_metalad documentation build configuration file, created by
+=======
+# datalad_helloworld documentation build configuration file, created by
+>>>>>>> template/master
 # sphinx-quickstart on Tue Oct 13 08:41:19 2015.
 #
 # This file is execfile()d with the current directory set to its
@@ -42,7 +46,11 @@
                     '{} build_{} --cmdsuite {} --manpath {} --rstpath {}'.format(
                         setup_py_path,
                         cmd,
+<<<<<<< HEAD
                         'datalad_debian:command_suite',
+=======
+                        'datalad_helloworld:command_suite',
+>>>>>>> template/master
                         abspath(opj(dirname(setup_py_path), 'build', 'man')),
                         opj(dirname(__file__), 'generated', 'man')))
         except:
@@ -93,7 +101,11 @@
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
+<<<<<<< HEAD
 version = datalad_debian.__version__
+=======
+version = datalad_helloworld.__version__
+>>>>>>> template/master
 release = version
 
 # The language for content autogenerated by Sphinx. Refer to documentation
@@ -136,3 +148,11 @@
 
 # If true, links to the reST sources are added to the pages.
 html_show_sourcelink = False
+<<<<<<< HEAD
+=======
+
+# smart quotes are incompatible with the RST flavor of the generated manpages
+# but see `smartquotes_action` for more fine-grained control, in case
+# some of this functionality is needed
+smartquotes = False
+>>>>>>> template/master

pyproject.toml

@@ -1,2 +1,2 @@
 [build-system]
-requires = ["setuptools >= 30.3.0", "wheel"]
+requires = ["setuptools >= 43.0.0", "wheel"]

setup.cfg

@@ -15,19 +15,29 @@ classifiers =
 python_requires = >= 3.6
 install_requires =
     datalad >= 0.14.0rc1
-test_requires =
-    nose
-    coverage
 packages = find:
 include_package_data = True
 
+[options.extras_require]
+# this matches the name used by -core and what is expected by some CI setups
+devel =
+    nose
+    coverage
+
 [options.packages.find]
 # do not ship the build helpers
 exclude=
     _datalad_buildsupport
 
 [options.package_data]
 * = resources/procedures/*.py
+[options.entry_points]
+# 'datalad.extensions' is THE entrypoint inspected by the datalad API builders
+datalad.extensions =
+    # the label in front of '=' is the command suite label
+    # the entrypoint can point to any symbol of any name, as long it is
+    # valid datalad interface specification (see demo in this extensions)
+    datalad_debian = datalad_debian:command_suite
 
 [versioneer]
 # See the docstring in versioneer.py for instructions. Note that you must
@@ -45,3 +55,4 @@ show_missing = True
 omit =
     # versioneer code
     datalad_debian/_version.py
+

setup.py

@@ -11,26 +11,9 @@
 cmdclass = versioneer.get_cmdclass()
 cmdclass.update(build_manpage=BuildManPage)
 
-# Give setuptools a hint to complain if it's too old a version
-# 30.3.0 allows us to put most metadata in setup.cfg
-# Should match pyproject.toml
-SETUP_REQUIRES = ['setuptools >= 30.3.0']
-# This enables setuptools to install wheel on-the-fly
-SETUP_REQUIRES += ['wheel'] if 'bdist_wheel' in sys.argv else []
-
 if __name__ == '__main__':
     setup(name='datalad_debian',
           version=versioneer.get_version(),
           cmdclass=cmdclass,
-          setup_requires=SETUP_REQUIRES,
-          entry_points={
-              # 'datalad.extensions' is THE entrypoint inspected by the datalad API builders
-              'datalad.extensions': [
-                  # the label in front of '=' is the command suite label
-                  # the entrypoint can point to any symbol of any name, as long it is
-                  # valid datalad interface specification (see demo in this extensions
-                  'debian=datalad_debian:command_suite',
-              ],
-          },
     )
 

versioneer.py

@@ -1500,7 +1500,7 @@ def get_cmdclass():
     cmds = {}
 
     # we add "version" to both distutils and setuptools
-    from distutils.core import Command
+    from setuptools import Command
 
     class cmd_version(Command):
         description = "report generated version string"