chaoss / augur

Python library and web service for Open Source Software Health and Sustainability metrics & data collection. You can find our documentation and new contributor information easily here: https://oss-augur.readthedocs.io/en/main/ and learn more about Augur at our website https://augurlabs.io
https://oss-augur.readthedocs.io/en/main/
MIT License
589 stars 845 forks source link

Questions about /:owner/:repo/timeseries/downloads #149

Closed OrkoHunter closed 6 years ago

OrkoHunter commented 6 years ago

Hi! I have a couple question about the API /:owner/:repo/timeseries/downloads

  1. It returns null for some repositories, example - http://twitter.augurlabs.io/api/unstable/twitter/finagle/timeseries/downloads (Scala) http://twitter.augurlabs.io/api/unstable/twitter/finatra/timeseries/downloads (Scala) http://twitter.augurlabs.io/api/unstable/pantsbuild/pants/timeseries/downloads (Python) http://twitter.augurlabs.io/api/unstable/twitter/rpc-perf/timeseries/downloads (Rust) http://twitter.augurlabs.io/api/unstable/twitter/serial/timeseries/downloads (Java)

But gives good results for http://twitter.augurlabs.io/api/unstable/twitter/twemoji/timeseries/downloads (Javascript)

How is this metric calculated? Does this have something to do with the language of the repository?

  1. In the result of http://twitter.augurlabs.io/api/unstable/twitter/twemoji/timeseries/downloads
...
{"date":"2018-05-30","downloads":0},{"date":"2018-05-31","downloads":0},
{"date":"2018-06-01","downloads":0},{"date":"2018-06-02","downloads":429},
{"date":"2018-06-03","downloads":493},{"date":"2018-06-04","downloads":1443},
{"date":"2018-06-05","downloads":1868},{"date":"2018-06-06","downloads":2071},
{"date":"2018-06-07","downloads":3617},{"date":"2018-06-08","downloads":2219},
{"date":"2018-06-09","downloads":824},{"date":"2018-06-10","downloads":676},
{"date":"2018-06-11","downloads":2630},{"date":"2018-06-12","downloads":2938},
{"date":"2018-06-13","downloads":2742},{"date":"2018-06-14","downloads":2840},
{"date":"2018-06-15","downloads":1855},{"date":"2018-06-16","downloads":592},
{"date":"2018-06-17","downloads":718},{"date":"2018-06-18","downloads":2131},
{"date":"2018-06-19","downloads":2252},{"date":"2018-06-20","downloads":2419},
{"date":"2018-06-21","downloads":2143},{"date":"2018-06-22","downloads":1934},
{"date":"2018-06-23","downloads":574},{"date":"2018-06-24","downloads":651},
{"date":"2018-06-25","downloads":2066},{"date":"2018-06-26","downloads":2396},
{"date":"2018-06-27","downloads":1941},{"date":"2018-06-28","downloads":2091},
{"date":"2018-06-29","downloads":1720},{"date":"2018-06-30","downloads":638},
{"date":"2018-07-01","downloads":608},{"date":"2018-07-02","downloads":1769},
{"date":"2018-07-03","downloads":1840},{"date":"2018-07-04","downloads":1424},
{"date":"2018-07-05","downloads":1871},{"date":"2018-07-06","downloads":1487},
{"date":"2018-07-07","downloads":519},{"date":"2018-07-08","downloads":700},
{"date":"2018-07-09","downloads":2040},{"date":"2018-07-10","downloads":2032},
{"date":"2018-07-11","downloads":2134},{"date":"2018-07-12","downloads":2004},
{"date":"2018-07-13","downloads":1745},{"date":"2018-07-14","downloads":545},
{"date":"2018-07-15","downloads":640},{"date":"2018-07-16","downloads":2249},
{"date":"2018-07-17","downloads":2121},{"date":"2018-07-18","downloads":1950},
{"date":"2018-07-19","downloads":1934},{"date":"2018-07-20","downloads":1716},
{"date":"2018-07-21","downloads":586},{"date":"2018-07-22","downloads":562},
{"date":"2018-07-23","downloads":1714},{"date":"2018-07-24","downloads":1966},
{"date":"2018-07-25","downloads":2142},{"date":"2018-07-26","downloads":2060},
{"date":"2018-07-27","downloads":1752},{"date":"2018-07-28","downloads":630},
{"date":"2018-07-29","downloads":583},{"date":"2018-07-30","downloads":1862},
{"date":"2018-07-31","downloads":1942},{"date":"2018-08-01","downloads":1902},
{"date":"2018-08-02","downloads":1786},{"date":"2018-08-03","downloads":1763},
{"date":"2018-08-04","downloads":981},{"date":"2018-08-05","downloads":743},
{"date":"2018-08-06","downloads":0},{"date":"2018-08-07","downloads":2208},
{"date":"2018-08-08","downloads":3051},{"date":"2018-08-09","downloads":2566},
{"date":"2018-08-10","downloads":2602},{"date":"2018-08-11","downloads":994},
{"date":"2018-08-12","downloads":856},{"date":"2018-08-13","downloads":2479},
{"date":"2018-08-14","downloads":0}]

sometimes the number suddenly drops to 0 or 1. My question is, can this number be trusted or should it be ignored as a bug?

howderek commented 6 years ago

Yes it has to do with the language of the repository because it depends on the package managers providing those metrics. Right now, we are getting metrics for Ruby Gems and NPM packages.

OrkoHunter commented 6 years ago

Hi @howderek! That makes a lot of sense. Even GitHub has not implemented this feature for other languages.

Thanks for answering!