github-stars

Tõmba repo tähtede ajatemplid GitHubi API-st ja joonista terminalis kaks ASCII diagrammi: tähed päeva kaupa ja tähed tunni kaupa (viimase(te) päeva(de) jaoks). Kasulik lansseerimise, Show HN / Product Hunt hüppe või DevReli kasvu jälgimiseks.

Nõuded

Installitud ja autenditud gh CLI (gh auth status). Autentimata kutsed tabavad madalat piirmäära ja suured repod ebaõnnestuvad lehitsemise keskel.
Python 3.9+ (kasutab stdlib zoneinfo't korrektseks DST käsitlemiseks).

Kuidas see töötab

Skript kutsub gh api-d Accept-päisega application/vnd.github.star+json, mis lisab igale tähele starred_at ajatempli. See lehitseb kõik stargazer'id, teisendab ajatemplid sihtajavööndisse ning koondab need päeva ja tunni kaupa.

Kasutamine

Skript asub selle faili kõrval. Oskuse kataloogist:

bash github-stars.sh <owner/repo | search-term> [--tz <IANA tz>] [--days N] [--hours-days N]

<owner/repo> — täpne repo (nt facebook/react). Jätab otsingu vahele.
<search-term> — paljas sõna (ilma /-ita) lahendatakse tähtede järgi tippreponi.
--tz — IANA ajavöönd kõikidele korvidele. Vaikimisi America/Los_Angeles. Kasuta nt UTC, America/New_York, Asia/Shanghai, Europe/Berlin.
--days N — mitu hiljutist päeva päevadiagrammis näidata (vaikimisi 14).
--hours-days N — mitu hiljutist päeva tunniti välja tuua (vaikimisi 2).

Näited

# default: last 14 days daily + last 2 days hourly
bash github-stars.sh vercel/next.js

# resolve a search term, show UTC
bash github-stars.sh next.js --tz UTC

# zoom in: only today hourly, 7-day daily window
bash github-stars.sh facebook/react --days 7 --hours-days 1

Näidisväljund

owner/repo — 284 stars (with timestamps)
newest: 2026-06-15 02:03 PM PDT   |   now: 2026-06-15 02:11 PM PDT

STARS BY DAY (PDT)
  2026-06-13    16  █████████
  2026-06-14    69  ████████████████████████████████████████  ← peak
  2026-06-15    22  █████████████

STARS BY HOUR — 2026-06-15 (PDT)   total 22
  06:00     5  ██████████████████████████████
  07:00     2  ████████████
  14:00     2  ████████████

Piirangud — too need kasutajale esile, kui asjakohane

40 000 tähe lagi: GitHub tagastab starred_at ainult esimese 40k stargazer'i kohta. Sellest edasi on tunni-/päevajaotus puudulik (skript hoiatab). Tavaline koguarv jääb täpseks.
Neto, mitte bruto: stargazer'ite loend peegeldab praegu kehtivaid tähti. Tähe eemaldamised ei ilmu, nii et tasane koguarv kahe kontrolli vahel võib peita +1/−1 käivet. Kui live stargazers_count ei ühti ajatemplite arvuga, on juhtunud un-star.
DST käsitletakse automaatselt zoneinfo kaudu — ära kõvakoodi UTC nihkeid.

Uuesti kontrollimine / live jälgimine

Käivita skript lihtsalt uuesti — see tõmbab iga kord live'ist. Lansseerimise jälgimiseks käivita intervalliga uuesti ja teata delta; ära polli sagedamini kui ~15 minuti tagant (piirmäärad + viisakus).

GitHubi tähed