parking_ticket 1.0.0 → 1.0.32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2316d548e3f47bee94290a6e0b4399150d1db6948217c4a0434cae0b3ab5ebd
-  data.tar.gz: 31cbaee19c0e458085ef5ab1c142d2fe5f24a82ff152e9e797c1a8e4ddd03782
+  metadata.gz: 683fc243081f913aef89d5424d206710fa0ddadd4eb8cf431f978046732cc57a
+  data.tar.gz: 64ee6ac6aedca57693dcd3266e89fb717abc46128ad5900bcaabf0f92656dc94
 SHA512:
-  metadata.gz: e5c572a25ce7df3ab41f449dbaf1999df4efde403ccad560c87bf284ceb1e08ae3c072a4950a06244ffe94086b147fb0fb56d779a16315cdae05a34e5f39450f
-  data.tar.gz: a1e55ec8f66f0909c49bd53d5cc89ceb243cd6f72d6070befe77f9f57c8b10d4650a396a5f7054cdec7959400e0cb2dd64f42415300bf168f74ebed8715d6e2a
+  metadata.gz: aa871a2cba4a8364c5c051e599f1cbc4867cfcf4aa1d50ea5a021f876d45bbba019f292cf22500afff59be800e6ed926f5fa9877e6d15339919b3575a637c3d7
+  data.tar.gz: 3e240587339c43d75ccc9bdd48586b92daf1c2d1e51011fb82118d51d0372f358941012119fcab2b55896b3a1ba022b4b698c75a26de2273d4b1a4eec194c0b8

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    parking_ticket (1.0.0)
+    parking_ticket (1.0.32)
       faraday
 
 GEM

data/README.md

@@ -1,3 +1,4 @@
+![example workflow](https://github.com/troptropcontent/parking_ticket/actions/workflows/main.yml/badge.svg)
 # ParkingTicket
 
 This gem is a wrapper around the majors residential parking tickets api (for now only PayByPhone is supported).
@@ -22,22 +23,45 @@ Or install it yourself as:
 
 To make the gem work above your parking account you need set some environment variables : 
 
-#PayByPhone : 
-- `PAYBYPHONE_PASSWORD` : your PayByPhone password
-- `PAYBYPHONE_USERNAME` : your PayByPhone username (usually your phone number)
-- `PAYBYPHONE_LICENSEPLATE` : tyhe license plate of the car that must be covered 
-- `PAYBYPHONE_ZIPCODE` : the zipcode you're resident in 
-- `PAYBYPHONE_CARDNUMBER` : the credit card used to pay parking tickets (must be formated as folow xxxxxx------xxxx)
+This give you access to a bunch of classes but the most important one is the ParkingTicket::Base. 
 
-#Other apis to come
+This class can be instanciated as follow : 
 
-Two methods comes with the gem : 
+```
+parking_ticket = ParkingTicket::Base.new(
+  'pay_by_phone',
+  {
+    username: your_pay_by_phone_username,
+    password: your_pay_by_phone_password,
+    license_plate: your_license_plate,
+    zipcode: the_zipcode_where_you_are_resident,
+    card_number: the_card_number_registered_on_pay_by_phone_you_want_to_use, # must be in the format : xxxxxx------xxxx
+  }
+)
+```
+
+Once instanciated and configured correctly (the methods won't work if the is a missing key in the confguration hash), you can use the two instance methods to do what you have to do : 
 
-#`ParkingTicket.current_ticket`
-=> returns an object representing a currently running residential ticket for your car. It returns nil if no ticket are found.
+- #current_ticket
+This checks if a ticket is currently running for the license_plate. 
+Returns :
+```
+#if a ticket is found : 
+{
+  starts_on: 2023-01-11 15:40:22 UTC,
+  ends_on: 2023-01-18 15:40:22 UTC,
+  cost: 9.0,
+  license_plate: your_license_plate,
+  client: "PayByPhone",
+  client_ticket_id: the_id_returned_by_the_adapter,
+}
+
+#if no ticket is found
+nil
+```
 
-#`ParkingTicket.renew`
-=> register a new residential ticket for your car, this won't work if current_ticket returns something.
+- #renew
+This will trigger the renewal of your ticket, works only if no current_ticket is found
 
 Then you can create a scrypt like this one :
 
@@ -45,7 +69,16 @@ Then you can create a scrypt like this one :
 #your_scrypt.rb
 require 'parking_ticket'
 
-ticket_client = ParkingTicket.new
+ticket_client = ParkingTicket::Base.new(
+  'pay_by_phone',
+  {
+    username: your_pay_by_phone_username,
+    password: your_pay_by_phone_password,
+    license_plate: your_license_plate,
+    zipcode: the_zipcode_where_you_are_resident,
+    card_number: the_card_number_registered_on_pay_by_phone_you_want_to_use, # must be in the format : xxxxxx------xxxx
+  }
+)
 
 unless ticket_client.current_ticket
   ticket_client.renew
@@ -53,7 +86,7 @@ end
 
 ```
 
-And play as often as you want to ensure that you always have a ticket for your car.
+And play it as often as you want to ensure that you always have a ticket for your car.
 (But this is very HTTP request consuming, a lot of wasted request will be performed, i am sure that you can do better than that.)
 
 Exemple of application : [parkautomat](https://github.com/troptropcontent/parkautomat)

data/lib/client/pay_by_phone/adapter.rb

@@ -2,10 +2,20 @@ module ParkingTicket
   module Client
     module PayByPhone
       class Adapter
+        class << self
+          def valid_credentials?(username, password)
+            Request.valid_credentials?(username, password)
+          end
+        end
+
         def initialize(configuration)
           @configuration = configuration
         end
 
+        def valid_credentials?(_username, _password)
+          request.valid_credentials?(_username, _password)
+        end
+
         def covered?
           !!current_ticket
         end

data/lib/client/pay_by_phone/request.rb

@@ -3,6 +3,33 @@ module ParkingTicket
   module Client
     module PayByPhone
       class Request
+        class << self
+          def valid_credentials?(username, password)
+            auth(username, password).status == 200
+          end
+
+          private
+
+          def auth(username, password)
+            conn = Faraday.new('https://auth.paybyphoneapis.com') do |f|
+              f.response :json
+            end
+            conn.post(
+              '/token',
+              URI.encode_www_form({
+                                    grant_type: 'password',
+                                    username: username,
+                                    password: password,
+                                    client_id: 'paybyphone_web'
+                                  }),
+              {
+                'Accept' => 'application/json, text/plain, */*',
+                'X-Pbp-ClientType' => 'WebApp'
+              }
+            )
+          end
+        end
+
         def initialize(configuration)
           @configuration = configuration
         end
@@ -11,7 +38,7 @@ module ParkingTicket
           connection.get("/parking/accounts/#{account_id}/sessions?periodType=Current").body
         end
 
-        def new_ticket(_account_id, _parking_start_time, _quote_id, _payment_method_id)
+        def new_ticket(account_id, parking_start_time, quote_id, payment_method_id)
           connection.post(
             "/parking/accounts/#{account_id}/sessions/",
             {
@@ -98,22 +125,7 @@ module ParkingTicket
         end
 
         def token
-          conn = Faraday.new('https://auth.paybyphoneapis.com') do |f|
-            f.response :json
-          end
-          conn.post(
-            '/token',
-            URI.encode_www_form({
-                                  grant_type: 'password',
-                                  username: @configuration.username,
-                                  password: @configuration.password,
-                                  client_id: 'paybyphone_web'
-                                }),
-            {
-              'Accept' => 'application/json, text/plain, */*',
-              'X-Pbp-ClientType' => 'WebApp'
-            }
-          ).body['access_token']
+          self.class.send(:auth, @configuration.username, @configuration.password).body['access_token']
         end
       end
     end

data/lib/parking_ticket/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ParkingTicket
-  VERSION = '1.0.0'
+  VERSION = '1.0.32'
 end

data/lib/parking_ticket.rb

@@ -10,6 +10,35 @@ require 'client/pay_by_phone/request'
 
 module ParkingTicket
   class Base
+    class << self
+      def valid_credentials?(adapter_name, username, password)
+        adapter = Client::PayByPhone::Adapter if adapter_name == 'pay_by_phone'
+        raise Error, 'EasyPark will be handled in the next major release' if adapter_name == 'easy_park'
+        raise Error, "Unhandled adapter : #{adapter_name}" unless adapter
+
+        adapter.valid_credentials?(username, password)
+      end
+
+      def config
+        yield(self)
+      end
+
+      attr_accessor :ticket_format
+
+      def format_ticket(ticket)
+        return unless ticket_format
+
+        ticket_format.each_with_object({}) do |element, acumulator|
+          if element.is_a?(Hash)
+            original_key = element.keys.first
+            target_key = element.values.first
+            acumulator[target_key] = ticket[original_key]
+          else
+            acumulator[element] = ticket[element]
+          end
+        end
+      end
+    end
     attr_reader :configuration
 
     class Error < StandardError
@@ -30,7 +59,9 @@ module ParkingTicket
     end
 
     def current_ticket
-      adapter.current_ticket
+      ticket = adapter.current_ticket
+      ticket = self.class.format_ticket(ticket) if self.class.ticket_format && ticket
+      ticket
     end
 
     private

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parking_ticket
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.32
 platform: ruby
 authors:
 - Tom Ecrepont
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-01-13 00:00:00.000000000 Z
+date: 2023-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -46,6 +46,8 @@ files:
 - lib/parking_ticket.rb
 - lib/parking_ticket/configuration.rb
 - lib/parking_ticket/version.rb
+- parking_ticket-1.0.0.gem
+- parking_ticket-1.0.1.gem
 homepage: https://github.com/troptropcontent/parking_ticket
 licenses:
 - MIT