git-annex 10.20250520b4__py3-none-macosx_14_0_arm64.whl

git_annex/__init__.py

@@ -0,0 +1,47 @@
+import os.path as op
+import subprocess
+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.
+
+    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.
+    """
+    exe_dir = op.dirname(__file__)
+    exe = op.join(
+        exe_dir,
+        op.basename(sys.argv[0]),
+    )
+    args = [exe] + sys.argv[1:]
+    try:
+        subprocess.run(
+            args,
+            executable=op.join(
+                exe_dir,
+                f'git-annex{".exe" if sys.platform.startswith("win") else ""}',
+            ),
+            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.20250520b4.dist-info/METADATA

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: git-annex
+Version: 10.20250520b4
+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
+
+## 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, but without the git-annex assistant.
+The primary purpose of this package is to provide git-annex (as a dependency),
+installed in a virtual environment. Users of the git-annex assistant application
+likely install git-annex via any of its platform packages.
+
+## 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
+
+Git-annex is built with libmagic support, but the library is not included and needs
+to be deployed separately.
+
+
+## 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.

git_annex-10.20250520b4.dist-info/RECORD

@@ -0,0 +1,7 @@
+git_annex/__init__.py,sha256=n9tUYvSlfPGVXj7L860y9YnDDnfhnCLPuAysEuxKihk,1472
+git_annex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+git_annex/git-annex,sha256=6ztA9yAfkRcjkB0gFQCItFZhwL2kVIzxbpvlW_L9ZFU,168165432
+git_annex-10.20250520b4.dist-info/METADATA,sha256=1gvH4C8pHXzUxvN0R1CXRrJ4uM_bgSLV2Z080VGdJ4Q,4879
+git_annex-10.20250520b4.dist-info/WHEEL,sha256=eaSKqWH-ZPKgFrHaSRkMfjdnqk5GaqaF1YPM6h_26sY,102
+git_annex-10.20250520b4.dist-info/entry_points.txt,sha256=BI1LqRvI7ETq6hOuPgaT9O9cmmHJwYS3SthvRoNS43s,146
+git_annex-10.20250520b4.dist-info/RECORD,,

git_annex-10.20250520b4.dist-info/WHEEL

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

git_annex-10.20250520b4.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