sam_gov_opportunities 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2fbefa3617aa3613df90d37c3103d0b6ec4b072564473fb3fbff7f9f98f3a81c
+  data.tar.gz: 664d76baf5841c00ee84567572d4d29565fb2120fdc507286107d1c696448e98
+SHA512:
+  metadata.gz: 2a6442ef54f50e41914316ae96e8d7bdfc7af9d10710b8fda8a616c72b46efac967a23d0122d44165da8fdf652314f6a81280a022bc93d4915dba9d2ac92947d
+  data.tar.gz: 927ff95232caf02274891da984bcef08e4ba4ad391ef797d27876dfefe06beb3ba1aafc77f621bbd1634a3ec34bcf6c3edec8e4188c87a8371eef196d63a962f

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [0.1.0] - 2025-03-13
+
+### Added
+- Initial release
+- Opportunities search with required date range
+- Convenience methods: recent, by_state, by_zip, by_naics, award_notices, expiring_soon
+- Offset-based pagination support
+- Date helpers for SAM.gov date format (MM/dd/yyyy)
+- API key authentication via query parameter

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jack Killilea
+
+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,270 @@
+# SAM Gov Opportunities
+
+A Ruby client for the [SAM.gov](https://api.sam.gov) Opportunities API v2. Search federal contract opportunities with filtering, pagination, and date helpers.
+
+**API key required.** See [API Key Setup](#api-key-setup) below.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'sam_gov_opportunities'
+```
+
+Then `bundle install`, or install directly:
+
+```bash
+gem install sam_gov_opportunities
+```
+
+## API Key Setup
+
+1. Go to [sam.gov](https://sam.gov/) and sign in (or create a [login.gov](https://login.gov) account)
+2. Navigate to Profile > API Keys (or visit the Entity Information page)
+3. Request a **Public API key** (type: "Opportunities Public API")
+4. Key arrives by email within a few minutes
+5. Set the environment variable:
+
+```bash
+export SAM_GOV_API_KEY="your-key-here"
+```
+
+## Quick Start
+
+```ruby
+require 'sam_gov_opportunities'
+
+SAMGov.configure do |config|
+  config.api_key = ENV['SAM_GOV_API_KEY']
+end
+
+# Search recent opportunities
+results = SAMGov.opportunities.recent(days: 30)
+results.each { |opp| puts opp['title'] }
+```
+
+## Usage
+
+### Search Opportunities
+
+```ruby
+# Search by date range
+response = SAMGov.opportunities.search(
+  posted_from: Date.new(2024, 1, 1),
+  posted_to: Date.new(2024, 3, 31)
+)
+
+response.results        # => [{ "noticeId" => "...", "title" => "...", ... }, ...]
+response.size           # => 100
+response.total_records  # => 1234
+response.next_page?     # => true
+```
+
+### Convenience Methods
+
+```ruby
+# Recent opportunities (last N days)
+SAMGov.opportunities.recent(days: 30)
+
+# Filter by state
+SAMGov.opportunities.by_state(
+  state: 'VA',
+  posted_from: Date.today - 30,
+  posted_to: Date.today
+)
+
+# Filter by ZIP code
+SAMGov.opportunities.by_zip(
+  zip: '22201',
+  posted_from: Date.today - 30,
+  posted_to: Date.today
+)
+
+# Filter by NAICS code
+SAMGov.opportunities.by_naics(
+  naics: '541511',
+  posted_from: Date.today - 30,
+  posted_to: Date.today
+)
+
+# Award notices only
+SAMGov.opportunities.award_notices(
+  posted_from: Date.today - 30,
+  posted_to: Date.today
+)
+
+# Opportunities with deadlines in the next 7 days
+SAMGov.opportunities.expiring_soon(
+  posted_from: Date.today - 90,
+  posted_to: Date.today,
+  days: 7
+)
+```
+
+### Date Helpers
+
+SAM.gov requires dates in `MM/dd/yyyy` format. The `DateHelpers` module handles conversion:
+
+```ruby
+# Format any date type
+SAMGov::DateHelpers.format(Date.today)         # => "03/13/2026"
+SAMGov::DateHelpers.format('2024-12-25')       # => "12/25/2024"
+
+# Date range for last N days
+SAMGov::DateHelpers.last_n_days(30)
+# => { posted_from: "02/11/2026", posted_to: "03/13/2026" }
+
+# Federal fiscal year boundaries (Oct 1 - Sep 30)
+SAMGov::DateHelpers.fiscal_year(2025)
+# => { posted_from: "10/01/2024", posted_to: "09/30/2025" }
+```
+
+### Pagination
+
+Iterate page by page with `each_page`:
+
+```ruby
+SAMGov.opportunities.each_page(
+  posted_from: Date.new(2024, 1, 1),
+  posted_to: Date.new(2024, 12, 31)
+) do |page|
+  page.each { |opp| process(opp) }
+end
+```
+
+Fetch all results at once:
+
+```ruby
+all = SAMGov.opportunities.all_opportunities(
+  posted_from: Date.new(2024, 1, 1),
+  posted_to: Date.new(2024, 3, 31)
+)
+all.size  # => total count
+```
+
+## Configuration
+
+```ruby
+SAMGov.configure do |config|
+  config.api_key = ENV['SAM_GOV_API_KEY']    # Required
+  config.timeout = 60                         # Request timeout in seconds (default: 30)
+  config.retries = 5                          # Max retries on 429/5xx (default: 3)
+  config.logger  = Logger.new($stdout)        # Optional request logging
+end
+```
+
+### Rails Initializer
+
+```ruby
+# config/initializers/sam_gov.rb
+SAMGov.configure do |config|
+  config.api_key = ENV['SAM_GOV_API_KEY']
+  config.timeout = 30
+  config.retries = 3
+  config.logger  = Rails.logger if Rails.env.development?
+end
+```
+
+### Per-Instance Client
+
+For different configurations in the same process:
+
+```ruby
+client = SAMGov::Client.new(custom_config)
+client.opportunities.search(posted_from: Date.today - 30, posted_to: Date.today)
+```
+
+## Response Object
+
+All API calls return a `SAMGov::Response`:
+
+```ruby
+response = SAMGov.opportunities.search(
+  posted_from: Date.today - 30,
+  posted_to: Date.today
+)
+
+response.results             # Array of opportunity hashes
+response.each { |r| ... }   # Enumerable — supports map, select, first, etc.
+response.size                # Results on this page
+response.empty?              # No results?
+response.total_records       # Total matching records
+response.limit               # Page size
+response.offset              # Current offset
+response.current_page        # Current page number (1-indexed)
+response.total_pages         # Total number of pages
+response.next_page?          # More pages available?
+response.next_offset         # Offset for next page
+response.success?            # HTTP 2xx?
+
+response['key']              # Direct hash access
+response.dig('nested', 'key')
+response.raw                 # Raw parsed JSON body
+response.to_h                # Always returns a Hash
+response.to_json             # JSON string
+```
+
+## Error Handling
+
+```ruby
+begin
+  SAMGov.opportunities.search(posted_from: Date.today, posted_to: Date.today)
+rescue SAMGov::BadRequestError => e
+  puts "Bad request: #{e.status} — #{e.body}"
+rescue SAMGov::NotFoundError => e
+  puts "Not found: #{e.status}"
+rescue SAMGov::UnauthorizedError => e
+  puts "Unauthorized — check your API key"
+rescue SAMGov::ForbiddenError => e
+  puts "Forbidden: #{e.body}"
+rescue SAMGov::RateLimitError
+  puts 'Rate limited — retries exhausted'
+rescue SAMGov::ServerError => e
+  puts "Server error: #{e.status}"
+rescue SAMGov::ConnectionError => e
+  puts "Network issue: #{e.message}"
+rescue SAMGov::MissingApiKeyError
+  puts 'API key not configured'
+rescue SAMGov::InvalidDateError => e
+  puts "Date format error: #{e.message}"
+end
+```
+
+Error hierarchy:
+
+```
+SAMGov::Error
+├── ClientError
+│   ├── BadRequestError         (400)
+│   ├── NotFoundError           (404)
+│   ├── UnauthorizedError       (401)
+│   ├── ForbiddenError          (403)
+│   └── RateLimitError          (429)
+├── ServerError                 (500+)
+├── ConnectionError             (timeouts, DNS, refused)
+├── MissingApiKeyError          (no API key configured)
+└── InvalidDateError            (bad date format/value)
+```
+
+All `ClientError` and `ServerError` subclasses expose `.status` and `.body`.
+
+## Development
+
+```bash
+git clone https://github.com/xjackk/sam_gov_opportunities.git
+cd sam_gov_opportunities
+bundle install
+
+bundle exec rspec       # Run tests
+bundle exec rubocop     # Lint
+```
+
+## Requirements
+
+- Ruby >= 3.1
+- Faraday ~> 2.0
+
+## License
+
+MIT License. See [LICENSE.txt](LICENSE.txt).

data/lib/sam_gov_opportunities/client.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'faraday/retry'
+
+module SAMGov
+  class Client
+    MAX_PAGES = 100
+
+    attr_reader :config
+
+    def initialize(config = SAMGov.configuration)
+      @config = config
+      return if config.api_key
+
+      raise MissingApiKeyError,
+            'SAM.gov API key is required. Set SAM_GOV_API_KEY or configure api_key.'
+    end
+
+    def connection
+      @connection ||= Faraday.new(url: config.base_url) do |f|
+        f.options.timeout      = config.timeout
+        f.options.open_timeout = 10
+
+        f.headers['User-Agent'] = "sam_gov_opportunities-rb/#{SAMGov::VERSION}"
+
+        f.request :json
+        f.response :json, content_type: /\bjson$/
+
+        f.request :retry,
+                  max: config.retries,
+                  interval: 0.5,
+                  interval_randomness: 0.5,
+                  backoff_factor: 2,
+                  retry_statuses: [429, 500, 502, 503, 504],
+                  exceptions: [
+                    Faraday::TimeoutError,
+                    Faraday::ConnectionFailed,
+                    Faraday::RetriableResponse
+                  ]
+
+        f.response :logger, config.logger if config.logger
+        f.adapter config.adapter
+      end
+    end
+
+    def get(params = {})
+      response = connection.get('', compact_params(params.merge(api_key: config.api_key)))
+      handle_response(response)
+    rescue Faraday::TimeoutError => e
+      raise ConnectionError, "Request timed out: #{e.message}"
+    rescue Faraday::ConnectionFailed => e
+      raise ConnectionError, "Connection failed: #{e.message}"
+    end
+
+    def paginate(params = {})
+      current_offset = params.fetch(:offset, 0)
+      limit = params.fetch(:limit, 100)
+      raise ArgumentError, 'limit must be > 0' if limit <= 0
+
+      iterations = 0
+      loop do
+        iterations += 1
+        response = get(params.merge(offset: current_offset, limit: limit))
+        yield response
+        break if response.empty?
+        break unless response.next_page?
+
+        current_offset = response.next_offset
+        break if iterations >= MAX_PAGES
+      end
+    end
+
+    def all(params = {})
+      records = []
+      paginate(params) { |response| records.concat(response.results) }
+      records
+    end
+
+    # Resource accessor
+
+    def opportunities
+      @opportunities ||= Resources::Opportunities.new(self)
+    end
+
+    def inspect
+      "#<#{self.class} base_url=#{config.base_url.inspect} timeout=#{config.timeout}>"
+    end
+
+    private
+
+    def compact_params(params)
+      params.compact.transform_keys(&:to_s)
+    end
+
+    def handle_response(response)
+      case response.status
+      when 200..299
+        Response.new(response.body, response.status)
+      when 400
+        raise BadRequestError.new(status: response.status, body: response.body)
+      when 401
+        raise UnauthorizedError.new(status: response.status, body: response.body)
+      when 403
+        raise ForbiddenError.new(status: response.status, body: response.body)
+      when 404
+        raise NotFoundError.new(status: response.status, body: response.body)
+      when 429
+        raise RateLimitError.new(status: 429, body: response.body)
+      when 400..499
+        raise ClientError.new(status: response.status, body: response.body)
+      when 500..599
+        raise ServerError.new(status: response.status, body: response.body)
+      else
+        raise Error, "Unexpected HTTP status: #{response.status}"
+      end
+    end
+  end
+end

data/lib/sam_gov_opportunities/configuration.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module SAMGov
+  class Configuration
+    DEFAULT_BASE_URL = 'https://api.sam.gov/opportunities/v2/search'
+    DEFAULT_TIMEOUT  = 30
+    DEFAULT_RETRIES  = 3
+
+    attr_accessor :base_url, :timeout, :retries, :logger, :adapter, :api_key
+
+    def initialize
+      @base_url = DEFAULT_BASE_URL
+      @timeout  = DEFAULT_TIMEOUT
+      @retries  = DEFAULT_RETRIES
+      @logger   = nil
+      @adapter  = Faraday.default_adapter
+      @api_key  = ENV.fetch('SAM_GOV_API_KEY', nil)
+    end
+
+    def to_h
+      {
+        base_url: base_url,
+        timeout: timeout,
+        retries: retries,
+        logger: logger,
+        adapter: adapter,
+        api_key: api_key
+      }
+    end
+
+    def inspect
+      "#<#{self.class} base_url=#{base_url.inspect} timeout=#{timeout} retries=#{retries}>"
+    end
+  end
+end

data/lib/sam_gov_opportunities/date_helpers.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'date'
+
+module SAMGov
+  module DateHelpers
+    module_function
+
+    def format(date)
+      case date
+      when Date, Time
+        date.strftime('%m/%d/%Y')
+      when String
+        parsed = Date.parse(date)
+        parsed.strftime('%m/%d/%Y')
+      else
+        raise InvalidDateError, "Cannot format #{date.class} as date"
+      end
+    rescue ArgumentError => e
+      raise InvalidDateError, e.message
+    end
+
+    def last_n_days(days = 30)
+      raise InvalidDateError, 'days must be <= 365' if days > 365
+      raise InvalidDateError, 'days must be positive' if days <= 0
+
+      today = Date.today
+      from_date = today - days
+      { posted_from: format(from_date), posted_to: format(today) }
+    end
+
+    def fiscal_year(year)
+      raise InvalidDateError, 'year must be >= 2' if year < 2
+
+      from_date = Date.new(year - 1, 10, 1)
+      to_date = Date.new(year, 9, 30)
+      { posted_from: format(from_date), posted_to: format(to_date) }
+    end
+  end
+end

data/lib/sam_gov_opportunities/error.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module SAMGov
+  class Error < StandardError; end
+
+  class ClientError < Error
+    attr_reader :status, :body
+
+    def initialize(message = nil, status: nil, body: nil)
+      @status = status
+      @body   = body
+      super(message || "HTTP #{status}: #{body}")
+    end
+  end
+
+  class BadRequestError < ClientError; end
+  class NotFoundError < ClientError; end
+  class UnauthorizedError < ClientError; end
+  class ForbiddenError < ClientError; end
+  class RateLimitError < ClientError; end
+
+  class ServerError < Error
+    attr_reader :status, :body
+
+    def initialize(message = nil, status: nil, body: nil)
+      @status = status
+      @body   = body
+      super(message || "Server error HTTP #{status}")
+    end
+  end
+
+  class ConnectionError < Error; end
+  class MissingApiKeyError < Error; end
+  class InvalidDateError < Error; end
+end

data/lib/sam_gov_opportunities/resources/base.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module SAMGov
+  module Resources
+    class Base
+      def initialize(client = SAMGov.client)
+        @client = client
+      end
+
+      private
+
+      attr_reader :client
+    end
+  end
+end

data/lib/sam_gov_opportunities/resources/opportunities.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module SAMGov
+  module Resources
+    class Opportunities < Base
+      def search(posted_from:, posted_to:, **params)
+        client.get(
+          params.merge(
+            postedFrom: DateHelpers.format(posted_from),
+            postedTo: DateHelpers.format(posted_to)
+          )
+        )
+      end
+
+      def recent(days: 30, **params)
+        dates = DateHelpers.last_n_days(days)
+        client.get(
+          params.merge(
+            postedFrom: dates[:posted_from],
+            postedTo: dates[:posted_to]
+          )
+        )
+      end
+
+      def by_state(state:, posted_from:, posted_to:, **params)
+        search(posted_from: posted_from, posted_to: posted_to, state: state, **params)
+      end
+
+      def by_zip(zip:, posted_from:, posted_to:, **params)
+        search(posted_from: posted_from, posted_to: posted_to, zipcode: zip, **params)
+      end
+
+      def by_naics(naics:, posted_from:, posted_to:, **params)
+        search(posted_from: posted_from, posted_to: posted_to, naics: naics, **params)
+      end
+
+      def award_notices(posted_from:, posted_to:, **params)
+        search(posted_from: posted_from, posted_to: posted_to, ptype: 'a', **params)
+      end
+
+      def expiring_soon(posted_from:, posted_to:, days: 7, **params)
+        today = Date.today
+        deadline = today + days
+        search(
+          posted_from: posted_from,
+          posted_to: posted_to,
+          rdlfrom: DateHelpers.format(today),
+          rdlto: DateHelpers.format(deadline),
+          **params
+        )
+      end
+
+      def each_page(posted_from:, posted_to:, **params, &block)
+        search_params = params.merge(
+          postedFrom: DateHelpers.format(posted_from),
+          postedTo: DateHelpers.format(posted_to)
+        )
+        client.paginate(search_params, &block)
+      end
+
+      def all_opportunities(posted_from:, posted_to:, **params)
+        search_params = params.merge(
+          postedFrom: DateHelpers.format(posted_from),
+          postedTo: DateHelpers.format(posted_to)
+        )
+        client.all(search_params)
+      end
+    end
+  end
+end

data/lib/sam_gov_opportunities/response.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module SAMGov
+  class Response
+    include Enumerable
+
+    attr_reader :raw, :status
+
+    def initialize(body, status)
+      @raw    = body
+      @status = status
+    end
+
+    def each(&)
+      results.each(&)
+    end
+
+    def results
+      return raw if raw.is_a?(Array)
+      return [] unless raw.is_a?(Hash)
+
+      raw['opportunitiesData'] || []
+    end
+
+    def size
+      results.size
+    end
+    alias length size
+
+    def empty?
+      results.empty?
+    end
+
+    def total_records
+      return nil unless raw.is_a?(Hash)
+
+      raw['totalRecords']
+    end
+
+    def limit
+      return nil unless raw.is_a?(Hash)
+
+      raw['limit']
+    end
+
+    def offset
+      return nil unless raw.is_a?(Hash)
+
+      raw['offset']
+    end
+
+    def next_page?
+      return false unless raw.is_a?(Hash)
+      return false unless total_records && offset && limit
+
+      (offset + limit) < total_records
+    end
+
+    def next_offset
+      return nil unless next_page?
+
+      offset + limit
+    end
+
+    def current_page
+      return nil unless offset && limit&.positive?
+
+      (offset / limit) + 1
+    end
+
+    def total_pages
+      return nil unless total_records && limit&.positive?
+
+      (total_records.to_f / limit).ceil
+    end
+
+    def [](key)
+      return nil unless raw.is_a?(Hash)
+
+      raw[key]
+    end
+
+    def dig(*keys)
+      return nil unless raw.is_a?(Hash)
+
+      raw.dig(*keys)
+    end
+
+    def to_h
+      raw.is_a?(Hash) ? raw : { 'opportunitiesData' => raw }
+    end
+
+    def to_json(*)
+      to_h.to_json
+    end
+
+    def success?
+      status >= 200 && status < 300
+    end
+
+    def inspect
+      "#<#{self.class} status=#{status} size=#{size} total_records=#{total_records.inspect} next_page?=#{next_page?}>"
+    end
+  end
+end

data/lib/sam_gov_opportunities/version.rb

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

data/lib/sam_gov_opportunities.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'sam_gov_opportunities/version'
+require 'sam_gov_opportunities/configuration'
+require 'sam_gov_opportunities/error'
+require 'sam_gov_opportunities/date_helpers'
+require 'sam_gov_opportunities/response'
+require 'sam_gov_opportunities/client'
+require 'sam_gov_opportunities/resources/base'
+require 'sam_gov_opportunities/resources/opportunities'
+
+module SAMGov
+  @mutex = Mutex.new
+
+  class << self
+    def configuration
+      @mutex.synchronize { @configuration ||= Configuration.new }
+    end
+
+    def configure
+      @mutex.synchronize { yield(@configuration ||= Configuration.new) }
+    end
+
+    def reset!
+      @mutex.synchronize do
+        @configuration = Configuration.new
+        @client = nil
+      end
+    end
+
+    def client
+      @mutex.synchronize { @client ||= Client.new(@configuration || Configuration.new) }
+    end
+
+    def opportunities
+      Resources::Opportunities.new(client)
+    end
+  end
+end

metadata

@@ -0,0 +1,174 @@
+--- !ruby/object:Gem::Specification
+name: sam_gov_opportunities
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jack Killilea
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.2'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.23'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.23'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.65'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.65'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+description: |
+  A Ruby client for the SAM.gov Opportunities API v2. Search federal contract
+  opportunities, filter by NAICS code, state, zip code, and more.
+email:
+- xkillilea@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/sam_gov_opportunities.rb
+- lib/sam_gov_opportunities/client.rb
+- lib/sam_gov_opportunities/configuration.rb
+- lib/sam_gov_opportunities/date_helpers.rb
+- lib/sam_gov_opportunities/error.rb
+- lib/sam_gov_opportunities/resources/base.rb
+- lib/sam_gov_opportunities/resources/opportunities.rb
+- lib/sam_gov_opportunities/response.rb
+- lib/sam_gov_opportunities/version.rb
+homepage: https://github.com/xjackk/sam_gov_opportunities
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/xjackk/sam_gov_opportunities
+  source_code_uri: https://github.com/xjackk/sam_gov_opportunities/tree/main/lib
+  changelog_uri: https://github.com/xjackk/sam_gov_opportunities/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/xjackk/sam_gov_opportunities/issues
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key: 
+specification_version: 4
+summary: Ruby client for the SAM.gov Opportunities API
+test_files: []