[WIP] start of early work to add opencontainers distribution (#9)

* start of early work to add opencontainers distribution

there is not much code in the core of the upstream (implemented
in golang) so I need to look closer to figure out how to
best implement this. I think ideally we would want some kind of
class to generate the correct data structure, although I am
not sure this will fit nicely into something like Django where
we would need to use database models and serialization instead.

Signed-off-by: vsoch <vsochat@stanford.edu>

* running linter

Signed-off-by: vsoch <vsochat@stanford.edu>

* rough work on reggie, not tested or finished

Signed-off-by: vsoch <vsochat@stanford.edu>

* adding wrapper to requests.Response

Signed-off-by: vsoch <vsochat@stanford.edu>

* finish up tests and will need to finish up docs

Signed-off-by: vsoch <vsochat@stanford.edu>

* tweaks to getting started docs and client

Signed-off-by: vsoch <vsochat@stanford.edu>

Author: vsoch

.gitignore

@@ -0,0 +1,3 @@
+__pycache__
+*.egg-info*
+.eggs

CHANGELOG.md

@@ -16,5 +16,6 @@ Critical items to know are:
 Versions here coincide with releases on pypi.
 
 ## [master](https://github.com/vsoch/oci-python)
+ - adding distribution spec (0.0.11)
  - adding image-spec and digests (0.0.1)
  - skeleton of package while core under development (0.0.0)

MANIFEST.in

@@ -1,5 +1,6 @@
 include README.md LICENSE
 recursive-include opencontainers *
+graft opencontainers
 prune .env
 prune doc*
 prune .doc*

README.md

@@ -9,5 +9,6 @@ This include:
 
  - [opencontainers/image-spec](https://github.com/opencontainers/image-spec/tree/master/specs-go) maps to [opencontainers/image](opencontainers/image)
  - [opencontainers/go-digest](https://github.com/opencontainers/go-digest) maps to [opencontainers/digest](opencontainers/digest)
+ - [opencontainers/distribution-spec](https://github.com/opencontainers/distribution-spec) maps to [opencontainers/distribution](opencontainers/distribution), which also includes a Python version of the [Reggie client](https://github.com/bloodorangeio/reggie) to interact with an OCI registry.
 
 See the documentation at [vsoch.github.io/oci-python](https://vsoch.github.io/oci-python).

docs/_data/toc.yml

@@ -6,10 +6,22 @@
       children:
         - title: Install
           url: "docs/getting-started#getting-started"
-        - title: Image Specification
-          url: "docs/getting-started#image-specification"
+    - title: "Distribution Specification"
+      url: "docs/getting-started#distribution-specification"
+      children:
+        - title: Reggie Client
+          url: "docs/getting-started#reggie"
+    - title: "Image Specification"
+      url: "docs/getting-started#image-specification"
+      children:
+        - title: Manifests
+          url: "docs/getting-started#image-manifest"
+        - title: Descriptor
+          url: "docs/getting-started#descriptor"
         - title: Digests
           url: "docs/getting-started#digest"
+        - title: Algorithms
+          url: "docs/getting-started#algorithms"
     - title: "About"
       url: "about"
     - title: "News"