Patch broken tarfile.TarFile.next

- Add monkey patch for broken `tarfile.TarFile.next` (see
  http://bugs.python.org/issue29760).
- Various cleanup and small updates.

.coveragerc

@@ -1,12 +1,11 @@
 #-*- encoding: utf-8; mode: ini -*-
 
 #=========================================================================
-# Copyright (c) 2015 Matt Bogosian <mtb19@columbia.edu>.
-#
-# Please see the accompanying LICENSE (or LICENSE.txt) file for rights and
-# restrictions governing use of this software. All rights not expressly
-# waived or licensed are reserved. If such a file did not accompany this
-# software, then please contact the author before viewing or using this
+# Copyright and other protections apply. Please see the accompanying
+# ``LICENSE`` and ``CREDITS`` files for rights and restrictions governing
+# use of this software. All rights not expressly waived or licensed are
+# reserved. If those files are missing or appear to be modified from their
+# originals, then please contact the author before viewing or using this
 # software in any capacity.
 #=========================================================================
 
@@ -20,4 +19,3 @@ omit =
     */lib_pypy/*
     */site-packages/*
     tests/*
-    txsocketio/tls.py

.gitignore

@@ -1,36 +1,32 @@
-#-*- encoding: utf-8 -*-
+# -*- encoding: utf-8 -*-
 
-#=========================================================================
-# Copyright (c) 2015 Matt Bogosian <mtb19@columbia.edu>.
-#
-# Please see the accompanying LICENSE (or LICENSE.txt) file for rights and
-# restrictions governing use of this software. All rights not expressly
-# waived or licensed are reserved. If such a file did not accompany this
-# software, then please contact the author before viewing or using this
+# ========================================================================
+# Copyright and other protections apply. Please see the accompanying
+# ``LICENSE`` and ``CREDITS`` files for rights and restrictions governing
+# use of this software. All rights not expressly waived or licensed are
+# reserved. If those files are missing or appear to be modified from their
+# originals, then please contact the author before viewing or using this
 # software in any capacity.
-#=========================================================================
+# ========================================================================
 
 # Various build/test entities
-__pycache__
+/.cache/
+/.coverage
+/.eggs/
+/.tox/
+/build/
+/dist/
+/doc/_build/
+/doc/_static/
+/doc/modules.rst
+/doc/dimgx.rst
+/doc/dimgx.*.rst
+/htmlcov/
+__pycache__/
 _trial_temp
-.coverage
-.eggs
-.tox
-.venv
-.venv-*
-.virtualenv
 *_flymake.py
 *.egg
-*.egg-info
-build
-dist
-docs/_build
-docs/_dimgx.rst
-docs/_dimgx.*.rst
-docs/modules.rst
-docs/dimgx.rst
-docs/dimgx.*.rst
-htmlcov
+*.egg-info/
 
 # Compiled objects
 *.class
@@ -41,6 +37,7 @@ htmlcov
 *.py[co]
 *.so
 dropin.cache
+node_modules/
 
 # Packages
 *.7z
@@ -68,8 +65,8 @@ nohup.out
 .~*
 .DS_Store
 .DS_Store?
-.Spotlight-V100
-.Trashes
+.Spotlight-V100/
+.Trashes/
 desktop.ini
 ehthumbs.db
 Thumbs.db

.travis.yml

@@ -1,32 +1,38 @@
-#-*- encoding: utf-8; mode: yaml -*-
-
-#=========================================================================
-# Copyright (c) 2015 Matt Bogosian <mtb19@columbia.edu>.
-#
-# Please see the accompanying LICENSE (or LICENSE.txt) file for rights and
-# restrictions governing use of this software. All rights not expressly
-# waived or licensed are reserved. If such a file did not accompany this
-# software, then please contact the author before viewing or using this
+# -*- encoding: utf-8; mode: yaml -*-
+
+# ========================================================================
+# Copyright and other protections apply. Please see the accompanying
+# ``LICENSE`` and ``CREDITS`` files for rights and restrictions governing
+# use of this software. All rights not expressly waived or licensed are
+# reserved. If those files are missing or appear to be modified from their
+# originals, then please contact the author before viewing or using this
 # software in any capacity.
-#=========================================================================
+# ========================================================================
 
-language:
-    - python
+language: python
 
 python:
-    - 3.4
+    - "2.7"
+    - pypy
+    - "3.3"
+    - "3.4"
+    - "3.5"
+    - "3.6"
+    - pypy3
 
 install:
-    - pip install coveralls tox
+    - pip install coveralls tox-travis
+
+matrix:
+    allow_failures:
+        # 3.6 is experimental (needs pylint >= 2.0)
+        - python: "3.6"
 
-env:
-    - TOX_ENV=py27
-    - TOX_ENV=py33
-    - TOX_ENV=py34
-    - TOX_ENV=pypy
+        # PyPy3 is experimental
+        - python: pypy3
 
 script:
-    - tox -e "${TOX_ENV}"
+    - tox
 
 after_success:
     - coveralls

CREDITS

@@ -1,18 +1,19 @@
-Written by Matt Bogosian <https://github.com/posita>.
+``CREDITS``
+===========
 
-The following individuals or entities have created and contributed
-derivative works of this software. By adding your name to this list, you
-transfer all title, license, and any other rights to your contributions to
-this software to its owner. You further warrant and agree that: (1) your
-contributions are exclusively your own creations and no one else has any
-right or claim to them; (2) once accepted, your contributions become the
-exclusive property of this software' owner and you retain no rights to
-them; and (3) you indemnify and hold harmless this software's owner of
-against any colorable claim of infringement by a third party for this
-software's owner's otherwise lawful use of your contribution, whether or
-not such use was contemplated by you at the time you made the
-contribution.
+The following individuals or entities have contributed to this software.
+
+By adding your name to this list, you grant a nonexclusive, perpetual
+license to your contributions to this software under the same terms as its
+:doc:`LICENSE <LICENSE>`. Further, you warrant that your contributions to
+this software are exclusively your own creations and no one else has any
+superior right or claim to them. Finally, you agree to indemnify and hold
+harmless this software's owner against any colorable claim of infringement
+by a third party for this software's owner's otherwise lawful use of your
+contribution, whether or not such use was contemplated by you at the time
+you made it.
 
 Contributors:
 
-* __NAME__ <__REF__>
+.. Entry format:
+.. * `NAME <CONTACT_URL>`__ (see `REPO_URL <REPO_URL>`__)

LICENSE

@@ -1,6 +1,15 @@
+``LICENSE``
+===========
+
 The MIT License (MIT)
+---------------------
+
+Copyright |(c)| 2014-2017 `Matt Bogosian`_ (|@posita|_).
 
-Copyright (c) 2014-2015 Matt Bogosian <mtb19@columbia.edu>.
+.. |(c)| unicode:: u+a9
+.. _`Matt Bogosian`: mailto:matt@bogosian.net?Subject=modwalk
+.. |@posita| replace:: **@posita**
+.. _`@posita`: https://github.com/posita
 
 Permission is hereby granted, free of charge, to any person obtaining a
 copy of this software and associated documentation files (the "Software"),

MANIFEST.in

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+
+# ========================================================================
+# Copyright and other protections apply. Please see the accompanying
+# ``LICENSE`` and ``CREDITS`` files for rights and restrictions governing
+# use of this software. All rights not expressly waived or licensed are
+# reserved. If those files are missing or appear to be modified from their
+# originals, then please contact the author before viewing or using this
+# software in any capacity.
+# ========================================================================
+
+include \
+    CREDITS \
+    LICENSE \
+    doc/CREDITS.rst \
+    doc/LICENSE.rst \
+    doc/Makefile \
+    doc/cli.rst \
+    doc/conf.py \
+    doc/contrib.rst \
+    doc/index.rst \
+    doc/intro.rst \
+    doc/py.rst \
+    doc/release_checklist.md \
+    doc/requirements.txt \
+    test/requirements.txt
+
+graft test/data

README.rst

@@ -6,21 +6,15 @@
     It looks like crap in a text editor, but it has no effect on rendering, and it allows much more useful diffs.
     Thank you!
 
-Copyright |(c)| 2014-2015 `Matt Bogosian`_ (|@posita|_).
-
-.. |(c)| unicode:: u+a9
-.. _`Matt Bogosian`: mailto:mtb19@columbia.edu?Subject=dimgx
-.. |@posita| replace:: **@posita**
-.. _`@posita`: https://github.com/posita
-
-Please see the accompanying |LICENSE|_ (or |LICENSE.txt|_) file for rights and restrictions governing use of this software.
+Copyright and other protections apply.
+Please see the accompanying |LICENSE|_ and |CREDITS|_ file(s) for rights and restrictions governing use of this software.
 All rights not expressly waived or licensed are reserved.
-If such a file did not accompany this software, then please contact the author before viewing or using this software in any capacity.
+If those files are missing or appear to be modified from their originals, then please contact the author before viewing or using this software in any capacity.
 
 .. |LICENSE| replace:: ``LICENSE``
 .. _`LICENSE`: LICENSE
-.. |LICENSE.txt| replace:: ``LICENSE.txt``
-.. _`LICENSE.txt`: LICENSE
+.. |CREDITS| replace:: ``CREDITS``
+.. _`CREDITS`: CREDITS
 
 .. image:: https://travis-ci.org/posita/dimgx.svg?branch=master
     :target: https://travis-ci.org/posita/dimgx?branch=master
@@ -73,7 +67,7 @@ See `the docs <https://dimgx.readthedocs.org/en/master/>`__ for more information
 Examples
 --------
 
-::
+.. code-block:: console
 
     % dimgx -h
     usage:
@@ -85,7 +79,7 @@ Examples
 
 ..
 
-::
+.. code-block:: console
 
     % dimgx nifty-box # show layers for "nifty-box[:latest]"
     REPO TAG                IMAGE ID        PARENT ID       CREATED         LAYER SIZE      VIRTUAL SIZE
@@ -97,7 +91,7 @@ Examples
 
 ..
 
-::
+.. code-block:: console
 
     % dimgx -l df2a:82ef nifty-box # show only the second through fourth layers
     IMAGE TAG               IMAGE ID        PARENT ID       CREATED         LAYER SIZE      VIRTUAL SIZE
@@ -107,7 +101,7 @@ Examples
 
 ..
 
-::
+.. code-block:: console
 
     % dimgx -l cd5e:6667 -t nifty.tar nifty-box # extract the third through fifth layers
     % du -hs nifty.tar