colectivero 0.0.2

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,50 @@
+Copyright (c) 2012 Bruno Bonamin
+
+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.
+
+----------------------------------------------------------
+
+TRADUCCIÓN NO OFICIAL NI AUTORIZADA PARA SU USO COMO LICENCIA LEGAL
+Copyright (c) 2012 Bruno Bonamin
+
+Se autoriza por la presente, de forma gratuita, a cualquier
+persona que haya obtenido una copia de este software y 
+archivos asociados de documentación (el "Software"), para tratar en el
+Software sin restricción, incluyendo sin ninguna limitación en lo que concierne
+los derechos para usar, copiar, modificar, fusionar, publicar,
+distribuir, sublicenciar, y / o vender copias de este
+Software, y para permitir a las personas a las que se les proporcione el Software para 
+hacer lo mismo, sujeto a las siguientes condiciones:
+
+El aviso de copyright anterior y este aviso de permiso
+tendrá que ser incluido en todas las copias o partes sustanciales de
+este Software.
+
+EL SOFTWARE SE ENTREGA "TAL CUAL", SIN GARANTÍA DE NINGÚN
+TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO PERO SIN LIMITARSE A GARANTÍAS DE
+MERCANTIBILIDAD, CAPACIDAD DE HACER Y DE NO INFRACCIÓN DE COPYRIGHT. EN NINGÚN 
+CASO LOS AUTORES O TITULARES DEL COPYRIGHT SERÁN RESPONSABLES DE 
+NINGUNA RECLAMACIÓN, DAÑOS U OTRAS RESPONSABILIDADES, 
+YA SEA EN UN LITIGIO, AGRAVIO O DE OTRO MODO, 
+DERIVADAS DE, OCASIONADAS POR CULPA DE O EN CONEXION CON EL
+SOFTWARE O SU USO U OTRO TIPO DE ACCIONES EN EL SOFTWARE.

data/README.rdoc

@@ -0,0 +1,35 @@
+= Colectivero
+
+Esta es una API no oficial para consultar el sistema de horarios de llegada de colectivos en la ciudad de Rosario, Argentina; del Ente de Transporte de Rosario.   
+
+Incluyo un par de ejemplos que detallan su uso.
+
+== Instalación
+
+La instalación es muy simple desde rubygems:
+    gem install colectivero
+
+Y hacer un require:
+    require 'colectivero'
+
+== Uso
+Para conocer la lista de todos los colectivos disponibles:  
+    Colectivero::Bus.list_all
+
+Seleccionando algún elemento de la lista, se puede instanciar un colectivo para poder conocer sus calles e intersecciones para obtener un número de parada:
+    bus = Colectivero::Bus.new('153')
+    bus.streets
+    calle = bus.streets[5]
+    intersec = bus.intersections(calle).first
+    parada = Colectivero::BusStop.new(bus, calle, intersec)
+
+Y finalmente, para consultar la llegada:  
+    llegada = Colectivero::Arrival.new bus, parada
+    llegada.message # => "Linea 153R: 16min. 7434mts"
+
+Alternativamente, también se puede consultar la llegada mandando la parada como un entero o un string:  
+    llegada = Colectivero::Arrival.new bus, '4186'
+    llegada = Colectivero::Arrival.new bus, 4186
+
+==Licencia
+Ver el archivo LICENSE para detalles.

data/Rakefile

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

data/colectivero.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "colectivero/version"
+
+Gem::Specification.new do |s|
+  s.name        = "colectivero"
+  s.version     = Colectivero::VERSION
+  s.authors     = ["Bruno Bonamin"]
+  s.email       = ["bruno@bonamin.org"]
+  s.homepage    = "http://github.com/bbonamin/colectivero"
+  s.summary     = %q{API de Cuándo Llega Rosario}
+  s.description = %q{API Wrapper para el Cuándo Llega del Ente de Transporte de Rosario}
+
+  s.add_dependency('mechanize', '>= 1.0.0')
+  s.add_dependency('json', '>= 1.6.6')
+
+  s.add_development_dependency 'rspec', '~> 2.9'
+  s.rubyforge_project = "colectivero"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/colectivero.rb

@@ -0,0 +1,8 @@
+# -*- encoding: utf-8 -*-
+require "colectivero/version"
+require "colectivero/bus"
+require "colectivero/bus_stop"
+require "colectivero/arrival"
+
+module Colectivero
+end

data/lib/colectivero/arrival.rb

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require 'mechanize'
+
+module Colectivero
+	class Arrival
+		attr_reader :query_date_time, :message
+
+		def initialize(bus, bus_stop)
+			if bus_stop.is_a? Colectivero::BusStop
+				bus_stop_number = bus_stop.number
+			else
+				bus_stop_number = bus_stop.to_s
+			end
+
+			agent = Mechanize.new
+	    agent.post("http://www.etr.gov.ar/getSmsResponse.php", {"parada" => "#{bus_stop_number}", "linea"=>"#{bus.value}"})
+	    @message = agent.page.content
+	    @query_date_time = Time.now
+
+	  end
+	end
+end

data/lib/colectivero/bus.rb

@@ -0,0 +1,80 @@
+# -*- encoding: utf-8 -*-
+module Colectivero
+	class Bus
+		BUS_LINES = [	{:name => '101', :line_id => '1,2', :value => '101'},
+									{:name => '102', :line_id => '3,4', :value => '102'},
+									{:name => '103', :line_id => '5,6', :value => '103'},
+									{:name => '110', :line_id =>  '11', :value => '110'},
+									{:name => '112', :line_id=>'12,13', :value => '112'},
+									{:name => '113', :line_id =>  '14', :value => '113'},
+									{:name => '115', :line_id =>  '15', :value => '115'},
+									{:name => '116', :line_id =>  '16', :value => '116'},
+									{:name => '120', :line_id =>  '17', :value => '120'},
+									{:name => '121', :line_id =>  '18', :value => '121'},
+									{:name => '122', :line_id=>'19,20', :value => '122'},
+									{:name => '123', :line_id =>  '21', :value => '123'},
+									{:name => '125', :line_id =>  '22', :value => '125'},
+									{:name => '126', :line_id=>'23,24', :value => '126'},
+									{:name => '127', :line_id =>  '25', :value => '127'},
+									{:name => '128', :line_id=>'26,27', :value => '128'},
+									{:name => '129', :line_id =>  '28', :value => '129'},
+									{:name => '130', :line_id =>  '29', :value => '130'},
+									{:name => '131', :line_id =>  '30', :value => '131'},
+									{:name => '132', :line_id =>  '31', :value => '132'},
+									{:name => '133', :line_id=>'32,33', :value => '133'},
+									{:name => '134', :line_id =>  '34', :value => '134'},
+									{:name => '135', :line_id =>  '35', :value => '135'},
+									{:name => '136', :line_id =>  '36', :value => '136'},
+									{:name => '137', :line_id =>  '37', :value => '137'},
+									{:name => '138', :line_id=>'38,39', :value => '138'},
+									{:name => '139', :line_id=>'40,41', :value => '139'},
+									{:name => '140', :line_id =>  '43', :value => '140'},
+									{:name => '141', :line_id =>  '44', :value => '141'},
+									{:name => '142', :line_id => '45,46,47', :value => '142'},
+									{:name => '143', :line_id => '48,49', :value => '143'},
+									{:name => '144', :line_id => '50,51', :value => '144'},
+									{:name => '145', :line_id => '52,53', :value => '145'},
+									{:name => '146', :line_id => '54,55', :value => '146'},
+									{:name => '153', :line_id => '56,57,58', :value => '153'},
+									{:name => 'K', :line_id => '64', :value => 'K'},
+									{:name => 'Linea de la Costa', :line_id => '65', :value => 'LC'},
+									{:name => 'Ronda del Centro', :line_id => '66', :value => 'RC'}	]
+
+		attr_reader :name, :line_id, :value, :streets
+		def initialize bus_name
+			bus = BUS_LINES.select { |bus| bus[:name] == bus_name.to_s }.first
+			if bus.nil?
+				raise 'Nombre de colectivo no válido'
+			else
+				@name 		= bus[:name]
+				@line_id 	= bus[:line_id]
+				@value 		= bus[:value]
+
+				agent = Mechanize.new
+				agent.get("http://www.etr.gov.ar/getData.php?accion=getCalle&idLinea=#{line_id}")
+				@streets  = JSON(agent.page.content)
+			end
+		end
+
+		def self.list_all
+			buses = []
+			BUS_LINES.each do |bus|
+				buses << bus[:name]
+			end
+			buses
+		end
+
+		def intersections(street)
+			agent = Mechanize.new
+    	agent.get("http://www.etr.gov.ar/getData.php?accion=getInterseccion&idLinea=#{line_id}&idCalle=#{street['id']}")
+    	JSON(agent.page.content)
+		end
+
+		# private
+		# 	def get_streets
+		# 		agent = Mechanize.new
+		# 		agent.get("http://www.etr.gov.ar/getData.php?accion=getCalle&idLinea=#{line_id}")
+		# 		JSON(agent.page.content)
+		# 	end
+	end
+end

data/lib/colectivero/bus_stop.rb

@@ -0,0 +1,15 @@
+# -*- encoding: utf-8 -*-
+require 'mechanize'
+require 'json'
+
+module Colectivero
+	class BusStop
+
+		attr_reader :number
+		def initialize(bus,street,intersection)
+			agent = Mechanize.new
+			agent.get("http://www.etr.gov.ar/getData.php?accion=getInfoParadas&idLinea=#{bus.line_id}&idCalle=#{street['id']}&idInt=#{intersection['id']}")
+			@number = agent.page.links.first.text
+		end
+	end
+end

data/lib/colectivero/version.rb

@@ -0,0 +1,3 @@
+module Colectivero
+  VERSION = "0.0.2"
+end

data/spec/colectivero/arrival_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe 'Arrival' do
+	it 'should return a string when called with object parameters' do
+		bus = Colectivero::Bus.new('110')
+		street = bus.streets.first
+		intersection = bus.intersections(street).first
+		bus_stop = Colectivero::BusStop.new(bus, street, intersection)
+
+		arrival = Colectivero::Arrival.new bus, bus_stop
+		arrival.message.should_not match "Disculpe\\*"
+	end
+
+	it 'should return a string when called with a bus stop number' do
+		bus = Colectivero::Bus.new('110')
+		valid_bus_stop = 7969
+
+		arrival = Colectivero::Arrival.new bus, valid_bus_stop
+		arrival.message.should_not match "Disculpe\\*"
+	end
+
+	it 'should return a Disculpe message when called with an invalid bus stop' do
+		bus = Colectivero::Bus.new('110')
+		street = bus.streets.first
+		intersection = bus.intersections(street).first
+		bus_stop = Colectivero::BusStop.new(bus, street, intersection)
+
+		arrival = Colectivero::Arrival.new bus, 9191
+		arrival.message.should match("Disculpe(.*)")
+	end
+end

data/spec/colectivero/bus_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+describe 'Bus' do
+	before(:each) do
+		@bus = Colectivero::Bus.new('110')
+	end
+
+	context 'with a valid name' do
+		it 'should have an id' do
+			@bus.line_id.should_not be_nil
+		end
+
+		it 'should have a name' do
+			@bus.name.should_not be_nil
+		end
+		
+		it 'should have a value' do
+			@bus.value.should_not be_nil
+		end
+	end
+
+	context 'with an invalid name' do
+		it 'should be raise an error' do
+			expect { Colectivero::Bus.new('xxx') }.should raise_error
+		end
+	end
+
+	it 'should have many streets' do
+		@bus.streets.should_not be_empty
+	end
+
+	context 'with a street as parameter' do
+		it 'should have many intersections' do
+			street = @bus.streets.first
+			@bus.intersections(street).should_not be_empty
+		end
+	end
+
+	it 'should raise an error when calling intersections without params' do
+		expect { @bus.intersections }.should raise_error
+	end
+end

data/spec/colectivero/bus_stop_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe 'BusStop' do
+	it 'should return a bus_stop number when called with the correct parameters' do
+		bus = Colectivero::Bus.new('110')
+		street = bus.streets.first
+		intersection = bus.intersections(street).first
+		bus_stop = Colectivero::BusStop.new(bus, street, intersection)
+
+		bus_stop.should_not be_nil
+	end
+
+	it 'should return an error when called with no parameters' do
+		expect { Colectivero::BusStop.new}.should raise_error
+	end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper.rb"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+Dir["../colectivero/lib/*.rb"].each {|file| require file }
+require 'pry'
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: colectivero
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Bruno Bonamin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-27 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mechanize
+  requirement: &70176595056820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70176595056820
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &70176595056300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.6.6
+  type: :runtime
+  prerelease: false
+  version_requirements: *70176595056300
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70176595044340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :development
+  prerelease: false
+  version_requirements: *70176595044340
+description: API Wrapper para el Cuándo Llega del Ente de Transporte de Rosario
+email:
+- bruno@bonamin.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.rdoc
+- Rakefile
+- colectivero.gemspec
+- lib/colectivero.rb
+- lib/colectivero/arrival.rb
+- lib/colectivero/bus.rb
+- lib/colectivero/bus_stop.rb
+- lib/colectivero/version.rb
+- spec/colectivero/arrival_spec.rb
+- spec/colectivero/bus_spec.rb
+- spec/colectivero/bus_stop_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/bbonamin/colectivero
+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: colectivero
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: API de Cuándo Llega Rosario
+test_files:
+- spec/colectivero/arrival_spec.rb
+- spec/colectivero/bus_spec.rb
+- spec/colectivero/bus_stop_spec.rb
+- spec/spec_helper.rb