assembla_api 0.1.2

data/lib/assembla_api/utils/url.rb

@@ -0,0 +1,59 @@
+require 'cgi'
+require 'addressable/uri'
+
+module Assembla
+  module Utils
+    module Url
+      extend self
+
+      DEFAULT_QUERY_SEP = /[&;] */n
+
+      KEY_VALUE_SEP = '='.freeze
+
+      def escape_uri(s) Addressable::URI.escape(s.to_s) end
+
+      def escape(s) CGI.escape(s.to_s) end
+
+      def unescape(s) CGI.unescape(s.to_s) end
+
+      def build_query(params)
+        params.map { |k, v|
+          if v.class == Array
+            build_query(v.map { |x| [k, x] })
+          else
+            v.nil? ? escape(k) : "#{escape(k)}=#{escape(v)}"
+          end
+        }.join("&")
+      end
+
+      def parse_query(query_string)
+        return '' if query_string.nil? || query_string.empty?
+        params = {}
+
+        query_string.split(DEFAULT_QUERY_SEP).each do |part|
+          k, v = part.split(KEY_VALUE_SEP, 2).map { |el| unescape(el) }
+
+          if cur = params[k]
+            if cur.class == Array
+              params[k] << v
+            else
+              params[k] = [cur, v]
+            end
+          else
+            params[k] = v
+          end
+        end
+        params
+      end
+
+      def parse_query_for_param(query_string, name)
+        parse_query(query_string).each do |key, val|
+          return val.first if (name == key) && val.is_a?(Array)
+          return val if (name == key)
+        end
+        return nil
+      end
+
+    end # Url
+  end # Utils
+end # Assembla

data/lib/assembla_api/validations.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+
+module Assembla
+  module Validations
+
+    Assembla::require_all 'assembla_api/validations',
+      'presence',
+      'token',
+      'format',
+      'required'
+
+    include Presence
+    include Format
+    include Token
+    include Required
+
+    VALID_API_KEYS = [
+      'page',
+      'per_page',
+      'auto_pagination',
+      'jsonp_callback'
+    ]
+
+  end # Validation
+end # Assembla

data/lib/assembla_api/validations/format.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+module Assembla
+  module Validations
+    module Format
+
+      # Ensures that value for a given key is of the correct form whether
+      # matching regular expression or set of predefined values.
+      #
+      def assert_valid_values(permitted, params)
+        params.each do |k, v|
+          next unless permitted.keys.include?(k)
+          if permitted[k].is_a?(Array) && !permitted[k].include?(params[k])
+            raise Assembla::Error::UnknownValue.new(k,v, permitted[k].join(', '))
+
+          elsif permitted[k].is_a?(Regexp) && !(permitted[k] =~ params[k])
+            raise Assembla::Error::UnknownValue.new(k,v, permitted[k])
+          end
+        end
+      end
+
+    end # Format
+  end # Validations
+end # Assembla

data/lib/assembla_api/validations/presence.rb

@@ -0,0 +1,30 @@
+# encoding: utf-8
+
+module Assembla
+  module Validations
+    # A mixin to help validate presence of non-empty values
+    module Presence
+
+      # Ensure that esential arguments are present before request is made.
+      #
+      # == Parameters
+      #  Hash/Array of arguments to be checked against nil and empty string
+      #
+      # == Example
+      #  assert_presence_of user: '...', repo: '...'
+      #  assert_presence_of user, repo
+      #
+      def assert_presence_of(*args)
+        hash = args.last.is_a?(::Hash) ? args.pop : {}
+
+        errors = hash.select { |key, val| val.to_s.empty? }
+        raise Assembla::Error::Validations.new(errors) unless errors.empty?
+
+        args.each do |arg|
+          raise ArgumentError, "parameter cannot be nil" if arg.nil?
+        end
+      end
+
+    end # Presence
+  end # Validations
+end # Assembla

data/lib/assembla_api/validations/required.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+module Assembla
+  module Validations
+    module Required
+
+      # Validate all keys present in a provided hash against required set,
+      # on mismatch raise Assembla::Error::RequiredParams
+      # Note that keys need to be in the same format i.e. symbols or strings,
+      # otherwise the comparison will fail.
+      #
+      def assert_required_keys(required, provided)
+        result = required.all? do |key|
+          provided.deep_key? key
+        end
+        if !result
+          raise Assembla::Error::RequiredParams.new(provided, required)
+        end
+        result
+      end
+
+    end # Required
+  end # Validations
+end # Assembla

data/lib/assembla_api/validations/token.rb

@@ -0,0 +1,41 @@
+# encoding: utf-8
+
+module Assembla
+  module Validations
+    module Token
+
+      TOKEN_REQUIRED = [
+        'get /user',
+        'get /user/emails',
+        'get /user/followers',
+        'get /user/following',
+        'get /user/keys',
+        'get /user/repos',
+        'patch /user',
+        'post /user/emails',
+        'post /user/keys',
+        'post /user/repos'
+      ]
+
+      TOKEN_REQUIRED_REGEXP = [
+        /repos\/.*\/.*\/comments/,
+      ]
+
+      # Ensures that required authentication token is present before
+      # request is sent.
+      #
+      def validates_token_for(method, path)
+        return true unless TOKEN_REQUIRED.grep("#{method} #{path}").empty?
+
+        token_required = false
+        TOKEN_REQUIRED_REGEXP.each do |regex|
+          if "#{method} #{path}" =~ regex
+            token_required = true
+          end
+        end
+        return token_required
+      end
+
+    end # Token
+  end # Validations
+end # Assembla

data/lib/assembla_api/version.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+
+module Assembla
+  module VERSION
+    MAJOR = 0
+    MINOR = 1
+    PATCH = 2
+    BUILD = nil
+
+    STRING = [MAJOR, MINOR, PATCH, BUILD].compact.join('.');
+  end
+end # Assembla

metadata

@@ -0,0 +1,347 @@
+--- !ruby/object:Gem::Specification
+name: assembla_api
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- Vitalie Lazu
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.7.5
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.7.5
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.16'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.16'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.3
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.3
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.3
+- !ruby/object:Gem::Dependency
+  name: descendants_tracker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.4
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: sshkey
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: git-ssh-wrapper
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: " Ruby client that supports all of the Assembla API methods. It's build
+  in a modular way, that is, you can either instantiate the whole api wrapper Assembla.new
+  or use parts of it e.i. Assembla::Client::Spaces.new if working solely with spaces
+  is your main concern. Intuitive query methods allow you easily call API endpoints. "
+email: vitalie.lazu@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- Rakefile
+- lib/assembla_api.rb
+- lib/assembla_api/api.rb
+- lib/assembla_api/api/actions.rb
+- lib/assembla_api/api/arguments.rb
+- lib/assembla_api/api/config.rb
+- lib/assembla_api/api/config/property.rb
+- lib/assembla_api/api/config/property_set.rb
+- lib/assembla_api/api/factory.rb
+- lib/assembla_api/authorization.rb
+- lib/assembla_api/client.rb
+- lib/assembla_api/client/activity.rb
+- lib/assembla_api/client/authorizations.rb
+- lib/assembla_api/client/authorizations/app.rb
+- lib/assembla_api/client/portfolio.rb
+- lib/assembla_api/client/portfolio/invitations.rb
+- lib/assembla_api/client/portfolio/spaces.rb
+- lib/assembla_api/client/portfolio/standup_reports.rb
+- lib/assembla_api/client/portfolio/tasks.rb
+- lib/assembla_api/client/portfolio/ticket_reports.rb
+- lib/assembla_api/client/portfolio/tickets.rb
+- lib/assembla_api/client/portfolio/users.rb
+- lib/assembla_api/client/spaces.rb
+- lib/assembla_api/client/spaces/documents.rb
+- lib/assembla_api/client/spaces/milestones.rb
+- lib/assembla_api/client/spaces/space_tools.rb
+- lib/assembla_api/client/spaces/space_tools/merge_requests.rb
+- lib/assembla_api/client/spaces/space_tools/merge_requests/versions.rb
+- lib/assembla_api/client/spaces/space_tools/merge_requests/versions/comments.rb
+- lib/assembla_api/client/spaces/space_tools/merge_requests/versions/votes.rb
+- lib/assembla_api/client/spaces/ssh.rb
+- lib/assembla_api/client/spaces/ssh/actions.rb
+- lib/assembla_api/client/spaces/ssh/actions/launches.rb
+- lib/assembla_api/client/spaces/ssh/keys.rb
+- lib/assembla_api/client/spaces/ssh/launches.rb
+- lib/assembla_api/client/spaces/ssh/servers.rb
+- lib/assembla_api/client/spaces/standup_away_reports.rb
+- lib/assembla_api/client/spaces/standup_reports.rb
+- lib/assembla_api/client/spaces/tags.rb
+- lib/assembla_api/client/spaces/tickets.rb
+- lib/assembla_api/client/spaces/tickets/associations.rb
+- lib/assembla_api/client/spaces/tickets/comments.rb
+- lib/assembla_api/client/spaces/tickets/custom_fields.rb
+- lib/assembla_api/client/spaces/tickets/statuses.rb
+- lib/assembla_api/client/spaces/user_roles.rb
+- lib/assembla_api/client/spaces/users.rb
+- lib/assembla_api/client/spaces/webhooks.rb
+- lib/assembla_api/client/spaces/wiki_pages.rb
+- lib/assembla_api/client/spaces/wiki_pages/versions.rb
+- lib/assembla_api/client/tasks.rb
+- lib/assembla_api/client/users.rb
+- lib/assembla_api/client/users/keys.rb
+- lib/assembla_api/configuration.rb
+- lib/assembla_api/connection.rb
+- lib/assembla_api/constants.rb
+- lib/assembla_api/core_ext/array.rb
+- lib/assembla_api/core_ext/hash.rb
+- lib/assembla_api/core_ext/ordered_hash.rb
+- lib/assembla_api/deprecation.rb
+- lib/assembla_api/error.rb
+- lib/assembla_api/error/bad_request.rb
+- lib/assembla_api/error/client_error.rb
+- lib/assembla_api/error/forbidden.rb
+- lib/assembla_api/error/internal_server_error.rb
+- lib/assembla_api/error/invalid_options.rb
+- lib/assembla_api/error/not_acceptable.rb
+- lib/assembla_api/error/not_found.rb
+- lib/assembla_api/error/required_params.rb
+- lib/assembla_api/error/service_error.rb
+- lib/assembla_api/error/service_unavailable.rb
+- lib/assembla_api/error/unauthorized.rb
+- lib/assembla_api/error/unknown_media.rb
+- lib/assembla_api/error/unknown_value.rb
+- lib/assembla_api/error/unprocessable_entity.rb
+- lib/assembla_api/error/validations.rb
+- lib/assembla_api/ext/faraday.rb
+- lib/assembla_api/jsonable.rb
+- lib/assembla_api/middleware.rb
+- lib/assembla_api/mime_type.rb
+- lib/assembla_api/normalizer.rb
+- lib/assembla_api/null_encoder.rb
+- lib/assembla_api/page_iterator.rb
+- lib/assembla_api/page_links.rb
+- lib/assembla_api/paged_request.rb
+- lib/assembla_api/pagination.rb
+- lib/assembla_api/parameter_filter.rb
+- lib/assembla_api/params_hash.rb
+- lib/assembla_api/rate_limit.rb
+- lib/assembla_api/request.rb
+- lib/assembla_api/request/basic_auth.rb
+- lib/assembla_api/request/jsonize.rb
+- lib/assembla_api/request/key_auth.rb
+- lib/assembla_api/request/oauth2.rb
+- lib/assembla_api/request/verbs.rb
+- lib/assembla_api/response.rb
+- lib/assembla_api/response/header.rb
+- lib/assembla_api/response/jsonize.rb
+- lib/assembla_api/response/mashify.rb
+- lib/assembla_api/response/raise_error.rb
+- lib/assembla_api/response/xmlize.rb
+- lib/assembla_api/response_wrapper.rb
+- lib/assembla_api/ssl_certs/cacerts.pem
+- lib/assembla_api/utils/url.rb
+- lib/assembla_api/validations.rb
+- lib/assembla_api/validations/format.rb
+- lib/assembla_api/validations/presence.rb
+- lib/assembla_api/validations/required.rb
+- lib/assembla_api/validations/token.rb
+- lib/assembla_api/version.rb
+homepage: http://www.assembla.com/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Ruby client for the official Assembla API
+test_files: []
+has_rdoc: