uniswap-python · TimeToBuildBob · Sep 2, 2026 · Sep 2, 2026 · Sep 2, 2026 · Sep 2, 2026
diff --git a/.github/workflows/adoption-snapshot.yml b/.github/workflows/adoption-snapshot.yml
@@ -0,0 +1,54 @@
+name: Adoption Snapshot
+
+on:
+  schedule:
+    # Daily at 06:00 UTC — captures GitHub traffic before the 14-day window rolls off
+    - cron: "0 6 * * *"
+  workflow_dispatch:  # allow manual runs
+
+# The default GITHUB_TOKEN cannot call GET /repos/.../traffic/* (always 403).
+# Add repo secret ADOPTION_GITHUB_TOKEN: a PAT with Administration:read
+# (fine-grained) or public_repo (classic). Contents:write on GITHUB_TOKEN
+# is still what commits the snapshot files.
+permissions:
+  contents: write
+
+concurrency:
+  group: adoption-snapshot
+  cancel-in-progress: false
+
+jobs:
+  snapshot:
+    runs-on: ubuntu-latest
+    steps:
+      # Pin checkout: this job has contents: write.
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4
+        with:
+          fetch-depth: 0
+
+      - name: Run adoption snapshot
+        env:
+          GITHUB_TOKEN: ${{ secrets.ADOPTION_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
+        run: python3 scripts/adoption_snapshot.py --out metrics/ --strict
+
+      - name: Commit snapshot
+        run: |
+          set -euo pipefail
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add metrics/
+          if git diff --staged --quiet; then
+            echo "No changes to commit (snapshot already up to date)"
+            exit 0
+          fi
+          git commit -m "chore(metrics): daily adoption snapshot $(date -u +%Y-%m-%d)"
+          branch="${GITHUB_REF_NAME}"
+          for attempt in 1 2 3; do
+            if git pull --rebase origin "$branch" && git push origin "HEAD:$branch"; then
+              exit 0
+            fi
+            echo "push attempt ${attempt} failed; retrying"
+            sleep $((attempt * 5))
+          done
+          echo "Failed to push snapshot after 3 rebase retries"
+          exit 1
diff --git a/metrics/adoption-2026-09-02.json b/metrics/adoption-2026-09-02.json
@@ -0,0 +1,62 @@
+{
+  "snapshot_at": "2026-09-02T01:29:29.972374+00:00",
+  "repo": "uniswap-python/uniswap-python",
+  "package": "uniswap-python",
+  "github": {
+    "stars": 1011,
+    "forks": 375,
+    "watchers": 23,
+    "open_issues": 66
+  },
+  "github_traffic": {
+    "note": "Skipped \u2014 set ADOPTION_GITHUB_TOKEN (PAT with Administration:read) to capture traffic (14-day window only). The default Actions GITHUB_TOKEN cannot read /traffic/*."
+  },
+  "pypi": {
+    "downloads_last_day": 19,
+    "downloads_last_week": 210,
+    "downloads_last_month": 1044,
+    "version_split_note": "Per-version counts require BigQuery (pypistats.org does not expose them). To check v4 pickup specifically, compare release-date-filtered BigQuery results."
+  },
+  "pypi_versions": [
+    {
+      "version": "0.8.0",
+      "released": "2026-08-03T09:45:06"
+    },
+    {
+      "version": "0.7.1",
+      "released": "2023-09-09T12:22:42"
+    },
+    {
+      "version": "0.7.0",
+      "released": "2023-03-30T13:21:25"
+    },
+    {
+      "version": "0.6.2",
+      "released": "2022-11-08T13:36:42"
+    },
+    {
+      "version": "0.6.1",
+      "released": "2022-10-18T12:25:29"
+    },
+    {
+      "version": "0.6.0",
+      "released": "2022-08-29T10:03:46"
+    },
+    {
+      "version": "0.5.5",
+      "released": "2022-01-03T09:02:11"
+    },
+    {
+      "version": "0.5.4",
+      "released": "2021-12-21T09:53:51"
+    },
+    {
+      "version": "0.5.3",
+      "released": "2021-10-19T10:34:58"
+    },
+    {
+      "version": "0.5.2",
+      "released": "2021-06-23T13:58:55"
+    }
+  ]
+}
diff --git a/metrics/adoption-2026-09-02.md b/metrics/adoption-2026-09-02.md
@@ -0,0 +1,36 @@
+# uniswap-python Adoption Snapshot
+
+**Snapshot date**: 2026-09-02T01:29:29.972374+00:00
+
+## GitHub
+
+| Metric | Value |
+| --- | --- |
+| Stars | 1011 |
+| Forks | 375 |
+| Watchers | 23 |
+| Open Issues | 66 |
+
+## GitHub Traffic (14-day window)
+
+_Skipped — set ADOPTION_GITHUB_TOKEN (PAT with Administration:read) to capture traffic (14-day window only). The default Actions GITHUB_TOKEN cannot read /traffic/*._
+
+## PyPI Downloads
+
+| Period | Downloads |
+| --- | --- |
+| Last day | 19 |
+| Last week | 210 |
+| Last month | 1044 |
+
+_Per-version counts require BigQuery (pypistats.org does not expose them). To check v4 pickup specifically, compare release-date-filtered BigQuery results._
+
+## Recent Releases
+
+| Version | Released |
+| --- | --- |
+| 0.8.0 | 2026-08-03 |
+| 0.7.1 | 2023-09-09 |
+| 0.7.0 | 2023-03-30 |
+| 0.6.2 | 2022-11-08 |
+| 0.6.1 | 2022-10-18 |