thecity 0.0.2

data/lib/the_city/content.rb

@@ -0,0 +1,29 @@
+require 'the_city/time'
+
+module TheCity
+  # Base class for The City content types: Topics, Events, Prayers, Needs, and Albums
+  #
+  # @!attribute [r] title
+  #   @return [String] The title of the post.
+  # @!attribute [r] body
+  #   @return [String] The body text of the post.
+  # @!attribute [r] id
+  #   @return [Integer] The id associated with the church account.
+  # @!attribute [r] group
+  #   @return [TheCity::Group] The group where the content originated.
+  # @!attribute [r] author
+  #   @return [TheCity::User] The user who posted the content.
+
+  class Content < TheCity::Base
+    include TheCity::Time
+    attr_reader :id, :title, :body
+    object_attr_reader :User, :user
+    object_attr_reader :Group, :group
+
+    # def user
+    #   @user
+    # end
+    alias author user
+    
+  end
+end

data/lib/the_city/error/argument_arror.rb

@@ -0,0 +1,8 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    class ArgumentError < ::ArgumentError
+    end
+  end
+end

data/lib/the_city/error/bad_gateway.rb

@@ -0,0 +1,10 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 502
+    class BadGateway < TheCity::Error
+      HTTP_STATUS_CODE = 502
+    end
+  end
+end

data/lib/the_city/error/bad_request.rb

@@ -0,0 +1,10 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 400
+    class BadRequest < TheCity::Error
+      HTTP_STATUS_CODE = 400
+    end
+  end
+end

data/lib/the_city/error/configuration_error.rb

@@ -0,0 +1,8 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    class ConfigurationError < ::ArgumentError
+    end
+  end
+end

data/lib/the_city/error/forbidden.rb

@@ -0,0 +1,10 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 403
+    class Forbidden < TheCity::Error
+      HTTP_STATUS_CODE = 403
+    end
+  end
+end

data/lib/the_city/error/gateway_timeout.rb

@@ -0,0 +1,10 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 504
+    class GatewayTimeout < TheCity::Error
+      HTTP_STATUS_CODE = 504
+    end
+  end
+end

data/lib/the_city/error/internal_server_error.rb

@@ -0,0 +1,10 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 500
+    class InternalServerError < TheCity::Error
+      HTTP_STATUS_CODE = 500
+    end
+  end
+end

data/lib/the_city/error/not_acceptable.rb

@@ -0,0 +1,10 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 406
+    class NotAcceptable < TheCity::Error
+      HTTP_STATUS_CODE = 406
+    end
+  end
+end

data/lib/the_city/error/not_found.rb

@@ -0,0 +1,10 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 404
+    class NotFound < TheCity::Error
+      HTTP_STATUS_CODE = 404
+    end
+  end
+end

data/lib/the_city/error/service_unavailable.rb

@@ -0,0 +1,10 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 503
+    class ServiceUnavailable < TheCity::Error
+      HTTP_STATUS_CODE = 503
+    end
+  end
+end

data/lib/the_city/error/too_many_requests.rb

@@ -0,0 +1,12 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 429
+    class TooManyRequests < TheCity::Error
+      HTTP_STATUS_CODE = 429
+    end
+    EnhanceYourCalm = TooManyRequests
+    RateLimited = TooManyRequests
+  end
+end

data/lib/the_city/error/unauthorized.rb

@@ -0,0 +1,10 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 401
+    class Unauthorized < TheCity::Error
+      HTTP_STATUS_CODE = 401
+    end
+  end
+end

data/lib/the_city/error/unprocessable_entity.rb

@@ -0,0 +1,10 @@
+require 'the_city/error'
+
+module TheCity
+  class Error
+    # Raised when The City returns the HTTP status code 422
+    class UnprocessableEntity < TheCity::Error
+      HTTP_STATUS_CODE = 422
+    end
+  end
+end

data/lib/the_city/error.rb

@@ -0,0 +1,66 @@
+require 'the_city/rate_limit'
+
+module TheCity
+  # Custom error class for rescuing from all The City API errors
+  class Error < StandardError
+    attr_reader :rate_limit, :wrapped_exception, :code
+
+    # Create a new error from an HTTP response
+    #
+    # @param response [Hash]
+    # @return [TheCity::Error]
+    def self.from_response(response={})
+      error, code = parse_error(response[:body])
+      new(error, response[:response_headers], code)
+    end
+
+    # @return [Hash]
+    def self.errors
+      @errors ||= descendants.inject({}) do |hash, klass|
+        hash[klass::HTTP_STATUS_CODE] = klass
+        hash
+      end
+    end
+
+    # @return [Array]
+    def self.descendants
+      @descendants ||= []
+    end
+
+    # @return [Array]
+    def self.inherited(descendant)
+      descendants << descendant
+    end
+
+    # Initializes a new Error object
+    #
+    # @param exception [Exception, String]
+    # @param response_headers [Hash]
+    # @param code [Integer]
+    # @return [TheCity::Error]
+    def initialize(exception=$!, response_headers={}, code=nil)
+      @rate_limit = TheCity::RateLimit.new(response_headers)
+      @wrapped_exception = exception
+      @code = code
+      exception.respond_to?(:message) ? super(exception.message) : super(exception.to_s)
+    end
+
+  private
+
+    def self.parse_error(body)
+      if body.nil?
+        ['', nil]
+      elsif body[:error]
+        [body[:error], nil]
+      elsif body[:errors]
+        first = Array(body[:errors]).first
+        if first.is_a?(Hash)
+          [first[:message].chomp, first[:code]]
+        else
+          [first.chomp, nil]
+        end
+      end
+    end
+
+  end
+end

data/lib/the_city/event.rb

@@ -0,0 +1,11 @@
+require 'the_city/content'
+
+module TheCity
+  
+  # class for content of type 'Event'
+  #
+  class Event < TheCity::Content
+  	attr_reader :timezone
+  end
+
+end

data/lib/the_city/group.rb

@@ -0,0 +1,6 @@
+module TheCity
+  class Group < TheCity::Base
+    attr_reader :name, :type, :id, :profile_picture, :role_title, :primary_campus
+
+  end
+end

data/lib/the_city/need.rb

@@ -0,0 +1,10 @@
+require 'the_city/content'
+
+module TheCity
+  
+  # class for content of type 'Need'
+  #
+  class Need < TheCity::Content
+  end
+
+end

data/lib/the_city/permissions.rb

@@ -0,0 +1,21 @@
+module TheCity
+  # The permissions associated with the current user
+  #
+  # @!attribute [r] can_list_in_plaza
+  #   @return [Boolean] The name of the church, 'Grace Church'.
+  # @!attribute [r] member
+  #   @return [Boolean] The subdomain used to access this account, subdomain.onthecity.org
+  # @!attribute [r] staff
+  #   @return [Boolean] The id associated with the church account
+  # @!attribute [r] admin
+  #   @return [Boolean] The id associated with the church account
+  # @!attribute [r] can_create_in_group_ids
+  #   @return [Hash] The id associated with the church account
+  # @!attribute [r] admin_privileges
+  #   @return [Array] An array of admin privileges the user has on the current account
+
+  class Permissions < TheCity::Base
+    attr_reader :can_list_in_plaza, :member, :staff, :admin, :can_create_in_group_ids, :admin_privileges
+
+  end
+end

data/lib/the_city/prayer.rb

@@ -0,0 +1,10 @@
+require 'the_city/content'
+
+module TheCity
+  
+  # class for content of type 'Prayer'
+  #
+  class Prayer < TheCity::Content
+  end
+
+end

data/lib/the_city/rate_limit.rb

@@ -0,0 +1,17 @@
+module TheCity
+  class RateLimit < TheCity::Base
+
+    # @return [Integer]
+    def limit
+      limit = @attrs['x-rate-limit-limit']
+      limit.to_i if limit
+    end
+
+    # @return [Integer]
+    def remaining
+      remaining = @attrs['x-rate-limit-remaining']
+      remaining.to_i if remaining
+    end
+
+  end
+end

data/lib/the_city/terminology.rb

@@ -0,0 +1,39 @@
+module TheCity
+	# The terminology overrides for a City account
+  #
+  # @!attribute [r] connect
+  #   @return [String] The name this account uses for Connect groups.
+  # @!attribute [r] campus
+  #   @return [String] The name this account uses for Campus groups.
+  # @!attribute [r] redemption
+  #   @return [String] The name this account uses for Redemption groups.
+  # @!attribute [r] seed
+  #   @return [String] The name this account uses for Seed groups.
+  # @!attribute [r] band
+  #   @return [String] The name this account uses for Band groups.
+  # @!attribute [r] other
+  #   @return [String] The name this account uses for Other groups.
+  # @!attribute [r] neighborhood
+  #   @return [String] The name this account uses for Neighborhood groups.
+  # @!attribute [r] network
+  #   @return [String] The name this account uses for Network groups.
+  # @!attribute [r] leader
+  #   @return [String] The name this account uses for Leader groups.
+  # @!attribute [r] community
+  #   @return [String] The name this account uses for Community groups.
+  # @!attribute [r] service
+  #   @return [String] The name this account uses for Service groups.
+  # @!attribute [r] church
+  #   @return [String] The name this account uses for the Church group.
+  # @!attribute [r] staff
+  #   @return [String] The label this account uses for 'Staff'.
+  # @!attribute [r] member
+  #   @return [String] The label this account uses for 'Member'.
+  # @!attribute [r] pledge
+  #   @return [String] The label this account uses for 'Pledge'.
+  class Terminology < TheCity::Base
+    attr_reader :connect, :campus, :redemption, :member, :seed,
+     :church, :service, :community, :staff, :pledge, :leader,
+     :neighborhood, :other, :network, :band
+  end
+end

data/lib/the_city/time.rb

@@ -0,0 +1,67 @@
+require 'time'
+#require 'tzinfo'
+#require 'tzinfo-data'
+
+module TheCity
+  module Time
+
+    # Time when the object was created
+    #
+    # @return [Time]
+    def created_at
+      @created_at ||= parse_or_at(@attrs[:created_at]) if @attrs[:created_at]
+    end
+
+    def created?
+      !!@attrs[:created_at]
+    end
+
+    # Time when the object was updated
+    #
+    # @return [Time]
+    def updated_at
+      @updated_at ||= parse_or_at(@attrs[:updated_at]) if @attrs[:updated_at]
+    end
+
+    def updated?
+      !!@attrs[:updated_at]
+    end
+
+    # Time when the object starts
+    #
+    # @return [Time]
+    def starting_at
+      @starting_at ||= parse_or_at(@attrs[:starting_at]) if @attrs[:starting_at]
+    end
+
+    def started?
+      !!@attrs[:starting_at] and starting_at <= Time.now
+    end
+
+    # Time when the object ends
+    #
+    # @return [Time]
+    def ending_at
+      @ending_at ||= parse_or_at(@attrs[:ending_at]) if @attrs[:ending_at]
+    end
+
+    def ended?
+      !!@attrs[:ending_at] and ending_at <= Time.now
+    end
+
+  private
+
+    def parse_or_at(time)
+      begin
+        if time.is_a? Integer
+          return Time.at(time).utc
+        else
+          return Time.parse(time).utc
+        end
+      rescue
+        return nil
+      end
+    end
+
+  end
+end

data/lib/the_city/token.rb

@@ -0,0 +1,16 @@
+require 'the_city/base'
+
+module TheCity
+  class Token < TheCity::Base
+    attr_reader :access_token, :token_type
+    alias to_s access_token
+
+    BEARER_TYPE = "bearer"
+
+    # @return [Boolean]
+    def bearer?
+      @attrs[:token_type] == BEARER_TYPE
+    end
+
+  end
+end

data/lib/the_city/topic.rb

@@ -0,0 +1,10 @@
+require 'the_city/content'
+
+module TheCity
+  
+  # class for content of type 'Topic'
+  #
+  class Topic < TheCity::Content
+  end
+
+end

data/lib/the_city/user.rb

@@ -0,0 +1,41 @@
+module TheCity
+  class User < TheCity::Base
+    extend Forwardable
+
+    attr_reader :id, :name, :profile_picture, :gender
+    attr_writer :permissions
+
+    def_delegators :@permissions, :member?, :staff?, :admin?
+
+    # Returns the groups that the user belongs to
+    #
+    # @return [Array<TheCity::Group>]
+    def groups
+      memoize(:groups) do
+        Array(@attrs[:groups]).map do |g|
+          TheCity::Group.new(g)
+        end
+      end
+    end
+
+    # Returns the permissions for the current user
+    #
+    # @return [TheCity::Permissions]
+    def permissions
+      @permissions ||= @client.permissions if (@client and @client.current_user.id == id)
+    end
+
+    # def member?
+    #   permissions.member? rescue false
+    # end
+
+    # def staff?
+    #   permissions.staff? rescue false
+    # end
+
+    # def admin?
+    #   permissions.admin? rescue false
+    # end
+
+  end
+end

data/lib/the_city/version.rb

@@ -0,0 +1,18 @@
+module TheCity
+  class Version
+    MAJOR = 0
+    MINOR = 0
+    PATCH = 2
+    PRE = nil
+
+    class << self
+
+      # @return [String]
+      def to_s
+        [MAJOR, MINOR, PATCH, PRE].compact.join('.')
+      end
+
+    end
+
+  end
+end

data/lib/the_city.rb

@@ -0,0 +1,15 @@
+require 'uri'
+
+require 'the_city/base'
+require 'the_city/api/client'
+
+require 'the_city/collection'
+require 'the_city/rate_limit'
+require 'the_city/terminology'
+require 'the_city/permissions'
+
+require 'the_city/account'
+require 'the_city/user'
+require 'the_city/group'
+require 'the_city/topic'
+

data/thecity.gemspec

@@ -0,0 +1,28 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'the_city/version'
+
+Gem::Specification.new do |spec|
+  spec.add_dependency 'faraday', ['>= 0.8', '< 0.10']
+  spec.add_dependency 'http', '~> 0.5.0'
+  spec.add_dependency 'http_parser.rb', '~> 0.5.3'
+  spec.add_dependency 'json', '~> 1.8'
+  #spec.add_dependency 'simple_oauth', '~> 0.2.0'
+  #spec.add_dependency 'tzinfo', '~> 1.0.1'
+  #spec.add_dependency 'tzinfo-data', "~> 1.2013.4"
+  spec.add_development_dependency 'bundler', '~> 1.0'
+  spec.authors = ["robertleib"]
+  spec.description = %q{A Ruby interface to The City API.}
+  spec.email = ["robert.leib@gmail.com"]
+  spec.files = %w(CHANGELOG.md LICENSE.md README.md Rakefile thecity.gemspec)
+  spec.files += Dir.glob("lib/**/*.rb")
+  spec.files += Dir.glob("spec/**/*")
+  spec.homepage = 'http://github.com/robertleib/thecity-ruby/'
+  spec.licenses = ['MIT']
+  spec.name = 'thecity'
+  spec.require_paths = ['lib']
+  spec.required_rubygems_version = '>= 1.3.5'
+  spec.summary = spec.description
+  spec.test_files = Dir.glob("spec/**/*")
+  spec.version = TheCity::Version
+end