patreon 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 099dc7242a83f365e34627068869909c160a4ad8
-  data.tar.gz: 5a05a3f08d9dc9738771a470cab0fe25b2f7d2c9
+  metadata.gz: bee2755fa7bbe4c0dcb717fb13f8d5cf1b06cee5
+  data.tar.gz: d529a387ad7c3ed3db7827bdd22ac1a3a9bd8b15
 SHA512:
-  metadata.gz: 548b98fb4223e057bdec954107651b1fddf21fe100e430617c7bf4aa1d964471b02c67a58b0a90ec5d5c0019f92a8f270e7cff9b08db2aa30175177a29cdfb62
-  data.tar.gz: 0aa98b2f5aa6d7cb100cca8effb0aba6e5662b0e7de0145a2beb74518b0e972d50a0dd3846390a23973753189584d413af92d133dc96a22cd34c6cd5909f1687
+  metadata.gz: 0c6b2ea5492326a1488fe824053dd338b832abb052f0c1f61d3c57571a684c66348ce1d73c449bdd110bd00c40d5f98b4c5d19262c221efb05d165f65c5c3887
+  data.tar.gz: 777e1d8b36da247e966769486495f9d1b61590bc50a72450b91c879beb53652362c4c52ff6919b67c17bb0e90f48d0dbb986b36c3751d0f782c4e134e694272c

data/LICENSE

@@ -0,0 +1,191 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2015-2016 Patreon, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/NOTICE

@@ -0,0 +1,4 @@
+Patreon Integration for Ruby
+Copyright 2015-2016 Patreon, Inc.
+
+This product includes software developed at Patreon, Inc. (https://www.patreon.com/).

data/README.md

@@ -5,7 +5,7 @@ Get the gem from [RubyGems](https://rubygems.org/gems/patreon)
 
 Step 1. Get your client_id and client_secret
 ---
-Visit the [OAuth Documentation Page](patreon.com/oauth2/documentation)
+Visit the [OAuth Documentation Page](http://patreon.com/oauth2/documentation)
 while logged in as a Patreon creator to register your client.
 
 This will provide you with a `client_id` and a `client_secret`.
@@ -36,3 +36,25 @@ class OAuthController < ApplicationController
   end
 end
 ```
+
+Step 3. (Optional) Customize your usage
+---
+`Patreon::API` instances have four methods:
+* `fetch_user(includes=nil, fields=nil)`
+* `fetch_campaign(includes=nil, fields=nil)`
+* `fetch_campaign_and_patrons(includes=nil, fields=nil)`
+* `fetch_page_of_pledges(campaign_id, page_size, cursor=nil, includes=nil, fields=nil)`
+
+The `includes` and `fields` arguments to these methods specify
+the [related resources](http://jsonapi.org/format/#fetching-includes)
+and the [resource attributes](http://jsonapi.org/format/#fetching-sparse-fieldsets)
+you want returned by our API, as per the [JSON:API specification](http://jsonapi.org/).
+The lists of valid `includes` and `fields` arguments are provided on `Patreon::Schemas`.
+For instance, if you wanted to request the total amount a patron has ever paid to your campaign,
+which is not included by default, you could do:
+```ruby
+api_client = Patreon::API.new(patron_access_token)
+patron_response = api_client.fetch_user(nil, {
+  'pledge': Patreon::Schemas::Pledge.default_attributes + [Patreon::Schemas::Pledge::Attributes::TOTAL_HISTORICAL_AMOUNT_CENTS]
+})
+```

data/lib/patreon.rb

@@ -1,4 +1,7 @@
 $: << File.dirname(__FILE__)
 
+require 'patreon/utils/jsonapi/url_util'
+require 'patreon/utils/enum'
+require 'patreon/schemas'
 require 'patreon/oauth'
 require 'patreon/api'

data/lib/patreon/api.rb

@@ -8,27 +8,30 @@ module Patreon
       @access_token = access_token
     end
 
-    def fetch_user
-      get_json('current_user')
+    def fetch_user(includes=nil, fields=nil)
+      get_json(Utils::JSONAPI::URLUtil.build_url('current_user',includes,fields))
     end
 
-    def fetch_campaign_and_patrons()
-      get_json('current_user/campaigns?include=rewards,creator,goals,pledges')
+    def fetch_campaign(includes=nil, fields=nil)
+      get_json(Utils::JSONAPI::URLUtil.build_url('current_user/campaigns',includes,fields))
     end
 
-    def fetch_campaign()
-      get_json('current_user/campaigns?include=rewards,creator,goals')
+    def fetch_campaign_and_patrons(includes=nil, fields=nil)
+      includes ||= Schemas::Campaign.default_relationships + [Schemas::Campaign::Relationships::PLEDGES]
+      fetch_campaign(includes, fields)
     end
 
-    def fetch_page_of_pledges(campaign_id, page_size, cursor=nil)
-      url = "campaigns/#{campaign_id}/pledges?page%5Bcount%5D=#{CGI::escape(page_size.to_s)}"
+    def fetch_page_of_pledges(campaign_id, page_size, cursor=nil, includes=nil, fields=nil)
+      url = "campaigns/#{campaign_id}/pledges"
+      url += "?page%5Bcount%5D=#{CGI::escape(page_size.to_s)}"
       url += "&page%5Bcursor%5D=#{CGI::escape(cursor.to_s)}" if cursor
-      get_json(url)
+      get_json(Patreon::Utils::JSONAPI::URLUtil.build_url(url,includes,fields))
     end
 
     private
 
     def get_json(suffix)
+      print "getting suffix #{suffix}"
       url = URI.parse("https://api.patreon.com/oauth2/api/#{suffix}")
       req = Net::HTTP::Get.new(url.to_s)
       req['Authorization'] = "Bearer #{@access_token}"
@@ -36,4 +39,4 @@ module Patreon
       JSON.parse(res.body)
     end
   end
-end
+end

data/lib/patreon/schemas.rb

@@ -0,0 +1,7 @@
+$: << File.dirname(__FILE__)
+
+require 'schemas/campaign'
+require 'schemas/goal'
+require 'schemas/pledge'
+require 'schemas/reward'
+require 'schemas/user'

data/lib/patreon/schemas/campaign.rb

@@ -0,0 +1,83 @@
+module Patreon
+  module Schemas
+    module Campaign
+      class Attributes
+        include Utils::Enum
+
+        define :SUMMARY, 'summary'
+        define :CREATION_NAME, 'creation_name'
+        define :PAY_PER_NAME, 'pay_per_name'
+        define :ONE_LINER, 'one_liner'
+        define :MAIN_VIDEO_EMBED, 'main_video_embed'
+        define :MAIN_VIDEO_URL, 'main_video_url'
+        define :IMAGE_SMALL_URL, 'image_small_url'
+        define :IMAGE_URL, 'image_url'
+        define :THANKS_VIDEO_URL, 'thanks_video_url'
+        define :THANKS_EMBED, 'thanks_embed'
+        define :THANKS_MSG, 'thanks_msg'
+        define :IS_MONTHLY, 'is_monthly'
+        define :IS_NSFW, 'is_nsfw'
+        define :IS_CHARGED_IMMEDIATELY, 'is_charged_immediately'
+        define :IS_CHARGE_UPFRONT_ELIGIBLE, 'is_charge_upfront_eligible'
+        define :IS_PLURAL, 'is_plural'
+        define :CREATED_AT, 'created_at'
+        define :PUBLISHED_AT, 'published_at'
+        define :PLEDGE_URL, 'pledge_url'
+        define :PLEDGE_SUM, 'pledge_sum'
+        define :PATRON_COUNT, 'patron_count'
+        define :CREATION_COUNT, 'creation_count'
+        define :OUTSTANDING_PAYMENT_AMOUNT_CENTS, 'outstanding_payment_amount_cents'
+      end
+
+      class Relationships
+        include Utils::Enum
+
+        define :REWARDS, 'rewards'
+        define :CREATOR, 'creator'
+        define :GOALS, 'goals'
+        define :PLEDGES, 'pledges'
+        define :CURRENT_USER_PLEDGE, 'current_user_pledge'
+        define :POST_AGGREGATION, 'post_aggregation'
+        define :CATEGORIES, 'categories'
+        define :PREVIEW_TOKEN, 'preview_token'
+      end
+
+      class << self
+        def default_attributes
+          [
+            Attributes::SUMMARY,
+            Attributes::CREATION_NAME,
+            Attributes::PAY_PER_NAME,
+            Attributes::ONE_LINER,
+            Attributes::MAIN_VIDEO_EMBED,
+            Attributes::MAIN_VIDEO_URL,
+            Attributes::IMAGE_SMALL_URL,
+            Attributes::IMAGE_URL,
+            Attributes::THANKS_VIDEO_URL,
+            Attributes::THANKS_EMBED,
+            Attributes::THANKS_MSG,
+            Attributes::IS_MONTHLY,
+            Attributes::IS_NSFW,
+            Attributes::IS_CHARGED_IMMEDIATELY,
+            Attributes::IS_PLURAL,
+            Attributes::CREATED_AT,
+            Attributes::PUBLISHED_AT,
+            Attributes::PLEDGE_URL,
+            Attributes::PLEDGE_SUM,
+            Attributes::PATRON_COUNT,
+            Attributes::CREATION_COUNT,
+            Attributes::OUTSTANDING_PAYMENT_AMOUNT_CENTS,
+          ]
+        end
+
+        def default_relationships
+          [
+            Relationships::REWARDS,
+            Relationships::CREATOR,
+            Relationships::GOALS,
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/patreon/schemas/goal.rb

@@ -0,0 +1,35 @@
+module Patreon
+  module Schemas
+    module Goal
+      class Attributes
+        include Utils::Enum
+
+        define :AMOUNT_CENTS, 'amount_cents'
+        define :TITLE, 'title'
+        define :DESCRIPTION, 'description'
+        define :CREATED_AT, 'created_at'
+        define :REACHED_AT, 'reached_at'
+      end
+
+      class Relationships
+      end
+
+      class << self
+        def default_attributes
+          [
+            Attributes::AMOUNT_CENTS,
+            Attributes::TITLE,
+            Attributes::DESCRIPTION,
+            Attributes::CREATED_AT,
+            Attributes::REACHED_AT,
+          ]
+        end
+
+        def default_relationships
+          [
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/patreon/schemas/pledge.rb

@@ -0,0 +1,50 @@
+module Patreon
+  module Schemas
+    module Pledge
+      class Attributes
+        include Utils::Enum
+
+        define :AMOUNT_CENTS, 'amount_cents'
+        define :TOTAL_HISTORICAL_AMOUNT_CENTS, 'total_historical_amount_cents'
+        define :DECLINED_SINCE, 'declined_since'
+        define :CREATED_AT, 'created_at'
+        define :PLEDGE_CAP_CENTS, 'pledge_cap_cents'
+        define :PATRON_PAYS_FEES, 'patron_pays_fees'
+        define :UNREAD_COUNT, 'unread_count'
+      end
+
+      class Relationships
+        include Utils::Enum
+
+        define :PATRON, 'patron'
+        define :REWARD, 'reward'
+        define :CREATOR, 'creator'
+        define :ADDRESS, 'address'
+        define :CARD, 'card'
+        define :PLEDGE_VAT_LOCATION, 'pledge_vat_location'
+      end
+
+      class << self
+        def default_attributes
+          [
+            Attributes::AMOUNT_CENTS,
+            Attributes::DECLINED_SINCE,
+            Attributes::CREATED_AT,
+            Attributes::PLEDGE_CAP_CENTS,
+            Attributes::PATRON_PAYS_FEES,
+          ]
+        end
+
+        def default_relationships
+          [
+            Relationships::PATRON,
+            Relationships::REWARD,
+            Relationships::CREATOR,
+            Relationships::ADDRESS,
+            Relationships::PLEDGE_VAT_LOCATION,
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/patreon/schemas/reward.rb

@@ -0,0 +1,45 @@
+module Patreon
+  module Schemas
+    module Goal
+      class Attributes
+        include Utils::Enum
+
+        define :AMOUNT_CENTS, 'amount_cents'
+        define :USER_LIMIT, 'user_limit'
+        define :REMAINING, 'remaining'
+        define :DESCRIPTION, 'description'
+        define :REQUIRES_SHIPPING, 'requires_shipping'
+        define :CREATED_AT, 'created_at'
+        define :URL, 'url'
+        define :PATRON_COUNT, 'patron_count'
+      end
+
+      class Relationships
+        include Utils::Enum
+
+        define :CREATOR, 'creator'
+      end
+
+      class << self
+        def default_attributes
+          [
+            Attributes::AMOUNT_CENTS,
+            Attributes::USER_LIMIT,
+            Attributes::REMAINING,
+            Attributes::DESCRIPTION,
+            Attributes::REQUIRES_SHIPPING,
+            Attributes::CREATED_AT,
+            Attributes::URL,
+            Attributes::PATRON_COUNT,
+          ]
+        end
+
+        def default_relationships
+          [
+            Relationships::CREATOR
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/patreon/schemas/user.rb

@@ -0,0 +1,85 @@
+module Patreon
+  module Schemas
+    module User
+      class Attributes
+        include Utils::Enum
+
+        define :EMAIL, 'email'
+        define :FIRST_NAME, 'first_name'
+        define :LAST_NAME, 'last_name'
+        define :FULL_NAME, 'full_name'
+        define :GENDER, 'gender'
+        define :STATUS, 'status'
+        define :VANITY, 'vanity'
+        define :ABOUT, 'about'
+        define :FACEBOOK_ID, 'facebook_id'
+        define :IMAGE_URL, 'image_url'
+        define :THUMB_URL, 'thumb_url'
+        define :THUMBNAILS, 'thumbnails'
+        define :YOUTUBE, 'youtube'
+        define :TWITTER, 'twitter'
+        define :FACEBOOK, 'facebook'
+        define :TWITCH, 'twitch'
+        define :IS_SUSPENDED, 'is_suspended'
+        define :IS_DELETED, 'is_deleted'
+        define :IS_NUKED, 'is_nuked'
+        define :CREATED, 'created'
+        define :URL, 'url'
+        define :LIKE_COUNT, 'like_count'
+        define :COMMENT_COUNT, 'comment_count'
+        define :IS_CREATOR, 'is_creator'
+        define :HIDE_PLEDGES, 'hide_pledges'
+        define :TWO_FACTOR_ENABLED, 'two_factor_enabled'
+      end
+
+      class Relationships
+        include Utils::Enum
+
+        define :PLEDGES, 'pledges'
+        define :CARDS, 'cards'
+        define :FOLLOWS, 'follows'
+        define :CAMPAIGN, 'campaign'
+        define :PRESENCE, 'presence'
+        define :SESSION, 'session'
+        define :LOCATIONS, 'locations'
+        define :CURRENT_USER_FOLLOW, 'current_user_follow'
+        define :PLEDGE_TO_CURRENT_USER, 'pledge_to_current_user'
+      end
+
+      class << self
+        def default_attributes
+          [
+            Attributes::EMAIL,
+            Attributes::FIRST_NAME,
+            Attributes::LAST_NAME,
+            Attributes::FULL_NAME,
+            Attributes::GENDER,
+            Attributes::STATUS,
+            Attributes::VANITY,
+            Attributes::ABOUT,
+            Attributes::FACEBOOK_ID,
+            Attributes::IMAGE_URL,
+            Attributes::THUMB_URL,
+            Attributes::THUMBNAILS,
+            Attributes::YOUTUBE,
+            Attributes::TWITTER,
+            Attributes::FACEBOOK,
+            Attributes::TWITCH,
+            Attributes::IS_SUSPENDED,
+            Attributes::IS_DELETED,
+            Attributes::IS_NUKED,
+            Attributes::CREATED,
+            Attributes::URL,
+          ]
+        end
+
+        def default_relationships
+          [
+            Relationships::CAMPAIGN,
+            Relationships::PLEDGES,
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/patreon/utils/enum.rb

@@ -0,0 +1,53 @@
+# from http://code.dblock.org/2011/03/16/how-to-define-enums-in-ruby.html
+
+module Patreon
+  module Utils
+    module Enum
+      def initialize(key, value)
+        @key = key
+        @value = value
+      end
+
+      def key
+        @key
+      end
+
+      def value
+        @value
+      end
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      module ClassMethods
+        def define(key, value)
+          @hash ||= {}
+          @hash[key] = self.new(key, value)
+        end
+
+        def const_missing(key)
+          @hash[key].value
+        end
+
+        def each
+          @hash.each do |key, value|
+            yield key, value
+          end
+        end
+
+        def all
+          @hash.values
+        end
+
+        def all_to_hash
+          hash = {}
+          each do |key, value|
+            hash[key] = value.value
+          end
+          hash
+        end
+      end
+    end
+  end
+end

data/lib/patreon/utils/jsonapi/url_util.rb

@@ -0,0 +1,30 @@
+require 'uri'
+
+module Patreon
+  module Utils
+    module JSONAPI
+      class URLUtil
+        def self.build_url(path, includes=nil, fields=nil)
+          connector = path.include?('?') ? '&' : '?'
+          params = {}
+          if includes
+            params.merge!({ 'include' => joined_or_null(includes) })
+          end
+          if fields
+            params.merge!(fields.reduce({}) {|memo, type_attributes|
+              type, attributes = type_attributes
+              memo.merge({ "fields[#{type}]" => joined_or_null(attributes) })
+            })
+          end
+          return "#{path}#{connector}#{URI.encode_www_form(params)}"
+        end
+
+        private
+
+        def self.joined_or_null(list)
+          list.length == 0 ? "null" : list.join(',')
+        end
+      end
+    end
+  end
+end

data/patreon.gemspec

@@ -4,11 +4,11 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |gem|
   gem.name          = "patreon"
-  gem.version       = "0.1.0"
-  gem.authors       = ["David Kettler"]
+  gem.version       = "0.2.0"
+  gem.authors       = ["Patreon"]
   gem.email         = ["david@patreon.com"]
   gem.description   = "Interact with the Patreon API via OAuth"
-  gem.licenses      = ["MIT"]
+  gem.licenses      = ["Apache 2.0"]
   gem.summary       = "Visit patreon.com/oauth2/documentation for more information."
   gem.homepage      = "https://github.com/Patreon/patreon-ruby"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: patreon
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
-- David Kettler
+- Patreon
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-12-15 00:00:00.000000000 Z
+date: 2016-06-21 00:00:00.000000000 Z
 dependencies: []
 description: Interact with the Patreon API via OAuth
 email:
@@ -18,14 +18,24 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- LICENSE
+- NOTICE
 - README.md
 - lib/patreon.rb
 - lib/patreon/api.rb
 - lib/patreon/oauth.rb
+- lib/patreon/schemas.rb
+- lib/patreon/schemas/campaign.rb
+- lib/patreon/schemas/goal.rb
+- lib/patreon/schemas/pledge.rb
+- lib/patreon/schemas/reward.rb
+- lib/patreon/schemas/user.rb
+- lib/patreon/utils/enum.rb
+- lib/patreon/utils/jsonapi/url_util.rb
 - patreon.gemspec
 homepage: https://github.com/Patreon/patreon-ruby
 licenses:
-- MIT
+- Apache 2.0
 metadata: {}
 post_install_message: 
 rdoc_options: []