angus 0.0.1 → 0.0.2

data/bin/angus

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+
+# resolve bin path, ignoring symlinks
+require 'pathname'
+bin_file = Pathname.new(__FILE__).realpath
+
+# add self to libpath
+$:.unshift File.expand_path('../../lib', bin_file)
+
+require 'angus/command'
+
+Angus::Command.start

data/lib/angus.rb

@@ -1,5 +1,7 @@
-require "angus/version"
+# Application external dependencies
+require 'json'
+require 'rack'
 
-module Angus
-  # Your code goes here...
-end
+require_relative 'angus/version'
+require_relative 'angus/utils'
+require_relative 'angus/base'

data/lib/angus/base.rb

@@ -0,0 +1,119 @@
+require 'json'
+require 'logger'
+
+require_relative 'resource_definition'
+require_relative 'request_handler'
+require_relative 'base_resource'
+require_relative 'responses'
+
+require_relative 'renders/base'
+require_relative 'marshallings/base'
+require_relative 'base_actions'
+
+require 'angus/sdoc'
+
+module Angus
+  class Base < RequestHandler
+    include BaseActions
+
+    FIRST_VERSION = '0.1'
+
+    def initialize
+      super
+
+      @resources_definitions = []
+      @version = FIRST_VERSION
+      @name = self.class.name.downcase
+      @configured  = false
+      @definitions = nil
+      @logger      = Logger.new(STDOUT)
+
+      configure!
+
+      register_base_routes
+      register_resources_routes
+    end
+
+    def register_resources_routes
+      @resources_definitions.each do |resource|
+        register_resource_routes(resource)
+      end
+    end
+
+    def configured?
+      @configured
+    end
+
+    # TODO ver que hacer
+    def configure
+    end
+
+    def configure!
+      raise 'Already configured' if configured?
+
+      # TODO ver como hacer configurable
+      @definitions = Angus::SDoc::DefinitionsReader.service_definition('definitions')
+
+      configure
+
+      @configured = true
+    end
+
+    def service_code_name
+      @definitions.code_name
+    end
+
+    def service_version
+      @definitions.version
+    end
+
+    def register(resource_name, options = {})
+      resource_definition = ResourceDefinition.new(resource_name, @definitions)
+
+      @resources_definitions << resource_definition
+    end
+
+    def base_path
+      "/#{service_code_name}"
+    end
+
+    def register_resource_routes(resource_definition)
+      resource_definition.operations.each do |operation|
+        method  = operation.method.to_sym
+        op_path = "#{api_path}#{operation.path}"
+
+        response_metadata = resource_definition.build_response_metadata(operation.response_elements)
+
+        router.on(method, op_path) do |env, params|
+          request = Rack::Request.new(env)
+          params  = Params.indifferent_params(params)
+
+          resource = resource_definition.resource_class.new(request, params)
+
+          begin
+            response = resource.send(operation.code_name)
+
+            response = {} unless response.is_a?(Hash)
+
+            messages = response.delete(:messages)
+
+            response = build_data_response(response, response_metadata, messages)
+
+            @response.write(response)
+          rescue Exception => error
+            status_code = get_error_status_code(error)
+            if status_code == Angus::Responses::HTTP_STATUS_CODE_INTERNAL_SERVER_ERROR
+              @logger.error("An exception occurs on #{resource.class.name}##{operation.code_name}")
+              @logger.error(error)
+            end
+            response = build_error_response(error)
+
+            @response.status = status_code
+            @response.write(response)
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/angus/base_actions.rb

@@ -0,0 +1,38 @@
+module Angus
+  module BaseActions
+
+    def discover_paths
+      {
+        'doc' => doc_path,
+        'api' => api_path
+      }
+    end
+
+    def register_base_routes
+      router.on(:get, '/') do
+        render discover_paths
+      end
+
+      router.on(:get, base_path) do
+        render discover_paths
+      end
+
+      router.on(:get, doc_path) do |env, params|
+        if params[:format] == 'json'
+          render(Angus::SDoc::JsonFormatter.format_service(@definitions), format: :json)
+        else
+          render(Angus::SDoc::HtmlFormatter.format_service(@definitions), format: :html)
+        end
+      end
+    end
+
+    def doc_path
+      "#{base_path}/doc/#{service_version}"
+    end
+
+    def api_path
+      "#{base_path}/api/#{service_version}"
+    end
+
+  end
+end

data/lib/angus/base_resource.rb

@@ -0,0 +1,14 @@
+require 'yaml'
+
+module Angus
+  class BaseResource
+
+    attr_reader :request, :params
+
+    def initialize(request, params)
+      @request = request
+      @params = params
+    end
+
+  end
+end

data/lib/angus/command.rb

@@ -0,0 +1,27 @@
+require 'erb'
+require 'thor'
+
+require_relative 'generator'
+
+module Angus
+  class Command < Thor
+
+    desc 'new [NAME]', 'Generate a new service'
+    def new(name)
+      generator.new_service(name)
+    end
+
+    desc 'resource [NAME]', 'Generate a new resource'
+    method_option :actions, aliases: '-a', type: :array, desc: 'Generate the given actions for the resource'
+    def resource(name)
+      generator.resource(name)
+    end
+
+    private
+
+    def generator
+      @generator ||= Angus::Generator.new
+    end
+
+  end
+end

data/lib/angus/generator.rb

@@ -0,0 +1,141 @@
+require 'erb'
+require 'thor'
+require 'thor/actions'
+
+module Angus
+  class Generator < Thor
+    include Thor::Actions
+
+    RESOURCES_DIR   = 'resources'
+    DEFINITIONS_DIR = 'definitions'
+    SERVICES_DIR    = 'services'
+
+    NEW_APP_DIRECTORIES = %W(#{DEFINITIONS_DIR} #{RESOURCES_DIR} #{SERVICES_DIR})
+
+    NEW_APP_FILES = %w(
+    Gemfile
+    config.ru.erb
+    services/service.rb.erb
+    definitions/messages.yml
+    definitions/representations.yml
+    definitions/service.yml.erb
+  )
+
+    FILE_MAPPINGS = {
+      'services/service.rb.erb' => -> command, app_name { File.join(SERVICES_DIR, "#{command.underscore(command.classify(app_name))}.rb") },
+      'resources/resource.rb.erb' => -> command, name { "#{command.underscore(command.classify(name))}.rb" },
+      'definitions/operations.yml.erb' => -> command, _ { File.join(command.resource_name, 'operations.yml') }
+    }
+
+    no_commands do
+      def new_service(name)
+        app_name(name)
+
+        empty_directory(app_name)
+
+        NEW_APP_DIRECTORIES.each do |directory|
+          empty_directory(File.join(app_name, directory))
+        end
+
+        NEW_APP_FILES.each do |file|
+          if is_erb?(file)
+            copy_erb_file(file, app_name)
+          else
+            copy_file(file, File.join(app_name, file))
+          end
+        end
+      end
+
+      def resource(name)
+        resource_name(name)
+        resource_actions(options[:actions])
+
+        empty_directory(RESOURCES_DIR)
+        empty_directory(DEFINITIONS_DIR)
+
+        copy_erb_file('resources/resource.rb.erb', resource_name, RESOURCES_DIR)
+        copy_erb_file('definitions/operations.yml.erb', resource_name, DEFINITIONS_DIR)
+        insert_into_services("    register :#{resource_name}\n")
+      end
+
+      def app_name(name = nil)
+        if name.nil?
+          @app_name
+        else
+          @app_name = name
+        end
+      end
+
+      def resource_name(name = nil)
+        if name.nil?
+          @resource_name
+        else
+          @resource_name = name
+        end
+      end
+
+      def resource_actions(actions = nil)
+        if actions.nil?
+          @resource_actions || []
+        else
+          @resource_actions = actions
+        end
+      end
+
+      def classify(string)
+        string.sub(/^[a-z\d]*/) { $&.capitalize }.gsub(/(?:_|(\/))([a-z\d]*)/i) { "#{$1}#{$2.capitalize}" }.gsub('/', '::')
+      end
+
+      def underscore(camel_cased_word)
+        word = camel_cased_word.to_s.dup
+        word.gsub!(/::/, '/')
+        word.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2')
+        word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
+        word.tr!('-', '_')
+        word.downcase!
+        word
+      end
+    end
+
+    private
+
+    def is_erb?(file)
+      file.end_with?('.erb')
+    end
+
+    def copy_erb_file(file, name, base_path = nil)
+      base_path = name if base_path.nil?
+
+      tmp_file = Tempfile.new(File.basename(file))
+
+      source = File.expand_path(find_in_source_paths(file.to_s))
+      content  = ERB.new(File.binread(source)).result(binding)
+
+      File.open(tmp_file.path, 'w') { |f| f << content }
+      tmp_file.close
+
+      copy_file(tmp_file.path, File.join(base_path, filename_resolver(file, name)))
+    end
+
+    def insert_into_services(content)
+      config = {}
+      config.merge!(:after => /def configure\n|def configure .*\n/)
+
+      file = Dir[File.join(Dir.pwd, SERVICES_DIR, '*.*')].first
+
+      insert_into_file(file, *([content] << config))
+    end
+
+    def filename_resolver(file, app_name)
+      if FILE_MAPPINGS[file].nil?
+        file.gsub('.erb', '')
+      else
+        FILE_MAPPINGS[file].call(self, app_name)
+      end
+    end
+
+  end
+end
+
+Angus::Generator.source_root(File.join(File.dirname(File.expand_path(__FILE__)), 'generator',
+                                       'templates'))

data/lib/angus/generator/templates/Gemfile

@@ -0,0 +1,5 @@
+source 'http://rubygems.org'
+
+gem 'rake'
+
+gem 'angus',  '~> 0.0'

data/lib/angus/generator/templates/config.ru.erb

@@ -0,0 +1,10 @@
+$: << (File.dirname(__FILE__))
+
+require 'bundler'
+
+Bundler.setup
+
+require 'angus'
+require 'services/<%= app_name %>'
+
+run <%= classify(name) %>.new

data/lib/angus/generator/templates/definitions/operations.yml.erb

@@ -0,0 +1,21 @@
+<% resource_actions.each do |action_name| %>
+<%= action_name%>:
+  name:
+  description: |
+
+  path:
+  method:
+  uri:
+    - element:
+      description:
+
+  response:
+    - element:
+      description:
+      required:
+      type:
+
+  messages:
+    - key:
+      description:
+<% end %>

data/lib/angus/generator/templates/definitions/service.yml.erb

@@ -0,0 +1,3 @@
+service:   '<%= classify(app_name) %>'
+code_name: '<%= app_name %>'
+version:   '0.1'

data/lib/angus/generator/templates/resources/resource.rb.erb

@@ -0,0 +1,6 @@
+class <%= classify(resource_name) %> < Angus::BaseResource
+<% resource_actions.each do |action_name| %>
+  def <%= action_name %>
+  end
+<% end %>
+end

data/lib/angus/generator/templates/services/service.rb.erb

@@ -0,0 +1,4 @@
+class <%= classify(app_name) %> < Angus::Base
+  def configure
+  end
+end

data/lib/angus/marshallings/base.rb

@@ -0,0 +1,2 @@
+require_relative 'marshalling'
+require_relative 'unmarshalling'