ruby_meetup2 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3b2259f6d227fabfd45a391f60fb921bfe5a9bfa
+  data.tar.gz: 261c71c7d833d3972848bea212a5e26dea6d6f24
+SHA512:
+  metadata.gz: ad17c9b2e18a6f64ffbecf3a0a714cfedf6bec7b97b44d871f4e07f3ae0a268d63e71559efa132aec2042d35c523ed9d03bd7962d54677f3605ed31b6994825f
+  data.tar.gz: 0c25063711c7a25582a059c58872f42d12c69ae1953394f92287bee6594e89102fcc4fdb1d315905891498ef94b7145f72025c0d70295b22ebd8f6212255adca

data/lib/api_key_client.rb

@@ -0,0 +1,57 @@
+module RubyMeetup
+
+# This class is typically used to read data without needing to first obtain a
+# user authenticated +access_token+. We just need a valid API Key, which any one
+# can obtain directly from http://www.meetup.com
+#
+# The API key can be configured globally like so,
+#
+#  > RubyMeetup::ApiKeyClient.key = 'abcd000000000000000wxyz'
+#
+# Then create a new client and make a request,
+#
+#  > client = RubyMeetup::ApiKeyClient.new
+#  > json_string = client.get_path("/2/groups", {:group_id => 390230})
+# 
+# The same client instance may be used to make multiple requests. Just supply a
+# different @path and/or @options parameters as required.
+#
+# ---
+# Copyright (c) 2013 Long On, released under the MIT license
+
+class ApiKeyClient < Client
+  @@key = ""
+
+  # == class methods
+
+  # Set the global API Key
+  def self.key=string
+    @@key = string
+  end
+
+  # == instance methods
+
+  # :nodoc:
+  def to_s
+    s = super
+    s << ", key=#{short_key}"
+  end
+
+
+  protected
+    # :nodoc:
+    def merge_params(options)
+      {:sign => true, :key => @@key}.merge!(options)
+    end
+
+    # :nodoc:
+    def short_key
+      key = @@key
+      return "" if key.nil? || key.empty?
+      key[0..3] + "..." + key[(key.length - 4)..(key.length - 1)]
+    end
+
+end
+
+end
+

data/lib/authenticated_client.rb

@@ -0,0 +1,93 @@
+module RubyMeetup
+
+# This class can be used to read and write data on behalf of an authenticated user.
+# An <b>OAuth 2</b> +access_token+ is given once user is authenticated. One of the
+# methods is to use the +ominauth-meetup+ gem.
+#
+# An +access_token+ is user-specific so we configure it per Client instance like so,
+#
+#  > client = RubyMeetup::AuthenticatedClient.new
+#  > client.access_token = user.access_token
+#
+# Then make a request,
+#
+#  > json_string = client.get_path("/2/groups", {:member_id => user.member_id})
+#
+# The same client instance may be used to make multiple requests. Just supply a
+# different @path and/or @options parameters as required.
+#
+# ---
+# Copyright (c) 2013 Long On, released under the MIT license
+
+class AuthenticatedClient < Client
+
+  attr_accessor :access_token
+
+  # == instance methods
+
+  # Make a POST API call with the current path value and @options.
+  # Return a JSON string if successful, otherwise an Exception
+  #   TODO - test AuthenticatedClient.post()
+  def post(options)
+    uri = new_uri
+    params = merge_params(options)
+    response = Net::HTTP.post_form(uri, params)
+    unless response.is_a?(Net::HTTPSuccess)
+      raise "#{response.code} #{response.message}\n#{response.body}"
+    end
+    response.body
+  end
+
+  # Fake a PUT API call since meetup.com only support POST method
+  #   TODO - test AuthenticatedClient.put()
+  def put(options)
+    post(options)
+  end
+
+  # Make a DELETE API call with the current path value and @options.
+  # Return true if successful, otherwise an Exception
+  #   TODO - test AuthenticatedClient.delete()
+  def delete(options={})
+    uri = new_uri
+    params = merge_params(options)
+    uri.query = URI.encode_www_form(params)
+
+    http = Net::HTTP.new(uri.host, uri.port)
+    request = Net::HTTP::Delete.new(uri) # uri or uri.request_uri?
+    response = http.request(request)
+    unless response.is_a?(Net::HTTPSuccess)
+      raise "#{response.code} #{response.message}\n#{response.body}"
+    end
+    true
+  end
+
+  # :nodoc:
+  def to_s
+    s = super
+    s << ", access_token=#{short_token}"
+  end
+
+
+  protected
+    # :nodoc:
+    def initialize
+      super
+      @access_token = ""
+    end
+
+    # :nodoc:
+    def merge_params(options)
+      {:access_token => access_token}.merge!(options)
+    end
+
+    # :nodoc:
+    def short_token
+      return "" if access_token.nil? || access_token.empty?
+      access_token[0..3] + "..." +
+        access_token[(access_token.length - 4)..(access_token.length - 1)]
+    end
+
+end
+
+end
+

data/lib/ruby_meetup.rb

@@ -0,0 +1,107 @@
+require 'net/http'
+#
+# RubyMeetup is a light-weight client for the Meetup.com API version 2.
+#
+# ---
+# Copyright (c) 2013 Long On, released under the MIT license
+
+module RubyMeetup
+
+# This class is abstract. It has accessor methods for configuring
+# the API site. By default it is set to https://api.meetup.com but may be changed
+# using the class setter method +site=+.
+#
+# The gem supports API request with two authentication strategies:
+# <b>API Key</b> and <b>OAuth 2</b> via the concrete classes *ApiKeyClient* and
+# *AuthenticatedClient*, respectively. More information can be found in the
+# specific class documentation.
+#
+# Example usage:
+#
+#  > require 'ruby_meetup'
+#  > RubyMeetup::ApiKeyClient.key = 'abcd000000000000000wxyz'
+#  > client = RubyMeetup::ApiKeyClient.new
+#  > json_string = client.get_path("/2/groups", {:group_id => 390230})
+#  > second_result = client.get({:group_id => 939203})
+#
+# If successful the captured response is a raw JSON string. The response can then
+# be processed using a JSON parser. Otherwise an exception is raised. 
+#
+# Typically, ApiKeyClient class is used to read data while the AuthenticatedClient
+# class is used for both read and write data, subject to Meetup API permission scopes.
+# 
+# ---
+# Copyright (c) 2013 Long On, released under the MIT license
+
+class Client
+  @@site = "https://api.meetup.com"
+
+  attr_accessor :path
+
+  # == class methods
+
+  # Retun the configured API endpoint
+  def self.site
+    @@site
+  end
+  # Set the global API endpoint
+  def self.site=string
+    @@site = string
+  end
+
+  # == instance methods
+
+  # A convenience method to set @path and @options in the same API call.
+  # Return a JSON string if successful, otherwise an Exception
+  def get_path(path, options={})
+    self.path = path
+    get(options)
+  end
+
+  # Make a GET API call with the current path value and @options.
+  # Return a JSON string if successful, otherwise an Exception
+  def get(options={})
+    uri = new_uri
+    params = merge_params(options)
+    uri.query = URI.encode_www_form(params)
+
+    Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
+      request = Net::HTTP::Get.new(uri)
+      response = http.request(request)
+      unless response.is_a?(Net::HTTPSuccess)
+        raise "#{response.code} #{response.message}\n#{response.body}"
+      end
+      return response.body
+    end
+  end
+
+  # :nodoc:
+  def to_s
+    "#{self.class.name}: site=#{@@site}, path=#{path}"
+  end
+
+
+  protected
+    # :nodoc:
+    def initialize
+      @path = ""
+    end
+
+    # :nodoc:
+    def new_uri
+      URI(@@site + path)
+    end
+
+    # :nodoc:
+    def merge_params(options={})
+      options
+    end
+
+end
+
+end
+# :nodoc:
+require 'authenticated_client'
+# :nodoc:
+require 'api_key_client'
+

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: ruby_meetup2
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Long On
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-02 00:00:00.000000000 Z
+dependencies: []
+description: A light-weight Ruby client for working with the Meetup API
+email: on.long.on@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ruby_meetup.rb
+- lib/api_key_client.rb
+- lib/authenticated_client.rb
+homepage: https://github.com/fun-ruby/ruby-meetup2
+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:
+- ruby net/http[s]
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Meetup API v2 Ruby client
+test_files: []