triton-ops 0.18.4.pre

data/lib/triton-ops/resource/server.rb

@@ -0,0 +1,188 @@
+
+# -*- ruby -*-
+
+require 'contracts' # BSD-2-Clause License
+
+require_relative '../support/feature/comparable_as_hash'
+require_relative '../support/feature/hash_from_initialization_contract'
+require_relative '../support/types'
+require_relative '../support/type_coercion'
+require_relative 'user'
+
+module TritonOps
+  module Resource
+    class Server
+      include ::Contracts::Core
+      include ::Contracts::Builtin
+      include ::TritonOps::Support::Feature::ComparableAsHash
+      include ::TritonOps::Support::Feature::HashFromInitializationContract
+      include ::TritonOps::Support::Types
+      include ::TritonOps::Support::TypeCoercion
+
+      Status             = Enum[*%(running)]
+      TransitionalStatus = Enum[""]
+      Console            = Enum[*%w(serial)]
+      SerialInterface    = Enum[*%w(ttya ttyb vga)]
+
+      Contract ({
+                  :boot_params          => HashOf[Or[String, Symbol], Any],
+                  :boot_platform        => String,
+                  :comments             => String,
+                  :created              => Castable::Time,
+                  :current_platform     => String,
+                  :datacenter           => String,
+                  :headnode             => Bool,
+                  :kernel_flags         => HashOf[Or[String, Symbol], Any],
+                  :last_boot            => Castable::Time,
+                  :overprovision_ratio  => Num,
+                  :rack_identifier      => String,
+                  :ram                  => Integer,
+                  :reservation_ratio    => Num,
+                  :reserved             => Bool,
+                  :reservoir            => Bool,
+                  :setup                => Bool,
+                  :status               => Status,
+                  :traits               => HashOf[Or[String, Symbol], Any],
+                  :transitional_status  => TransitionalStatus,
+                  :uuid                 => String,
+
+                  :boot_modules         => Maybe[ArrayOf[Any]],
+                  :default_console      => Maybe[Console],
+                  :serial               => Maybe[SerialInterface],
+                }) => Server
+      def initialize(**options)
+        @options = options
+        self.to_h
+        remove_instance_variable '@options'
+        self
+      end
+
+      #######################
+      # Required Properties #
+      #######################
+
+      Contract None => String
+      def datacenter
+        @datacenter ||= @options.fetch :datacenter
+      end
+
+      Contract None => Num
+      def overprovision_ratio
+        @overprovision_ratio ||= @options.fetch :overprovision_ratio
+      end
+
+      Contract None => Num
+      def reservation_ratio
+        @reservation_ratio ||= @options.fetch :reservation_ratio
+      end
+
+      Contract None => Bool
+      def reservoir
+        @reservoir ||= (@options || {}).fetch :reservoir, false
+      end
+
+      Contract None => HashOf[Symbol, Any]
+      def traits
+        @traits ||= @options.fetch(:traits).transform_keys(&:to_sym)
+      end
+
+      Contract None => String
+      def rack_identifier
+        @rack_identifier ||= @options.fetch :rack_identifier
+      end
+
+      Contract None => String
+      def comments
+        @comments ||= @options.fetch :comments
+      end
+
+      Contract None => String
+      def uuid
+        @uuid ||= @options.fetch :uuid
+      end
+
+      Contract None => Bool
+      def reserved
+        @reserved ||= (@options || {}).fetch :reserved, false
+      end
+
+      Contract None => String
+      def boot_platform
+        @boot_platform ||= @options.fetch :boot_platform
+      end
+
+      Contract None => HashOf[Symbol, Any]
+      def boot_params
+        @boot_params ||= @options.fetch(:boot_params).transform_keys(&:to_sym)
+      end
+
+      Contract None => HashOf[Symbol, Any]
+      def kernel_flags
+        @kernel_flags ||= @options.fetch(:kernel_flags).transform_keys(&:to_sym)
+      end
+
+      Contract None => Integer
+      def ram
+        @ram ||= @options.fetch :ram
+      end
+
+      Contract None => Status
+      def status
+        @status ||= @options.fetch :status
+      end
+
+      Contract None => Bool
+      def headnode
+        @headnode ||= (@options || {}).fetch :headnode, false
+      end
+
+      Contract None => String
+      def current_platform
+        @current_platform ||= @options.fetch :current_platform
+      end
+
+      Contract None => Bool
+      def setup
+        @setup ||= (@options || {}).fetch :setup, false
+      end
+
+      Contract None => Time
+      def last_boot
+        @last_boot ||= Coerce.to_time @options.fetch :last_boot
+      end
+
+      Contract None => Time
+      def created
+        @created ||= Coerce.to_time @options.fetch :created
+      end
+
+      Contract None => TransitionalStatus
+      def transitional_status
+        @transitional_status ||= @options.fetch :transitional_status
+      end
+
+      alias headnode? headnode
+      alias reserved? reserved
+      alias setup? setup
+
+      #######################
+      # Optional Properties #
+      #######################
+
+      Contract None => Maybe[ArrayOf[Any]]
+      def boot_modules
+        @boot_modules ||= (@options || {}).fetch :boot_modules, nil
+      end
+
+      Contract None => Maybe[String]
+      def default_console
+        @default_console ||= (@options || {}).fetch :default_console, nil
+      end
+
+      Contract None => Maybe[String]
+      def serial
+        @serial ||= (@options || {}).fetch :serial, nil
+      end
+    end
+  end
+end

data/lib/triton-ops/resource/user.rb

@@ -0,0 +1,206 @@
+
+# -*- ruby -*-
+
+require 'contracts' # BSD-2-Clause License
+require 'time'      # Ruby Standard Library
+
+require_relative '../support/feature/comparable_as_hash'
+require_relative '../support/feature/hash_from_initialization_contract'
+require_relative '../support/types'
+require_relative '../support/type_coercion'
+
+module TritonOps
+  module Resource
+    class User
+      include ::Contracts::Core
+      include ::Contracts::Builtin
+      include ::TritonOps::Support::Feature::ComparableAsHash
+      include ::TritonOps::Support::Feature::HashFromInitializationContract
+      include ::TritonOps::Support::Types
+      include ::TritonOps::Support::TypeCoercion
+
+      Contract ({
+                  :cn                        => String,
+                  :controls                  => ArrayOf[Any],
+                  :created_at                => Castable::Time,
+                  :dn                        => String,
+                  :email                     => String,
+                  :givenname                 => String,
+                  :login                     => String,
+                  :objectclass               => String,
+                  :pwdchangedtime            => Castable::Time,
+                  :pwdendtime                => Castable::Time,
+                  :sn                        => String,
+                  :updated_at                => Castable::Time,
+                  :uuid                      => String,
+                  :approved_for_provisioning => Maybe[Castable::Bool],
+                  :company                   => Maybe[String],
+                  :phone                     => Maybe[String],
+                  :pwdhistory                => Maybe[Or[String, ArrayOf[String]]],
+                  :registered_developer      => Maybe[Castable::Bool],
+                  :tenant                    => Maybe[String],
+                  :triton_cns_enabled        => Maybe[Castable::Bool],
+                }) => User
+      def initialize(**options)
+        @options = options
+        self.to_h
+        remove_instance_variable '@options'
+        self
+      end
+
+      Contract Any => Bool
+      def ==(other)
+        (other.respond_to?(:to_h) && (self.to_h == other.to_h)) || false
+      end
+
+      #######################
+      # Required Properties #
+      #######################
+
+      Contract None => String
+      def cn
+        @cn ||= @options.fetch(:cn)
+      end
+
+      Contract None => ArrayOf[Any]
+      def controls
+        @controls ||= @options.fetch(:controls)
+      end
+
+      Contract None => Time
+      def created_at
+        @created_at ||= Coerce.to_time @options.fetch :created_at
+      end
+
+      Contract None => String
+      def dn
+        @dn ||= @options.fetch(:dn)
+      end
+
+      Contract None => String
+      def email
+        @email ||= @options.fetch(:email)
+      end
+
+      Contract None => String
+      def givenname
+        @givenname ||= @options.fetch(:givenname)
+      end
+
+      Contract None => String
+      def login
+        @login ||= @options.fetch(:login)
+      end
+
+      Contract None => String
+      def objectclass
+        @objectclass ||= @options.fetch(:objectclass)
+      end
+
+      Contract None => Time
+      def pwdchangedtime
+        @password_changed_time ||= Coerce.to_time @options.fetch :pwdchangedtime
+      end
+
+      Contract None => Time
+      def pwdendtime
+        @password_end_time ||= Coerce.to_time @options.fetch :pwdendtime
+      end
+
+      Contract None => String
+      def sn
+        @sn ||= @options.fetch(:sn)
+      end
+
+      Contract None => Time
+      def updated_at
+        @updated_at ||= Coerce.to_time @options.fetch :updated_at
+      end
+
+      Contract None => String
+      def uuid
+        @uuid ||= @options.fetch(:uuid)
+      end
+
+      alias common_name cn
+      alias distinguished_name dn
+      alias given_name givenname
+      alias object_class objectclass
+      alias password_changed_time pwdchangedtime
+      alias password_last_changed pwdchangedtime
+      alias password_end_time pwdendtime
+
+      #######################
+      # Optional Properties #
+      #######################
+
+      Contract None => Maybe[Bool]
+      def approved_for_provisioning
+        @approved_for_provisioning ||= case (@options || {}).fetch(:approved_for_provisioning, nil)
+                                       when nil
+                                         nil
+                                       when 'true', true
+                                         true
+                                       when 'false', false
+                                         false
+                                       end
+      end
+
+      Contract None => Maybe[String]
+      def company
+        @company ||= (@options || {}).fetch(:company, nil)
+      end
+
+      Contract None => Maybe[String]
+      def phone
+        @phone ||= (@options || {}).fetch(:phone, nil)
+      end
+
+      Contract None => ArrayOf[String]
+      def pwdhistory
+        @password_history ||= case raw = @options.fetch(:pwdhistory, nil)
+                              when Array
+                                raw
+                              when String
+                                [raw]
+                              when nil
+                                []
+                              end
+      end
+
+      Contract None => Maybe[Bool]
+      def registered_developer
+        @registered_developer ||= case (@options || {}).fetch(:registered_developer, nil)
+                                  when nil
+                                    nil
+                                  when 'true', true
+                                    true
+                                  when 'false', false
+                                    false
+                                  end
+      end
+
+      Contract None => Maybe[String]
+      def tenant
+        @tenant ||= (@options || {}).fetch(:tenant, nil)
+      end
+
+      Contract None => Maybe[Bool]
+      def triton_cns_enabled
+        @triton_cns_enabled ||= case (@options || {}).fetch(:triton_cns_enabled, nil)
+                                when 'true'
+                                  true
+                                when 'false'
+                                  false
+                                end
+      end
+
+      alias approved_for_provisioning? approved_for_provisioning
+      alias cns_enabled triton_cns_enabled
+      alias cns_enabled? triton_cns_enabled
+      alias password_history pwdhistory
+      alias registered_developer? registered_developer
+      alias triton_cns_enabled? triton_cns_enabled
+    end
+  end
+end

data/lib/triton-ops/resource/virtual_machine.rb

@@ -0,0 +1,298 @@
+
+# -*- ruby -*-
+
+require 'contracts' # BSD-2-Clause License
+require 'date'      # Ruby Standard Library
+require 'time'      # Ruby Standard Library
+
+require_relative '../support/feature/comparable_as_hash'
+require_relative '../support/feature/hash_from_initialization_contract'
+require_relative '../support/type_coercion'
+require_relative '../support/types'
+require_relative 'virtual_machine/disk'
+require_relative 'virtual_machine/network_interface'
+
+module TritonOps
+  module Resource
+    class VirtualMachine
+      include ::Contracts::Core
+      include ::Contracts::Builtin
+      include ::TritonOps::Support::Feature::ComparableAsHash
+      include ::TritonOps::Support::Feature::HashFromInitializationContract
+      include ::TritonOps::Support::Types
+      include ::TritonOps::Support::TypeCoercion
+
+      Brand     = Enum[*%w(joyent joyent-minimal lx kvm)]
+      State     = Enum[*%w(configured down failed incomplete provisioning ready receiving running shutting_down stopped stopping)]
+      ZoneState = Enum[*%w(configured down incomplete installed ready running shutting_down)]
+      CPU       = Enum[*%w(qemu64 host)]
+      Type      = Enum[*%w(OS LX KVM)]
+
+      Contract ({
+                  :alias               => String,
+                  :billing_id          => String,
+                  :brand               => Brand,
+                  :cpu_shares          => Integer,
+                  :create_timestamp    => Castable::Time,
+                  :customer_metadata   => HashOf[Or[String, Symbol], Any],
+                  :datasets            => ArrayOf[Any],
+                  :internal_metadata   => HashOf[Or[String, Symbol], Any],
+                  :last_modified       => Castable::Time,
+                  :limit_priv          => Or[String, ArrayOf[String]],
+                  :max_locked_memory   => Integer,
+                  :max_lwps            => Integer,
+                  :max_physical_memory => Integer,
+                  :max_swap            => Integer,
+                  :nics                => ArrayOf[Or[HashOf[Or[String, Symbol], Any], NetworkInterface]],
+                  :owner_uuid          => String,
+                  :platform_buildstamp => Castable::Time,
+                  :quota               => Integer,
+                  :ram                 => Integer,
+                  :resolvers           => ArrayOf[String],
+                  :server_uuid         => String,
+                  :snapshots           => ArrayOf[Any],
+                  :state               => State,
+                  :tags                => HashOf[Or[String, Symbol], Any],
+                  :uuid                => String,
+                  :zfs_filesystem      => String,
+                  :zfs_io_priority     => Integer,
+                  :zone_state          => ZoneState,
+                  :zonepath            => String,
+                  :zpool               => String,
+
+                  :autoboot            => Maybe[Bool],
+                  :boot_timestamp      => Maybe[Castable::Time],
+                  :cpu_cap             => Maybe[Integer],
+                  :cpu_type            => Maybe[CPU],
+                  :destroyed           => Maybe[Bool],
+                  :disks               => Maybe[ArrayOf[Or[HashOf[Symbol, Any], Disk]]],
+                  :firewall_enabled    => Maybe[Bool],
+                  :pid                 => Maybe[Integer],
+                  :vcpus               => Maybe[Integer],
+                }) => VirtualMachine
+      def initialize(**options)
+        @options = options
+        self.to_h
+        remove_instance_variable '@options'
+        self
+      end
+
+      #######################
+      # Required Properties #
+      #######################
+
+      Contract None => String
+      def alias
+        @alias ||= @options.fetch :alias
+      end
+
+      Contract None => Brand
+      def brand
+        @brand ||= @options.fetch :brand
+      end
+
+      Contract None => String
+      def billing_id
+        @billing_id ||= @options.fetch :billing_id
+      end
+
+      Contract None => Integer
+      def cpu_shares
+        @cpu_shares ||= @options.fetch :cpu_shares
+      end
+
+      Contract None => Time
+      def create_timestamp
+        @create_timestamp ||= Coerce.to_time @options.fetch :create_timestamp
+      end
+
+      Contract None => HashOf[String, Any]
+      def customer_metadata
+        @customer_metadata ||= @options.fetch(:customer_metadata).transform_keys(&:to_s)
+      end
+
+      Contract None => Maybe[ArrayOf[Any]]
+      def datasets
+        @datasets ||= (@options || {}).fetch(:datasets, nil)
+      end
+
+      Contract None => HashOf[String, Any]
+      def internal_metadata
+        @internal_metadata ||= @options.fetch(:internal_metadata).transform_keys(&:to_s)
+      end
+
+      Contract None => Time
+      def last_modified
+        @last_modified ||= Coerce.to_time @options.fetch :last_modified
+      end
+
+      Contract None => ArrayOf[String]
+      def limit_priv
+        @limit_priv ||= case raw = @options.fetch(:limit_priv)
+                        when String
+                          raw.split(',')
+                        when Array
+                          raw
+                        end
+      end
+
+      Contract None => Integer
+      def max_locked_memory
+        @max_locked_memory ||= @options.fetch :max_locked_memory
+      end
+
+      Contract None => Integer
+      def max_lwps
+        @max_lwps ||= @options.fetch :max_lwps
+      end
+
+      Contract None => Integer
+      def max_physical_memory
+        @max_physical_memory ||= @options.fetch :max_physical_memory
+      end
+
+      Contract None => Integer
+      def max_swap
+        @max_swap ||= @options.fetch :max_swap
+      end
+
+      Contract None => ArrayOf[NetworkInterface]
+      def nics
+        @nics ||= @options.fetch(:nics).map { |nic| NetworkInterface.new nic.to_h }
+      end
+
+      Contract None => String
+      def owner_uuid
+        @owner_uuid ||= @options.fetch :owner_uuid
+      end
+
+      Contract None => Time
+      def platform_buildstamp
+        @platform_buildstamp ||= Coerce.to_time @options.fetch :platform_buildstamp
+      end
+
+      Contract None => Integer
+      def quota
+        @quota ||= @options.fetch :quota
+      end
+
+      Contract None => Integer
+      def ram
+        @ram ||= @options.fetch :ram
+      end
+
+      Contract None => ArrayOf[String]
+      def resolvers
+        @resolvers ||= @options.fetch :resolvers
+      end
+
+      Contract None => String
+      def server_uuid
+        @server_uuid ||= @options.fetch :server_uuid
+      end
+
+      Contract None => ArrayOf[Any]
+      def snapshots
+        @snapshots ||= @options.fetch :snapshots
+      end
+
+      Contract None => State
+      def state
+        @state ||= @options.fetch :state
+      end
+
+      Contract None => HashOf[Symbol, Any]
+      def tags
+        @tags ||= @options.fetch(:tags).transform_keys(&:to_sym)
+      end
+
+      Contract None => String
+      def uuid
+        @uuid ||= @options.fetch :uuid
+      end
+
+      Contract None => String
+      def zfs_filesystem
+        @zfs_filesystem ||= @options.fetch :zfs_filesystem
+      end
+
+      Contract None => Integer
+      def zfs_io_priority
+        @zfs_io_priority ||= @options.fetch :zfs_io_priority
+      end
+
+      Contract None => ZoneState
+      def zone_state
+        @zone_state ||= @options.fetch :zone_state
+      end
+
+      Contract None => String
+      def zonepath
+        @zonepath ||= @options.fetch :zonepath
+      end
+
+      Contract None => String
+      def zpool
+        @zpool ||= @options.fetch :zpool
+      end
+
+      #######################
+      # Optional Properties #
+      #######################
+
+      Contract None => Maybe[Bool]
+      def autoboot
+        @autoboot ||= (@options || {}).fetch(:autoboot, nil)
+      end
+
+      Contract None => Maybe[Time]
+      def boot_timestamp
+        @boot_timestamp ||= case raw = (@options || {}).fetch(:boot_timestamp, nil)
+                            when nil
+                              nil
+                            else
+                              Coerce.to_time raw
+                            end
+      end
+
+      Contract None => Maybe[Integer]
+      def cpu_cap
+        @cpu_cap ||= (@options || {}).fetch(:cpu_cap, nil)
+      end
+
+      Contract None => Maybe[CPU]
+      def cpu_type
+        @cpu_type ||= (@options || {}).fetch(:cpu_type, nil)
+      end
+
+      Contract None => Maybe[Bool]
+      def destroyed
+        @destroyed ||= (@options || {}).fetch(:destroyed, nil)
+      end
+
+      Contract None => Maybe[ArrayOf[Disk]]
+      def disks
+        @disks ||= @options.fetch(:disks, []).map { |disk| Disk.new disk.to_h }
+      end
+
+      Contract None => Maybe[Bool]
+      def firewall_enabled
+        @firewall_enabled ||= (@options || {}).fetch(:firewall_enabled, nil)
+      end
+
+      Contract None => Maybe[Integer]
+      def pid
+        @pid ||= (@options || {}).fetch(:pid, nil)
+      end
+
+      Contract None => Maybe[Integer]
+      def vcpus
+        @vcpus ||= (@options || {}).fetch(:vcpus, nil)
+      end
+
+      ###########
+      # SmartOS #
+      ###########
+    end
+  end
+end