nsastorage 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ecae367c1dc75c720c89af10a90e6325bfe10c03dbfee675a125a45c70fcc6f5
+  data.tar.gz: dbd35a90238e4a806a9e569bae4c99f474f101d92e906eef91cec2a7c85867b2
+SHA512:
+  metadata.gz: 3fa08993d81f797354e095db5f367e650a4c58c67763fa147f65de1cc4794113c7b4394bb5656219484ac62dd530c4dc70fc5b2aa86a6b826140b0c1cd767575
+  data.tar.gz: 2b0dbea4c879f0d44d0716772830b330d497ee1c8170969909db7dcdb375203b50672cba4d1f4611e29e3cd800e183aeee405e4f90b040b5fc7994a936691695

data/Gemfile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'rake'
+gem 'rspec'
+gem 'rspec_junit_formatter'
+gem 'rubocop'
+gem 'rubocop-rake'
+gem 'rubocop-rspec'
+gem 'vcr'
+gem 'webmock'
+gem 'yard'

data/README.md

@@ -0,0 +1,51 @@
+# NSAStorage
+
+[![LICENSE](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/ksylvest/nsastorage/blob/main/LICENSE)
+[![RubyGems](https://img.shields.io/gem/v/nsastorage)](https://rubygems.org/gems/nsastorage)
+[![GitHub](https://img.shields.io/badge/github-repo-blue.svg)](https://github.com/ksylvest/nsastorage)
+[![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)
+
+## Installation
+
+```bash
+gem install nsastorage
+```
+
+## Configuration
+
+```ruby
+require 'nsastorage'
+
+NSAStorage.configure do |config|
+  config.user_agent = '../..' # ENV['NSASTORAGE_USER_AGENT']
+  config.timeout = 30 # ENV['NSASTORAGE_TIMEOUT']
+  config.proxy_url = 'http://user:pass@superproxy.zenrows.com:1337' # ENV['NSASTORAGE_PROXY_URL']
+end
+```
+
+## Usage
+
+```ruby
+require 'nsastorage'
+
+sitemap = NSAStorage::Facility.sitemap
+sitemap.links.each do |link|
+  url = link.loc
+  facility = NSAStorage::Facility.fetch(url:)
+
+  puts facility.text
+
+  facility.prices.each do |price|
+    puts price.text
+  end
+
+  puts
+end
+```
+
+## CLI
+
+```bash
+nsastorage crawl
+```

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'nsastorage'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/nsastorage

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'nsastorage'
+
+cli = NSAStorage::CLI.new
+cli.parse

data/lib/nsastorage/address.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # The address (street + city + state + zip) of a facility.
+  class Address
+    # @attribute [rw] street
+    #   @return [String]
+    attr_accessor :street
+
+    # @attribute [rw] city
+    #   @return [String]
+    attr_accessor :city
+
+    # @attribute [rw] state
+    #   @return [String]
+    attr_accessor :state
+
+    # @attribute [rw] zip
+    #   @return [String]
+    attr_accessor :zip
+
+    # @param street [String]
+    # @param city [String]
+    # @param state [String]
+    # @param zip [String]
+    def initialize(street:, city:, state:, zip:)
+      @street = street
+      @city = city
+      @state = state
+      @zip = zip
+    end
+
+    # @return [String]
+    def inspect
+      props = [
+        "street=#{@street.inspect}",
+        "city=#{@city.inspect}",
+        "state=#{@state.inspect}",
+        "zip=#{@zip.inspect}"
+      ]
+      "#<#{self.class.name} #{props.join(' ')}>"
+    end
+
+    # @return [String]
+    def text
+      "#{street}, #{city}, #{state} #{zip}"
+    end
+
+    # @param data [Hash]
+    #
+    # @return [Address]
+    def self.parse(data:)
+      new(
+        street: data['streetAddress'],
+        city: data['addressLocality'],
+        state: data['addressRegion'],
+        zip: data['postalCode']
+      )
+    end
+  end
+end

data/lib/nsastorage/cli.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'optparse'
+
+module NSAStorage
+  # Used when interacting with the library from the command line interface (CLI).
+  #
+  # Usage:
+  #
+  #   cli = NSAStorage::CLI.new
+  #   cli.parse
+  class CLI
+    module Code
+      OK = 0
+      ERROR = 1
+    end
+
+    # @param argv [Array<String>]
+    def parse(argv = ARGV)
+      parser.parse!(argv)
+      command = argv.shift
+
+      case command
+      when 'crawl' then crawl
+      else
+        warn("unsupported command=#{command.inspect}")
+        exit(Code::ERROR)
+      end
+    end
+
+    private
+
+    def crawl
+      Crawl.run
+      exit(Code::OK)
+    end
+
+    def help(options)
+      puts(options)
+      exit(Code::OK)
+    end
+
+    def version
+      puts(VERSION)
+      exit(Code::OK)
+    end
+
+    # @return [OptionParser]
+    def parser
+      OptionParser.new do |options|
+        options.banner = 'usage: nsastorage [options] <command> [<args>]'
+
+        options.on('-h', '--help', 'help') { help(options) }
+        options.on('-v', '--version', 'version') { version }
+      end
+    end
+  end
+end

data/lib/nsastorage/config.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # The core configuration.
+  class Config
+    # @attribute [rw] accept_language
+    #   @return [String]
+    attr_accessor :accept_language
+
+    # @attribute [rw] user_agent
+    #   @return [String]
+    attr_accessor :user_agent
+
+    # @attribute [rw] timeout
+    #   @return [Integer]
+    attr_accessor :timeout
+
+    # @attribute [rw] proxy_url
+    #   @return [String]
+    attr_accessor :proxy_url
+
+    def initialize
+      @accept_language = ENV.fetch('NSASTORAGE_ACCEPT_LANGUAGE', 'en-US,en;q=0.9')
+      @user_agent = ENV.fetch('NSASTORAGE_USER_AGENT', "nsastorage.rb/#{VERSION}")
+      @timeout = Integer(ENV.fetch('NSASTORAGE_TIMEOUT', 60))
+      @proxy_url = ENV.fetch('NSASTORAGE_PROXY_URL', nil)
+    end
+
+    # @return [Boolean]
+    def headers?
+      !@user_agent.nil?
+    end
+
+    # @return [Boolean]
+    def timeout?
+      !@timeout.zero?
+    end
+
+    # @return [Boolean]
+    def proxy?
+      !@proxy_url.nil?
+    end
+
+    # @return [Hash<String, String>] e.g { 'User-Agent' => 'nsastorage.rb/1.0.0' }
+    def headers
+      {
+        'Accept-Language' => @accept_language,
+        'User-Agent' => @user_agent
+      }
+    end
+
+    # @return [Array] e.g. ['proxy.example.com', 8080, 'user', 'pass']
+    def via
+      proxy_uri = URI.parse(@proxy_url)
+      [proxy_uri.host, proxy_uri.port, proxy_uri.user, proxy_uri.password]
+    end
+  end
+end

data/lib/nsastorage/crawl.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # Handles the crawl command via CLI.
+  class Crawl
+    def self.run(...)
+      new(...).run
+    end
+
+    # @param stdout [IO] optional
+    # @param stderr [IO] optional
+    # @param options [Hash] optional
+    def initialize(stdout: $stdout, stderr: $stderr, options: {})
+      @stdout = stdout
+      @stderr = stderr
+      @options = options
+    end
+
+    def run
+      sitemap = Facility.sitemap
+      @stdout.puts("count=#{sitemap.links.count}")
+      @stdout.puts
+
+      sitemap.links.each { |link| process(url: link.loc) }
+    end
+
+    def process(url:)
+      @stdout.puts(url)
+      facility = Facility.fetch(url: url)
+      @stdout.puts(facility.text)
+      facility.prices.each { |price| @stdout.puts(price.text) }
+      @stdout.puts
+    rescue FetchError => e
+      @stderr.puts("url=#{url} error=#{e.message}")
+    end
+  end
+end

data/lib/nsastorage/crawler.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # Used to fetch and parse either HTML or XML via a URL.
+  class Crawler
+    HOST = 'https://www.nsastorage.com'
+
+    # @param url [String]
+    # @raise [FetchError]
+    # @return [Nokogiri::HTML::Document]
+    def self.html(url:)
+      new.html(url:)
+    end
+
+    # @param url [String]
+    # @raise [FetchError]
+    # @return [Nokogiri::XML::Document]
+    def self.xml(url:)
+      new.xml(url:)
+    end
+
+    # @return [HTTP::Client]
+    def connection
+      @connection ||= begin
+        config = NSAStorage.config
+
+        connection = HTTP.use(:auto_deflate).use(:auto_inflate).persistent(HOST)
+        connection = connection.headers(config.headers) if config.headers?
+        connection = connection.timeout(config.timeout) if config.timeout?
+        connection = connection.via(*config.via) if config.proxy?
+
+        connection
+      end
+    end
+
+    # @param url [String]
+    # @return [HTTP::Response]
+    def fetch(url:)
+      response = connection.get(url)
+      raise FetchError.new(url:, response: response.flush) unless response.status.ok?
+
+      response
+    end
+
+    # @param url [String]
+    # @raise [FetchError]
+    # @return [Nokogiri::XML::Document]
+    def html(url:)
+      Nokogiri::HTML(String(fetch(url:).body))
+    end
+
+    # @param url [String]
+    # @raise [FetchError]
+    # @return [Nokogiri::XML::Document]
+    def xml(url:)
+      Nokogiri::XML(String(fetch(url:).body))
+    end
+  end
+end

data/lib/nsastorage/dimensions.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # The dimensions (width + depth + sqft) of a price.
+  class Dimensions
+    DEFAULT_HEIGHT = 8.0 # feet
+
+    # @attribute [rw] depth
+    #   @return [Float]
+    attr_accessor :depth
+
+    # @attribute [rw] width
+    #  @return [Float]
+    attr_accessor :width
+
+    # @attribute [rw] height
+    #   @return [Float]
+    attr_accessor :height
+
+    # @param depth [Float]
+    # @param width [Float]
+    # @param height [Float]
+    def initialize(depth:, width:, height: DEFAULT_HEIGHT)
+      @depth = depth
+      @width = width
+      @height = height
+    end
+
+    # @return [String]
+    def inspect
+      props = [
+        "depth=#{@depth.inspect}",
+        "width=#{@width.inspect}",
+        "height=#{@height.inspect}"
+      ]
+      "#<#{self.class.name} #{props.join(' ')}>"
+    end
+
+    # @return [Integer]
+    def sqft
+      Integer(@width * @depth)
+    end
+
+    # @return [Integer]
+    def cuft
+      Integer(@width * @depth * @height)
+    end
+
+    # @return [String] e.g. "10' × 10' (100 sqft)"
+    def text
+      "#{format('%g', @width)}' × #{format('%g', @depth)}' (#{sqft} sqft)"
+    end
+
+    # @param element [Nokogiri::XML::Element]
+    #
+    # @return [Dimensions]
+    def self.parse(element:)
+      text = element.text
+      match = text.match(/(?<width>[\d\.]+)'x(?<depth>[\d\.]+)'/)
+      raise text.inspect if match.nil?
+
+      width = Float(match[:width])
+      depth = Float(match[:depth])
+      new(depth:, width:, height: DEFAULT_HEIGHT)
+    end
+  end
+end

data/lib/nsastorage/facility.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # A facility (address + geocode + prices) on nsastorage.com.
+  #
+  # e.g. https://www.nsastorage.com/storage/california/storage-units-paramount/7752-Jackson-St-876
+  class Facility
+    class ParseError < StandardError; end
+
+    DEFAULT_EMAIL = 'TODO'
+    DEFAULT_PHONE = 'TODO'
+
+    SITEMAP_URL = 'https://www.nsastorage.com/sitemap.xml'
+
+    ID_REGEX = %r{/(?<id>\d+)}
+
+    # @attribute [rw] id
+    #   @return [String]
+    attr_accessor :id
+
+    # @attribute [rw] url
+    #   @return [String]
+    attr_accessor :url
+
+    # @attribute [rw] name
+    #   @return [String]
+    attr_accessor :name
+
+    # @attribute [rw] phone
+    #   @return [String]
+    attr_accessor :phone
+
+    # @attribute [rw] email
+    #   @return [String]
+    attr_accessor :email
+
+    # @attribute [rw] address
+    #   @return [Address]
+    attr_accessor :address
+
+    # @attribute [rw] geocode
+    #   @return [Geocode]
+    attr_accessor :geocode
+
+    # @attribute [rw] prices
+    #   @return [Array<Price>]
+    attr_accessor :prices
+
+    # @return [Sitemap]
+    def self.sitemap
+      Sitemap.fetch(url: SITEMAP_URL)
+    end
+
+    # @param url [String]
+    #
+    # @return [Facility]
+    def self.fetch(url:)
+      document = Crawler.html(url:)
+      parse(url:, document:)
+    end
+
+    # @param url [String]
+    # @param document [Nokogiri::HTML::Document]
+    #
+    # @return [Facility]
+    def self.parse(url:, document:)
+      data = parse_json_ld(document: document)
+      id = ID_REGEX.match(url)[:id]
+
+      address = Address.parse(data: data['address'])
+      geocode = Geocode.parse(data: data['address'])
+
+      new(id:, url:, name: data['name'], address:, geocode:)
+    end
+
+    # @param document [Nokogiri::HTML::Document]
+    #
+    # @raise [ParseError]
+    #
+    # @return [Hash]
+    def self.parse_json_ld(document:)
+      document
+        .xpath('//script[@type="application/ld+json"]')
+        .map { |script| JSON.parse(script.text) }
+        .find { |data| data['@type'] == 'SelfStorage' }
+    end
+
+    # @param id [String]
+    # @param url [String]
+    # @param name [String]
+    # @param address [Address]
+    # @param geocode [Geocode]
+    # @param phone [String]
+    # @param email [String]
+    # @param prices [Array<Price>]
+    def initialize(id:, url:, name:, address:, geocode:, phone: DEFAULT_PHONE, email: DEFAULT_EMAIL, prices: [])
+      @id = id
+      @url = url
+      @name = name
+      @address = address
+      @geocode = geocode
+      @phone = phone
+      @email = email
+      @prices = prices
+    end
+
+    # @return [String]
+    def inspect
+      props = [
+        "id=#{@id.inspect}",
+        "url=#{@url.inspect}",
+        "address=#{@address.inspect}",
+        "geocode=#{@geocode.inspect}",
+        "phone=#{@phone.inspect}",
+        "email=#{@email.inspect}",
+        "prices=#{@prices.inspect}"
+      ]
+      "#<#{self.class.name} #{props.join(' ')}>"
+    end
+
+    # @return [String]
+    def text
+      "#{@id} | #{@name} | #{@phone} | #{@email} | #{@address.text} | #{@geocode.text}"
+    end
+  end
+end

data/lib/nsastorage/features.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # The features (e.g. climate-controlled, inside-drive-up-access, outside-drive-up-access, etc) of a price.
+  class Features
+    # @param element [Nokogiri::XML::Element]
+    #
+    # @return [Features]
+    def self.parse(element:)
+      text = element.text
+
+      new(
+        climate_controlled: text.include?('Climate controlled'),
+        inside_drive_up_access: text.include?('Inside drive-up access'),
+        outside_drive_up_access: text.include?('Outside drive-up access'),
+        first_floor_access: text.include?('1st floor access')
+      )
+    end
+
+    # @param climate_controlled [Boolean]
+    # @param inside_drive_up_access [Boolean]
+    # @param outside_drive_up_access [Boolean]
+    # @param first_floor_access [Boolean]
+    def initialize(climate_controlled:, inside_drive_up_access:, outside_drive_up_access:, first_floor_access:)
+      @climate_controlled = climate_controlled
+      @inside_drive_up_access = inside_drive_up_access
+      @outside_drive_up_access = outside_drive_up_access
+      @first_floor_access = first_floor_access
+    end
+
+    # @return [String]
+    def inspect
+      props = [
+        "climate_controlled=#{@climate_controlled}",
+        "inside_drive_up_access=#{@inside_drive_up_access}",
+        "outside_drive_up_access=#{@outside_drive_up_access}",
+        "first_floor_access=#{@first_floor_access}"
+      ]
+
+      "#<#{self.class.name} #{props.join(' ')}>"
+    end
+
+    # @return [String] e.g. "Climate Controlled + First Floor Access"
+    def text
+      amenities.join(' + ')
+    end
+
+    # @return [Array<String>]
+    def amenities
+      [].tap do |amenities|
+        amenities << 'Climate Controlled' if climate_controlled?
+        amenities << 'Inside Drive-Up Access' if inside_drive_up_access?
+        amenities << 'Outside Drive-Up Access' if outside_drive_up_access?
+        amenities << 'First Floor Access' if first_floor_access?
+      end
+    end
+
+    # @return [Boolean]
+    def climate_controlled?
+      @climate_controlled
+    end
+
+    # @return [Boolean]
+    def inside_drive_up_access?
+      @inside_drive_up_access
+    end
+
+    # @return [Boolean]
+    def outside_drive_up_access?
+      @outside_drive_up_access
+    end
+
+    # @return [Boolean]
+    def drive_up_access?
+      inside_drive_up_access? || outside_drive_up_access?
+    end
+
+    # @return [Boolean]
+    def first_floor_access?
+      @first_floor_access
+    end
+  end
+end

data/lib/nsastorage/fetch_error.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # Raised for unexpected HTTP responses.
+  class FetchError < Error
+    # @param url [String]
+    # @param response [HTTP::Response]
+    def initialize(url:, response:)
+      super("url=#{url} status=#{response.status.inspect} body=#{String(response.body).inspect}")
+    end
+  end
+end

data/lib/nsastorage/geocode.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # The geocode (latitude + longitude) of a facility.
+  class Geocode
+    # @attribute [rw] latitude
+    #   @return [Float]
+    attr_accessor :latitude
+
+    # @attribute [rw] longitude
+    #   @return [Float]
+    attr_accessor :longitude
+
+    # @param data [Hash]
+    #
+    # @return [Geocode]
+    def self.parse(data:)
+      new(
+        latitude: data['latitude'],
+        longitude: data['longitude']
+      )
+    end
+
+    # @param latitude [Float]
+    # @param longitude [Float]
+    def initialize(latitude:, longitude:)
+      @latitude = latitude
+      @longitude = longitude
+    end
+
+    # @return [String]
+    def inspect
+      props = [
+        "latitude=#{@latitude.inspect}",
+        "longitude=#{@longitude.inspect}"
+      ]
+      "#<#{self.class.name} #{props.join(' ')}>"
+    end
+
+    # @return [String]
+    def text
+      "#{@latitude},#{@longitude}"
+    end
+  end
+end

data/lib/nsastorage/link.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # A link in a sitemap.
+  class Link
+    # @attribute [rw] loc
+    #   @return [String]
+    attr_accessor :loc
+
+    # @attribute [rw] lastmod
+    #   @return [Time]
+    attr_accessor :lastmod
+
+    # @param loc [String]
+    # @param lastmod [String]
+    def initialize(loc:, lastmod:)
+      @loc = loc
+      @lastmod = Time.parse(lastmod)
+    end
+
+    # @return [String]
+    def inspect
+      "#<#{self.class.name} loc=#{@loc.inspect} lastmod=#{@lastmod.inspect}>"
+    end
+  end
+end

data/lib/nsastorage/price.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # The price (id + dimensions + rate) for a facility
+  class Price
+    # @attribute [rw] id
+    #   @return [String]
+    attr_accessor :id
+
+    # @attribute [rw] dimensions
+    #   @return [Dimensions]
+    attr_accessor :dimensions
+
+    # @attribute [rw] features
+    #   @return [Features]
+    attr_accessor :features
+
+    # @attribute [rw] rates
+    #   @return [Rates]
+    attr_accessor :rates
+
+    # @param id [String]
+    # @param dimensions [Dimensions]
+    # @param features [Features]
+    # @param rates [Rates]
+    def initialize(id:, dimensions:, features:, rates:)
+      @id = id
+      @dimensions = dimensions
+      @features = features
+      @rates = rates
+    end
+
+    # @return [String]
+    def inspect
+      props = [
+        "id=#{@id.inspect}",
+        "dimensions=#{@dimensions.inspect}",
+        "features=#{@features.inspect}",
+        "rates=#{@rates.inspect}"
+      ]
+      "#<#{self.class.name} #{props.join(' ')}>"
+    end
+
+    # @return [String] e.g. "123 | 5' × 5' (25 sqft) | $100 (street) / $90 (web)"
+    def text
+      "#{@id} | #{@dimensions.text} | #{@rates.text} | #{@features.text}"
+    end
+
+    # @param element [Nokogiri::XML::Element]
+    #
+    # @return [Price]
+    def self.parse(element:)
+      new(
+        id: element.attr('id'),
+        dimensions: Dimensions.parse(element:),
+        features: Features.parse(element:),
+        rates: Rates.parse(element:)
+      )
+    end
+  end
+end

data/lib/nsastorage/rates.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # The rates (street + web) for a facility
+  class Rates
+    STREET_SELECTOR = '.ptOriginalPriceSpan'
+    WEB_SELECTOR = '.ptDiscountPriceSpan'
+    VALUE_REGEX = /(?<value>[\d\.]+)/
+
+    # @attribute [rw] street
+    #   @return [Integer]
+    attr_accessor :street
+
+    # @attribute [rw] web
+    #   @return [Integer]
+    attr_accessor :web
+
+    # @param element [Nokogiri::XML::Element]
+    #
+    # @return [Rates]
+    def self.parse(element:)
+      street = parse_value(element: element.at_css(STREET_SELECTOR))
+      web = parse_value(element: element.at_css(WEB_SELECTOR))
+
+      new(street: street || web, web: web || street)
+    end
+
+    # @param element [Nokogiri::XML::Element]
+    #
+    # @return [Float, nil]
+    def self.parse_value(element:)
+      return if element.nil?
+
+      match = VALUE_REGEX.match(element.text)
+      Float(match[:value]) if match
+    end
+
+    # @param street [Integer]
+    # @param web [Integer]
+    def initialize(street:, web:)
+      @street = street
+      @web = web
+    end
+
+    # @return [String]
+    def inspect
+      props = [
+        "street=#{@street.inspect}",
+        "web=#{@web.inspect}"
+      ]
+      "#<#{self.class.name} #{props.join(' ')}>"
+    end
+
+    # @return [String] e.g. "$80 (street) | $60 (web)"
+    def text
+      "$#{@street} (street) | $#{@web} (web)"
+    end
+  end
+end

data/lib/nsastorage/sitemap.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module NSAStorage
+  # A sitemap on nsastorage.com.
+  #
+  # e.g. https://www.nsastorage.com/sitemap-facility.xml
+  class Sitemap
+    # @attribute [rw] links
+    #   @return [Array<Link>]
+    attr_accessor :links
+
+    # @param document [NokoGiri::XML::Document]
+    #
+    # @return [Sitemap]
+    def self.parse(document:)
+      links = document.xpath('//xmlns:url').map do |url|
+        loc = url.at_xpath('xmlns:loc')&.text
+        lastmod = url.at_xpath('xmlns:lastmod')&.text
+        Link.new(loc:, lastmod:)
+      end
+
+      new(links: links)
+    end
+
+    # @param url [String]
+    #
+    # @return [Sitemap]
+    def self.fetch(url:)
+      document = Crawler.xml(url:)
+      parse(document:)
+    end
+
+    # @param links [Array<Link>]
+    def initialize(links:)
+      @links = links
+    end
+
+    # @return [String]
+    def inspect
+      "#<#{self.class.name} links=#{@links.inspect}>"
+    end
+  end
+end

data/lib/nsastorage/version.rb

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

data/lib/nsastorage.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'http'
+require 'nokogiri'
+require 'zeitwerk'
+
+loader = Zeitwerk::Loader.for_gem
+loader.inflector.inflect 'nsastorage' => 'NSAStorage'
+loader.inflector.inflect 'cli' => 'CLI'
+loader.setup
+
+# An interface for NSAStorage.
+module NSAStorage
+  class Error < StandardError; end
+
+  # @return [Config]
+  def self.config
+    @config ||= Config.new
+  end
+
+  # @yield [config]
+  # @yieldparam config [Config]
+  def self.configure
+    yield config
+  end
+end

metadata

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: nsastorage
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kevin Sylvestre
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-12-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: optparse
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Uses HTTP.rb to scrape nsastorage.com.
+email:
+- kevin@ksylvest.com
+executables:
+- nsastorage
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- README.md
+- bin/console
+- bin/setup
+- exe/nsastorage
+- lib/nsastorage.rb
+- lib/nsastorage/address.rb
+- lib/nsastorage/cli.rb
+- lib/nsastorage/config.rb
+- lib/nsastorage/crawl.rb
+- lib/nsastorage/crawler.rb
+- lib/nsastorage/dimensions.rb
+- lib/nsastorage/facility.rb
+- lib/nsastorage/features.rb
+- lib/nsastorage/fetch_error.rb
+- lib/nsastorage/geocode.rb
+- lib/nsastorage/link.rb
+- lib/nsastorage/price.rb
+- lib/nsastorage/rates.rb
+- lib/nsastorage/sitemap.rb
+- lib/nsastorage/version.rb
+homepage: https://github.com/ksylvest/nsastorage
+licenses:
+- MIT
+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:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: A crawler for NSAStorage.
+test_files: []