docker_registry2 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c6ea58879e9bc75f39640a3db5ace45d46291437
-  data.tar.gz: 92cc2a0bce7d5fa73a4a6c21da456ac23d25968e
+  metadata.gz: c827b61fd48f2bd6359d119f56abcc48be8ccf57
+  data.tar.gz: b73fec0b836cbb3930a44e830c8ef44664d63cd2
 SHA512:
-  metadata.gz: be00444d06f0e8e742a28d0f40e4b97e1f62bbbf4803d16d09439215024720f4b145d5fdaf4394956e2490d3215bcf68c21e161e67360b44ebe112d647b26534
-  data.tar.gz: 5f3ba88b12ad4378c5b20fd554f87f81903b86ac8be4c5fb177e1d69ee09019acef37ea03089e9596c3cd27fb3c2403b24db615592297f2423bd809fe3a9748a
+  metadata.gz: eb535e5baa99262fd1a5819a9df3bdf7c9d98a8b13782c1dfecaeff1a05071e9b4c16e9df0d6f6a25749434f5a7280617f7dab458e6b08f94e60bc1c3909cf68
+  data.tar.gz: ba4f8dfaa9ef8b3210d317f5cb9d843fc21b60e2a15101f609adb0118ced20b2c8b73ebdf29d0f5d2ee2501aadb6dc8c8f947d27eef016108de357a4cbb23d38

data/README.md

@@ -5,7 +5,7 @@
 This is a simple gem that provides direct http access to a docker registry v2 without going through a docker server. You do **not** requires docker installed on your system to provide access.
 
 ````ruby
-reg = DockerRegistry.connect("https://my.registy.corp.com")
+reg = DockerRegistry2.connect("https://my.registy.corp.com")
 repos = reg.search("foo/repo")
 tags = reg.tags("foo/repo")
 ````
@@ -14,12 +14,20 @@ Supports anonymous access, http authorization and v2 token access.
 
 Inspired by https://github.com/rosylilly/docker_registry but written separately.
 
+#### Note
+
+Prior to version 0.4.0, the name used was DockerRegistry. As of 0.4.0 it is DockerRegistry2.
+If you still need DockerRegistry, just create an alias with:
+
+````ruby
+DockerRegistry = DockerRegistry2
+````
 
 ## Installation
 
 Add the following to your Gemfile:
 
-    gem 'docker_registry2`
+    gem 'docker_registry2'
 
 And execute:
 
@@ -35,7 +43,7 @@ Once it is installed, you first *open* a connection to a registry, and then *req
 To connect to a registry:
 
 ````ruby
-reg = DockerRegistry.connect("https://my.registy.corp.com")
+reg = DockerRegistry2.connect("https://my.registy.corp.com")
 ````
 
 The above will connect anonymously to the registry via the endpoint `https://my.registry.corp.com/v2/`.
@@ -50,7 +58,7 @@ The following exceptions are thrown:
 If you wish to authenticate, pass a username and password as part of the URL.
 
 ````ruby
-reg = DockerRegistry.connect("https://myuser:mypass@my.registy.corp.com")
+reg = DockerRegistry2.connect("https://myuser:mypass@my.registy.corp.com")
 ````
 
 The following exceptions are thrown:
@@ -62,7 +70,7 @@ The following exceptions are thrown:
 
 
 ### Requests
-Once you have a valid `reg` object return by `DockerRegistry.connect()`, you can make requests. As of this version, only search and tags are supported. Others will be added over time.
+Once you have a valid `reg` object return by `DockerRegistry2.connect()`, you can make requests. As of this version, only search and tags are supported. Others will be added over time.
 
 
 #### search
@@ -239,7 +247,7 @@ The following exceptions are thrown:
 
 ### Exceptions
 
-All exceptions thrown inherit from `DockerRegistry::Exception`.
+All exceptions thrown inherit from `DockerRegistry2::Exception`.
 
 ## Tests
 The simplest way to test is against a true v2 registry. Thus, the test setup and teardown work against a docker registry. That means that to test, you need a docker engine running. The tests will start up a registry (actually, two registries, to be able to test `copy()`), initialize the data and test against them.

data/docker_registry2.gemspec

@@ -5,8 +5,8 @@ require 'registry/version'
 
 Gem::Specification.new do |spec|
   spec.name          = 'docker_registry2'
-  spec.version       = DockerRegistry::VERSION
-  spec.authors       = ['Avi Deitcher https://github.com/deitch', 'Jonathan Hurter https://github.com/johnsudaar']
+  spec.version       = DockerRegistry2::VERSION
+  spec.authors       = ['Avi Deitcher https://github.com/deitch', 'Jonathan Hurter https://github.com/johnsudaar', 'Dmitry Fleytman https://github.com/dmitryfleytman']
   spec.summary       = 'Docker v2 registry HTTP API client'
   spec.description   = 'Docker v2 registry HTTP API client with support for token authentication'
   spec.homepage      = 'https://github.com/deitch/docker_registry2'

data/lib/docker_registry2.rb

@@ -3,9 +3,9 @@ require File.dirname(__FILE__) + '/registry/registry'
 require File.dirname(__FILE__) + '/registry/exceptions'
 
 
-module DockerRegistry
+module DockerRegistry2
   def self.connect(uri)
-    @reg = DockerRegistry::Registry.new(uri)
+    @reg = DockerRegistry2::Registry.new(uri)
   end  
   
   def self.search(query = '')

data/lib/registry/exceptions.rb

@@ -1,4 +1,4 @@
-module DockerRegistry
+module DockerRegistry2
   class Exception < RuntimeError
     
   end

data/lib/registry/registry.rb

@@ -2,7 +2,7 @@ require 'fileutils'
 require 'rest-client'
 require 'json'
 
-class DockerRegistry::Registry
+class DockerRegistry2::Registry
   # @param [#to_s] base_uri Docker registry base URI
   # @param [Hash] options Client options
   # @option options [#to_s] :user User name for basic authentication
@@ -53,7 +53,7 @@ class DockerRegistry::Registry
         else
           begin
             head = dohead "/v2/#{repo}/manifests/#{tag}"
-          rescue DockerRegistry::InvalidMethod
+          rescue DockerRegistry2::InvalidMethod
             # in case we are in a registry pre-2.3.0, which did not support manifest HEAD
             useGet = true
             head = doget "/v2/#{repo}/manifests/#{tag}"
@@ -95,49 +95,64 @@ class DockerRegistry::Registry
   end
   
   private
-    def doreq(type,url)
+    def doreq(type,url,stream=nil)
       begin
-        response = RestClient::Request.execute method: type, url: @base_uri+url
+        block = stream.nil? ? nil : proc { |response|
+          response.read_body do |chunk|
+            stream.write chunk
+          end
+        }
+        response = RestClient::Request.execute method: type, url: @base_uri+url, headers: {Accept: 'application/vnd.docker.distribution.manifest.v2+json'}, block_response: block
       rescue SocketError
-        raise DockerRegistry::RegistryUnknownException
+        raise DockerRegistry2::RegistryUnknownException
       rescue RestClient::Unauthorized => e
         header = e.response.headers[:www_authenticate]
         method = header.downcase.split(' ')[0]
         case method
         when 'basic'
-          response = do_basic_req(type, url)
+          response = do_basic_req(type, url, stream)
         when 'bearer'
-          response = do_bearer_req(type, url, header)
+          response = do_bearer_req(type, url, header, stream)
         else
-          raise DockerRegistry::RegistryUnknownException
+          raise DockerRegistry2::RegistryUnknownException
         end
       end
       return response
     end
 
-    def do_basic_req(type, url)
+    def do_basic_req(type, url, stream=nil)
       begin
-        response = RestClient::Request.execute method: type, url: @base_uri+url, user: @user, password: @password
+        block = stream.nil? ? nil : proc { |response|
+          response.read_body do |chunk|
+            stream.write chunk
+          end
+        }
+        response = RestClient::Request.execute method: type, url: @base_uri+url, user: @user, password: @password, headers: {Accept: 'application/vnd.docker.distribution.manifest.v2+json'}, block_response: block
       rescue SocketError
-        raise DockerRegistry::RegistryUnknownException
+        raise DockerRegistry2::RegistryUnknownException
       rescue RestClient::Unauthorized
-        raise DockerRegistry::RegistryAuthenticationException
+        raise DockerRegistry2::RegistryAuthenticationException
       rescue RestClient::MethodNotAllowed
-        raise DockerRegistry::InvalidMethod
+        raise DockerRegistry2::InvalidMethod
       end
       return response
     end
 
-    def do_bearer_req(type, url, header)
+    def do_bearer_req(type, url, header, stream=false)
       token = authenticate_bearer(header)
       begin
-        response = RestClient::Request.execute method: type, url: @base_uri+url, headers: {Authorization: 'Bearer '+token}
+        block = stream.nil? ? nil : proc { |response|
+          response.read_body do |chunk|
+            stream.write chunk
+          end
+        }
+        response = RestClient::Request.execute method: type, url: @base_uri+url, headers: {Authorization: 'Bearer '+token, Accept: 'application/vnd.docker.distribution.manifest.v2+json'}, block_response: block
       rescue SocketError
-        raise DockerRegistry::RegistryUnknownException
+        raise DockerRegistry2::RegistryUnknownException
       rescue RestClient::Unauthorized
-        raise DockerRegistry::RegistryAuthenticationException
+        raise DockerRegistry2::RegistryAuthenticationException
       rescue RestClient::MethodNotAllowed
-        raise DockerRegistry::InvalidMethod
+        raise DockerRegistry2::InvalidMethod
       end
 
       return response
@@ -158,7 +173,7 @@ class DockerRegistry::Registry
         response = RestClient.get uri.to_s, {params: target[:params]}
       rescue RestClient::Unauthorized
         # bad authentication
-        raise DockerRegistry::RegistryAuthenticationException
+        raise DockerRegistry2::RegistryAuthenticationException
       end
       # now save the web token
       return JSON.parse(response)["token"]

data/lib/registry/version.rb

@@ -1,3 +1,3 @@
-module DockerRegistry
-  VERSION = '0.3.0'
+module DockerRegistry2
+  VERSION = '0.4.0'
 end

metadata

@@ -1,15 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: docker_registry2
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Avi Deitcher https://github.com/deitch
 - Jonathan Hurter https://github.com/johnsudaar
+- Dmitry Fleytman https://github.com/dmitryfleytman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-02-24 00:00:00.000000000 Z
+date: 2017-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -101,9 +102,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Docker v2 registry HTTP API client
 test_files: []
-has_rdoc: