nsastorage 1.0.1 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0f13e7fb615668101d5da8a5549bb85779e59499c55d6935e9d4fd2f369a1b74
-  data.tar.gz: c2aa0859eea895d690d3e24ea7de9a2f7673be7de4fe842f31f1f81c39c702c1
+  metadata.gz: 949d27c50eb31c2fd300fb0b79746ce5582239ab7b471f82e69d8c7b39b45aa6
+  data.tar.gz: 3614b9d81dc60f5648ba04b36b499b04f30f3eb5b6208e28718bc5369b9be3be
 SHA512:
-  metadata.gz: 2725593f7e064e70ea041f0f031cf1a2be8e7d0f024b09e14384821391748d86d6efcf081b0d89817405c89e2d253b2da0a045f0664209c19b0bd033de05c2b4
-  data.tar.gz: 2399ae9154b3a1ac1d8af45d3aae39425f67a060aed5679e47d57d821022525539ce4b1c79e2e8e5843d3202fc9e0cea2c11febe67d16e06a41f52eb4a882079
+  metadata.gz: c28896e881cbed9602776cf811f77a3c09f7e461df19f3f5bd4fa2b6f3c3022bfcf449b12e07db0739db12ca0cf7944eabb77279efc0a2db60d0e3a74a8aecad
+  data.tar.gz: 63217a2e77acb61b0ad432298f6c428c795e385c6a7721a2551c88aabc13db8a06b1b07a482541c8bdbc85cfa933a875d5a74efe263b91cde839bb67f1056cb0

data/README.md

@@ -6,6 +6,8 @@
 [![Yard](https://img.shields.io/badge/docs-site-blue.svg)](https://nsastorage.ksylvest.com)
 [![CircleCI](https://img.shields.io/circleci/build/github/ksylvest/nsastorage)](https://circleci.com/gh/ksylvest/nsastorage)
 
+A Ruby library offering both a CLI and API for scraping [NSA Storage](https://www.nsastorage.com/) self-storage facilities and prices.
+
 ## Installation
 
 ```bash
@@ -49,3 +51,7 @@ end
 ```bash
 nsastorage crawl
 ```
+
+```bash
+nsastorage crawl "https://www.nsastorage.com/storage/georgia/storage-units-norcross/1-Western-Hills-Ct-2"
+```

data/lib/nsastorage/cli.rb

@@ -21,7 +21,7 @@ module NSAStorage
       command = argv.shift
 
       case command
-      when 'crawl' then crawl
+      when 'crawl' then crawl(*argv)
       else
         warn("unsupported command=#{command.inspect}")
         exit(Code::ERROR)
@@ -30,8 +30,9 @@ module NSAStorage
 
     private
 
-    def crawl
-      Crawl.run
+    # @param url [String] optional
+    def crawl(url = nil)
+      Crawl.run(url:)
       exit(Code::OK)
     end
 

data/lib/nsastorage/crawl.rb

@@ -9,21 +9,25 @@ module NSAStorage
 
     # @param stdout [IO] optional
     # @param stderr [IO] optional
-    # @param options [Hash] optional
-    def initialize(stdout: $stdout, stderr: $stderr, options: {})
+    # @param url [String] optional
+    def initialize(stdout: $stdout, stderr: $stderr, url: nil)
       @stdout = stdout
       @stderr = stderr
-      @options = options
+      @url = url
     end
 
     def run
-      sitemap = Facility.sitemap
-      @stdout.puts("count=#{sitemap.links.count}")
-      @stdout.puts
-
-      sitemap.links.each { |link| process(url: link.loc) }
+      if @url
+        process(url: @url)
+      else
+        sitemap = Facility.sitemap
+        @stdout.puts("count=#{sitemap.links.count}")
+        @stdout.puts
+        sitemap.links.each { |link| process(url: link.loc) }
+      end
     end
 
+    # @param url [String]
     def process(url:)
       @stdout.puts(url)
       facility = Facility.fetch(url: url)

data/lib/nsastorage/facility.rb

@@ -37,7 +37,7 @@ module NSAStorage
     attr_accessor :address
 
     # @attribute [rw] geocode
-    #   @return [Geocode]
+    #   @return [Geocode, nil]
     attr_accessor :geocode
 
     # @attribute [rw] prices
@@ -127,7 +127,7 @@ module NSAStorage
 
     # @return [String]
     def text
-      "#{@id} | #{@name} | #{@phone} | #{@email} | #{@address.text} | #{@geocode.text}"
+      "#{@id} | #{@name} | #{@phone} | #{@email} | #{@address.text} | #{@geocode ? @geocode.text : 'N/A'}"
     end
   end
 end

data/lib/nsastorage/geocode.rb

@@ -18,8 +18,10 @@ module NSAStorage
     #
     # @return [Geocode]
     def self.parse(document:)
-      latitude = LATITUDE_REGEX.match(document.text)[:latitude]
-      longitude = LONGITUDE_REGEX.match(document.text)[:longitude]
+      latitude = LATITUDE_REGEX.match(document.text)&.[](:latitude)
+      longitude = LONGITUDE_REGEX.match(document.text)&.[](:longitude)
+
+      return if latitude.nil? || longitude.nil?
 
       new(latitude: Float(latitude), longitude: Float(longitude))
     end

data/lib/nsastorage/price.rb

@@ -3,7 +3,7 @@
 module NSAStorage
   # The price (id + dimensions + rate) for a facility.
   class Price
-    ID_REGEX = %r{(?<id>\d+)/(?:rent|reserve)/}
+    ID_REGEX = %r{/reservation/(?<facility_id>\d+)/(?<id>\d+)}
     PRICE_SELECTOR = '[data-unit-size="small"],[data-unit-size="medium"],[data-unit-size="large"]'
 
     # @attribute [rw] id
@@ -65,12 +65,13 @@ module NSAStorage
     #
     # @return [Price]
     def self.parse(element:)
-      link = element.at_xpath(".//a[contains(text(), 'Rent')]|//a[contains(text(), 'Reserve')]")
+      link = element.at_css('.cta-holder > a[href*="reservation"]')
       dimensions = Dimensions.parse(element:)
       features = Features.parse(element:)
       rates = Rates.parse(element:)
 
-      id = link ? ID_REGEX.match(link['href'])[:id] : "#{dimensions.id}-#{features.id}"
+      match = ID_REGEX.match(link['href']) if link
+      id = match ? match[:id] : "#{dimensions.id}-#{features.id}"
 
       new(id:, dimensions:, features:, rates:)
     end

data/lib/nsastorage/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module NSAStorage
-  VERSION = '1.0.1'
+  VERSION = '1.0.4'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: nsastorage
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.4
 platform: ruby
 authors:
 - Kevin Sylvestre
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-12-17 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -115,9 +114,9 @@ licenses:
 metadata:
   rubygems_mfa_required: 'true'
   homepage_uri: https://github.com/ksylvest/nsastorage
-  source_code_uri: https://github.com/ksylvest/nsastorage
-  changelog_uri: https://github.com/ksylvest/nsastorage
-post_install_message: 
+  source_code_uri: https://github.com/ksylvest/nsastorage/tree/v1.0.4
+  changelog_uri: https://github.com/ksylvest/nsastorage/releases/tag/v1.0.4
+  documentation_uri: https://nsastorage.ksylvest.com/
 rdoc_options: []
 require_paths:
 - lib
@@ -132,8 +131,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key: 
+rubygems_version: 4.0.12
 specification_version: 4
 summary: A crawler for NSAStorage.
 test_files: []