docker-remote 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f8dcfda8b4cbf58474274964a653f5049f609333bf88d1b9497205a4bb366e6e
+  data.tar.gz: 9ec104d6e95619a579b0e8e4049d00d6e1eb68c425f7490a83a12477ca812e21
+SHA512:
+  metadata.gz: 96faa086fc0223dc3377c77e57042b806f446923156c46bf6627438d64104c06bcadcda9674901a830f209ab68abb09a79335893df8e9428472d292e62dc8c83
+  data.tar.gz: '038eb80f159cc9c1c0a3740923c55a4c351c156b10a1e641aaaf4f3d7ceab790fe03d1ca0001f5b2b150978acf8f3e709654764b1e9ab9e950874d2837b54c59'

data/CHANGELOG.md

@@ -0,0 +1,2 @@
+## 0.1.0
+* Birthday!

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development do
+  gem 'rake'
+end
+
+group :test do
+  gem 'rspec'
+end

data/Rakefile

@@ -0,0 +1,14 @@
+require 'bundler'
+require 'rspec/core/rake_task'
+require 'rubygems/package_task'
+
+require 'docker/remote'
+
+Bundler::GemHelper.install_tasks
+
+task default: :spec
+
+desc 'Run specs'
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = './spec/**/*_spec.rb'
+end

data/docker-remote.gemspec

@@ -0,0 +1,17 @@
+$:.unshift File.join(File.dirname(__FILE__), 'lib')
+require 'docker/remote/version'
+
+Gem::Specification.new do |s|
+  s.name     = 'docker-remote'
+  s.version  = ::Docker::Remote::VERSION
+  s.authors  = ['Cameron Dutro']
+  s.email    = ['camertron@gmail.com']
+  s.homepage = 'http://github.com/getkuby/docker-remote'
+
+  s.description = s.summary = 'A Ruby client for communicating with the Docker HTTP API v2.'
+
+  s.platform = Gem::Platform::RUBY
+
+  s.require_path = 'lib'
+  s.files = Dir['{lib,spec}/**/*', 'Gemfile', 'CHANGELOG.md', 'README.md', 'Rakefile', 'docker-remote.gemspec']
+end

data/lib/docker/remote.rb

@@ -0,0 +1,9 @@
+require 'net/http'
+require 'uri'
+
+module Docker
+  module Remote
+    autoload :Client,     'docker/remote/client'
+    autoload :ServerAuth, 'docker/remote/server_auth'
+  end
+end

data/lib/docker/remote/client.rb

@@ -0,0 +1,114 @@
+require 'json'
+
+module Docker
+  module Remote
+    class ClientError < StandardError; end
+    class ServerError < StandardError; end
+    class UnauthorizedError < ClientError; end
+    class NotFoundError < ClientError; end
+
+    class Client
+      attr_reader :registry_url, :repo, :username, :password
+
+      def initialize(registry_url, repo, username = nil, password = nil)
+        @registry_url = registry_url
+        @repo = repo
+        @username = username
+        @password = password
+      end
+
+      def tags
+        request = make_get("/v2/#{repo}/tags/list")
+        response = registry_http.request(request)
+        potentially_raise_error!(response)
+        JSON.parse(response.body)['tags']
+      end
+
+      def manifest_for(reference)
+        request = make_get("/v2/#{repo}/manifests/#{reference}")
+        response = registry_http.request(request)
+        potentially_raise_error!(response)
+        JSON.parse(response.body)
+      end
+
+      def catalog
+        request = make_get("/v2/_catalog")
+        response = registry_http.request(request)
+        potentially_raise_error!(response)
+        JSON.parse(response.body)
+      end
+
+      private
+
+      def token
+        @token ||= begin
+          uri = URI.parse(server_auth.realm)
+          http = Net::HTTP.new(uri.host, uri.port)
+          http.use_ssl = true if uri.scheme == 'https'
+
+          request = Net::HTTP::Get.new(
+            "#{uri.request_uri}?service=#{server_auth.service}&scope=repository:#{repo}:pull"
+          )
+
+          if username && password
+            request.basic_auth(username, password)
+          end
+
+          response = http.request(request)
+          potentially_raise_error!(response)
+          JSON.parse(response.body)['token']
+        end
+      end
+
+      def server_auth
+        @server_auth ||= begin
+          request = Net::HTTP::Get.new('/v2/')
+          response = registry_http.request(request)
+          auth = response['www-authenticate']
+
+          idx = auth.index(' ')
+          auth_type = auth[0..idx].strip
+
+          params = auth[idx..-1].split(',').each_with_object({}) do |param, ret|
+            key, value = param.split('=')
+            ret[key.strip] = value.strip[1..-2]  # remove quotes
+          end
+
+          ServerAuth.new(auth_type, params)
+        end
+      end
+
+      def registry_uri
+        @registry_uri ||= URI.parse(registry_url)
+      end
+
+      def registry_http
+        @registry_http ||= Net::HTTP.new(registry_uri.host, registry_uri.port).tap do |http|
+          http.use_ssl = true if registry_uri.scheme == 'https'
+        end
+      end
+
+      def make_get(path)
+        Net::HTTP::Get.new(path).tap do |request|
+          request['Authorization'] = "Bearer #{token}"
+        end
+      end
+
+      def potentially_raise_error!(response)
+        case response.code.to_i
+          when 401
+            raise UnauthorizedError, "401 Unauthorized: #{response.message}"
+          when 404
+            raise NotFoundError, "404 Not Found: #{response.message}"
+        end
+
+        case response.code.to_i / 100
+          when 4
+            raise ClientError, "#{response.code}: #{response.message}"
+          when 5
+            raise ServerError, "#{response.code}: #{response.message}"
+        end
+      end
+    end
+  end
+end

data/lib/docker/remote/server_auth.rb

@@ -0,0 +1,20 @@
+module Docker
+  module Remote
+    class ServerAuth
+      attr_reader :auth_type, :params
+
+      def initialize(auth_type, params)
+        @auth_type = auth_type
+        @params = params
+      end
+
+      def realm
+        @params['realm']
+      end
+
+      def service
+        @params['service']
+      end
+    end
+  end
+end

data/lib/docker/remote/version.rb

@@ -0,0 +1,5 @@
+module Docker
+  module Remote
+    VERSION = '0.1.0'
+  end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: docker-remote
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Cameron Dutro
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-05-21 00:00:00.000000000 Z
+dependencies: []
+description: A Ruby client for communicating with the Docker HTTP API v2.
+email:
+- camertron@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- Rakefile
+- docker-remote.gemspec
+- lib/docker/remote.rb
+- lib/docker/remote/client.rb
+- lib/docker/remote/server_auth.rb
+- lib/docker/remote/version.rb
+homepage: http://github.com/getkuby/docker-remote
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.6
+signing_key: 
+specification_version: 4
+summary: A Ruby client for communicating with the Docker HTTP API v2.
+test_files: []