statbank_denmark 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ff97514ce9d09ec1296d7ce144c5a9d104f427c7f5a0ef888d0728779bcc3195
+  data.tar.gz: f670282617270e9c6f7d7d826c80728852266e7d13920d4ac585d29af7c6d71c
+SHA512:
+  metadata.gz: 383718b874f4b6216078e3588788bab94a9723bdcf37fe35116a05e9cfefd849dadc5513a07a9a8fc921797db0e76c2967273793a517f4a08f7b1c5031552da3
+  data.tar.gz: e9b17ec3220fa02870fcb5d80d086507f901631042062cb89a3be5a02ae6fe10360db57ab96e4dc350eed96391933c5e748abe275b3f5dd5691b7ef5238f2336

data/CHANGELOG.txt

@@ -0,0 +1,9 @@
+# CHANGELOG.md
+
+## [0.0.0] - 2025-09-08
+- Initial release
+- subjects(): /subjects endpoint
+- tables(): /tables endpoint
+- tableinfo(): /tableinfo endpoint
+- data(): /data endpoint
+- search(): Search all tables by string.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/README.md

@@ -0,0 +1,127 @@
+# statbank_denmark
+
+A Ruby client for easy access to StatBank; Denmark's official statistics (Danmarks Statistik) REST API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'statbank_denmark'
+```
+
+And then execute:
+
+```
+$ bundle install
+```
+
+Or install it yourself as:
+
+```
+$ gem install statbank_denmark
+```
+
+## Usage
+
+### Defaults for all interfaces
+```ruby
+lang: 'en' # also can be 'da'
+format: 'json' # except for data(), where it defaults to format: 'csv' and JSON data requires format: 'jsonstat'
+```
+
+### Via module methods
+```ruby
+# Get all subjects in English
+StatBankDenmark.subjects # implicitly lang: 'en'
+StatBankDenmark.subjects(lang: 'en') # explicitly lang: 'en'
+
+# Get all subjects in Danish
+StatBankDenmark.subjects(lang: 'da')
+
+# Get subjects recursively
+StatBankDenmark.subjects(recursive: true)
+
+# Get a list of all tables
+StatBankDenmark.tables
+
+# Get a list of tables about a specific subject by code
+StatBankDenmark.tables(subject: 4)
+
+# Get a list of tables which are inactive
+StatBankDenmark.tables(include_inactive: true)
+
+# Get a list of tables which are inactive on a specific subject by code
+StatBankDenmark.tables(include_inactive: true, subject: 4)
+
+# Get info on a specific table
+StatBankDenmark.table_info('STRAF42') # implicitly format: 'json'
+StatBankDenmark.table_info('STRAF42', format: 'json') # explicitly format: 'json'
+StatBankDenmark.table_info('STRAF42', format: 'csv') # format: 'csv'
+
+# Get data from a specific table
+StatBankDenmark.data('STRAF42') # implicitly format: 'csv'
+StatBankDenmark.data('STRAF42', format: 'csv') # explicitly format: 'csv'
+StatBankDenmark.data('STRAF42', format: 'jsonstat') # Returns json and must be specified with /jsonstat/i, not /json/i.
+
+# Search tables for metadata strings
+StatBankDenmark.search('population')
+StatBankDenmark.search('POPULATION') # case insensitive search
+StatBankDenmark.search('befolkning', lang: 'da') # lang: 'da'
+StatBankDenmark.search('BEFOLKNING', lang: 'da') # case insensitive search and lang: 'da'
+```
+
+### Via instantiation
+```ruby
+client = StatBankDenmark.new
+
+# Get all subjects in English
+client.subjects # implicitly lang: 'en'
+client.subjects(lang: 'en') # explicitly lang: 'en'
+
+# Get all subjects in Danish
+client.subjects(lang: 'da')
+
+# Get subjects recursively
+client.subjects(recursive: true)
+
+# Get a list of all tables
+client.tables
+
+# Get a list of tables about a specific subject by code
+client.tables(subject: 4)
+
+# Get a list of tables which are inactive
+client.tables(include_inactive: true)
+
+# Get a list of tables which are inactive on a specific subject by code
+client.tables(include_inactive: true, subject: 4)
+
+# Get info on a specific table
+client.table_info('STRAF42') # implicitly format: 'json'
+client.table_info('STRAF42', format: 'json') # explicitly format: 'json'
+client.table_info('STRAF42', format: 'csv') # format: 'csv'
+
+# Get data from a specific table
+client.data('STRAF42') # implicitly format: 'csv'
+client.data('STRAF42', format: 'csv') # explicitly format: 'csv'
+client.data('STRAF42', format: 'jsonstat') # Returns json and must be specified with /jsonstat/i, not /json/i.
+
+# Search tables for metadata strings
+client.search('population')
+client.search('POPULATION') # case insensitive search
+client.search('befolkning', lang: 'da') # lang: 'da'
+client.search('BEFOLKNING', lang: 'da') # case insensitive search and lang: 'da'
+```
+
+## Contributing
+
+1. Fork it (https://github.com/thoran/statbank_denmark/fork)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new pull request
+
+## License
+
+The gem is available as open source under the terms of the [Ruby License](https://opensource.org/licenses/MIT).

data/lib/Object/inQ.rb

@@ -0,0 +1,15 @@
+# Object/inQ.rb
+# Object#in?
+
+# 20250906
+# 0.5.1
+
+# Description: This is essentially the reverse of Enumerable#include?. It can be pointed at any object and takes a collection as an argument.
+
+class Object
+
+  def in?(*a)
+    a.flatten.include?(self)
+  end
+
+end

data/lib/StatBankDenmark/Client.rb

@@ -0,0 +1,199 @@
+# lib/StatBankDenmark/Client.rb
+# StatBankDenmark::Client
+
+gem 'http.rb'; require 'http.rb'
+require 'json'
+
+require_relative './Error'
+require_relative '../Object/inQ'
+
+module StatBankDenmark
+  class Client
+    ALLOWABLE_VERBS = %w{GET POST}
+    API_HOST = 'api.statbank.dk'
+
+    class << self
+      def path_prefix
+        '/v1'
+      end
+    end # class << self
+
+    def subjects(
+      format: 'json',
+      include_tables: nil,
+      lang: 'en',
+      omit_empty: nil,
+      recursive: nil
+    )
+      response = get(
+        path: '/subjects',
+        args: {
+          format: format,
+          includeTables: include_tables,
+          lang: lang,
+          omitEmptySubjects: omit_empty,
+          recursive: recursive,
+        }
+      )
+      handle_response(response)
+    end
+
+    def tables(
+      format: 'json',
+      include_inactive: nil,
+      lang: 'en',
+      subject: nil
+    )
+      response = get(
+        path: '/tables',
+        args: {
+          format: format,
+          includeInactive: include_inactive,
+          lang: lang,
+          subjects: subject,
+        }
+      )
+      handle_response(response)
+    end
+
+    def table_info(
+      table_id,
+      format: 'json',
+      lang: 'en'
+    )
+      raise ArgumentError, "table_id is required" if table_id.nil? || table_id.empty?
+      response = get(
+        path: '/tableinfo',
+        args: {
+          format: format,
+          lang: lang,
+          id: table_id,
+        }
+      )
+      handle_response(response)
+    end
+
+    def data(
+      table_id,
+      format: 'csv',
+      lang: 'en',
+      value_presentation: 'Default',
+      variables: {}
+    )
+      raise ArgumentError, "table_id is required" if table_id.nil? || table_id.empty?
+      body = {
+        table: table_id,
+        lang: lang,
+        format: format,
+        valuePresentation: value_presentation,
+      }
+      unless variables.empty?
+        body[:variables] = variables.map do |var_name, values|
+          {
+            code: var_name.to_s,
+            values: Array(values)
+          }
+        end
+      end
+      response = post(path: '/data', args: body)
+      handle_response(response)
+    end
+
+    def search(query, lang: 'en')
+      all_tables = tables(lang: lang)
+      return [] unless all_tables.is_a?(Array)
+      all_tables.select do |table|
+        text = table['text'] || table[:text] || ''
+        text.downcase.include?(query.downcase)
+      end
+    end
+
+    private
+
+    def initialize(timeout: 30)
+      @timeout = timeout
+    end
+
+    def get(path:, args: {})
+      do_request(verb: 'GET', path: path, args: args, options: {open_timeout: @timeout, read_timeout: @timeout})
+    end
+
+    def post(path:, args: {})
+      do_request(verb: 'POST', path: path, args: args, options: {open_timeout: @timeout, read_timeout: @timeout})
+    end
+
+    def do_request(verb:, path:, args: {}, options: {})
+      verb = verb.to_s.upcase
+      raise ArgumentError, "Unsupported HTTP method: #{verb}" unless verb.in?(ALLOWABLE_VERBS)
+      request_string = request_string(path: path)
+      args = args.reject{|k,v| v.nil?}
+      headers = {'Content-Type' => 'application/json'}
+      HTTP.send(verb.downcase, request_string, args, headers, options)
+    end
+
+    def request_string(path:)
+      "https://#{API_HOST}#{self.class.path_prefix}#{path}"
+    end
+
+    def handle_response(response)
+      if response.success?
+        body = response.body.to_s
+        parsed_response(response)
+      else
+        case response.code.to_i
+        when 400
+          raise BadRequestError.new(
+            code: response.code,
+            message: response.message,
+            body: response.body
+          )
+        when 404
+          raise NotFoundError.new(
+            code: response.code,
+            message: response.message,
+            body: response.body
+          )
+        when 429
+          raise RateLimitError.new(
+            code: response.code,
+            message: response.message,
+            body: response.body
+          )
+        when 500..599
+          raise ServerError.new(
+            code: response.code,
+            message: response.message,
+            body: response.body
+          )
+        else
+          raise APIError.new(
+            code: response.code,
+            message: response.message,
+            body: response.body
+          )
+        end
+      end
+    end
+
+    def parsed_response(response)
+      case response['content-type']
+      when /application\/json/
+        begin
+          JSON.parse(response.body)
+        rescue JSON::ParserError
+          response.body
+        end
+      when /text\/csv/
+        response.body
+      when /application\/xml/, /text\/xml/
+        response.body
+      else
+        begin
+          JSON.parse(response.body)
+        rescue JSON::ParserError
+          response.body
+        end
+      end
+    end
+  end
+end

data/lib/StatBankDenmark/Error.rb

@@ -0,0 +1,35 @@
+# lib/StatBankDenmark/Error.rb
+# StatBankDenmark::Error
+
+module StatBankDenmark
+  class Error < RuntimeError
+    attr_reader\
+      :code,
+      :message,
+      :body
+
+    def to_s
+      "#{self.class} (#{@code}): #{@message}"
+    end
+
+    private
+
+    def initialize(code:, message:, body:)
+      @code = code
+      @message = message
+      @body = body
+      super(message)
+    end
+  end
+
+  # 400
+  class BadRequestError < Error; end
+  # 404
+  class NotFoundError < Error; end
+  # 429
+  class RateLimitError < Error; end
+  # 500..599
+  class ServerError < Error; end
+  # Everything else.
+  class APIError < Error; end
+end

data/lib/StatBankDenmark/VERSION.rb

@@ -0,0 +1,6 @@
+# lib/StatBankDenmark/VERSION.rb
+# StatBankDenmark::VERSION
+
+module StatBankDenmark
+  VERSION = '0.0.0'
+end

data/lib/StatBankDenmark.rb

@@ -0,0 +1,35 @@
+# lib/StatBankDenmark.rb
+# StatBankDenmark
+
+require_relative './StatBankDenmark/VERSION'
+require_relative './StatBankDenmark/Client'
+
+module StatBankDenmark
+  class << self
+    def subjects(**options)
+      client.subjects(**options)
+    end
+
+    def tables(**options)
+      client.tables(**options)
+    end
+
+    def table_info(table_id, **options)
+      client.table_info(table_id, **options)
+    end
+
+    def data(table_id, **options)
+      client.data(table_id, **options)
+    end
+
+    def search(query, **options)
+      client.search(query, **options)
+    end
+
+    private
+
+    def client
+      @client ||= Client.new
+    end
+  end
+end

data/lib/statbank_denmark.rb

@@ -0,0 +1,3 @@
+# lib/statbank_denmark.rb
+
+require_relative './StatBankDenmark'

data/statbank_denmark.gemspec

@@ -0,0 +1,36 @@
+require_relative './lib/StatBankDenmark/VERSION'
+
+Gem::Specification.new do |spec|
+  spec.name = 'statbank_denmark'
+
+  spec.version = StatBankDenmark::VERSION
+  spec.date = '2025-09-09'
+
+  spec.summary = "A Ruby client for the StatBank Denmark API."
+  spec.description = "A Ruby client for easy access to StatBank; Denmark's official statistics (Danmarks Statistik) REST API."
+
+  spec.authors = 'thoran'
+  spec.email = 'code@thoran.com'
+  spec.homepage = 'https://github.com/thoran/statbank_denmark'
+  spec.license = 'Ruby'
+
+  spec.required_ruby_version = '>= 2.7'
+
+  spec.files = [
+    'CHANGELOG.txt',
+    'Gemfile',
+    'README.md',
+    'statbank_denmark.gemspec',
+    Dir['lib/**/*.rb'],
+    Dir['test/**/*.rb']
+  ].flatten
+  spec.require_paths = ['lib']
+
+  spec.add_dependency('http.rb')
+  spec.add_dependency('json')
+
+  spec.add_development_dependency('minitest')
+  spec.add_development_dependency('minitest-spec-context')
+  spec.add_development_dependency('webmock')
+  spec.add_development_dependency('vcr')
+end

data/test/StatBankDenmark/Client_test.rb

@@ -0,0 +1,316 @@
+# test/StatBankDenmark/Client_test.rb
+
+require_relative '../helper'
+
+describe StatBankDenmark::Client do
+  let(:client){StatBankDenmark::Client.new}
+
+  describe "#subjects" do
+    context "with English language" do
+      let(:result){client.subjects(lang: 'en')}
+
+      it "returns available subjects in English" do
+        VCR.use_cassette("subjects_en") do
+          _(result).must_be_kind_of(Array)
+          _(result).wont_be_empty
+          _(result.first.keys).must_include('id')
+          _(result.first.keys).must_include('description')
+          _(result.first.keys).must_include('active')
+          _(result.first.keys).must_include('hasSubjects')
+          _(result.first.keys).must_include('subjects')
+        end
+      end
+    end
+
+    context "with Danish language" do
+      let(:result){client.subjects(lang: 'da')}
+
+      it "returns available subjects in Danish" do
+        VCR.use_cassette("subjects_da") do
+          _(result).must_be_kind_of(Array)
+          _(result).wont_be_empty
+          _(result.first.keys).must_include('id')
+          _(result.first.keys).must_include('description')
+          _(result.first.keys).must_include('active')
+          _(result.first.keys).must_include('hasSubjects')
+          _(result.first.keys).must_include('subjects')
+        end
+      end
+    end
+
+    context "with recursive hierarchy enabled" do
+      let(:result){client.subjects(recursive: true)}
+
+      it "handles recursive parameter" do
+        VCR.use_cassette("subjects_recursive") do
+          _(result).must_be_kind_of(Array)
+        end
+      end
+    end
+
+    context "when API returns error" do
+      it "raises BadRequestError for invalid parameters" do
+        WebMock.stub_request(:get, /api\.statbank\.dk/).to_return(status: 400, body: 'Bad Request')
+        _(proc{client.subjects(lang: 'invalid')}).must_raise(StatBankDenmark::BadRequestError)
+      end
+    end
+  end
+
+  describe "#tables" do
+    context "when retrieving all tables" do
+      let(:result){client.tables}
+
+      it "returns all available tables" do
+        VCR.use_cassette("tables_all") do
+          _(result).must_be_kind_of(Array)
+          _(result).wont_be_empty
+          _(result.first).must_include('id')
+          _(result.first).must_include('text')
+          _(result.first).must_include('variables')
+        end
+      end
+    end
+
+    context "when filtering by specific subject" do
+      let(:result){client.tables(subject: 4)}
+
+      it "returns tables for crime and justice subject" do
+        VCR.use_cassette("tables_subject_crime") do
+          _(result).must_be_kind_of(Array)
+          _(result).wont_be_empty
+          crime_table = result.find{|t| t['id'] == 'STRAF42'}
+          _(crime_table).wont_be_nil if crime_table
+        end
+      end
+    end
+
+    context "when including inactive tables" do
+      let(:result){client.tables(include_inactive: true)}
+
+      it "handles include_inactive parameter" do
+        VCR.use_cassette("tables_include_inactive") do
+          _(result).must_be_kind_of(Array)
+        end
+      end
+    end
+
+    it "raises NotFoundError for non-existent subject" do
+      WebMock.stub_request(:get, /api\.statbank\.dk/).to_return(status: 404, body: 'Not Found')
+      _(proc {client.tables(subject: '999')}).must_raise(StatBankDenmark::NotFoundError)
+    end
+  end
+
+  describe "#table_info" do
+    context "when requesting metadata in English" do
+      let(:result){client.table_info('STRAF42')}
+
+      it "returns metadata for valid table" do
+        VCR.use_cassette("table_info_straf42") do
+          _(result).must_be_kind_of(Hash)
+          _(result).must_include('id')
+          _(result).must_include('text')
+          _(result).must_include('variables')
+          _(result['id']).must_equal('STRAF42')
+
+          variables = result['variables']
+          _(variables).must_be_kind_of(Array)
+          _(variables).wont_be_empty
+          _(variables.first).must_include('id')
+          _(variables.first).must_include('text')
+        end
+      end
+    end
+
+    context "when requesting metadata in Danish" do
+      let(:result){client.table_info('STRAF42', lang: 'da')}
+
+      it "returns metadata in Danish" do
+        VCR.use_cassette("table_info_straf42_da") do
+          _(result).must_be_kind_of(Hash)
+          _(result['id']).must_equal('STRAF42')
+        end
+      end
+    end
+
+    it "raises ArgumentError for nil table_id" do
+      _(proc{client.table_info(nil)}).must_raise(ArgumentError)
+    end
+
+    it "raises ArgumentError for empty table_id" do
+      _(proc{client.table_info('')}).must_raise(ArgumentError)
+    end
+
+    it "raises NotFoundError for non-existent table" do
+      WebMock.stub_request(:get, /api\.statbank\.dk/).to_return(status: 404, body: 'Table not found')
+      _(proc{client.table_info('NONEXISTENT')}).must_raise(StatBankDenmark::NotFoundError)
+    end
+  end
+
+  describe "#data" do
+    context "when requesting CSV format" do
+      let(:result) do
+        client.data(
+          'STRAF42',
+          format: 'csv',
+          variables: {'HERKOMST1' => ['00'], 'TID' => ['2023']}
+        )
+      end
+
+      it "returns CSV data for table with variables" do
+        VCR.use_cassette("data_straf42_csv") do
+          _(result).must_be_kind_of(String)
+          _(result).must_include('HERKOMST1')
+          _(result).must_include('2023')
+          _(result.lines.length).must_be(:>, 1)
+        end
+      end
+    end
+
+    context "when requesting JSON format" do
+      let(:result) do
+        client.data(
+          'STRAF42',
+          format: 'jsonstat',
+          variables: {'HERKOMST1' => ['00'], 'TID' => ['2023']}
+        )
+      end
+
+      it "returns JSON data for table" do
+        VCR.use_cassette("data_straf42_json") do
+          _(result).must_be_kind_of(Hash)
+          _(result).wont_be_empty
+          _(result['dataset']['dimension']).must_include('HERKOMST1')
+          _(result['dataset']['dimension']).must_include('ContentsCode')
+          _(result['dataset']['dimension']).must_include('Tid')
+          _(result['dataset']['dimension']).must_include('id')
+          _(result['dataset']['dimension']).must_include('size')
+          _(result['dataset']['dimension']).must_include('role')
+        end
+      end
+    end
+
+    context "when no variables specified" do
+      let(:result) do
+        client.data(
+          'STRAF42',
+          format: 'jsonstat'
+        )
+      end
+
+      it "returns all available data" do
+        VCR.use_cassette("data_straf42_all") do
+          _(result).must_be_kind_of(Hash)
+          _(result).wont_be_empty
+        end
+      end
+    end
+
+    it "raises ArgumentError for nil table_id" do
+      _(proc{client.data(nil)}).must_raise(ArgumentError)
+    end
+
+    it "raises ArgumentError for empty table_id" do
+      _(proc{client.data('')}).must_raise(ArgumentError)
+    end
+
+    it "raises BadRequestError for invalid variables" do
+      WebMock.stub_request(:post, /api\.statbank\.dk/).to_return(status: 400, body: 'Invalid variable specification')
+      _(proc{client.data('STRAF42', variables: {'INVALID' => ['bad']})}).must_raise(StatBankDenmark::BadRequestError)
+    end
+
+    it "handles rate limiting" do
+      WebMock.stub_request(:post, /api\.statbank\.dk/).to_return(status: 429, body: 'Rate limit exceeded')
+      _(proc{client.data('STRAF42')}).must_raise(StatBankDenmark::RateLimitError)
+    end
+
+    it "handles server errors" do
+      WebMock.stub_request(:post, /api\.statbank\.dk/).to_return(status: 500, body: 'Internal Server Error')
+      _(proc{client.data('STRAF42')}).must_raise(StatBankDenmark::ServerError)
+    end
+  end
+
+  describe "#search" do
+    context "when searching for existing tables" do
+      let(:result){client.search('crime')}
+
+      it "finds tables by search term" do
+        VCR.use_cassette("search_crime") do
+          _(result).must_be_kind_of Array
+          crime_table = result.find{|t| t['id'] == 'STRAF42'}
+          _(crime_table).wont_be_nil if crime_table
+        end
+      end
+    end
+
+    context "when searching for non-existent tables" do
+      let(:result){client.search('xyzzyx_nonexistent_term')}
+
+      it "returns empty array for no matches" do
+        VCR.use_cassette("search_nomatch") do
+          _(result).must_be_kind_of(Array)
+          _(result).must_be_empty
+        end
+      end
+    end
+
+    context "when testing case sensitivity" do
+      let(:result_lower){client.search('population')}
+      let(:result_upper){client.search('POPULATION')}
+
+      it "is case insensitive" do
+        VCR.use_cassette("search_case_insensitive") do
+          _(result_lower).must_equal(result_upper)
+        end
+      end
+    end
+
+    context "when searching in Danish" do
+      let(:result){client.search('befolkning', lang: 'da')}
+
+      it "searches in Danish language" do
+        VCR.use_cassette("search_danish") do
+          _(result).must_be_kind_of(Array)
+        end
+      end
+    end
+  end
+
+  describe "error handling" do
+    context "when network times out" do
+      before do
+        WebMock.stub_request(:get, /api\.statbank\.dk/).to_timeout
+      end
+
+      it "handles network timeouts" do
+        _(proc{client.subjects}).must_raise(StandardError)
+      end
+    end
+
+    context "when API returns malformed JSON" do
+      let(:result){client.subjects}
+
+      before do
+        WebMock.stub_request(:get, /api\.statbank\.dk/).to_return(
+          status: 200,
+          headers: {'Content-Type' => 'application/json'},
+          body: 'invalid json{'
+        )
+      end
+
+      it "handles malformed JSON responses gracefully" do
+        _(result).must_equal('invalid json{')
+      end
+    end
+  end
+
+  describe "private methods" do
+    it "builds request URLs correctly" do
+      url = client.send(:request_string, path: '/subjects')
+      _(url).must_equal('https://api.statbank.dk/v1/subjects')
+    end
+
+    it "validates HTTP verbs" do
+      _(proc{client.send(:do_request, verb: 'PATCH', path: '/test')}).must_raise(ArgumentError)
+    end
+  end
+end

data/test/StatBankDenmark/Error_test.rb

@@ -0,0 +1,45 @@
+# test/StatBankDenmark/Error_test.rb
+
+require_relative '../helper'
+
+describe StatBankDenmark::Error do
+  context "" do
+    let(:error) do
+      StatBankDenmark::BadRequestError.new(
+        code: 400,
+        message: "Bad Request",
+        body: "Invalid parameter"
+      )
+    end
+
+    it "stores error details" do
+      _(error.code).must_equal(400)
+      _(error.message).must_equal("Bad Request")
+      _(error.body).must_equal("Invalid parameter")
+    end
+  end
+
+  context "" do
+    let(:error) do
+      StatBankDenmark::NotFoundError.new(
+        code: 404,
+        message: "Not Found",
+        body: "Table does not exist"
+      )
+    end
+
+    it "provides meaningful string representation" do
+      _(error.to_s).must_equal("StatBankDenmark::NotFoundError (404): Not Found")
+    end
+  end
+
+  describe "error hierarchy" do
+    it "has correct inheritance" do
+      _(StatBankDenmark::BadRequestError).must_be :<, StatBankDenmark::Error
+      _(StatBankDenmark::NotFoundError).must_be :<, StatBankDenmark::Error
+      _(StatBankDenmark::RateLimitError).must_be :<, StatBankDenmark::Error
+      _(StatBankDenmark::ServerError).must_be :<, StatBankDenmark::Error
+      _(StatBankDenmark::APIError).must_be :<, StatBankDenmark::Error
+    end
+  end
+end

data/test/StatBankDenmark/VERSION_test.rb

@@ -0,0 +1,9 @@
+# test/StatBankDenmark/VERSION_test.rb
+
+require_relative '../helper'
+
+describe StatBankDenmark::VERSION do
+  it "returns the version number" do
+    _(StatBankDenmark::VERSION).must_match(/\d.\d.\d/)
+  end
+end

data/test/StatBankDenmark_test.rb

@@ -0,0 +1,15 @@
+# test/StatBankDenmark_test.rb
+
+require_relative './test_helper'
+
+describe StatBankDenmark do
+  describe "module methods" do
+    it "responds to core API methods" do
+      _(StatBankDenmark).must_respond_to(:subjects)
+      _(StatBankDenmark).must_respond_to(:tables)
+      _(StatBankDenmark).must_respond_to(:table_info)
+      _(StatBankDenmark).must_respond_to(:data)
+      _(StatBankDenmark).must_respond_to(:search)
+    end
+  end
+end

data/test/helper.rb

@@ -0,0 +1,15 @@
+# test/helper.rb
+
+require 'minitest/autorun'
+require 'minitest-spec-context'
+require 'webmock/minitest'
+require 'vcr'
+
+require_relative '../lib/statbank_denmark'
+
+VCR.configure do |config|
+  config.cassette_library_dir = File.join(__dir__, 'fixtures', 'vcr_cassettes')
+  config.hook_into :webmock
+  config.default_cassette_options = {record: :once}
+  config.allow_http_connections_when_no_cassette = true
+end

data/test/integration_test.rb

@@ -0,0 +1,40 @@
+# test/integration_test.rb
+# Note: This test bypasses VCR and makes real API calls.
+
+require_relative './helper'
+
+describe "Integration Tests", :integration do
+  let(:client){StatBankDenmark::Client.new}
+
+  before do
+    skip unless ENV['RUN_INTEGRATION_TESTS']
+  end
+
+  it "can fetch real data from Danish Statistics API" do
+    # Test the API
+    subjects = client.subjects
+    _(subjects).must_be_kind_of(Array)
+    _(subjects).wont_be_empty
+
+    # Find People subject
+    people_subject = subjects.find{|s| s['description']&.downcase&.include?('people')}
+    skip "People subject not found" unless people_subject
+
+    # Get People tables
+    tables = client.tables(subject: people_subject['id'])
+    _(tables).must_be_kind_of(Array)
+
+    # Find FOLK1A table
+    folk1a = tables.find{|t| t['id'] == 'FOLK1A'}
+    skip "FOLK1A table not found" unless folk1a
+
+    # Get table metadata
+    info = client.table_info('FOLK1A')
+    _(info['id']).must_equal('FOLK1A')
+
+    # Get some actual data (limited to avoid large responses)
+    data = client.data('FOLK1A', format: 'jsonstat')
+    _(data).must_be_kind_of(Hash)
+    _(data).wont_be_empty
+  end
+end

metadata

@@ -0,0 +1,140 @@
+--- !ruby/object:Gem::Specification
+name: statbank_denmark
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- thoran
+bindir: bin
+cert_chain: []
+date: 2025-09-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: http.rb
+  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: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest-spec-context
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby client for easy access to StatBank; Denmark's official statistics
+  (Danmarks Statistik) REST API.
+email: code@thoran.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.txt
+- Gemfile
+- README.md
+- lib/Object/inQ.rb
+- lib/StatBankDenmark.rb
+- lib/StatBankDenmark/Client.rb
+- lib/StatBankDenmark/Error.rb
+- lib/StatBankDenmark/VERSION.rb
+- lib/statbank_denmark.rb
+- statbank_denmark.gemspec
+- test/StatBankDenmark/Client_test.rb
+- test/StatBankDenmark/Error_test.rb
+- test/StatBankDenmark/VERSION_test.rb
+- test/StatBankDenmark_test.rb
+- test/helper.rb
+- test/integration_test.rb
+homepage: https://github.com/thoran/statbank_denmark
+licenses:
+- Ruby
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.1
+specification_version: 4
+summary: A Ruby client for the StatBank Denmark API.
+test_files: []