waybackprov 0.0.9__tar.gz → 0.1.0__tar.gz

{waybackprov-0.0.9/waybackprov.egg-info → waybackprov-0.1.0}/PKG-INFO

@@ -1,35 +1,49 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: waybackprov
-Version: 0.0.9
+Version: 0.1.0
 Summary: Checks the provenance of a URL in the Wayback machine
-Home-page: https://github.com/edsu/waybackprov
 Author: Ed Summers
-Author-email: ehs@pobox.com
-License: UNKNOWN
-Platform: UNKNOWN
+Author-email: Ed Summers <ehs@pobox.com>
 Requires-Python: >=3.0
+Project-URL: repository, https://github.com/docnow/waybackprov
 Description-Content-Type: text/markdown
 
+# waybackprov
+
+[![Test](https://github.com/DocNow/waybackprov/actions/workflows/test.yml/badge.svg)](https://github.com/DocNow/waybackprov/actions/workflows/test.yml)
+
 Give *waybackprov* a URL and it will summarize which Internet Archive
 collections have archived the URL. This kind of information can sometimes
 provide insight about why a particular web resource or set of web resources were
 archived from the web.
 
-## Install 
+## Run
+
+If you have [uv] installed you can run `waybackprov` easily without installing anything:
+
+```
+uvx waybackprov
+```
 
-    pip install waybackprov
+Otherwise you'll probably want to install it with `pip`:
+
+```
+pip install waybackprov
+```
 
 ## Basic Usage
 
 To check a particular URL here's how it works:
 
-    % waybackprov https://twitter.com/EPAScottPruitt
-    364 https://archive.org/details/focused_crawls
-    306 https://archive.org/details/edgi_monitor
-    151 https://archive.org/details/www3.epa.gov
-     60 https://archive.org/details/epa.gov4
-     47 https://archive.org/details/epa.gov5
-    ...
+```shell
+waybackprov https://twitter.com/EPAScottPruitt
+364 https://archive.org/details/focused_crawls
+306 https://archive.org/details/edgi_monitor
+151 https://archive.org/details/www3.epa.gov
+ 60 https://archive.org/details/epa.gov4
+ 47 https://archive.org/details/epa.gov5
+  ...
+```
 
 The first column contains the number of crawls for a particular URL, and the
 second column contains the URL for the Internet Archive collection that added
@@ -40,14 +54,18 @@ it.
 By default waybackprov will only look at the current year. If you would like it
 to examine a range of years use the `--start` and `--end` options:
 
-    % waybackprov --start 2016 --end 2018 https://twitter.com/EPAScottPruitt
+```shell
+waybackprov --start 2016 --end 2018 https://twitter.com/EPAScottPruitt
+```
 
 ## Multiple Pages
 
 If you would like to look at all URLs at a particular URL prefix you can use the
 `--prefix` option:
 
-    % waybackprov --prefix https://twitter.com/EPAScottPruitt
+```shell
+waybackprov --prefix https://twitter.com/EPAScottPruitt
+```
 
 This will use the Internet Archive's [CDX API](https://github.com/webrecorder/pywb/wiki/CDX-Server-API) to also include URLs that are extensions of the URL you supply, so it would include for example:
 
@@ -63,7 +81,9 @@ interested in is highly recommended since it prevents lots of lookups for CSS,
 JavaScript and image files that are components of the resource that was
 initially crawled.
 
-    % waybackprov --prefix --match 'status/\d+$' https://twitter.com/EPAScottPruitt
+```
+waybackprov --prefix --match 'status/\d+$' https://twitter.com/EPAScottPruitt
+```
 
 ## Collections
 
@@ -88,14 +108,15 @@ rather than a summary.
 If you would like to see detailed information about what *waybackprov* is doing
 use the `--log` option to supply the a file path to log to:
 
-    % waybackprov --log waybackprov.log https://example.com/
+```shell
+waybackprov --log waybackprov.log https://example.com/
+```
 
 ## Test
 
 If you would like to test it first install [pytest] and then:
 
-    pytest test.py
+    uv run pytest test.py
 
 [pytest]: https://docs.pytest.org/en/latest/
-
-
+[uv]: https://docs.astral.sh/uv/

waybackprov-0.0.9/PKG-INFO → waybackprov-0.1.0/README.md

@@ -1,35 +1,39 @@
-Metadata-Version: 2.1
-Name: waybackprov
-Version: 0.0.9
-Summary: Checks the provenance of a URL in the Wayback machine
-Home-page: https://github.com/edsu/waybackprov
-Author: Ed Summers
-Author-email: ehs@pobox.com
-License: UNKNOWN
-Platform: UNKNOWN
-Requires-Python: >=3.0
-Description-Content-Type: text/markdown
+# waybackprov
+
+[![Test](https://github.com/DocNow/waybackprov/actions/workflows/test.yml/badge.svg)](https://github.com/DocNow/waybackprov/actions/workflows/test.yml)
 
 Give *waybackprov* a URL and it will summarize which Internet Archive
 collections have archived the URL. This kind of information can sometimes
 provide insight about why a particular web resource or set of web resources were
 archived from the web.
 
-## Install 
+## Run
+
+If you have [uv] installed you can run `waybackprov` easily without installing anything:
+
+```
+uvx waybackprov
+```
 
-    pip install waybackprov
+Otherwise you'll probably want to install it with `pip`:
+
+```
+pip install waybackprov
+```
 
 ## Basic Usage
 
 To check a particular URL here's how it works:
 
-    % waybackprov https://twitter.com/EPAScottPruitt
-    364 https://archive.org/details/focused_crawls
-    306 https://archive.org/details/edgi_monitor
-    151 https://archive.org/details/www3.epa.gov
-     60 https://archive.org/details/epa.gov4
-     47 https://archive.org/details/epa.gov5
-    ...
+```shell
+waybackprov https://twitter.com/EPAScottPruitt
+364 https://archive.org/details/focused_crawls
+306 https://archive.org/details/edgi_monitor
+151 https://archive.org/details/www3.epa.gov
+ 60 https://archive.org/details/epa.gov4
+ 47 https://archive.org/details/epa.gov5
+  ...
+```
 
 The first column contains the number of crawls for a particular URL, and the
 second column contains the URL for the Internet Archive collection that added
@@ -40,14 +44,18 @@ it.
 By default waybackprov will only look at the current year. If you would like it
 to examine a range of years use the `--start` and `--end` options:
 
-    % waybackprov --start 2016 --end 2018 https://twitter.com/EPAScottPruitt
+```shell
+waybackprov --start 2016 --end 2018 https://twitter.com/EPAScottPruitt
+```
 
 ## Multiple Pages
 
 If you would like to look at all URLs at a particular URL prefix you can use the
 `--prefix` option:
 
-    % waybackprov --prefix https://twitter.com/EPAScottPruitt
+```shell
+waybackprov --prefix https://twitter.com/EPAScottPruitt
+```
 
 This will use the Internet Archive's [CDX API](https://github.com/webrecorder/pywb/wiki/CDX-Server-API) to also include URLs that are extensions of the URL you supply, so it would include for example:
 
@@ -63,7 +71,9 @@ interested in is highly recommended since it prevents lots of lookups for CSS,
 JavaScript and image files that are components of the resource that was
 initially crawled.
 
-    % waybackprov --prefix --match 'status/\d+$' https://twitter.com/EPAScottPruitt
+```
+waybackprov --prefix --match 'status/\d+$' https://twitter.com/EPAScottPruitt
+```
 
 ## Collections
 
@@ -88,14 +98,15 @@ rather than a summary.
 If you would like to see detailed information about what *waybackprov* is doing
 use the `--log` option to supply the a file path to log to:
 
-    % waybackprov --log waybackprov.log https://example.com/
+```shell
+waybackprov --log waybackprov.log https://example.com/
+```
 
 ## Test
 
 If you would like to test it first install [pytest] and then:
 
-    pytest test.py
+    uv run pytest test.py
 
 [pytest]: https://docs.pytest.org/en/latest/
-
-
+[uv]: https://docs.astral.sh/uv/

waybackprov-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[project]
+name = "waybackprov"
+version = "0.1.0"
+description = "Checks the provenance of a URL in the Wayback machine"
+readme = "README.md"
+authors = [
+    { name = "Ed Summers", email = "ehs@pobox.com" }
+]
+requires-python = ">=3.0"
+dependencies = []
+
+[project.urls]
+repository = "https://github.com/docnow/waybackprov"
+
+[project.scripts]
+waybackprov = "waybackprov:main"
+
+[build-system]
+requires = ["uv_build>=0.9.8,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=4.6.11",
+]
+
+[tool.pytest.ini_options]
+addopts = "-v -s"
+log_file = "test.log"
+log_file_level = "DEBUG"

waybackprov-0.1.0/src/waybackprov/__init__.py

@@ -0,0 +1,269 @@
+#!/usr/bin/env python3
+
+import re
+import csv
+import sys
+import json
+import time
+import codecs
+import logging
+import operator
+import datetime
+import optparse
+import collections
+
+from functools import reduce
+from urllib.parse import quote
+from urllib.request import urlopen
+
+colls = {}
+
+
+def main():
+    now = datetime.datetime.now()
+
+    parser = optparse.OptionParser("waybackprov [options] <url>")
+    parser.add_option("--start", default=now.year - 1, help="start year")
+    parser.add_option("--end", default=now.year, help="end year")
+    parser.add_option(
+        "--format", choices=["text", "csv", "json"], default="text", help="output data"
+    )
+    parser.add_option(
+        "--collapse", action="store_true", help="only display most specific collection"
+    )
+    parser.add_option("--prefix", action="store_true", help="use url as a prefix")
+    parser.add_option("--match", help="limit to urls that match pattern")
+    parser.add_option("--log", help="where to log activity to")
+    opts, args = parser.parse_args()
+
+    if opts.log:
+        logging.basicConfig(
+            filename=opts.log,
+            format="%(asctime)s - %(levelname)s - %(message)s",
+            level=logging.INFO,
+        )
+    else:
+        logging.basicConfig(
+            format="%(asctime)s - %(levelname)s - %(message)s", level=logging.WARNING
+        )
+    if len(args) != 1:
+        parser.error("You must supply a URL to lookup")
+
+    url = args[0]
+
+    crawl_data = get_crawls(
+        url,
+        start_year=opts.start,
+        end_year=opts.end,
+        collapse=opts.collapse,
+        prefix=opts.prefix,
+        match=opts.match,
+    )
+
+    if opts.format == "text":
+        crawls = 0
+        coll_urls = {}
+        coll_counter = collections.Counter()
+        for crawl in crawl_data:
+            crawls += 1
+            coll_counter.update(crawl["collections"])
+            for coll in crawl["collections"]:
+                # keep track of urls in each collection
+                if coll not in coll_urls:
+                    coll_urls[coll] = set()
+                coll_urls[coll].add(crawl["url"])
+
+        if len(coll_counter) == 0:
+            print(
+                "No results for %s-%s, consider using --start and --end to broaden."
+                % (opts.start, opts.end)
+            )
+            return
+
+        max_pos = str(len(str(coll_counter.most_common(1)[0][1])))
+        if opts.prefix:
+            str_format = (
+                "%" + max_pos + "i %" + max_pos + "i https://archive.org/details/%s"
+            )
+        else:
+            str_format = "%" + max_pos + "i https://archive.org/details/%s"
+
+        for coll_id, count in coll_counter.most_common():
+            if opts.prefix:
+                print(str_format % (count, len(coll_urls[coll_id]), coll_id))
+            else:
+                print(str_format % (count, coll_id))
+
+        print("")
+        print("total crawls %s-%s: %s" % (opts.start, opts.end, crawls))
+        if opts.prefix:
+            total_urls = len(reduce(operator.or_, coll_urls.values()))
+            print("total urls: %s" % total_urls)
+
+    elif opts.format == "json":
+        data = list(crawl_data)
+        print(json.dumps(data, indent=2))
+
+    elif opts.format == "csv":
+        w = csv.DictWriter(
+            sys.stdout,
+            fieldnames=["timestamp", "status", "collections", "url", "wayback_url"],
+        )
+        for crawl in crawl_data:
+            crawl["collections"] = ",".join(crawl["collections"])
+            w.writerow(crawl)
+
+
+def get_crawls(
+    url, start_year=None, end_year=None, collapse=False, prefix=False, match=None
+):
+    if prefix is True:
+        for year, sub_url in cdx(
+            url, match=match, start_year=start_year, end_year=end_year
+        ):
+            yield from get_crawls(sub_url, start_year=year, end_year=year)
+
+    if start_year is None:
+        start_year = datetime.datetime.now().year - 1
+    else:
+        start_year = int(start_year)
+    if end_year is None:
+        end_year = datetime.datetime.now().year
+    else:
+        end_year = int(end_year)
+
+    api = "https://web.archive.org/__wb/calendarcaptures?url=%s&selected_year=%s"
+    for year in range(start_year, end_year + 1):
+        # This calendar data structure reflects the layout of a calendar
+        # month. So some spots in the first and last row are null. Not
+        # every day has any data if the URL wasn't crawled then.
+        logging.info("getting calendar year %s for %s", year, url)
+        cal = get_json(api % (url, year))
+        for month in cal:
+            for week in month:
+                for day in week:
+                    if day is None or day == {}:
+                        continue
+                    # note: we can't seem to rely on 'cnt' as a count
+                    for i in range(0, len(day["st"])):
+                        c = {
+                            "status": day["st"][i],
+                            "timestamp": day["ts"][i],
+                            "collections": day["why"][i],
+                            "url": url,
+                        }
+                        c["wayback_url"] = "https://web.archive.org/web/%s/%s" % (
+                            c["timestamp"],
+                            url,
+                        )
+                        if c["collections"] is None:
+                            continue
+                        if collapse and len(c["collections"]) > 0:
+                            c["collections"] = [deepest_collection(c["collections"])]
+                        logging.info("found crawl %s", c)
+                        yield c
+
+
+def deepest_collection(coll_ids):
+    return max(coll_ids, key=get_depth)
+
+
+def get_collection(coll_id):
+    # no need to fetch twice
+    if coll_id in colls:
+        return colls[coll_id]
+
+    logging.info("fetching collection %s", coll_id)
+
+    # get the collection metadata
+    url = "https://archive.org/metadata/%s" % coll_id
+    data = get_json(url)["metadata"]
+
+    # make collection into reliable array
+    if "collection" in data:
+        if type(data["collection"]) is str:
+            data["collection"] = [data["collection"]]
+    else:
+        data["collection"] = []
+
+    # so we don't have to look it up again
+    colls[coll_id] = data
+
+    return data
+
+
+def get_depth(coll_id, seen_colls=None):
+    coll = get_collection(coll_id)
+    if "depth" in coll:
+        return coll["depth"]
+
+    logging.info("calculating depth of %s", coll_id)
+
+    if len(coll["collection"]) == 0:
+        return 0
+
+    # prevent recursive loops
+    if seen_colls is None:
+        seen_colls = set()
+    if coll_id in seen_colls:
+        return 0
+    seen_colls.add(coll_id)
+
+    depth = max(map(lambda id: get_depth(id, seen_colls) + 1, coll["collection"]))
+
+    coll["depth"] = depth
+    logging.info("depth %s = %s", coll_id, depth)
+    return depth
+
+
+def get_json(url):
+    count = 0
+    while True:
+        count += 1
+        if count >= 10:
+            logging.error("giving up on fetching JSON from %s", url)
+        try:
+            resp = urlopen(url)
+            reader = codecs.getreader("utf-8")
+            return json.load(reader(resp))
+        except Exception as e:
+            logging.error("caught exception: %s", e)
+        logging.info("sleeping for %s seconds", count * 10)
+        time.sleep(count * 10)
+    raise (Exception("unable to get JSON for %s", url))
+
+
+def cdx(url, match=None, start_year=None, end_year=None):
+    logging.info("searching cdx for %s with regex %s", url, match)
+
+    if match:
+        try:
+            pattern = re.compile(match)
+        except Exception as e:
+            sys.exit("invalid regular expression: {}".format(e))
+    else:
+        pattern = None
+
+    cdx_url = "http://web.archive.org/cdx/search/cdx?url={}&matchType=prefix&from={}&to={}".format(
+        quote(url), start_year, end_year
+    )
+    seen = set()
+    results = codecs.decode(urlopen(cdx_url).read(), encoding="utf8")
+
+    for line in results.split("\n"):
+        parts = line.split(" ")
+        if len(parts) == 7:
+            year = int(parts[1][0:4])
+            url = parts[2]
+            seen_key = "{}:{}".format(year, url)
+            if seen_key in seen:
+                continue
+            if pattern and not pattern.search(url):
+                continue
+            seen.add(seen_key)
+            logging.info("cdx found %s", url)
+            yield (year, url)
+
+
+if __name__ == "__main__":
+    main()

waybackprov-0.0.9/README.md

@@ -1,87 +0,0 @@
-Give *waybackprov* a URL and it will summarize which Internet Archive
-collections have archived the URL. This kind of information can sometimes
-provide insight about why a particular web resource or set of web resources were
-archived from the web.
-
-## Install 
-
-    pip install waybackprov
-
-## Basic Usage
-
-To check a particular URL here's how it works:
-
-    % waybackprov https://twitter.com/EPAScottPruitt
-    364 https://archive.org/details/focused_crawls
-    306 https://archive.org/details/edgi_monitor
-    151 https://archive.org/details/www3.epa.gov
-     60 https://archive.org/details/epa.gov4
-     47 https://archive.org/details/epa.gov5
-    ...
-
-The first column contains the number of crawls for a particular URL, and the
-second column contains the URL for the Internet Archive collection that added
-it.
-
-## Time
-
-By default waybackprov will only look at the current year. If you would like it
-to examine a range of years use the `--start` and `--end` options:
-
-    % waybackprov --start 2016 --end 2018 https://twitter.com/EPAScottPruitt
-
-## Multiple Pages
-
-If you would like to look at all URLs at a particular URL prefix you can use the
-`--prefix` option:
-
-    % waybackprov --prefix https://twitter.com/EPAScottPruitt
-
-This will use the Internet Archive's [CDX API](https://github.com/webrecorder/pywb/wiki/CDX-Server-API) to also include URLs that are extensions of the URL you supply, so it would include for example:
-
-    https://twitter.com/EPAScottPruitt/status/1309839080398339
-
-But it can also include things you may not want, such as:
-
-    https://twitter.com/EPAScottPruitt/status/1309839080398339/media/1
-
-To further limit the URLs use the `--match` parameter to specify a regular
-expression only check particular URLs. Further specifying the URLs you are
-interested in is highly recommended since it prevents lots of lookups for CSS,
-JavaScript and image files that are components of the resource that was
-initially crawled.
-
-    % waybackprov --prefix --match 'status/\d+$' https://twitter.com/EPAScottPruitt
-
-## Collections
-
-One thing to remember when interpreting this data is that collections can
-contain other collections. For example the *edgi_monitor* collection is a
-sub-collection of *focused_crawls*.
-
-If you use the `--collapse` option only the most specific collection will be
-reported for a given crawl.  So if *coll1* is part of *coll2* which is part of
-*coll3*, only *coll1* will be reported instead of *coll1*, *coll2* and *coll3*.
-This does involve collection metadata lookups at the Internet Archive API, so it
-does slow performance significantly.
-
-## JSON and CSV
-
-If you would rather see the raw data as JSON or CSV use the `--format` option.
-When you use either of these formats you will see the metadata for each crawl,
-rather than a summary.
-
-## Log
-
-If you would like to see detailed information about what *waybackprov* is doing
-use the `--log` option to supply the a file path to log to:
-
-    % waybackprov --log waybackprov.log https://example.com/
-
-## Test
-
-If you would like to test it first install [pytest] and then:
-
-    pytest test.py
-
-[pytest]: https://docs.pytest.org/en/latest/

waybackprov-0.0.9/setup.cfg

@@ -1,4 +0,0 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-

waybackprov-0.0.9/setup.py

@@ -1,19 +0,0 @@
-from setuptools import setup
-
-with open("README.md") as f:
-    long_description = f.read()
-
-if __name__ == "__main__":
-    setup(
-        name='waybackprov',
-        version='0.0.9',
-        url='https://github.com/edsu/waybackprov',
-        author='Ed Summers',
-        author_email='ehs@pobox.com',
-        py_modules=['waybackprov', ],
-        description='Checks the provenance of a URL in the Wayback machine',
-        long_description=long_description,
-        long_description_content_type="text/markdown",
-        python_requires='>=3.0',
-        entry_points={'console_scripts': ['waybackprov = waybackprov:main']}
-    )

waybackprov-0.0.9/waybackprov.egg-info/SOURCES.txt

@@ -1,8 +0,0 @@
-README.md
-setup.py
-waybackprov.py
-waybackprov.egg-info/PKG-INFO
-waybackprov.egg-info/SOURCES.txt
-waybackprov.egg-info/dependency_links.txt
-waybackprov.egg-info/entry_points.txt
-waybackprov.egg-info/top_level.txt

waybackprov-0.0.9/waybackprov.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

waybackprov-0.0.9/waybackprov.egg-info/entry_points.txt

@@ -1,3 +0,0 @@
-[console_scripts]
-waybackprov = waybackprov:main
-

waybackprov-0.0.9/waybackprov.egg-info/top_level.txt

@@ -1 +0,0 @@
-waybackprov

waybackprov-0.0.9/waybackprov.py

@@ -1,249 +0,0 @@
-#!/usr/bin/env python3
-
-import re
-import csv
-import sys
-import json
-import time
-import codecs
-import logging
-import operator
-import datetime
-import optparse
-import collections
-
-from functools import reduce
-from urllib.parse import quote
-from urllib.request import urlopen
-
-colls = {}
-
-def main():
-    now = datetime.datetime.now()
-
-    parser = optparse.OptionParser('waybackprov.py [options] <url>')
-    parser.add_option('--start', default=now.year -1, help='start year')
-    parser.add_option('--end', default=now.year, help='end year')
-    parser.add_option('--format', choices=['text', 'csv', 'json'], 
-                      default='text', help='output data')
-    parser.add_option('--collapse', action='store_true', 
-                      help='only display most specific collection')
-    parser.add_option('--prefix', action='store_true',
-                      help='use url as a prefix')
-    parser.add_option('--match', help='limit to urls that match pattern')
-    parser.add_option('--log', help='where to log activity to')
-    opts, args = parser.parse_args()
-
-    if opts.log:
-        logging.basicConfig(
-            filename=opts.log,
-            format='%(asctime)s - %(levelname)s - %(message)s',
-            level=logging.INFO
-        )
-    else:
-        logging.basicConfig(
-            format='%(asctime)s - %(levelname)s - %(message)s',
-            level=logging.WARNING
-        )
-    if len(args) != 1:
-        parser.error('You must supply a URL to lookup')
-
-    url = args[0]
-
-    crawl_data = get_crawls(url, 
-        start_year=opts.start,
-        end_year=opts.end, 
-        collapse=opts.collapse, 
-        prefix=opts.prefix,
-        match=opts.match
-    )
-
-    if opts.format == 'text':
-        crawls = 0
-        coll_urls = {}
-        coll_counter = collections.Counter()
-        for crawl in crawl_data:
-            crawls += 1
-            coll_counter.update(crawl['collections'])
-            for coll in crawl['collections']:
-                # keep track of urls in each collection
-                if coll not in coll_urls:
-                    coll_urls[coll] = set()
-                coll_urls[coll].add(crawl['url'])
-
-        if len(coll_counter) == 0:
-            print('No results for %s-%s, consider using --start and --end to broaden.' % (opts.start, opts.end))
-            return
-
-        max_pos = str(len(str(coll_counter.most_common(1)[0][1])))
-        if opts.prefix:
-            str_format = '%' + max_pos + 'i %' + max_pos + 'i https://archive.org/details/%s'
-        else:
-            str_format = '%' + max_pos + 'i https://archive.org/details/%s'
-
-        for coll_id, count in coll_counter.most_common():
-            if opts.prefix:
-                print(str_format % (count, len(coll_urls[coll_id]), coll_id))
-            else:
-                print(str_format % (count, coll_id))
-
-        print('')
-        print('total crawls %s-%s: %s' % (opts.start, opts.end, crawls))
-        if (opts.prefix):
-            total_urls = len(reduce(operator.or_, coll_urls.values()))
-            print('total urls: %s' % total_urls)
-
-    elif opts.format == 'json':
-        data = list(crawl_data)
-        print(json.dumps(data, indent=2))
-
-    elif opts.format == 'csv':
-        w = csv.DictWriter(sys.stdout, 
-            fieldnames=['timestamp', 'status', 'collections', 'url', 'wayback_url'])
-        for crawl in crawl_data:
-            crawl['collections'] = ','.join(crawl['collections'])
-            w.writerow(crawl)
-
-def get_crawls(url, start_year=None, end_year=None, collapse=False, 
-               prefix=False, match=None):
-
-    if prefix == True:
-        for year, sub_url in cdx(url, match=match, start_year=start_year,
-                                 end_year=end_year):
-            yield from get_crawls(sub_url, start_year=year, end_year=year)
-        
-    if start_year is None:
-        start_year = datetime.datetime.now().year - 1
-    else:
-        start_year = int(start_year)
-    if end_year is None:
-        end_year = datetime.datetime.now().year
-    else:
-        end_year = int(end_year)
-
-    api = 'https://web.archive.org/__wb/calendarcaptures?url=%s&selected_year=%s'
-    for year in range(start_year, end_year + 1):
-        # This calendar data structure reflects the layout of a calendar
-        # month. So some spots in the first and last row are null. Not
-        # every day has any data if the URL wasn't crawled then.
-        logging.info("getting calendar year %s for %s", year, url)
-        cal = get_json(api % (url, year))
-        found = False
-        for month in cal:
-            for week in month:
-                for day in week:
-                    if day is None or day == {}:
-                        continue
-                    # note: we can't seem to rely on 'cnt' as a count
-                    for i in range(0, len(day['st'])):
-                        c = {
-                            'status': day['st'][i],
-                            'timestamp': day['ts'][i],
-                            'collections': day['why'][i],
-                            'url': url
-                        }
-                        c['wayback_url'] = 'https://web.archive.org/web/%s/%s' % (c['timestamp'], url)
-                        if c['collections'] is None:
-                            continue
-                        if collapse and len(c['collections']) > 0:
-                            c['collections'] = [deepest_collection(c['collections'])]
-                        logging.info('found crawl %s', c)
-                        found = True
-                        yield c
-
-def deepest_collection(coll_ids):
-    return max(coll_ids, key=get_depth)
-
-def get_collection(coll_id):
-    # no need to fetch twice
-    if coll_id in colls:
-        return colls[coll_id]
-
-    logging.info('fetching collection %s', coll_id)
-
-    # get the collection metadata
-    url = 'https://archive.org/metadata/%s' % coll_id
-    data = get_json(url)['metadata']
-
-    # make collection into reliable array
-    if 'collection' in data:
-        if type(data['collection']) == str:
-            data['collection'] = [data['collection']]
-    else:
-        data['collection'] = []
-
-    # so we don't have to look it up again
-    colls[coll_id] = data
-
-    return data
-
-def get_depth(coll_id, seen_colls=None):
-    coll = get_collection(coll_id)
-    if 'depth' in coll:
-        return coll['depth']
-
-    logging.info('calculating depth of %s', coll_id)
-
-    if len(coll['collection']) == 0:
-        return 0
-
-    # prevent recursive loops
-    if seen_colls == None:
-        seen_colls = set()
-    if coll_id in seen_colls:
-        return 0
-    seen_colls.add(coll_id)
-
-    depth = max(map(lambda id: get_depth(id, seen_colls) + 1, coll['collection']))
-
-    coll['depth'] = depth
-    logging.info('depth %s = %s', coll_id, depth)
-    return depth
-
-def get_json(url):
-    count = 0
-    while True:
-        count += 1
-        if count >= 10:
-            logging.error("giving up on fetching JSON from %s", url)
-        try:
-            resp = urlopen(url)
-            reader = codecs.getreader('utf-8')
-            return json.load(reader(resp))
-        except Exception as e:
-            logging.error('caught exception: %s', e)
-        logging.info('sleeping for %s seconds', count * 10)
-        time.sleep(count * 10)
-    raise(Exception("unable to get JSON for %s", url))
-
-def cdx(url, match=None, start_year=None, end_year=None):
-    logging.info('searching cdx for %s with regex %s', url, match)
-
-    if match:
-        try:
-            pattern = re.compile(match)
-        except Exception as e:
-            sys.exit('invalid regular expression: {}'.format(e))
-    else:
-        pattern = None
-
-    cdx_url = 'http://web.archive.org/cdx/search/cdx?url={}&matchType=prefix&from={}&to={}'.format(quote(url), start_year, end_year)
-    seen = set()
-    results = codecs.decode(urlopen(cdx_url).read(), encoding='utf8')
-
-    for line in results.split('\n'):
-        parts = line.split(' ')
-        if len(parts) == 7:
-            year = int(parts[1][0:4])
-            url = parts[2]
-            seen_key = '{}:{}'.format(year, url)
-            if seen_key in seen:
-                continue
-            if pattern and not pattern.search(url):
-                continue 
-            seen.add(seen_key)
-            logging.info('cdx found %s', url)
-            yield(year, url)
-
-if __name__ == "__main__":
-    main()