dotslash 0.5.8__py3-none-manylinux_2_28_x86_64.whl

dotslash/__init__.py

@@ -0,0 +1,36 @@
+from __future__ import annotations
+
+
+def locate() -> str:
+    """
+    Returns:
+        The path to the DotSlash binary that was installed by this package.
+    """
+    import os
+    import sys
+    import sysconfig
+
+    from dotslash._locate import _search_paths
+
+    if extension := sysconfig.get_config_var("EXE"):
+        binary_name = f"dotslash{extension}"
+    elif sys.platform == "win32":
+        binary_name = "dotslash.exe"
+    else:
+        binary_name = "dotslash"
+
+    # Map of normalized paths to the actual path
+    seen_paths: dict[str, str] = {}
+    for search_path in _search_paths():
+        normalized_path = os.path.normcase(search_path)
+        if normalized_path in seen_paths:
+            continue
+
+        seen_paths[normalized_path] = search_path
+        binary_path = os.path.join(search_path, binary_name)
+        if os.path.isfile(binary_path):
+            return binary_path
+
+    search_paths = "\n".join(f"- {search_path}" for search_path in seen_paths.values())
+    msg = f"The `{binary_name}` binary was not found in any of the following paths:\n{search_paths}"
+    raise FileNotFoundError(msg)

dotslash/__main__.py

@@ -0,0 +1,16 @@
+if __name__ == "__main__":
+    import sys
+
+    from dotslash import locate
+
+    dotslash = locate()
+
+    if sys.platform == "win32":
+        import subprocess
+
+        process = subprocess.run([dotslash, *sys.argv[1:]])
+        sys.exit(process.returncode)
+    else:
+        import os
+
+        os.execvp(dotslash, [dotslash, *sys.argv[1:]])

dotslash/_locate.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+import os
+import sys
+import sysconfig
+
+
+def _search_paths():
+    # The scripts directory for the current Python installation
+    yield sysconfig.get_path("scripts")
+
+    # The scripts directory for the base prefix if in a virtual environment
+    yield sysconfig.get_path("scripts", vars={"base": sys.base_prefix, "platbase": sys.base_exec_prefix})
+
+    module_dir = os.path.dirname(os.path.abspath(__file__))
+    package_parent, package_name = os.path.split(module_dir)
+    if package_name == "dotslash":
+        # Above the package root e.g. when running `pip install --prefix` or `uv run --with`
+        # Windows: <prefix>\Lib\site-packages\dotslash
+        # macOS: <prefix>/lib/pythonX.Y/site-packages/dotslash
+        # Linux:
+        #   <prefix>/lib/pythonX.Y/site-packages/dotslash
+        #   <prefix>/lib/pythonX.Y/dist-packages/dotslash (Debian-based distributions)
+        head, tail = os.path.split(package_parent)
+        if tail.endswith("-packages"):
+            head, tail = os.path.split(head)
+            if sys.platform == "win32":
+                if tail == "Lib":
+                    yield os.path.join(head, "Scripts")
+            elif tail.startswith("python"):
+                head, tail = os.path.split(head)
+                if tail == sys.platlibdir:
+                    yield os.path.join(head, "bin")
+        else:
+            # Adjacent to the package root e.g. when using the `--target` option of pip-like installers
+            yield os.path.join(package_parent, "bin")
+
+    # The scripts directory for user installations
+    yield sysconfig.get_path("scripts", scheme=sysconfig.get_preferred_scheme("user"))

dotslash-0.5.8.dist-info/METADATA

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: dotslash
+Version: 0.5.8
+Summary: Command-line tool to facilitate fetching an executable, caching it, and then running it.
+Project-URL: Homepage, https://dotslash-cli.com
+Project-URL: Tracker, https://github.com/facebook/dotslash/issues
+Project-URL: Source, https://github.com/facebook/dotslash
+Author-email: Ofek Lev <oss@ofek.dev>
+License-Expression: MIT OR Apache-2.0
+Keywords: dotslash
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# DotSlash: simplified executable deployment
+
+[![CI - Build](https://github.com/ofek/dotslash/actions/workflows/build.yml/badge.svg)](https://github.com/ofek/dotslash/actions/workflows/build.yml)
+[![CI - Test](https://github.com/ofek/dotslash/actions/workflows/test.yml/badge.svg)](https://github.com/ofek/dotslash/actions/workflows/test.yml)
+[![PyPI - Version](https://img.shields.io/pypi/v/dotslash.svg?logo=pypi&label=PyPI&logoColor=gold)](https://pypi.org/project/dotslash/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/dotslash.svg?color=blue&label=Downloads&logo=pypi&logoColor=gold)](https://pypi.org/project/dotslash/)
+[![Built by Hatch](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch)
+[![Ruff linting/formatting](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+
+-----
+
+[DotSlash](https://dotslash-cli.com/docs/) (`dotslash`) is a command-line tool that lets you represent a set of platform-specific, heavyweight executables with an equivalent small, easy-to-read text file. In turn, this makes it efficient to store executables in source control without hurting repository size. This paves the way for checking build toolchains and other tools directly into the repo, reducing dependencies on the host environment and thereby facilitating reproducible builds.
+
+The `dotslash` package allows you to use DotSlash in your Python projects without having to install DotSlash globally.
+
+***Table of Contents***
+
+- [Using as a library](#using-as-a-library)
+- [Using as a command-line tool](#using-as-a-command-line-tool)
+- [License](#license)
+
+## Using as a library
+
+The `dotslash.locate` function returns the path to the DotSlash binary that was installed by this package.
+
+```pycon
+>>> import dotslash
+>>> dotslash.locate()
+'/root/.local/bin/dotslash'
+```
+
+## Using as a command-line tool
+
+The installed DotSlash binary can be invoked directly by running the `dotslash` module as a script.
+
+```
+python -m dotslash path/to/dotslash-file.json
+```
+
+## License
+
+DotSlash is licensed under both the MIT license and Apache-2.0 license; the exact terms can be found in the [LICENSE-MIT]() and LICENSE-APACHE files, respectively.

dotslash-0.5.8.dist-info/RECORD

@@ -0,0 +1,8 @@
+dotslash/__init__.py,sha256=RwrwUD4V3uVIR-l74szVivnihV7ELJtYQcbmirt6vkg,1125
+dotslash/__main__.py,sha256=yPbDw8nAL_B_R0E8xR9B_U_NerYlGuyKtSK8OnXzmFs,341
+dotslash/_locate.py,sha256=vsI1dQn6aY6qvJExq6iA0sKJuy66t3IDSmrA-VYjf4o,1678
+dotslash/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dotslash-0.5.8.data/scripts/dotslash,sha256=5EUv-mV4J0y0MxpdA9ZwwAKbKISECa8FBfLwxefyABg,1773200
+dotslash-0.5.8.dist-info/METADATA,sha256=b8KIjQMSgIQBeQA2C1N9LuviX5WLX6QFG73hRZZW8SA,3087
+dotslash-0.5.8.dist-info/WHEEL,sha256=KIAe9EgegkXPFiHp2a_tp7eYSZ2g_QNM3LO8Ikw3feA,105
+dotslash-0.5.8.dist-info/RECORD,,

dotslash-0.5.8.dist-info/WHEEL

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