cloud_party 0.1.13 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea936d4104179612043c6e522da8ae2e77e787bc808f423f9d6292f5f11a2a9a
-  data.tar.gz: da0db5d79fd575e5be4f0adecbea51364b618ede63774e970bdd3635010080f3
+  metadata.gz: b6b2bf33cb61834c640e0c0bbfe4b4dc89366d6992401b2d02f4a414ffed624b
+  data.tar.gz: 2d2b4e215e0313d54e67a0dc9316fb447fefd9c73cca3f84cc1ca3dddd8f127f
 SHA512:
-  metadata.gz: 2602acb8688170b200ad2aeb6088a79dc92e480519718c7c3265270081598e16984f66eb6db451a717261a6fcd6637712644fcb09d8c6a23a3a90863b62703f3
-  data.tar.gz: c2d2800b7a476f604ad4224bfedcea85d29a9b77d055bc67f94073e62d992899705016eb6e60f992bdba0ff62beb2b6b95fcd55fbc20a60f76b7265a2f3cd735
+  metadata.gz: afe0f76830a0c96685a86a85969bf56a3d7cc4ae1ac76e895644b1fead048e85192648c1c06197890a9a0bafbaf38bc1852300f1f77b58d147d7a31f32c344f1
+  data.tar.gz: 9787873b795dc8ad29ab371ca74fa69c040b00e336e72534eef05f3309b6f261dc35f49e5c9bd352932bdb1112ec0f171a738370984f63f4d937c67fe2cc6932

data/bin/console

@@ -8,8 +8,8 @@ require 'cloud_party'
 # with your gem easier. You can also use a different console, if you like.
 
 # (If you use this, don't forget to add pry to your Gemfile!)
-require 'pry'
-Pry.start
+# require 'pry'
+# Pry.start
 
-# require "irb"
-# IRB.start
+require "irb"
+IRB.start

data/lib/cloud_party/helpers.rb

@@ -0,0 +1,11 @@
+require 'uri'
+
+module CloudParty
+  module Helpers
+    module_function
+    def self.build_query(params)
+      uri = URI::HTTPS.build(host: 'example.com', query: URI.encode_www_form(params))
+      return "?#{uri.query}"
+    end
+  end
+end

data/lib/cloud_party/nodes/dns_records.rb

@@ -7,6 +7,7 @@
 #
 # License is in project root, MIT License is in use.
 require 'cloud_party/config'
+require 'cloud_party/helpers'
 require 'cloud_party/context'
 require 'cloud_party/responses'
 CloudParty::Config.new
@@ -20,7 +21,7 @@ module CloudParty
               'Content-Type' => 'application/json',
               'User-Agent' => "CloudParty/#{CloudParty::VERSION}"
 
-      def self.id_by_name(zone)
+      def self.zone_id_by_name(zone)
         options = {
             match: 'all',
             name: zone,
@@ -31,15 +32,15 @@ module CloudParty
         else
           @options.merge!(options)
         end
-        zone = CloudParty::Responses::Zones.new(:get, '/zones', get('/zones', query: @options), @options).result
-                   if zone.is_a?(Array)
-                          if zone.size > 1
-                            raise CloudParty::Errors::ResultError.new()
-                          else
-                            zone.first.fetch(:id, nil)
-
-                          end
-                   end
+        zone = CloudParty::Responses::Zones.new(:get, '/zones',
+        get('/zones', query: @options), @options).result
+          if zone.is_a?(Array)
+                if zone.size > 1
+                  raise CloudParty::Errors::ResultError.new()
+                else
+                  zone.first.fetch(:id, nil)
+                end
+          end
 
       end
       def initialize(options = {})
@@ -47,12 +48,101 @@ module CloudParty
         @options = options
       end
 
-      def list(zone)
-        zone_id = self.id_by_name(zone)
+      # Retrieve a list of DNS records for the given zone
+      #
+      # @param zone [String] Zone to retrieve DNS records for
+      # @param opts [Hash] Additional query options
+      # @option opts [String] :name Name of DNS record to search for
+      # @option opts [String] :type Type of DNS record to search for
+      # @option opts [Integer] :page Page number to retrieve
+      # @option opts [Integer] :per_page Number of items per page
+      # @option opts [String] :order Direction of results
+      # @option opts [String] :comment Exact value of the DNS record comment. This is a convenience alias for comment.exact.
+      # Example: Hello, world
+      # @option opts [String] :"comment.absent" If this parameter is present, only records without a comment are returned.
+      # @option opts [String] :"comment.contains" Substring of the DNS record comment. Comment filters are case-insensitive.
+      # Example: ello, worl
+      # @option opts [String] :"comment.endswith" Suffix of the DNS record comment. Comment filters are case-insensitive.
+      # Example: o, world
+      # @option opts [String] :"comment.present" If this parameter is present, only records with a comment are returned.
+      # @option opts [String] :"comment.exact" Exact value of the DNS record comment. Comment filters are case-insensitive.
+      # Example: Hello, world
+      # @option opts [String] :"comment.startswith" Prefix of the DNS record comment. Comment filters are case-insensitive.
+      # Example: Hello, w
+      # @option opts [String] :content Exact value of the DNS record content. This is a convenience alias for content.exact.
+      # Example: 127.0.0.1
+      # @option opts [String] :"content.contains" Substring of the DNS record content. Content filters are case-insensitive.
+      # Example: 7.0.0.
+      # @option opts [String] :"content.endswith" Suffix of the DNS record content. Content filters are case-insensitive.
+      # Example: .0.1
+      # @option opts [String] :"content.exact" Exact value of the DNS record content. Content filters are case-insensitive.
+      # Example: 127.0.0.1
+      # @option opts [String] :"content.startswith" Prefix of the DNS record content. Content filters are case-insensitive.
+      # Example: 127.0.
+      # @option opts [String] :direction Direction to order DNS records in.
+      # Allowed values: asc, desc
+      # Default: asc
+      # Example: desc
+      # @option opts [String] :match Whether to match all search requirements or at least one (any). If set to all, acts like a logical AND between filters. If set to any, acts like a logical OR instead. Note that the interaction between tag filters is controlled by the tag-match parameter instead.
+      # Allowed values: any, all
+      # Default: all
+      # Example: any
+      # @option opts [String] :name Exact value of the DNS record name. This is a convenience alias for name.exact.
+      # Example: www.example.com
+      # @option opts [String] :name.contains Substring of the DNS record name. Name filters are case-insensitive.
+      # Example: w.example.
+      # @option opts [String] :name.endswith Suffix of the DNS record name. Name filters are case-insensitive.
+      # Example: .example.com
+      # @option opts [String] :name.exact Exact value of the DNS record name. Name filters are case-insensitive.
+      # Example: www.example.com
+      # @option opts [String] :name.startswith Prefix of the DNS record name. Name filters are case-insensitive.
+      # Example: www.example
+      # @option opts [String] :order Field to order DNS records by.
+      # Allowed values: type, name, content, ttl, proxied
+      # Default: type
+      # Example: name
+      # @option opts [String] :page Page number of paginated results.
+      # >= 1
+      # Default: 1
+      # @option opts [Integer] :per_page Number of DNS records per page.
+      # >= 1
+      # <= 5000000
+      # Default: 100
+      # @option opts [String] :proxied Whether the record is receiving the performance and security benefits of Cloudflare.
+      # Default: false
+      # Example: true
+      # @option opts [String] :search Allows searching in multiple properties of a DNS record simultaneously. This parameter is intended for human users, not automation. Its exact behavior is intentionally left unspecified and is subject to change in the future. This parameter works independently of the match setting. For automated searches, please use the other available parameters.
+      # Example: www.cloudflare.com
+      # @option opts [String] :tag Name of a tag which must not be present on the DNS record. Tag filters are case-insensitive.
+      # Example: important
+      # @option opts [String] :tag.absent Name of a tag which must not be present on the DNS record. Tag filters are case-insensitive.
+      # Example: important
+      # @option opts [String] :tag.contains A tag and value, of the form <tag-name>:<tag-value>. The API will only return DNS records that have a tag named <tag-name> whose value contains <tag-value>. Tag filters are case-insensitive.
+      # Example: greeting:ello, world
+      # @option opts [String] :tag.endswith Name of a tag whose value must end with the given value. Tag filters are case-insensitive.
+      # Example: greeting:ello, world
+      # @option opts [String] :tag.exact Name of a tag whose value must exactly match the given value. Tag filters are case-insensitive.
+      # Example: greeting:ello, world
+      # @option opts [String] :tag.startswith Name of a tag whose value must start with the given value. Tag filters are case-insensitive.
+      # Example: greeting:ello, world
+      # @option opts [String] :type Type of the DNS record.
+      # Allowed values: A, AAAA, CAA, CERT, CNAME, DNSKEY, DS, HTTPS, LOC, MX, NAPTR, NS, OPENPGPKEY, PTR, SMIMEA, SRV, SSHFP, SVCB, TLSA, TXT, URI
+      # Default: A
+      # Example: A  
+      # @return [CloudParty::Responses::DNSRecords] DNS records response object
+      def list(zone, opts = {})
+        zone_id = DNSRecords.zone_id_by_name(zone)
+        
+        CloudParty::Responses::DNSRecords.new(:get, '/zones/:id/dns_records', self.class.get("/zones/#{zone_id}/dns_records", query: opts), @options)
+      end
+
+      def search(zone, query)
+        zone_id = DNSRecords.zone_id_by_name(zone)
         CloudParty::Responses::DNSRecords.new(:get, '/zones/:id/dns_records', self.class.get("/zones/#{zone_id}/dns_records", @options), @options)
       end
 
-      def get(id)
+      def get(zone, id)
+        zone_id = DNSRecords.zone_id_by_name(zone)
         CloudParty::Responses::DNSRecords.new(:get, '/zones/:id/dns_records', self.class.get("/zones/#{zone_id}/dns_records", @options), @options)
       end
 
@@ -82,19 +172,7 @@ module CloudParty
         options.merge!(ttl: ttl) unless ttl.nil?
         options.merge!(priority: priority) unless priority.nil?
         options.merge!(proxied: proxied) unless proxied.nil?
-        if zone
-          zone_options = {
-              match: 'all',
-              name: zone,
-              order: 'name'
-          }
-          zone_id = CloudParty::Responses::Zones.new(:get, '/zones', self.class.get('/zones', query: zone_options), @options).result.first.fetch(:id, nil)
-        elsif self.class.class_variable_defined?(:@@zone)
-          zone_id = @@zone
-        else
-          raise CloudParty::Errors::NoDefinedZoneError.new("neither the keyword 'zone:' nor the class variable @@zone ended up being defined.", nil)
-        end
-
+        zone_id = zone_id_by_name(zone)
         CloudParty::Responses::DNSRecords.new(
             :post,
             '/zones/:id/dns_records',
@@ -102,13 +180,21 @@ module CloudParty
             @options)
       end
       def rem(id, zone: nil)
-        zone_id = id_by_name(zone)
+        zone_id = zone_id_by_name(zone)
         CloudParty::Responses::DNSRecords.new(
             :delete,
             '/zones/:id/dns_records/:identifier',
             self.class.delete("/zones/#{zone_id}/dns_records/#{id}")
             )
       end
+      def update(id, type, name, content, opts, zone: nil)
+        zone_id = zone_id_by_name(zone)
+
+      end
+      
+      def batch(records, zone: nil)
+        zone_id = zone_id_by_name(zone)
+      end
     end
   end
 end

data/lib/cloud_party/responses/nodes/dns_records.rb

@@ -1,2 +1 @@
-require 'cloud_party/responses/nodes/dns_records/timing'
 require 'cloud_party/responses/nodes/dns_records/meta'

data/lib/cloud_party/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CloudParty
-  VERSION = '0.1.13'
+  VERSION = '0.1.14'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cloud_party
 version: !ruby/object:Gem::Version
-  version: 0.1.13
+  version: 0.1.14
 platform: ruby
 authors:
 - Ken Spencer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-12-10 00:00:00.000000000 Z
+date: 2024-12-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -208,6 +208,7 @@ files:
 - lib/cloud_party/exceptions/request_errors/unsupported_media_type_error.rb
 - lib/cloud_party/exceptions/un_recognized_endpoint_error.rb
 - lib/cloud_party/exceptions/un_recognized_result_type_error.rb
+- lib/cloud_party/helpers.rb
 - lib/cloud_party/nodes.rb
 - lib/cloud_party/nodes/accounts.rb
 - lib/cloud_party/nodes/dns_records.rb