support for clone

README.md

@@ -18,7 +18,10 @@ See https://github.com/liquidcarbon/puppy
 The `pup-py-fetch` API accepts query parameters that allow specifying the exact environment recipe you want to build:
   - `python`: [3.10](https://pup-py-fetch.hf.space?python=3.10) through [3.13](https://pup-py-fetch.hf.space?python=3.13)
   - `pixi`: [comma-separated list of pixi/Conda dependencies](https://pup-py-fetch.hf.space?pixi=jupyter,quarto)
-  - virtual environments: [all other query parameters with comma-separated package names](https://pup-py-fetch.hf.space?env1=duckdb,pandas&env2=cowsay)
+  - `clone`: [comma-separated list of GitHub repos to clone and install](https://pup-py-fetch.hf.space?clone=marimo-team/marimo) (only GitHub at this time)
+  - virtual environments: [all other query parameters with comma-separated package names](https://pup-py-fetch.hf.space?env1=duckdb,pandas&env2=cowsay), including:
+    - regular PyPI packages (no support for version pinning at this time)
+    - packages from GitHub repos using <username>/<reponame>
 
 > [!NOTE]
 > As of Dec 2024, many packages still do not support python 3.13; thus, the default version in puppy is 3.12.

fetch.py

@@ -47,12 +47,15 @@ def read_root(request: Request) -> Response:
     Query parameters can be used to install specific things, e.g.
     curl -fsSL "https://pup-py-fetch.hf.space?python=3.11&pixi=marimo&myenv=cowsay,duckdb"
 
-    A slash ("/") in package name is interpreted as a git repo.
+    A slash ("/") in package name is interpreted as a GitHub repo.
     Package specs "duckdb>=1.1" are not supported.
     """
 
     query_params = dict(request.query_params)
 
+    # exclude internal endpoints
+    _ = query_params.pop("logs", "")
+
     # python version
     py_ver = query_params.pop("python", "3.12")
     if "Windows" in request.headers.get("user-agent"):
@@ -71,16 +74,22 @@ def read_root(request: Request) -> Response:
     pixi_packages = query_params.pop("pixi", "")
     if pixi_packages:
         for pkg in pixi_packages.split(","):
-            if "/" in pkg:
-                pkg = f"https://github.com/{pkg}.git"
             script.append(f"pixi add {pkg}")
 
+    # repos to be cloned
+    to_clone = query_params.pop("clone", "")
+    if to_clone:
+        for repo in to_clone.split(","):
+            if "/" in repo:
+                pkg = f"https://github.com/{repo}.git"
+                script.append(f"pup clone {pkg}")
+            else:
+                script.append(f"# can't clone `{repo}`: expected <username>/<reponame>")
+
     # remaining query params are venvs
     for venv, uv_packages in query_params.items():
-        if venv in ["logs"]:
-            continue
         for pkg in uv_packages.split(","):
-            if "/" in pkg:
+            if "/" in pkg:  # slash implies GitHub repo
                 pkg = f"https://github.com/{pkg}.git"
             script.append(f"pup add {venv} {pkg}")
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fetch"
-version = "0.5.1"
+version = "0.6.0"
 description = "Puppy Installer"
 authors = [
     { name = "Alex Kislukhin" }
@@ -11,3 +11,6 @@ dependencies = [
     "apscheduler>=3.11.0",
     "fastapi[standard]>=0.115.6",
 ]
+
+[project.urls]
+homepage = "https://github.com/liquidcarbon/puppy"