From 2a321d4df93c00c7130102227040622e056e11c8 Mon Sep 17 00:00:00 2001
From: mbohlool <mehdy@google.com>
Date: Thu, 26 Jan 2017 05:36:10 -0800
Subject: [PATCH] Add download stat how-to page [skip ci]

---
 devel/stats.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 devel/stats.md

diff --git a/devel/stats.md b/devel/stats.md
new file mode 100644
index 000000000..8a960e9ce
--- /dev/null
+++ b/devel/stats.md
@@ -0,0 +1,26 @@
+# Download Statistics
+
+Pypi stores download information in a [BigQuery public dataset](https://bigquery.cloud.google.com/dataset/the-psf:pypi). It can be queried to get detail infomration about downloads. For example, to get number of downloads per version, you can run this query:
+
+```sql
+SELECT
+  file.version,
+  COUNT(*) as total_downloads,
+FROM
+  TABLE_DATE_RANGE(
+    [the-psf:pypi.downloads],
+    TIMESTAMP("20161120"),
+    CURRENT_TIMESTAMP()
+  )
+where file.project == "kubernetes"
+GROUP BY
+  file.version
+ORDER BY
+  total_downloads DESC
+LIMIT 20
+```
+
+More example queries can be found [here](https://gist.github.com/alex/4f100a9592b05e9b4d63)
+
+Reference: https://mail.python.org/pipermail/distutils-sig/2016-May/028986.html
+