dnscaster 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 649f52da69e201dba57be755d708abd98c6fdef359ec90521b744a946b9682c2
+  data.tar.gz: a021553142612c3f9fd600c297aef301ebcd8bc13cd07d97a7f9ee090210231c
+SHA512:
+  metadata.gz: 81bfef0008fd8c24354a9144d202277cfdf555a2a59eb6ea5b43902a33e64c4dbcbf715ddafa4951d7ac4c7ccc8e3c610da6c6d405715655c3b9161ef5bac968
+  data.tar.gz: e29d4b9a475f0a5d5ed8e1b3ced4ca3bdc420365747a3bbd8737cbfa11f2b9477f7da001a9ae52363e80342591eccfc3709afbeedcd9d018076d814883e94092

data/.gitignore

@@ -0,0 +1,14 @@
+*.gem
+.bundle
+.config
+coverage/
+doc/
+Gemfile.lock
+pkg/
+rdoc
+spec/reports/
+test/tmp
+test/version_tmp
+tmp/
+.yardoc
+_yardoc

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in dnscaster.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright 2022-2025 Notioneer, Inc.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,45 @@
+# DNScaster
+
+[DNScaster](https://dnscaster.com/) is a powerful, easy to use DNS service, with full suite of modern features, including near realtime updates, Geo-location, true ALIAS records, IP restrictions, target monitoring, and more.
+
+This gem works with both Rails and plain Ruby.
+
+
+
+## Usage
+
+To your Gemfile, add:
+
+    gem 'dnscaster'
+
+Then go create an API key (DNScaster -> Preferences -> API keys) and set this environment variable:
+
+    DNSCASTER_KEY = key_SAMPLE
+
+Alternatively, the API key may be configured programmatically. Be sure to store your key securely and not commit it with your code!
+
+    Dnscaster::Api.credentials = {
+      api_key: 'key_SAMPLE'
+    }
+
+
+
+## Reference
+
+For full details on the DNScaster API, see our [documentation](https://dnscaster.com/docs).
+
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/dnscaster.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dnscaster/api/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "dnscaster"
+  spec.version       = Dnscaster::VERSION
+  spec.authors       = ["DNScaster Team"]
+  spec.email         = ["hello@notioneer.com"]
+  spec.description   = %q{DNScaster client for Ruby.}
+  spec.summary       = %q{DNScaster client for Ruby}
+  spec.homepage      = "https://dnscaster.com/"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = '>= 2.7'
+
+  spec.add_dependency 'ncore', '>= 3.10', '< 4'
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+end

data/lib/dnscaster/api/api_config.rb

@@ -0,0 +1,36 @@
+module Dnscaster
+  include NCore::Builder
+
+  configure do
+    self.default_url = proc do
+      ENV['DNSCASTER_URL'] || 'https://api.dnscaster.com/v1/'
+    end
+
+    self.default_headers = {
+      accept: 'application/json',
+      content_type: 'application/json',
+      user_agent: "DNScaster/ruby v#{VERSION} [nc #{NCore::VERSION}]"
+    }
+
+    self.credentials = proc do
+      { api_key: ENV['DNSCASTER_KEY'] }
+    end
+
+    self.debug = false
+
+    self.strict_attributes = true
+
+    self.i18n_scope = :dnscaster
+
+    self.instrument_key = 'request.dnscaster'
+
+    self.status_page = 'http://status.notioneer.com/'
+
+    self.auth_header_prefix = 'dnscaster'
+
+    self.bearer_credential_key = :api_key
+
+    self.credentials_error_message = %Q{Missing API credentials. Set default credentials using env var "DNSCASTER_KEY" or "Dnscaster::Api.credentials = {api_key: YOUR_SECRET_KEY}"}
+
+  end
+end

data/lib/dnscaster/api/log_subscriber.rb

@@ -0,0 +1,10 @@
+require 'ncore/rails/log_subscriber'
+
+module Dnscaster
+  class LogSubscriber < ActiveSupport::LogSubscriber
+    include NCore::LogSubscriber
+    self.runtime_variable = 'dnscaster_runtime'
+  end
+end
+
+Dnscaster::LogSubscriber.attach_to :dnscaster

data/lib/dnscaster/api/railtie.rb

@@ -0,0 +1,28 @@
+module Dnscaster
+  class Railtie < Rails::Railtie
+
+    config.before_initialize do
+      config.action_dispatch.rescue_responses.merge!(
+        'Dnscaster::RecordInvalid'  => :unprocessable_entity, # 422
+        'Dnscaster::RecordNotFound' => :not_found, # 404
+      )
+    end
+
+    initializer "dnscaster.cache_store" do |app|
+      Dnscaster::Api.cache_store = Rails.cache
+    end
+
+    initializer "dnscaster.log_runtime" do |app|
+      require 'dnscaster/api/log_subscriber'
+      ActiveSupport.on_load(:action_controller) do
+        include NCore::ControllerRuntime
+        register_api_runtime Dnscaster::LogSubscriber, 'DNScaster'
+      end
+    end
+
+    initializer "dnscaster.logger" do |app|
+      Dnscaster::Api.logger = Rails.logger
+    end
+
+  end
+end

data/lib/dnscaster/api/version.rb

@@ -0,0 +1,3 @@
+module Dnscaster
+  VERSION = '0.2.0'
+end

data/lib/dnscaster/boundary.rb

@@ -0,0 +1,12 @@
+module Dnscaster
+  class Boundary < Resource
+    crud :all, :find, :create, :update, :delete
+
+    belongs_to :nameserver_set
+    has_many :hosts
+
+    attr :external_ref, :ips, :locations, :name
+    attr :in_use # readonly
+
+  end
+end

data/lib/dnscaster/domain_provider.rb

@@ -0,0 +1,10 @@
+module Dnscaster
+  class DomainProvider < Resource
+    crud :all, :find
+
+    attr :credential_state, :domains, :name, :provider_name, :provider_type
+    attr :in_use
+    attr_datetime :credential_state_at, :domains_updated_at
+
+  end
+end

data/lib/dnscaster/host.rb

@@ -0,0 +1,14 @@
+module Dnscaster
+  class Host < Resource
+    crud :all, :find, :create, :update, :delete
+
+    belongs_to :boundary
+    belongs_to :ip_monitor
+    belongs_to :zone
+
+    attr :data, :dns_type, :external_ref, :hostname, :priority, :state, :ttl
+    attr :notes
+    attr :effective_ttl, :fqdn, :fqdn_utf8, :hostname_utf8 # readonly
+
+  end
+end

data/lib/dnscaster/instance.rb

@@ -0,0 +1,10 @@
+module Dnscaster
+  class Instance < Resource
+
+    belongs_to :nameserver
+
+    attr :health, :ipv4, :ipv6, :region, :state
+    attr_datetime :health_at
+
+  end
+end

data/lib/dnscaster/ip_monitor.rb

@@ -0,0 +1,13 @@
+module Dnscaster
+  class IpMonitor < Resource
+    crud :all, :find, :create, :update, :delete
+
+    belongs_to :nameserver_set
+    has_many :hosts
+
+    attr :external_ref, :hostname, :name, :uri
+    attr :health, :in_use # readonly
+    attr_datetime :health_at
+
+  end
+end

data/lib/dnscaster/nameserver.rb

@@ -0,0 +1,11 @@
+module Dnscaster
+  class Nameserver < Resource
+    crud :all, :find, :create, :delete
+
+    belongs_to :nameserver_set
+
+    attr :region
+    attr :fqdn, :instances, :vanity_fqdns, :state # readonly
+
+  end
+end

data/lib/dnscaster/nameserver_set.rb

@@ -0,0 +1,15 @@
+module Dnscaster
+  class NameserverSet < Resource
+    crud :all, :find, :create, :update, :delete
+
+    has_many :boundaries
+    has_many :ip_monitors
+    has_many :nameservers
+    has_many :vanity_sets
+    has_many :zones
+
+    attr :external_ref, :hostmaster, :ip_ttl, :name, :ns_ttl
+    attr :in_use # readonly
+
+  end
+end

data/lib/dnscaster/region.rb

@@ -0,0 +1,8 @@
+module Dnscaster
+  class Region < Resource
+    crud :all
+
+    attr :name, :region, :state
+
+  end
+end

data/lib/dnscaster/vanity_set.rb

@@ -0,0 +1,14 @@
+module Dnscaster
+  class VanitySet < Resource
+    crud :all, :find, :create, :update, :delete
+
+    belongs_to :nameserver_set
+    belongs_to :vanity_zone
+    has_many :zones
+
+    attr :default_set, :external_ref, :pattern
+    attr :in_use, :name, :vanity_domain # readonly
+
+
+  end
+end

data/lib/dnscaster/zone.rb

@@ -0,0 +1,25 @@
+module Dnscaster
+  class Zone < Resource
+    crud :all, :find, :create, :update, :delete
+
+    belongs_to :domain_provider
+    belongs_to :nameserver_set
+    belongs_to :vanity_set
+    has_many :hosts
+
+    attr :default_ttl, :domain, :external_ref, :nx_ttl, :tags
+    attr :delegation_updates, :glue_updates
+    attr :notes
+    attr :delegation_errors, :domain_utf8, :glue_errors, :in_use, :synced # readonly
+    attr_datetime :live_checked_at
+
+
+    def check(attribs={})
+      params = parse_request_params(attribs, json_root: json_root).reverse_merge credentials: api_creds
+      parsed, _ = request(:post, resource_path+'/check', params)
+      load(parsed)
+      errors.empty? ? self : false
+    end
+
+  end
+end

data/lib/dnscaster.rb

@@ -0,0 +1,22 @@
+require 'ncore'
+
+%w(version api_config).each do |f|
+  require "dnscaster/api/#{f}"
+end
+
+%w(
+  boundary
+  domain_provider
+  host
+  instance
+  ip_monitor
+  nameserver
+  nameserver_set
+  region
+  vanity_set
+  zone
+).each do |f|
+  require "dnscaster/#{f}"
+end
+
+require 'dnscaster/api/railtie' if defined?(Rails)

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: dnscaster
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- DNScaster Team
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ncore
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.10'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.10'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: DNScaster client for Ruby.
+email:
+- hello@notioneer.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- dnscaster.gemspec
+- lib/dnscaster.rb
+- lib/dnscaster/api/api_config.rb
+- lib/dnscaster/api/log_subscriber.rb
+- lib/dnscaster/api/railtie.rb
+- lib/dnscaster/api/version.rb
+- lib/dnscaster/boundary.rb
+- lib/dnscaster/domain_provider.rb
+- lib/dnscaster/host.rb
+- lib/dnscaster/instance.rb
+- lib/dnscaster/ip_monitor.rb
+- lib/dnscaster/nameserver.rb
+- lib/dnscaster/nameserver_set.rb
+- lib/dnscaster/region.rb
+- lib/dnscaster/vanity_set.rb
+- lib/dnscaster/zone.rb
+homepage: https://dnscaster.com/
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: DNScaster client for Ruby
+test_files: []