asterisk-ari-client 0.0.1

data/lib/ari/generators/model.rb

@@ -0,0 +1,38 @@
+module Ari
+  module Generators
+    class Model
+
+      def initialize(klass_name, resource, specification)
+        @klass_name = klass_name
+        @resource = resource
+        @specification = specification
+      end
+
+      def name
+        klass_name.underscore
+      end
+
+      def klass_name
+        @klass_name
+      end
+
+      def description
+        @specification['description']
+      end
+
+      def properties
+        @properties ||= @specification['properties'].map { |name, options| Property.new(name, options) }
+      end
+
+      def sub_types
+        @specification['subTypes'] || []
+      end
+
+      def inherits_from
+        inherits_from_model = @resource.models.detect { |m| m.sub_types.include?(klass_name) }
+        inherits_from_model ? inherits_from_model.klass_name : 'Model'
+      end
+
+    end
+  end
+end

data/lib/ari/generators/operation.rb

@@ -0,0 +1,43 @@
+module Ari
+  module Generators
+    class Operation
+
+      def initialize(specification)
+        @specification = specification
+      end
+
+      def http_method
+        @specification['httpMethod']
+      end
+
+      def description
+        @specification['summary']
+      end
+
+      def method_name
+        @specification['nickname'].underscore
+      end
+
+      def original_method_name
+        @specification['nickname']
+      end
+
+      def return_klass
+        if @specification['responseClass'].start_with?('List[')
+          @specification['responseClass'][5..-2]
+        else
+          @specification['responseClass'] == 'void' ? nil : @specification['responseClass']
+        end
+      end
+
+      def returns_array?
+        @specification['responseClass'].start_with?('List[')
+      end
+
+      def parameters
+        @parameters ||= @specification['parameters'].map { |p| Parameter.new(p) } rescue []
+      end
+
+    end
+  end
+end

data/lib/ari/generators/parameter.rb

@@ -0,0 +1,35 @@
+module Ari
+  module Generators
+    class Parameter
+
+      def initialize(specification)
+        @specification = specification
+      end
+
+      def name
+        @specification['name']
+      end
+
+      def description
+        @specification['description']
+      end
+
+      def location
+        @specification['paramType']
+      end
+
+      def required?
+        @specification['required'] || location == 'path'
+      end
+
+      def multiple?
+        @specification['allowMultiple']
+      end
+
+      def type
+        @specification['dataType']
+      end
+
+    end
+  end
+end

data/lib/ari/generators/property.rb

@@ -0,0 +1,32 @@
+module Ari
+  module Generators
+    class Property
+
+      def initialize(name, specification)
+        @name = name
+        @specification = specification
+      end
+
+      def name
+        @name
+      end
+
+      def required?
+        @specification['required']
+      end
+
+      def type
+        if @specification['type'].start_with?('List[')
+          @specification['type'][5..-2]
+        else
+          @specification['type'] == 'void' ? nil : @specification['type']
+        end
+      end
+
+      def description
+        @specification['description']
+      end
+
+    end
+  end
+end

data/lib/ari/generators/resource_generator.rb

@@ -0,0 +1,94 @@
+require 'erb'
+require 'active_support'
+require 'active_support/core_ext'
+require 'ari/generators/api'
+require 'ari/generators/attribute'
+require 'ari/generators/model'
+require 'ari/generators/operation'
+require 'ari/generators/parameter'
+require 'ari/generators/property'
+
+module Ari
+  module Generators
+    class ResourceGenerator
+
+      def initialize(resource_name, specification, options = {})
+        @resource_name = resource_name.underscore
+        @klass_name = @resource_name.classify
+        @specification = specification
+        @options = options
+      end
+
+      def template_path(klass)
+        File.join(__dir__, 'templates', "#{klass}.rb.erb")
+      end
+
+      def destination_path(klass)
+        File.join(__dir__, '..', klass)
+      end
+
+      def generate_only_models?
+        @options.fetch(:only_models, false)
+      end
+
+      def generate
+        generate_resource
+        generate_models
+      end
+
+      def generate_resource
+        erb = ERB.new(IO.read(template_path('resource')), nil, '-')
+        File.open(File.join(destination_path('resources'), "#{resource_name}.rb"), 'w') do |f|
+          f.write erb.result(binding)
+        end
+      end
+
+      def generate_models
+        erb = ERB.new(IO.read(template_path('model')), nil, '-')
+        models.each do |model|
+          next if model.name == resource_name
+          File.open(File.join(destination_path('models'), "#{model.name}.rb"), 'w') do |f|
+            f.write erb.result(model.instance_eval { binding })
+          end
+        end
+      end
+
+      def klass_name
+        @klass_name
+      end
+
+      def resource_klass_name
+        options.fetch(:resource_klass_name, klass_name)
+      end
+
+      def resource_attributes
+        models.detect { |m| m.klass_name == klass_name }.properties rescue []
+      end
+
+      def resource_name
+        @resource_name.singularize
+      end
+
+      def resource_plural_name
+        @resource_name
+      end
+
+      def id_attribute_name
+        @options.fetch(:id_attribute_name, "#{klass_name.camelcase(:lower)}Id")
+      end
+
+      def apis
+        @apis ||= @specification['apis'].map { |api| Api.new(api) }
+      end
+
+      def models
+        @models ||= @specification['models'].map { |klass_name, options| Model.new(klass_name, self, options) }
+      end
+
+      def inherits_from
+        generate_only_models? ? 'Model' : 'Resource'
+      end
+
+    end
+  end
+end

data/lib/ari/generators/templates/model.rb.erb

@@ -0,0 +1,36 @@
+#------------------------------------------------------------------------------
+#
+#  WARNING !
+#
+#  This is a generated file. DO NOT EDIT THIS FILE! Your changes will
+#  be lost the next time this file is regenerated.
+#
+#  This file was generated using asterisk-ari-client ruby gem.
+#
+#------------------------------------------------------------------------------
+
+module Ari
+  class <%= klass_name %> < <%= inherits_from %>
+
+    <%- if properties.present? -%>
+    attr_reader <%= properties.map { |a| ":#{a.name}" }.join(', ') %>
+
+    <%- end -%>
+    <%- properties.each do |attribute| -%>
+    <%- unless %{ string int long boolean }.include?(attribute.type) -%>
+    <%- attribute_value = begin
+      if attribute.type == 'Date'
+        'Time.parse(val)'
+      else
+        attribute.type + '.new(val)'
+      end
+    end -%>
+    def <%= attribute.name %>=(val)
+      @<%= attribute.name %> ||= <%= attribute_value %>
+    end
+
+    <%- end -%>
+    <%- end -%>
+
+  end
+end

data/lib/ari/generators/templates/resource.rb.erb

@@ -0,0 +1,97 @@
+#------------------------------------------------------------------------------
+#
+#  WARNING !
+#
+#  This is a generated file. DO NOT EDIT THIS FILE! Your changes will
+#  be lost the next time this file is regenerated.
+#
+#  This file was generated using asterisk-ari-client ruby gem.
+#
+#------------------------------------------------------------------------------
+
+module Ari
+  class <%= klass_name %> < <%= inherits_from %>
+
+    <%- if resource_attributes.present? -%>
+    attr_reader <%= resource_attributes.map { |a| ":#{a.name}" }.join(', ') %>
+
+    <%- end -%>
+    <%- resource_attributes.each do |attribute| -%>
+    <%- unless %{ string int long boolean }.include?(attribute.type) -%>
+    <%- attribute_value = begin
+      if attribute.type == 'Date'
+        'Time.parse(val)'
+      else
+        attribute.type + '.new(val)'
+      end
+    end -%>
+    def <%= attribute.name %>=(val)
+      @<%= attribute.name %> ||= <%= attribute_value %>
+    end
+
+    <%- end -%>
+    <%- end -%>
+
+    <%- apis.each do |api| -%>
+    <%- api.operations.each do |operation| -%>
+    # <%= operation.http_method %> <%= api.path %>
+    #
+    # <%= api.description %>
+    #<% operation.description.scan(/.{80}/).each do |comment_line| %>
+    # <%= comment_line -%>
+    <%- end if operation.description %>
+    #
+    <%- if operation.parameters.present? -%>
+    # Parameters:
+    #
+    <%- operation.parameters.each do |parameter| -%>
+    # <%= parameter.name %> <%= '(required)' if parameter.required? %> - <%= parameter.description %>
+    <%- end -%>
+    #
+    <%- end -%>
+    def self.<%= operation.method_name %>(options = {})
+      <%- operation.parameters.each do |parameter| -%>
+      <%- next unless parameter.required? -%>
+      raise ArgumentError.new("Parameter <%= parameter.name %> must be passed in options hash.") unless options[:<%= parameter.name %>]
+      <%- end -%>
+      <%- if operation.parameters.any? { |p| p.location == 'path' } -%>
+      path = '<%= api.path %>' % options
+      <%- else -%>
+      path = '<%= api.path %>'
+      <%- end -%>
+      response = client(options).<%= operation.http_method.downcase %>(path, options)
+      <%- if operation.returns_array? -%>
+      <%- if operation.return_klass -%>
+      response.map { |hash| <%= operation.return_klass %>.new(hash.merge(client: options[:client])) }
+      <%- else -%>
+      response.map { |hash| <%= operation.return_klass %>.new(hash) }
+      <%- end -%>
+      <%- elsif operation.return_klass -%>
+      <%= operation.return_klass %>.new(response.merge(client: options[:client]))
+      <%- end -%>
+    <%- if operation.http_method == 'DELETE' -%>
+    rescue Ari::RequestError => e
+      raise unless e.code == '404'
+    <%- end -%>
+    end
+    <%- unless operation.method_name == operation.original_method_name -%>
+    class << self; alias_method :<%= operation.original_method_name %>, :<%= operation.method_name %>; end
+    <%- end -%>
+    <%- if operation.parameters.any? { |p| p.location == 'path' } -%>
+
+    def <%= operation.method_name %>(options = {})
+      self.class.<%= operation.method_name %>(options.merge(<%= id_attribute_name %>: self.id, client: @client))
+    end
+    <%- end -%>
+
+    <%- end -%>
+    <%- end unless generate_only_models? -%>
+
+  end
+end
+
+<%- unless generate_only_models? -%>
+Ari::Client.send :define_method, '<%= resource_plural_name %>' do
+  Ari::ListResource.new(self, Ari::<%= klass_name %>)
+end
+<%- end -%>

data/lib/ari/list_resource.rb

@@ -0,0 +1,23 @@
+module Ari
+  class ListResource
+
+    def initialize(client, resource_klass)
+      @client = client
+      @resource_klass = resource_klass
+    end
+
+    private
+
+    def method_missing(method, *args, &block)
+      if @resource_klass.respond_to? method
+        options = args.first
+        options ||= {}
+        options.merge!(client: @client)
+        @resource_klass.send(method, options, &block)
+      else
+        super
+      end
+    end
+
+  end
+end

data/lib/ari/model.rb

@@ -0,0 +1,26 @@
+require 'time'
+
+module Ari
+  class Model
+
+    def initialize(attributes)
+      if attributes
+        @client = attributes.delete(:client)
+        self.attributes = attributes
+      end
+    end
+
+    def attributes=(attributes)
+      attributes.each do |name, value|
+        setter = "#{name}="
+        if respond_to? setter
+          value.merge!(client: @client) if @client && value.is_a?(Hash)
+          __send__ setter, value
+        else
+          instance_variable_set "@#{name}", value
+        end
+      end
+    end
+
+  end
+end

data/lib/ari/models.rb

@@ -0,0 +1,47 @@
+require 'ari/models/build_info'
+require 'ari/models/system_info'
+require 'ari/models/set_id'
+require 'ari/models/config_info'
+require 'ari/models/status_info'
+require 'ari/models/asterisk_info'
+require 'ari/models/variable'
+require 'ari/models/dialed'
+require 'ari/models/dialplan_cep'
+require 'ari/models/caller_id'
+require 'ari/models/text_message_variable'
+require 'ari/models/text_message'
+require 'ari/models/message'
+require 'ari/models/missing_params'
+require 'ari/models/device_state_changed'
+require 'ari/models/playback_started'
+require 'ari/models/playback_finished'
+require 'ari/models/recording_started'
+require 'ari/models/recording_finished'
+require 'ari/models/recording_failed'
+require 'ari/models/application_replaced'
+require 'ari/models/bridge_created'
+require 'ari/models/bridge_destroyed'
+require 'ari/models/bridge_merged'
+require 'ari/models/bridge_blind_transfer'
+require 'ari/models/bridge_attended_transfer'
+require 'ari/models/channel_created'
+require 'ari/models/channel_destroyed'
+require 'ari/models/channel_entered_bridge'
+require 'ari/models/channel_left_bridge'
+require 'ari/models/channel_state_change'
+require 'ari/models/channel_dtmf_received'
+require 'ari/models/channel_dialplan'
+require 'ari/models/channel_caller_id'
+require 'ari/models/channel_userevent'
+require 'ari/models/channel_hangup_request'
+require 'ari/models/channel_varset'
+require 'ari/models/channel_talking_started'
+require 'ari/models/channel_talking_finished'
+require 'ari/models/endpoint_state_change'
+require 'ari/models/dial'
+require 'ari/models/stasis_end'
+require 'ari/models/stasis_start'
+require 'ari/models/text_message_received'
+require 'ari/models/stored_recording'
+require 'ari/models/live_recording'
+require 'ari/models/format_lang_pair'