race_partner_registrations 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 829a089bdfa591b49c8ac0779fcec3e18317dd20
+  data.tar.gz: 3530b3c0562e2d8fcf72490b7f17755ea8950b1d
+SHA512:
+  metadata.gz: 090adc25ca86353750f9470cd47817c0d8243faa23a496e4d6927b60adc7935ca42fe5b882e71cf7c995197cb8e3a2cbc7ed28977700aff5a8021e8725c07256
+  data.tar.gz: 0715201e670f578c3314daeb606205fc3bc07173cbf2882376f77eda7347624b5961c8af0ae4d438118383ee5a8f0f77f9b4dc4b7e4288eb9aa460ef98bd2c86

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1,5 @@
+--require spec_helper
+--color true
+--format documentation
+
+--tag ~slow

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in race_partner_registrations.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Sean Devine
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,41 @@
+# Race Partner Registrations
+
+[Race Partner](http://www.racepartner.com) is a platform for registration, volunteer management, and marketing for road races and other endurance events.
+
+[racepartner.com](http://www.racepartner.com) enables users to browse the registrations for a given event.
+
+![Race Partner Entrance List Screen Shot](./assets/images/entrance_list.jpg?raw=true)
+
+`race_partner_registrations` enables you to extract these registration lists.
+
+## Usage
+
+The `name` and `location` are extracted from the entrance list.
+
+### Examples
+
+```bash
+$ gem install race_partner_registrations
+$ irb
+irb> require 'race_partner_registrations'
+irb> url = "https://register.racepartner.com/falmouthroadrace/entrants"
+irb> event = RacePartnerRegistrations::Event.new(url)
+```
+
+An event can be converted to a CSV.
+```
+irb> puts event.to_csv
+name,location
+Sean Devine,"Suffield, CT"
+```
+
+You can also download the registrations and iterate through them directly.
+
+```bash
+irb> event.download_registrations!
+irb> registration = event.registrations.first
+irb> registration.name
+=> "Sean Devine"
+irb> registration.location
+=> "Suffield, CT"
+```

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/exec/bundler

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'bundler' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('race_partner_registrations', 'bundler')

data/exec/htmldiff

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'htmldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('race_partner_registrations', 'htmldiff')

data/exec/ldiff

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'ldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('race_partner_registrations', 'ldiff')

data/exec/nokogiri

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'nokogiri' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('race_partner_registrations', 'nokogiri')

data/exec/rake

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('race_partner_registrations', 'rake')

data/exec/rspec

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rspec-core', 'rspec')

data/lib/race_partner_registrations.rb

@@ -0,0 +1,11 @@
+require "race_partner_registrations/version"
+
+require "mechanize"
+require "csv"
+
+require "race_partner_registrations/event"
+require "race_partner_registrations/registration"
+
+module RacePartnerRegistrations
+  # Your code goes here...
+end

data/lib/race_partner_registrations/event.rb

@@ -0,0 +1,76 @@
+module RacePartnerRegistrations
+  class Event
+    class InvalidUrlError < StandardError; end
+    class RegistrationsNotDownloadedError < StandardError; end
+
+    attr_reader :url
+
+    def initialize(url)
+      @url = url
+    end
+
+    def valid?
+      page.search("div#EntrantSearchForm").any?
+    end
+
+    def registrations
+      @registrations || raise(RegistrationsNotDownloadedError, "download_registrations! has not been sent to this event.")
+    end
+
+    def downloaded?
+      !!@registrations
+    end
+
+    def download_registrations!
+      raise InvalidUrlError unless valid?
+      @registrations = []
+      get_state_values(page).each do |state_value|
+        agent.get(single_page_url(state_value)).search("div#EntrantList tr").each do |row|
+          name_td, location_td = [0,1].collect { |n| row.search("td")[n] }
+          next unless name_td && location_td
+          @registrations << Registration.new(name_td.text.strip, location_td.text.strip)
+        end
+      end
+      @registrations
+    end
+
+    def to_csv
+      download_registrations! unless downloaded?
+      CSV.generate do |csv|
+        csv << ["name", "location"]
+        registrations.each do |registration|
+          csv << [:name, :location].collect { |attr| registration.send(attr) }
+        end
+      end
+    end
+
+  private
+
+    def page
+      @page ||= agent.get(url)
+    end
+
+    def agent
+      @agent = Mechanize.new
+    end
+
+    def get_form(page)
+      form_action = page.search("div#EntrantSearchForm form").first.attr("action")
+      page.form_with(action: form_action)
+    end
+
+    def get_state_values(page)
+      get_form(page).field_with(id: "state").options.collect do |state_option|
+        state_option.value
+      end.reject do |state_value|
+        state_value.length == 0
+      end
+    end
+
+    def single_page_url(state_value)
+      base_url = url.split("?")[0]
+      base_url + "?State=#{state_value}&PageSize=#{200_000_000}&PageIndex=1&Submitted=true"
+    end
+
+  end
+end

data/lib/race_partner_registrations/registration.rb

@@ -0,0 +1,11 @@
+module RacePartnerRegistrations
+  class Registration
+
+    attr_reader :name, :location
+
+    def initialize(name, location)
+      @name, @location = name, location
+    end
+
+  end
+end

data/lib/race_partner_registrations/version.rb

@@ -0,0 +1,3 @@
+module RacePartnerRegistrations
+  VERSION = "0.0.1"
+end

data/race_partner_registrations.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'race_partner_registrations/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "race_partner_registrations"
+  spec.version       = RacePartnerRegistrations::VERSION
+  spec.authors       = ["Sean Devine"]
+  spec.email         = ["barelyknown@icloud.com"]
+  spec.summary       = "Download registration list from a Race Partner event."
+  spec.description   = spec.summary
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.bindir = 'exec'
+  spec.test_files    = spec.files.grep(%r{^(spec)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0.0"
+
+  spec.add_dependency "mechanize", "~> 2.7.3"
+end

data/spec/lib/race_partner_registrations/event_spec.rb

@@ -0,0 +1,83 @@
+module RacePartnerRegistrations
+  describe Event do
+
+    subject do
+      described_class.new url
+    end
+
+    context "when initialized with a valid url" do
+      let :url do
+        "https://register.racepartner.com/falmouthroadrace/entrants"
+      end
+
+      it "sets and gets the url" do
+        expect(subject.url).to eq url
+      end
+
+      it "is valid" do
+        expect(subject).to be_valid
+      end
+
+      describe "#downloaded?" do
+        context "when the @registrations is not nil" do
+          before do
+            subject.instance_variable_set "@registrations", []
+          end
+          it "is downloaded" do
+            expect(subject).to be_downloaded
+          end
+        end
+        context "when the @registrations is nil" do
+          before do
+            subject.instance_variable_set "@registrations", nil
+          end
+          it "is not downloaded" do
+            expect(subject).to_not be_downloaded
+          end
+        end
+      end
+
+      describe "#download_registrations!" do
+        it "does not raise an exception", :slow do
+          expect{subject.download_registrations!}.to_not raise_error
+        end
+        it "sets the registrations", :slow do
+          subject.download_registrations!
+          expect(subject.registrations).to_not be_empty
+        end
+      end
+
+      describe "#to_csv" do
+        before do
+          allow(subject).to receive(:download_registrations!)
+          allow(subject).to receive(:registrations).and_return([Registration.new("Sean Devine", "Suffield, CT")])
+        end
+        it "generates the csv" do          expect(subject.to_csv).to eq "name,location\nSean Devine,\"Suffield, CT\"\n"
+        end
+      end
+    end
+
+    context "when initialized with an invalid url" do
+      let :url do
+        "https://register.racepartner.com/falmouthroadrace"
+      end
+
+      it "is not valid" do
+        expect(subject).to_not be_valid
+      end
+
+      describe "#download_registrations!" do
+        it "raises an exception" do
+          expect{subject.download_registrations!}.to raise_error Event::InvalidUrlError
+        end
+      end
+
+      describe "#registrations" do
+        it "raises an exception" do
+          expect{subject.registrations}.to raise_error Event::RegistrationsNotDownloadedError
+        end
+      end
+    end
+
+  end
+end

data/spec/lib/race_partner_registrations/registration_spec.rb

@@ -0,0 +1,31 @@
+module RacePartnerRegistrations
+  describe Registration do
+
+    let :name do
+      "Sean Devine"
+    end
+
+    let :location do
+      "Suffield, CT"
+    end
+
+    context "when initialized with the name and location" do
+      subject do
+        described_class.new name, location
+      end
+      it "sets and gets the name" do
+        expect(subject.name).to eq name
+      end
+      it "sets and get the location" do
+        expect(subject.location).to eq location
+      end
+    end
+
+    context "when initialized without a name and location" do
+      it "raises an ArgumentError" do
+        expect{described_class.new}.to raise_error ArgumentError
+      end
+    end
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require "race_partner_registrations"

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: race_partner_registrations
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Sean Devine
+autorequire: 
+bindir: exec
+cert_chain: []
+date: 2014-08-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: mechanize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.3
+description: Download registration list from a Race Partner event.
+email:
+- barelyknown@icloud.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- assets/images/entrance_list.jpg
+- exec/bundler
+- exec/htmldiff
+- exec/ldiff
+- exec/nokogiri
+- exec/rake
+- exec/rspec
+- lib/race_partner_registrations.rb
+- lib/race_partner_registrations/event.rb
+- lib/race_partner_registrations/registration.rb
+- lib/race_partner_registrations/version.rb
+- race_partner_registrations.gemspec
+- spec/lib/race_partner_registrations/event_spec.rb
+- spec/lib/race_partner_registrations/registration_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+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: Download registration list from a Race Partner event.
+test_files:
+- spec/lib/race_partner_registrations/event_spec.rb
+- spec/lib/race_partner_registrations/registration_spec.rb
+- spec/spec_helper.rb
+has_rdoc: