Skip to content

Latest commit

 

History

147 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Otzaria Download Tracker

לוח נתונים נגיש ונעים לשימוש עבור ההורדות של אוצריא — עם ציר גרסאות לפי תאריך הפרסום, ואיסוף יומי שמתחיל לבנות ציר הורדות אמיתי מרגע הפעלת המאגר.

המערכת עוקבת אחר:

הממשק משתמש באותה ערכת צבעים של אפליקציית אוצריא: seed חום עמוק (#2C1B02) במצב בהיר ו־seed סגול (#9C27B0) במצב כהה. ברירת המחדל באתר היא התאמה אוטומטית למערכת, וניתן לבחור ידנית בהיר, מערכת או כהה.

הלוח דו־לשוני — עברית (RTL) ואנגלית (LTR). השפה נבחרת אוטומטית לפי הגדרות הדפדפן, ניתנת לכפייה בקישור עם ?lang=he / ?lang=en, ונשמרת ב־localStorage דרך מתג השפה שבכותרת. כל המחרוזות יושבות במילון site/i18n.js.

תמונת מצב

שלוש משפחות מדידה נפרדות — מתקיני התוכנה, קובץ הספרייה המלא ועדכוני הדלתא. אלה יחידות מדידה שונות ואין לסכם אותן למספר אחד.

משפחת מדידה ערך
הורדות התוכנה (שני המאגרים יחד) 166,257
↳ מתוכן במאגר הקודם Sivan22/otzaria 50,043
↳ מתוכן במאגר הנוכחי Otzaria/otzaria 116,214
הספרייה המלאה (קובץ הספרים) 15,303
עדכוני ספרייה (דלתא) 33,333
סך כל הקבצים שנמדדו (שלוש המשפחות יחד) 214,893
הורדות חדשות שנצפו מאז תחילת המעקב 106,024

עדכון אחרון: 2026-11-21 00:40:58 UTC. לתצוגה האינטראקטיבית המלאה יש להפעיל GitHub Pages.

איך זה עובד

ה־workflow שב־.github/workflows/collect-and-publish.yml רץ מדי יום, קורא את כל עמודי ה־Releases דרך GitHub API, שומר Snapshot יומי ומפרסם את הלוח ב־GitHub Pages.

GitHub מספק לכל קובץ מונה מצטבר נוכחי בלבד. לכן אי אפשר לשחזר הורדות יומיות מהעבר. מהרגע שהאיסוף היומי מתחיל, ההפרש בין שני Snapshots עוקבים הוא מספר ההורדות החדש שנצפה באותו פרק זמן.

קבצי הנתונים

  • site/data/overview.json — תקציר קל ומהיר למדדים ולהורדה המומלצת.
  • site/data/latest.json — גרסאות, קבצים ומונים נוכחיים לתצוגה.
  • site/data/history/YYYY-MM-DD.json — Snapshot קומפקטי לכל יום.
  • site/data/timeseries.json — סדרת הזמן המחושבת עבור הגרפים.

ארכיון (לא מתפרסם באתר)

תיקיית archive/ שומרת נתונים שאי אפשר לשחזר בדיעבד, בלי להכביד על האתר:

  • archive/registry.json — מרשם קבוע של כל גרסה וקובץ שנראו אי פעם: שם, תגית, גודל, תאריכי העלאה ועדכון, first_seen ו־removed_on. כך קבצים וגרסאות שנמחקו לא מאבדים את שמם.
  • archive/daily/YYYY-MM-DD.json — מונים שאינם בהיסטוריה של האתר: בדיקות עדכון (patch-*.manifest.json, שנמשכים לפי הגרסה המותקנת אצל המשתמש, ו־version.txt של הקטלוג), וקבצי ריפוזיטוריז שהאפליקציה מורידה בזמן ריצה (קטלוג חיצוני, מילון מורפולוגי, ביוגרפיות, עדכון אופליין). בנוסף: כוכבים, פורקים ועוקבים של כל ריפוזיטורי, ו־decreases כשמונה ירד (העלאה מחדש או מחיקה).
  • archive/traffic/<owner>__<repo>.json — צפיות ושכפולים יומיים, מפנים ודפים פופולריים. GitHub שומר אותם 14 יום בלבד, ולכן הם נאספים מדי יום. נדרש סוד TRAFFIC_TOKEN עם הרשאת push לריפוזיטוריז שב־TRAFFIC_REPOSITORIES; בלעדיו השלב מדולג.

otzaria-android.json נשמר בארכיון כ־update_check: הוא אינו מוצע כמתקין, והורדותיו אינן נכללות במוני התוכנה.

קבצי build ו־CI (checksums, provenance, buildstate וכדומה) לא נשמרים בכוונה, כי מורידים אותם תהליכים אוטומטיים ולא משתמשים. המרשם ובדיקות העדכון מהימים שלפני הארכיון שוחזרו מהיסטוריית git של latest.json באמצעות python3 scripts/collect_downloads.py --backfill-archive. לנתוני תנועה, סטטיסטיקות ריפוזיטורי וריפוזיטוריז הנוספים אין מקור כזה, והם נאספים רק מעכשיו.

העמוד טוען תחילה רק את התקציר. קובץ הגרסאות המלא וספריית התרשימים נטענים באופן עצל כשהמשתמש מתקרב לאזור הסטטיסטיקות או לרשימת הגרסאות.

בטווח זמן מוגדר, דירוג הגרסאות ופילוח מערכות ההפעלה משתפים טעינה אחת לכל Snapshot יומי. לכל היותר ארבע בקשות היסטוריה פעילות במקביל, כולל קריאת גוף התשובה. לכל בקשה יש זמן מרבי של 30 שניות מרגע תחילתה; כישלון או חריגה מהזמן מאפשרים ניסיון חוזר בבחירת טווח נוספת. Snapshots שנטענו בהצלחה נשמרים בזיכרון למשך חיי העמוד. הקבצים המקוריים והחישוב לפי הפרשים יומיים חיוביים אינם משתנים.

בהחלפת טווח או תצוגה, הבקשות שעוד נחוצות לאחד הפאנלים נשמרות ומשותפות ביניהם. בקשות ממתינות שאינן נחוצות מוסרות מהתור ובקשות פעילות כאלה מבוטלות; המקום שלהן מתפנה רק לאחר סיום הניקוי. לכן מעבר מטווח ארוך לשבוע אינו ממתין לטעינת הימים הישנים, ומעבר ל״הכול״ מפסיק טעינת היסטוריה מיותרת. נתונים שכבר נטענו נשארים במטמון גם לאחר החלפת הטווח.

הפעלה ראשונה

  1. מעלים את המאגר ל־GitHub בשם otzaria-download-tracker.
  2. נכנסים אל Settings → Pages ובוחרים ב־GitHub Actions כמקור הפרסום.
  3. מריצים פעם אחת את Collect downloads and publish מתוך לשונית Actions.

אין צורך ליצור Token ידני. ה־workflow משתמש ב־GITHUB_TOKEN המוגבל של המאגר.

להרצה מקומית:

python3 scripts/collect_downloads.py
python3 -m http.server 8000 --directory site

ואז פותחים http://localhost:8000.

פיתוח ובדיקות

python3 -m unittest discover -s tests -v
node --test tests/*.cjs
node --check site/app.js
node --check site/i18n.js

קובצי המקור שהובילו לגרסה הזאת נשמרו מקומית בתיקיית reference/ לצורכי תיעוד בלבד. התיקייה מוחרגת מ־Git כדי שמטא־דאטה מקומי מתוך ייצואי ה־HTML לא יפורסם במאגר.

רישיון

MIT

Releases

Packages

Contributors

Languages