git-annex 10.20250520b7__py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

git_annex/__init__.py

@@ -0,0 +1,57 @@
+import os
+import os.path as op
+import sys
+
+
+def cli():
+    """Emulate a symlink to a binary.
+
+    This script essentially calls the `git-annex` binary that is shipped
+    with the package, but using the `argv` list (including a potentially
+    different executable name) pass to the script itself.
+
+    On Unix-like systems, it `exec`s the binary, replacing the current process.
+    Windows does not support `exec`, so in that case, it relies on the
+    `executable` argument of `subprocess.run()` to achieve this.
+
+    This approach provides alternative means for git-annex's installation
+    method with symlinks pointing to a single binary, and works on platforms
+    without symlink support, and also in packages that cannot represent
+    symlinks.
+    """
+    exedir = op.dirname(__file__)
+    exe = op.join(exedir, 'git-annex')
+    if sys.platform.startswith('darwin'):
+        # we look for an embedded file magic DB,
+        # and instruct libmagic to use it
+        embedded_magic = op.join(exedir, 'magic.mgc')
+        if op.exists(embedded_magic):
+            os.environ['MAGIC'] = embedded_magic
+
+    if sys.platform.startswith('win'):
+        exec_subproc(f'{exe}.exe', sys.argv)
+    else:
+        os.execv(exe, sys.argv)
+
+
+def exec_subproc(executable, argv):
+    import subprocess
+
+    try:
+        subprocess.run(
+            argv,
+            executable=executable,
+            shell=False,
+            check=True,
+        )
+        # try flush here to trigger a BrokenPipeError
+        # within the try-except block so we can handle it
+        # (happens if the calling process closed stdout
+        # already)
+        sys.stdout.flush()
+    except BrokenPipeError:
+        # setting it to None prevents Python from trying to
+        # flush again
+        sys.stdout = None
+    except subprocess.CalledProcessError as e:
+        sys.exit(e.returncode)

git_annex-10.20250520b7.dist-info/METADATA

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: git-annex
+Version: 10.20250520b7
+Summary: manage files with git, without checking their contents into git
+Project-URL: Homepage, https://git-annex.branchable.com/
+Project-URL: Documentation, https://git-annex.branchable.com/git-annex
+Project-URL: Issues, https://git-annex.branchable.com/bugs
+Project-URL: Source, http://source.git-annex.branchable.com/?p=source.git
+Project-URL: Changelog, http://source.git-annex.branchable.com/?p=source.git;a=blob;f=CHANGELOG;hb=HEAD
+Author-email: Joey Hess <id@joeyh.name>
+Maintainer-email: Michael Hanke <mih@ngln.eu>
+License-Expression: AGPL-3.0-or-later
+Keywords: data logistics,git,version control
+Classifier: Development Status :: 6 - Mature
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: DFSG approved
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Natural Language :: English
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Haskell
+Classifier: Topic :: Software Development :: Version Control
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: System :: Archiving :: Backup
+Classifier: Topic :: System :: Archiving :: Mirroring
+Classifier: Topic :: System :: Archiving :: Packaging
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Python wheel package for git-annex
+
+[![Test git-annex wheel from PyPi](https://github.com/psychoinformatics-de/git-annex-wheel/actions/workflows/test-pypi-wheel.yaml/badge.svg)](https://github.com/psychoinformatics-de/git-annex-wheel/actions/workflows/test-pypi-wheel.yaml)
+
+## Why?
+
+[Git-annex](https://git-annex.branchable.com/) is written in Haskell and plenty
+of [installation methods](https://git-annex.branchable.com/install/) are
+available. However, for deploying git-annex as a dependency of a Python
+library/application, like [DataLad](https://datalad.org) or
+[AnnexRemote](https://github.com/Lykos153/AnnexRemote), system packages
+are a lot less flexible than Python's virtual environments, and other methods
+are more complex and fragile.
+
+With git-annex being available from PyPi, versioned dependencies and deployment
+in application-specific environments are possible via standard means of Python
+packaging.
+
+## Caveats
+
+A standard git-annex deployment is (primarily) a single binary (`git-annex`),
+and a bunch of symlinks that make this one binary fulfilled multiple roles
+(`git-annex-shell`, `git-remote-annex`, etc.). A Python wheel, however, is a
+ZIP file container with no support for symlinks, and also no support for
+"post-install" scripts.
+
+In order to square this circle, the git-annex binary is wrapped via regular
+Python entrypoint scripts that handle calling git-annex as necessary. This
+delivers a cross-platform compatible wheel, but at a start-up cost (~30ms vs
+~11ms on my laptop).
+
+## Installation
+
+Get the package from [PyPi](https://pypi.org/project/git-annex/), and install like
+any other package from PyPi.
+
+[uv](https://docs.astral.sh/uv/) users can deploy git-annex in a dedicated virtual
+environment via the one-liner:
+
+```
+uv tool install git-annex
+```
+
+## git-annex build configuration
+
+Git-annex is built with libmagic support.
+
+## Platform notes
+
+### Linux
+
+The `manylinux` wheel is self-contained and includes copies of all libraries.
+It only depends on the declared GLIBC versions.
+The `magic.mgc` database is not included, and is assumed to be available on
+the target system. Install it separately, if needed (e.g., `libmagic-mgc`
+package).
+
+### Windows
+
+The wheel is self-contained and includes a copy of libmagic and the `magic.mgc` database.
+
+### Mac
+
+The wheel is self-contained and includes a copy of libmagic and the `magic.mgc` database.
+
+
+## Developer information
+
+### Sources
+
+The sources for this package are available at
+https://github.com/psychoinformatics-de/git-annex-wheel
+
+The repository tracks the git-annex sources as a Git submodule.
+
+### Issues
+
+For issues related to the Python wheel packaging of git-annex, please
+use the tracker at https://github.com/psychoinformatics-de/git-annex-wheel/issues
+
+### How to update for a new git-annex release?
+
+Advance the submodule `./git-annex` to the new release tag.
+
+Now adjust the package version in `pyproject.toml` accordingly. This version
+must follow the [rules for Python
+packages](https://packaging.python.org/en/latest/discussions/versioning/).
+
+The included (GitHub) action workflows will build a corresponding wheel
+and upload it to PyPi.
+
+
+## Acknowledgements
+
+This work was funded, in part, by
+
+- Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) under grant TRR 379 (546006540, Q02 project)
+- Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) under grant SFB 1451 (431549029, INF project)
+- MKW-NRW: Ministerium für Kultur und Wissenschaft des Landes Nordrhein-Westfalen under the Kooperationsplattformen 2022 program, grant number: KP22-106A

git_annex-10.20250520b7.dist-info/RECORD

@@ -0,0 +1,9 @@
+git_annex-10.20250520b7.dist-info/WHEEL,sha256=6_2lANoj4akpF0dr94LsANkG1f93WWvG9zbNtT8RhqI,142
+git_annex-10.20250520b7.dist-info/METADATA,sha256=WdllYufgVbQ1I3viAUzKGrlEPh3kJ9tkIkQRLtQqOaQ,5281
+git_annex-10.20250520b7.dist-info/entry_points.txt,sha256=BI1LqRvI7ETq6hOuPgaT9O9cmmHJwYS3SthvRoNS43s,146
+git_annex-10.20250520b7.dist-info/RECORD,,
+git_annex/git-annex,sha256=tIkjmvMyqsgN8j0YrBWcVXHCNxWMtldoRnBCe0QHA-k,99411512
+git_annex/__init__.py,sha256=71NXukas5SOL6UI65o830T-lAx4QC8h6B1PcYTRxL3g,1869
+git_annex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+git_annex.libs/libmagic-bfa5e61a.so.1.0.0,sha256=hMol0fstxmHO59eaEoZhox5SSiLWBSeibqaylUx1ALo,132872
+git_annex.libs/libgmp-40922323.so.10.3.0,sha256=MWOfBqrSPSsVLbEbD3CKo-a9gPXBME0bkUow1jZKA4Q,535856

git_annex-10.20250520b7.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: false
+Tag: py3-none-manylinux_2_17_x86_64
+Tag: py3-none-manylinux2014_x86_64
+

git_annex-10.20250520b7.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+git-annex = git_annex:cli
+git-annex-shell = git_annex:cli
+git-remote-annex = git_annex:cli
+git-remote-tor-annex = git_annex:cli