meetup_client 0.0.5

data/README.md

@@ -0,0 +1,89 @@
+# The Meetup Ruby Gem
+
+A Ruby interface to the Meetup.com API.
+
+## Installation
+    gem install meetup_client
+
+## Quick Start Guide
+This gem is a simple and easy-to-use interface to the Meetup.com API.
+The methods you can call with the gem are:
+
+-categories
+
+-checkins
+
+-cities
+
+-events
+
+-members
+
+-messaging
+
+-photos
+
+-profiles
+
+-rsvps
+
+-streams
+
+The parameters for each request have to be passed with a hash (i.e. { category: '1', city: 'London', country: 'GB', status: 'upcoming'} ) 
+
+First, [get a Meetup API key][register].
+
+Then, create a new file config/initializers/meetup_client.rb, and put the following content in it:
+
+```ruby
+MeetupClient.configure do |config|
+  config.api_key = MEETUP_API_KEY
+end
+```
+
+[Have a look at the Meetup API website for details about the API] [check_api]
+
+[register]: http://www.meetup.com/meetup_api/key/ 
+[check_api]: http://www.meetup.com/meetup_api/
+
+## Usage Examples
+
+**To get events in London about Arts & Culture**
+
+```ruby
+    params = { category: '1',
+      city: 'London',
+      country: 'GB',
+      status: 'upcoming',
+      format: 'json',
+      page: '50'}
+    meetup_api = MeetupApi.new
+    @events = meetup_api.open_events(params)
+```
+Any response will be exactly what the Meetup API returns. In the case above, it will be a json containing 
+a list of events.
+
+## Supported Ruby Versions
+This library aims to support and is [tested against][travis] the following Ruby
+implementations:
+
+* Ruby 1.9.2
+* Ruby 1.9.3
+* Ruby 2.0.0
+
+If something doesn't work on one of these interpreters, it's a bug.
+
+This library may inadvertently work (or seem to work) on other Ruby
+implementations, however support will only be provided for the versions listed
+above.
+
+If you would like this library to support another Ruby version, you may
+volunteer to be a maintainer. Being a maintainer entails making sure all tests
+run and pass on that implementation. When something breaks on your
+implementation, you will be responsible for providing patches in a timely
+fashion. If critical issues for a particular implementation exist at the time
+of a major release, support for that Ruby version may be dropped.
+
+
+## Copyright
+Copyright (c) 2013 Cosimo Ranieri.

data/Rakefile

@@ -0,0 +1,7 @@
+#!/usr/bin/env rake
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+
+MeetupApiGem::Application.load_tasks

data/lib/api_callers/http_request.rb

@@ -0,0 +1,30 @@
+module ApiCallers
+  class HttpRequest
+    CHARSET = 'UTF-8'
+
+    def initialize(uri, method = 'get')
+      @in_uri = uri
+      @method = method
+    end
+
+    def make_request
+      uri = URI.parse(@in_uri)
+      http = Net::HTTP.new(uri.host, uri.port)
+      response = http.request(class_to_call.new(uri.request_uri, headers))
+      format_response(response.body)
+    end
+
+    def format_response(response_body); response_body; end;
+
+    private
+
+    def headers
+      { 'Accept-Charset' => CHARSET }
+    end
+
+    def class_to_call
+      "Net::HTTP::#{@method.capitalize}".constantize
+    end
+
+  end
+end

data/lib/api_callers/http_requester.rb

@@ -0,0 +1,13 @@
+require 'net/http'
+
+module ApiCallers
+  class HttpRequester
+    def initialize(requester)
+      @requester = requester
+    end
+
+    def execute_request
+      @requester.make_request
+    end
+  end
+end

data/lib/api_callers/json_request.rb

@@ -0,0 +1,15 @@
+require 'api_callers/http_request'
+
+module ApiCallers
+  class JsonRequest < HttpRequest
+    def format_response(response_body)
+      ActiveSupport::JSON.decode(clean_response_body(response_body))
+    end
+
+    private
+
+    def clean_response_body(response_body)
+      ActionController::Base.helpers.strip_tags(response_body.gsub('\"','').force_encoding(CHARSET))
+    end
+  end
+end

data/lib/meetup_api.rb

@@ -0,0 +1,22 @@
+require 'api_callers/json_request'
+require 'api_callers/http_requester'
+
+class MeetupApi
+  BASE_URL = 'http://api.meetup.com/2/'
+
+  def method_request(method, params)
+    json_request = ApiCallers::JsonRequest.new("#{BASE_URL}#{method}?#{query_string(params.merge( { key: MeetupClient.config.api_key } ))}")
+    requester = ApiCallers::HttpRequester.new(json_request)
+    requester.execute_request
+  end
+
+  def method_missing(method, *args, &block)
+    self.method_request(method, args[0])
+  end
+
+  private
+
+  def query_string(params)
+     params.map { |k,v| "#{k}=#{v}" }.join("&")
+  end
+end

data/lib/meetup_client.rb

@@ -0,0 +1,14 @@
+require 'meetup_client/configuration'
+require 'meetup_api'
+
+module MeetupClient
+  class << self
+    def configure(&block)
+      yield @config ||= ::MeetupClient::Configuration.new
+    end
+
+    def config
+      @config
+    end
+  end
+end

data/lib/meetup_client/configuration.rb

@@ -0,0 +1,5 @@
+module MeetupClient
+  class Configuration
+    attr_accessor :api_key
+  end
+end

data/lib/meetup_client/version.rb

@@ -0,0 +1,9 @@
+module MeetupClient
+  class Version
+    def to_s
+      '0.0.1'
+    end
+  end
+end
+
+

data/meetup_client.gemspec

@@ -0,0 +1,18 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |s|
+  s.name        = 'meetup_client'
+  s.date        = '2013-07-25'
+  s.summary     = "Easy way to access the Meetup.com API"
+  s.description = "Easy way to access the Meetup.com API"
+  s.authors     = ["Cosimo Ranieri"]
+  s.email       = 'co.ranieri@gmail.com'
+  s.files       = %w(README.md Rakefile meetup_client.gemspec)
+  s.files      += Dir.glob("lib/**/*.rb")
+  s.files      += Dir.glob("spec/**/*")
+  s.version     = '0.0.5'
+  s.homepage    = 'https://rubygems.org/gems/meetup_client' 
+  s.license     = 'MIT'
+end

data/spec/api_callers/http_request_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+require 'net/http'
+
+describe ::ApiCallers::HttpRequest do
+  subject { ::ApiCallers::HttpRequest.new('') }
+
+  describe "#headers" do
+    it "returns { 'Accept-Charset' => 'utf-8' }" do
+      expect(subject.send(:headers)).to eq({ 'Accept-Charset' => 'UTF-8' })
+    end
+  end
+
+  describe "#class_to_call" do
+    it "returns Net::HTTP::Get by default" do
+      expect(subject.send(:class_to_call)).to eq Net::HTTP::Get
+    end
+
+    it "returns the class to call based on the request method, whether it is 'get', 'post', or 'delete'" do
+      json_request = ::ApiCallers::JsonRequest.new('', 'post')
+      expect(json_request.send(:class_to_call)).to eq Net::HTTP::Post
+    end
+  end
+end

data/spec/api_callers/json_request_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+require 'net/http'
+
+describe ::ApiCallers::JsonRequest do
+  subject { ::ApiCallers::JsonRequest.new('') }
+
+  describe "#clean_response_body" do
+    let(:body_response) { 'I\'m the \"Best\"' }
+
+    it "removed \" from the passed text " do
+      expect(subject.send(:clean_response_body, body_response)).to eq 'I\'m the Best'
+    end
+
+    it "forces the encoding to utf-8" do
+      body_response.encode!('windows-1251')
+      expect(subject.send(:clean_response_body, body_response).encoding.to_s).to eq 'UTF-8'
+    end
+  end
+end

data/spec/meetup_api_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+
+describe MeetupApi do
+  describe "#query_string" do
+    subject { MeetupApi.new }
+    it "returns a valid query string" do
+      params = { category: '1',
+                 status: 'upcoming',
+                 time: '0,1m' }
+      expect(subject.send(:query_string, params)).to eq 'category=1&status=upcoming&time=0,1m'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,38 @@
+# This file is copied to spec/ when you run 'rails generate rspec:install'
+ENV["RAILS_ENV"] ||= 'test'
+require File.expand_path("../../config/environment", __FILE__)
+require 'rspec/rails'
+require 'rspec/autorun'
+
+# Requires supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f }
+
+RSpec.configure do |config|
+  # ## Mock Framework
+  #
+  # If you prefer to use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+
+  # Remove this line if you're not using ActiveRecord or ActiveRecord fixtures
+  config.fixture_path = "#{::Rails.root}/spec/fixtures"
+
+  # If you're not using ActiveRecord, or you'd prefer not to run each of your
+  # examples within a transaction, remove the following line or assign false
+  # instead of true.
+  config.use_transactional_fixtures = true
+
+  # If true, the base class of anonymous controllers will be inferred
+  # automatically. This will be the default behavior in future versions of
+  # rspec-rails.
+  config.infer_base_class_for_anonymous_controllers = false
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = "random"
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: meetup_client
+version: !ruby/object:Gem::Version
+  version: 0.0.5
+  prerelease: 
+platform: ruby
+authors:
+- Cosimo Ranieri
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-25 00:00:00.000000000 Z
+dependencies: []
+description: Easy way to access the Meetup.com API
+email: co.ranieri@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- meetup_client.gemspec
+- lib/api_callers/http_request.rb
+- lib/api_callers/http_requester.rb
+- lib/api_callers/json_request.rb
+- lib/meetup_api.rb
+- lib/meetup_client/configuration.rb
+- lib/meetup_client/version.rb
+- lib/meetup_client.rb
+- spec/api_callers/http_request_spec.rb
+- spec/api_callers/json_request_spec.rb
+- spec/meetup_api_spec.rb
+- spec/spec_helper.rb
+homepage: https://rubygems.org/gems/meetup_client
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Easy way to access the Meetup.com API
+test_files: []