pennride 0.1

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+api/
+local

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Matt Parmett
+
+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,86 @@
+# pennride: A humble ruby gem hoping to make sense of Penn Transit #
+
+There are cool new Penn Transit buses, but not a single Penn student **ever** uses them.  This must piss *someone* in the administration off, right?
+
+Well, maybe more students would hop on a bus if they knew:
+
+* **where** the buses stopped (some routes go to Rittenhouse -- this means free transport to Center City)
+* **when** the buses are expected to arrive at each stop
+
+There is an obscure [PennRide website](http://pennrides.com) that has live schedule and map data for buses, but I don't think anybody knows it exists.
+
+pennride provides you with an easy way to access arrival times by route and stop.  Read on to learn how to use the gem.
+
+## Installation ##
+
+pennride is hosted on rubygems, so run
+
+```gem install pennride```
+
+to install.
+
+Alternatively, include ```gem 'pennride'``` in your gemfile and run ```bundle install```.
+
+## How to use pennride ##
+
+pennride emulates the PennRide bus system through a hierarchy consisting of Routes and Stops.
+
+### Routes ###
+
+Routes are individual bus lines within the PennRide system.  There are 5 routes:
+
+* East Shuttle Route
+* PennBUS East
+* PennBUS West
+* West Shuttle Route A
+* West Shuttle Route B
+
+Each Route contains several Stops, and Routes may have any number of Stops.
+
+#### List all Routes ####
+
+```ruby
+require 'pennride'
+pennride = PennRide.new
+p pennride.routes```
+
+#### Get all Stops for a certain Route ####
+
+```ruby
+require 'pennride'
+pennride = PennRide.new
+routes = pennride.routes
+route = routes.first # East Shuttle Route
+stops = route.stops```
+
+### Stops ###
+
+*Note: Because PennRide is not in operation as of this gem's writing, there is no way for me to test the arrival time function.  The gem and docs will be updated when the schedule information becomes available.*
+
+Stops are, logically, individual bus stops on a given Route.  A Stop's `arrival_time` attribute is an array of Strings, each representing the expected arrival time of the next shuttle.  For example, `arrival_time[0]` would give you the arrival time of the next bus, `arrival_time[1]` the next, and so on.
+
+#### Get the arrival times of a Stop ####
+
+```ruby
+require 'pennride'
+pennride = PennRide.new
+routes = pennride.routes
+route = routes.first # East Shuttle Route
+stops = route.stops
+stop = route.stops.first
+p stop.arrival_times```
+
+## Web API ##
+
+*I plan to make the PennRide information available through a RESTful JSON web API.  When the API is available, this section will be updated with the information needed to access the API.*
+
+## Contributing ##
+
+If you find any bugs or have feature ideas, feel free to fork and send me a pull request.
+
+## License ##
+
+MIT License (see `./LICENSE`), which means you can take this code and do whatever you'd like with it.  If you do make use of the source code or the gem, I ask that you do two things:
+
+1.  Give me/this project a hat tip
+2.  Send me the link to your project, so I can feature it on this page

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/pennride.rb

@@ -0,0 +1,21 @@
+require 'wombat'
+Dir[File.dirname(__FILE__) + "/pennride/*.rb"].each { |file| require file }
+
+ROOT = 'http://pennrides.com'
+
+class PennRide
+  attr_accessor :routes
+
+  # Returns array of instantiated Routes
+  def initialize(root = ROOT)
+    @root = root
+    @routes = Wombat.crawl {
+      base_url ROOT
+      path '/simple/routes'
+      routes "xpath=//li[@class='arrow']", :iterator do
+        name "xpath=./a/text()"
+        href "xpath=./a/@href"
+      end
+    }['routes'].map { |r| Route.new(r['name'], r['href']) }
+  end
+end

data/lib/pennride/route.rb

@@ -0,0 +1,21 @@
+class Route
+  attr_accessor :id, :link, :name
+
+  def initialize(name, link)
+    @name, @link = name, link.gsub('direction', 'stops')
+    @id = @link.split("/")[-2]
+  end
+
+  # Returns array of instantiated Stops associated with Route
+  def stops(link = @link)
+    @stops = Wombat.crawl {
+      base_url ROOT
+      path link
+      stops "xpath=//li[@class='arrow']/a[contains(@href, '/stops/')]", :iterator do
+        name "xpath=./text()"
+        href "xpath=./@href"
+      end
+    }['stops'].map { |s| Stop.new(s['name'], s['href']) } unless @stops
+    @stops
+  end
+end

data/lib/pennride/stop.rb

@@ -0,0 +1,19 @@
+class Stop
+  attr_accessor :arrival_times, :id, :link, :name
+
+  def initialize(name, link)
+    @name, @link = name, link
+    @id = @link.split("/")[-1]
+  end
+
+  # Returns array of arrival times (Strings) for the Stop
+  # Note: untested as PennRide isn't operating over winter break
+  def arrival_times(link = @link)
+    @arrival_times = Wombat.crawl {
+      base_url ROOT
+      path link
+      times "xpath=//ul/li[not(contains(@class,'arrow'))]/text()", :list
+    }['times'] unless @arrival_times
+    @arrival_times
+  end
+end

data/lib/pennride/version.rb

@@ -0,0 +1,5 @@
+module PennRide
+  module Ruby
+    VERSION = "0.1"
+  end
+end

data/pennride.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/pennride/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = "Matt Parmett"
+  gem.email         = "mparmett@wharton.upenn.edu"
+  gem.description   = %q{Ruby gem to retrieve PennRide schedules}
+  gem.summary       = %q{Ruby gem to retrieve PennRide schedules}
+  gem.homepage      = "http://github.com/mattparmett/pennride"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "pennride"
+  gem.require_paths = ["lib"]
+  gem.version       = PennRide::Ruby::VERSION
+  
+  gem.add_dependency "wombat"
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: pennride
+version: !ruby/object:Gem::Version
+  version: '0.1'
+  prerelease: 
+platform: ruby
+authors:
+- Matt Parmett
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: wombat
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby gem to retrieve PennRide schedules
+email: mparmett@wharton.upenn.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/pennride.rb
+- lib/pennride/route.rb
+- lib/pennride/stop.rb
+- lib/pennride/version.rb
+- pennride.gemspec
+homepage: http://github.com/mattparmett/pennride
+licenses: []
+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: Ruby gem to retrieve PennRide schedules
+test_files: []