Initial

LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 relikd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,91 @@
+# brew.py
+
+A lightweight replacement for Homebrew
+
+see [usage](#usage) below.
+
+
+## Install
+
+Copy `brew.py` to anywhere, where it can be found by your shell.
+Or add a new path to your `$PATH`.
+
+In your shell config (e.g., `.zprofile`) add
+
+```sh
+export BREW_PY_CELLAR=$HOME/any/path/you/like
+```
+
+
+## FAQ
+
+### Why this project?
+
+Well, I hate dependencies.
+For years, I have been avoiding Homebrew because of the large codebase and because Homebrew installs a lot of stuff in a lot of different places.
+And I did not want to audit every single installation.
+
+Most of the time, I just need a single binary and thus fallback to downloading that binary manually.
+That's how this script started – as a way to download a single binary.
+And then it escalated quickly.
+Now I am trying to copy some of the functionality of brew itself and the, once simple script, is growing into a full-fledged Homebrew-alternative suite.
+
+I don't know if anybody can make use of this, but here you go.
+
+
+### What is the scope?
+
+I don't know yet.
+Maybe I will add more features, and copy more of the original brew CLI.
+But most importantly, it should be simple and dependency free.
+
+brew.py focuses on:
+- downloading pre-built binaries (bottles) from Brew.sh or GitHub registry
+- re-link dynamic libraries (.dylib) to use relative paths
+- provide a structure for other brew packages to link to shared libs
+
+What brew.py does **NOT** do:
+- build from source code
+- search or browse packages (use Brew.sh for that)
+- formula analysis & dependency checks (use Brew.sh to check if a package is suitable for your machine)
+- cask management (beyond mere download)
+
+
+## Usage
+
+```
+usage: brew.py [-h] [-q] [--version] command ...
+
+A lightweight replacement for Homebrew
+
+positional arguments:
+  command
+    info                List versions, dependencies, platforms, etc.
+    home (homepage)     Open a project's homepage in a browser.
+    fetch               Download bottle (binary tar) for package.
+    list (ls)           List installed packages.
+    deps                Show dependencies for package.
+    uses                Show dependents of package (reverse dependencies).
+    leaves              List installed packages that are not dependencies of
+                        another package.
+    missing             Check the given packages for missing dependencies. If
+                        no packages are provided, check all kegs. Will exit
+                        with a non-zero status if any are found to be missing.
+    install             Install a package with all dependencies.
+    uninstall (remove, rm)
+                        Remove / uninstall a package.
+    link (ln)           Link a specific package version (activate).
+    unlink              Remove symlinks for package to (temporarily) disable
+                        it.
+    switch              Change package version.
+    cleanup             Remove old versions of installed packages. If
+                        arguments are specified, only do this for the given
+                        packages. Removes all downloads more than 120 days
+                        old. This can be adjusted with
+                        $BREW_PY_CLEANUP_MAX_AGE_DAYS.
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -q, --quiet           reduce verbosity (-q or -qq)
+  --version             show program's version number and exit
+```