Впровадження в екосистемі вимірює, наскільки широко пакет фактично встановлюють, — за даними самих реєстрів пакетів: npm, PyPI, Packagist, crates.io, RubyGems, Hex та інших підтримуваних екосистем. Реальний обсяг завантажень переважає зірки GitHub як доказ впровадження: завантаження вимірюють використання, зірки — увагу.
- Категорія: Спільнота та впровадження (25% у межах категорії)
- Вага в загальному індексі: 4.5%
- Ключ метрики:
ecosystem_adoption - Застосовується до: репозиторіїв, що публікують принаймні один пакет; інакше
null
Як обчислюється значення
| Компонент | Вага | Критерії |
|---|---|---|
| Щомісячні завантаження | 80 | сума за пакетами репозиторію, логарифмічна шкала — насичення на ~1 000 000/місяць |
| Сумарні завантаження | 80 | резервний варіант, коли реєстр не публікує щомісячної цифри (наприклад, RubyGems); логарифмічна шкала, насичення на ~50 000 000 за весь час |
| Залежні пакети в реєстрі | 20 | логарифмічна шкала; звітується лише деякими екосистемами, деінде виключається |
Компонент завантажень використовує щомісячну цифру, де вона доступна, а в інших випадках — сумарну за весь час: те, що надає реєстр, тож жодна екосистема не опиняється в структурно гіршому становищі.
Правила справедливості
- Репозиторії, що не публікують пакетів, не штрафуються. Застосунки та інфраструктурні проєкти, які нічого не постачають у реєстр, отримують тут
null, а Спільнота та впровадження перенормовується на решту своїх метрик. - Пакети мають вказувати назад. Пакет із реєстру зараховується лише тоді, коли його метадані верифіковано посилаються на інспектований репозиторій; невідповідні пакети наводяться у звіті, але виключаються з обчислення.
- Логарифмічне масштабування зберігає осмисленість метрики в усьому діапазоні — пакет, що зростає з 1 000 до 10 000 щомісячних завантажень, зрушується так само, як той, що зростає зі 100 000 до 1 000 000.
Як читати результат
- У межах своєї категорії це найсильніший доступний доказ впровадження — сильніший за популярність, і саме тому пакет із великою кількістю завантажень, але скромними зірками може читатися вище за знаменитий.
- Значення цифр завантажень різниться між реєстрами (дзеркала, трафік CI); логарифмічна шкала поглинає більшість цього шуму, а точні вхідні дані відтворюються в кожному звіті для перевірки.
Як покращити значення
- Опублікувати пакет у реєстрі його екосистеми й підтримувати точне посилання на репозиторій у метаданих пакета.
- Поза цим завантаження йдуть слідом за справжнім використанням — чесний важіль полягає в корисності та виявлюваності проєкту, а не в метриці.
Дивіться також: супровід пакетів · підтримувані екосистеми