droplet_kit 3.7.0 → 3.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c1031673d25cdfb01e6d3104c78d1b54323b89226caf46cdefed299a1a59a63
-  data.tar.gz: 78014149c0412f7aabd632d7743bfc6a83f518612f2eb1b15a41540032f4b2cd
+  metadata.gz: 79d5dbbc1878d5fd027c7aac42a36a72a4d05103c2ec5ab69d6dc59c8ce6d432
+  data.tar.gz: 2755491d1d07c7ff22163ce26fe5fdb1c25932333355bc8ddf87b5ca1bdd4fea
 SHA512:
-  metadata.gz: 6b5ac4a556582c79f77212260bb0f47817685e1957d16a6502e666b73cc4e3c923a673cfa4cf873c18b8ba9c3dc03974405e84599e7b6aa17d1710d4b6f2b3b6
-  data.tar.gz: 990d08778766896d2878dba7f997486bc55a063295d22d56b4714182f07ce5b7838e1bfc91eabbbaf251a59ade95ec61f13bbdb9e8ef309bd1b49e0dd8dae0dd
+  metadata.gz: 16d7c9d3ec1ac1257ed63bd82618b40e59aebcb6f6a6017d202aba2b52223555ace1368f64cc2c7b5475f45a4041204a7155f421d9b1a9e34f430bac33751866
+  data.tar.gz: 18824ee8b5e29b65feaae6616173a93eb0ddb2bf684742bd0a8bdade254f8baa4e2721ff9839e1bdd8f7451180e967db3d1bfb5cc8b0feb287436f69f25c6d18

data/README.md

@@ -354,6 +354,17 @@ Image Actions Supported:
 * `client.image_actions.find(image_id: 123, id: 123455)`
 * `client.image_actions.transfer(image_id: 123, region: 'nyc3')`
 
+## Invoice resource
+
+```ruby
+client = DropletKit::Client.new(access_token: 'TOKEN')
+client.invoices #=> DropletKit::InvoiceResource
+```
+
+Actions supported:
+
+* `client.invoices.list()`
+* `client.invoices.find(id:123)`
 
 ## Kubernetes Resource
 
@@ -502,6 +513,16 @@ Actions supported:
 
 * `client.account.info()`
 
+## Balance resource
+
+```ruby
+client = DropletKit::Client.new(access_token: 'TOKEN')
+client.balance #=> DropletKit::BalanceResource
+```
+
+Actions supported:
+
+* `client.balance.info()`
 
 ## Floating IP resource
 
@@ -577,6 +598,30 @@ Actions supported:
 * `client.vpcs.delete(id: 'id')`
 * `client.vpcs.all_members(id: 'id')`
 
+## Container Registry resource
+
+    client = DropletKit::Client.new(access_token: 'TOKEN')
+    client.container_registry #=> DropletKit::ContainerRegistryResource
+
+Actions supported:
+
+* `client.container_registry.get()`
+* `client.container_registry.create(registry)`
+* `client.container_registry.delete()`
+* `client.container_registry.docker_credentials()`
+
+## Container Registry Repository resource
+
+    client = DropletKit::Client.new(access_token: 'TOKEN')
+    client.container_registry_repository #=> DropletKit::ContainerRegistryRepositoryResource
+
+Actions supported:
+
+* `client.container_registry_repository.all(registry_name: 'registry')`
+* `client.container_registry_repository.tags(registry_name: 'registry', repository: 'repo')`
+* `client.container_registry_repository.delete_tag(registry_name: 'registry', repository: 'repo', tag: 'tag')`
+* `client.container_registry_repository.delete_manifest(registry_name: 'registry', repository: 'repo', manifest_digest: 'sha256:cb8a924afdf0229ef7515d9e5b3024e23b3eb03ddbba287f4a19c6ac90b8d221')`
+
 ## Contributing
 
 1. Fork it ( https://github.com/digitalocean/droplet_kit/fork )

data/lib/droplet_kit.rb

@@ -8,9 +8,12 @@ module DropletKit
   # Models
   autoload :BaseModel, 'droplet_kit/models/base_model'
   autoload :ContainerRegistry, 'droplet_kit/models/container_registry'
+  autoload :ContainerRegistryRepository, 'droplet_kit/models/container_registry_repository'
+  autoload :ContainerRegistryRepositoryTag, 'droplet_kit/models/container_registry_repository_tag'
   autoload :Droplet, 'droplet_kit/models/droplet'
   autoload :Region, 'droplet_kit/models/region'
   autoload :Image, 'droplet_kit/models/image'
+  autoload :Invoice, 'droplet_kit/models/invoice'
   autoload :Size, 'droplet_kit/models/size'
   autoload :NetworkHash, 'droplet_kit/models/network_hash'
   autoload :Network, 'droplet_kit/models/network'
@@ -22,6 +25,7 @@ module DropletKit
   autoload :SSHKey, 'droplet_kit/models/ssh_key'
   autoload :MetaInformation, 'droplet_kit/models/meta_information'
   autoload :Account, 'droplet_kit/models/account'
+  autoload :Balance, 'droplet_kit/models/balance'
   autoload :DropletUpgrade, 'droplet_kit/models/droplet_upgrade'
   autoload :FloatingIp, 'droplet_kit/models/floating_ip'
   autoload :Project, 'droplet_kit/models/project'
@@ -67,15 +71,18 @@ module DropletKit
   autoload :DropletResource, 'droplet_kit/resources/droplet_resource'
   autoload :ActionResource, 'droplet_kit/resources/action_resource'
   autoload :ContainerRegistryResource, 'droplet_kit/resources/container_registry_resource'
+  autoload :ContainerRegistryRepositoryResource, 'droplet_kit/resources/container_registry_repository_resource'
   autoload :DomainResource, 'droplet_kit/resources/domain_resource'
   autoload :DomainRecordResource, 'droplet_kit/resources/domain_record_resource'
   autoload :DropletActionResource, 'droplet_kit/resources/droplet_action_resource'
   autoload :ImageResource, 'droplet_kit/resources/image_resource'
+  autoload :InvoiceResource, 'droplet_kit/resources/invoice_resource'
   autoload :ImageActionResource, 'droplet_kit/resources/image_action_resource'
   autoload :SSHKeyResource, 'droplet_kit/resources/ssh_key_resource'
   autoload :RegionResource, 'droplet_kit/resources/region_resource'
   autoload :SizeResource, 'droplet_kit/resources/size_resource'
   autoload :AccountResource, 'droplet_kit/resources/account_resource'
+  autoload :BalanceResource, 'droplet_kit/resources/balance_resource'
   autoload :DropletUpgradeResource, 'droplet_kit/resources/droplet_upgrade_resource'
   autoload :FloatingIpResource, 'droplet_kit/resources/floating_ip_resource'
   autoload :FloatingIpActionResource, 'droplet_kit/resources/floating_ip_action_resource'
@@ -96,6 +103,8 @@ module DropletKit
   # JSON Maps
   autoload :DropletMapping, 'droplet_kit/mappings/droplet_mapping'
   autoload :ContainerRegistryMapping, 'droplet_kit/mappings/container_registry_mapping'
+  autoload :ContainerRegistryRepositoryMapping, 'droplet_kit/mappings/container_registry_repository_mapping'
+  autoload :ContainerRegistryRepositoryTagMapping, 'droplet_kit/mappings/container_registry_repository_tag_mapping'
   autoload :ImageMapping, 'droplet_kit/mappings/image_mapping'
   autoload :RegionMapping, 'droplet_kit/mappings/region_mapping'
   autoload :SizeMapping, 'droplet_kit/mappings/size_mapping'
@@ -108,8 +117,10 @@ module DropletKit
   autoload :DomainRecordMapping, 'droplet_kit/mappings/domain_record_mapping'
   autoload :DropletActionMapping, 'droplet_kit/mappings/droplet_action_mapping'
   autoload :ImageActionMapping, 'droplet_kit/mappings/image_action_mapping'
+  autoload :InvoiceMapping, 'droplet_kit/mappings/invoice_mapping'
   autoload :SSHKeyMapping, 'droplet_kit/mappings/ssh_key_mapping'
   autoload :AccountMapping, 'droplet_kit/mappings/account_mapping'
+  autoload :BalanceMapping, 'droplet_kit/mappings/balance_mapping'
   autoload :DropletUpgradeMapping, 'droplet_kit/mappings/droplet_upgrade_mapping'
   autoload :FloatingIpMapping, 'droplet_kit/mappings/floating_ip_mapping'
   autoload :ProjectMapping, 'droplet_kit/mappings/project_mapping'

data/lib/droplet_kit/client.rb

@@ -32,6 +32,7 @@ module DropletKit
         cdns: CDNResource,
         certificates: CertificateResource,
         container_registry: ContainerRegistryResource,
+        container_registry_repository: ContainerRegistryRepositoryResource,
         databases: DatabaseResource,
         droplets: DropletResource,
         kubernetes_clusters: KubernetesClusterResource,
@@ -42,12 +43,14 @@ module DropletKit
         firewalls: FirewallResource,
         images: ImageResource,
         image_actions: ImageActionResource,
+        invoices: InvoiceResource,
         load_balancers: LoadBalancerResource,
         regions: RegionResource,
         sizes: SizeResource,
         ssh_keys: SSHKeyResource,
         snapshots: SnapshotResource,
         account: AccountResource,
+        balance: BalanceResource,
         floating_ips: FloatingIpResource,
         floating_ip_actions: FloatingIpActionResource,
         tags: TagResource,

data/lib/droplet_kit/mappings/balance_mapping.rb

@@ -0,0 +1,14 @@
+module DropletKit
+  class BalanceMapping
+    include Kartograph::DSL
+
+    kartograph do
+      mapping Balance
+      property :month_to_date_balance, scopes: [:read]
+      property :account_balance, scopes: [:read]
+      property :month_to_date_usage, scopes: [:read]
+      property :generated_at, scopes: [:read]
+      
+    end
+  end
+end

data/lib/droplet_kit/mappings/container_registry_repository_mapping.rb

@@ -0,0 +1,14 @@
+module DropletKit
+  class ContainerRegistryRepositoryMapping
+    include Kartograph::DSL
+    kartograph do
+      mapping ContainerRegistryRepository
+      root_key singular: 'repository', plural: 'repositories', scopes: [:read]
+
+      property :registry_name, scopes: [:read]
+      property :name, scopes: [:read]
+      property :latest_tag, scopes: [:read], include: ContainerRegistryRepositoryTagMapping
+      property :tag_count, scopes: [:read]
+    end
+  end
+end

data/lib/droplet_kit/mappings/container_registry_repository_tag_mapping.rb

@@ -0,0 +1,17 @@
+module DropletKit
+  class ContainerRegistryRepositoryTagMapping
+    include Kartograph::DSL
+    kartograph do
+      mapping ContainerRegistryRepositoryTag
+      root_key singular: 'tag', plural: 'tags', scopes: [:read]
+
+      property :registry_name, scopes: [:read]
+      property :repository, scopes: [:read]
+      property :tag, scopes: [:read]
+      property :manifest_digest, scopes: [:read]
+      property :compressed_size_bytes, scopes: [:read]
+      property :size_bytes, scopes: [:read]
+      property :updated_at, scopes: [:read]
+    end
+  end
+end

data/lib/droplet_kit/mappings/invoice_mapping.rb

@@ -0,0 +1,32 @@
+module DropletKit
+  class InvoiceMapping
+    include Kartograph::DSL
+
+    kartograph do
+      mapping Invoice
+      root_key plural: 'invoices', scopes: [:read]
+      root_key plural: 'invoice_items', scopes: [:find]
+
+      scoped :read do
+        property :invoice_uuid
+        property :amount
+        property :invoice_period
+      end
+
+      scoped :find do
+        property :product
+        property :amount
+        property :resource_uuid
+        property :group_description
+        property :description
+        property :duration
+        property :duration_unit
+        property :start_time
+        property :end_time
+        property :project_name
+        property :category
+      end
+    end
+  end
+end
+  

data/lib/droplet_kit/mappings/vpc_mapping.rb

@@ -20,6 +20,7 @@ module DropletKit
       scoped :update, :patch do
         property :name
         property :description
+        property :default
       end
 
       scoped :create do
@@ -30,4 +31,4 @@ module DropletKit
       end
     end
   end
-end
+end

data/lib/droplet_kit/models/balance.rb

@@ -0,0 +1,8 @@
+module DropletKit
+  class Balance < BaseModel
+    attribute :month_to_date_balance
+    attribute :account_balance
+    attribute :month_to_date_usage
+    attribute :generated_at
+  end
+end

data/lib/droplet_kit/models/container_registry_repository.rb

@@ -0,0 +1,7 @@
+module DropletKit
+  class ContainerRegistryRepository < BaseModel
+    [:registry_name,:name,:latest_tag,:tag_count].each do |key|
+      attribute(key)
+    end
+  end
+end

data/lib/droplet_kit/models/container_registry_repository_tag.rb

@@ -0,0 +1,7 @@
+module DropletKit
+  class ContainerRegistryRepositoryTag < BaseModel
+    [:registry_name,:repository,:tag,:manifest_digest,:compressed_size_bytes,:size_bytes,:updated_at].each do |key|
+      attribute(key)
+    end
+  end
+end

data/lib/droplet_kit/models/invoice.rb

@@ -0,0 +1,18 @@
+module DropletKit
+    class Invoice < BaseModel
+      attribute :invoice_uuid
+      attribute :amount
+      attribute :invoice_period
+      attribute :product
+      attribute :resource_uuid
+      attribute :group_description
+      attribute :description
+      attribute :duration
+      attribute :duration_unit
+      attribute :start_time
+      attribute :end_time
+      attribute :project_name
+      attribute :category
+    end
+  end
+  

data/lib/droplet_kit/paginated_resource.rb

@@ -25,7 +25,7 @@ module DropletKit
       @collection[index]
     end
 
-    def each(start = 0)
+    def each(start = 0, &block)
       # Start off with the first page if we have no idea of anything yet
       fetch_next_page if total.nil?
 
@@ -37,7 +37,7 @@ module DropletKit
       unless last?
         start = [@collection.size, start].max
         fetch_next_page
-        each(start, &Proc.new)
+        each(start, &block)
       end
 
       self

data/lib/droplet_kit/resources/balance_resource.rb

@@ -0,0 +1,10 @@
+module DropletKit
+  class BalanceResource < ResourceKit::Resource
+    include ErrorHandlingResourcable
+
+    resources do
+      default_handler(:ok) {|r| BalanceMapping.extract_single(r.body, :read) }
+      get '/v2/customers/my/balance' => :info
+    end
+  end
+end

data/lib/droplet_kit/resources/container_registry_repository_resource.rb

@@ -0,0 +1,35 @@
+module DropletKit
+    class ContainerRegistryRepositoryResource < ResourceKit::Resource
+      include ErrorHandlingResourcable
+  
+      resources do
+        action :all, 'GET /v2/registry/:registry_name/repositories' do
+          query_keys :per_page, :page
+          handler(200) { |response| ContainerRegistryRepositoryMapping.extract_collection(response.body, :read) }
+        end
+
+        action :tags, 'GET /v2/registry/:registry_name/repositories/:repository/tags' do
+          query_keys :per_page, :page
+          handler(200) { |response| DropletKit::ContainerRegistryRepositoryTagMapping.extract_collection(response.body, :read) }
+        end
+
+        action :delete_tag, 'DELETE /v2/registry/:registry_name/repositories/:repository/tags/:tag' do
+          handler(204) { |response| true }
+        end
+
+        action :delete_manifest, 'DELETE /v2/registry/:registry_name/repositories/:repository/digests/:manifest_digest' do
+          handler(204) { |response| true }
+          handler(400) { |response| ErrorMapping.fail_with(FailedDelete, response.body) }
+        end
+      end
+
+      def all(*args)
+        PaginatedResource.new(action(:all), self, *args)
+      end
+
+      def tags(*args)
+        PaginatedResource.new(action(:tags), self, *args)
+      end
+    end
+end
+  

data/lib/droplet_kit/resources/invoice_resource.rb

@@ -0,0 +1,15 @@
+module DropletKit
+    class InvoiceResource < ResourceKit::Resource
+      include ErrorHandlingResourcable
+  
+      resources do
+        action :list, 'GET /v2/customers/my/invoices' do
+          handler(200) { |response| InvoiceMapping.extract_collection(response.body, :read) }
+        end
+
+        action :find, 'GET v2/customers/my/invoices/:id' do
+          handler(200) { |response| InvoiceMapping.extract_collection(response.body, :find) }
+        end
+      end
+    end
+  end

data/lib/droplet_kit/resources/project_resource.rb

@@ -34,6 +34,7 @@ module DropletKit
       end
 
       action :list_resources, 'GET /v2/projects/:id/resources' do
+        query_keys :per_page, :page
         handler(200) { |response| ProjectAssignmentMapping.extract_collection(response.body, :read) }
       end
 
@@ -61,5 +62,9 @@ module DropletKit
     def all(*args)
       PaginatedResource.new(action(:all), self, *args)
     end
+
+    def list_resources(*args)
+      PaginatedResource.new(action(:list_resources), self, *args)
+    end
   end
 end

data/lib/droplet_kit/resources/vpc_resource.rb

@@ -19,7 +19,7 @@ module DropletKit
 
       action :create, 'POST /v2/vpcs' do
         body { |vpc| VPCMapping.representation_for(:create, vpc) }
-        handler(202) { |response| VPCMapping.extract_single(response.body, :read) }
+        handler(201) { |response| VPCMapping.extract_single(response.body, :read) }
         handler(422) { |response| ErrorMapping.fail_with(FailedCreate, response.body) }
       end
 

data/lib/droplet_kit/version.rb

@@ -1,3 +1,3 @@
 module DropletKit
-  VERSION = "3.7.0"
+  VERSION = "3.11.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: droplet_kit
 version: !ruby/object:Gem::Version
-  version: 3.7.0
+  version: 3.11.0
 platform: ruby
 authors:
-- Digital Ocean API/CLI team
+- DigitalOcean API Engineering team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-07 00:00:00.000000000 Z
+date: 2020-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: virtus
@@ -56,14 +56,14 @@ dependencies:
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.15'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.15'
 - !ruby/object:Gem::Dependency
@@ -138,7 +138,7 @@ dependencies:
         version: 3.8.0
 description: Droplet Kit is the official Ruby library for DigitalOcean's API
 email:
-- devex-api-engineering@digitalocean.com
+- api-engineering@digitalocean.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -150,9 +150,12 @@ files:
 - lib/droplet_kit/error_handling_resourcable.rb
 - lib/droplet_kit/mappings/account_mapping.rb
 - lib/droplet_kit/mappings/action_mapping.rb
+- lib/droplet_kit/mappings/balance_mapping.rb
 - lib/droplet_kit/mappings/cdn_mapping.rb
 - lib/droplet_kit/mappings/certificate_mapping.rb
 - lib/droplet_kit/mappings/container_registry_mapping.rb
+- lib/droplet_kit/mappings/container_registry_repository_mapping.rb
+- lib/droplet_kit/mappings/container_registry_repository_tag_mapping.rb
 - lib/droplet_kit/mappings/database_backup_mapping.rb
 - lib/droplet_kit/mappings/database_backup_restore_mapping.rb
 - lib/droplet_kit/mappings/database_cluster_mapping.rb
@@ -180,6 +183,7 @@ files:
 - lib/droplet_kit/mappings/forwarding_rule_mapping.rb
 - lib/droplet_kit/mappings/health_check_mapping.rb
 - lib/droplet_kit/mappings/image_mapping.rb
+- lib/droplet_kit/mappings/invoice_mapping.rb
 - lib/droplet_kit/mappings/kernel_mapping.rb
 - lib/droplet_kit/mappings/kubernetes_cluster_mapping.rb
 - lib/droplet_kit/mappings/kubernetes_maintenance_policy_mapping.rb
@@ -206,10 +210,13 @@ files:
 - lib/droplet_kit/mappings/vpc_member_mapping.rb
 - lib/droplet_kit/models/account.rb
 - lib/droplet_kit/models/action.rb
+- lib/droplet_kit/models/balance.rb
 - lib/droplet_kit/models/base_model.rb
 - lib/droplet_kit/models/cdn.rb
 - lib/droplet_kit/models/certificate.rb
 - lib/droplet_kit/models/container_registry.rb
+- lib/droplet_kit/models/container_registry_repository.rb
+- lib/droplet_kit/models/container_registry_repository_tag.rb
 - lib/droplet_kit/models/database.rb
 - lib/droplet_kit/models/database_backup.rb
 - lib/droplet_kit/models/database_cluster.rb
@@ -236,6 +243,7 @@ files:
 - lib/droplet_kit/models/forwarding_rule.rb
 - lib/droplet_kit/models/health_check.rb
 - lib/droplet_kit/models/image.rb
+- lib/droplet_kit/models/invoice.rb
 - lib/droplet_kit/models/kernel.rb
 - lib/droplet_kit/models/kubernetes_cluster.rb
 - lib/droplet_kit/models/kubernetes_maintenance_policy.rb
@@ -265,8 +273,10 @@ files:
 - lib/droplet_kit/paginated_resource.rb
 - lib/droplet_kit/resources/account_resource.rb
 - lib/droplet_kit/resources/action_resource.rb
+- lib/droplet_kit/resources/balance_resource.rb
 - lib/droplet_kit/resources/cdn_resource.rb
 - lib/droplet_kit/resources/certificate_resource.rb
+- lib/droplet_kit/resources/container_registry_repository_resource.rb
 - lib/droplet_kit/resources/container_registry_resource.rb
 - lib/droplet_kit/resources/database_resource.rb
 - lib/droplet_kit/resources/domain_record_resource.rb
@@ -279,6 +289,7 @@ files:
 - lib/droplet_kit/resources/floating_ip_resource.rb
 - lib/droplet_kit/resources/image_action_resource.rb
 - lib/droplet_kit/resources/image_resource.rb
+- lib/droplet_kit/resources/invoice_resource.rb
 - lib/droplet_kit/resources/kubernetes_cluster_resource.rb
 - lib/droplet_kit/resources/kubernetes_options_resource.rb
 - lib/droplet_kit/resources/load_balancer_resource.rb
@@ -306,14 +317,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Droplet Kit is the official Ruby library for DigitalOcean's API