Module: Timeprice::Sources

Defined in:

lib/timeprice/sources.rb,
lib/timeprice/sources/coverage.rb

Overview

Enumerate bundled data sources with license/attribution and the actual coverage range derived from data/ at runtime.

Defined Under Namespace

Modules: Coverage

Constant Summary

ATTRIBUTIONS =

Static license & attribution metadata. Coverage is computed dynamically.

[
  {
    id: "us_cpi",
    kind: "cpi",
    country: "US",
    name: "U.S. Bureau of Labor Statistics — CPI-U (series CUUR0000SA0)",
    license: "U.S. Government work — public domain",
    license_url: "https://www.bls.gov/bls/linksite.htm",
    attribution: "Data: U.S. Bureau of Labor Statistics",
  },
  {
    id: "uk_cpi",
    kind: "cpi",
    country: "UK",
    name: "UK Office for National Statistics — CPI all-items (series D7BT)",
    license: "Open Government Licence v3.0",
    license_url: "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
    attribution: "Contains public sector information licensed under the Open Government Licence v3.0",
  },
  {
    id: "eu_hicp",
    kind: "cpi",
    country: "EU",
    name: "Eurostat — HICP prc_hicp_midx (Euro area, all items)",
    license: "Eurostat reuse policy (free reuse with attribution)",
    license_url: "https://ec.europa.eu/eurostat/about-us/policies/copyright",
    attribution: "Source: Eurostat",
  },
  {
    id: "jp_cpi",
    kind: "cpi",
    country: "JP",
    name: "World Bank — FP.CPI.TOTL (annual, JP fallback)",
    license: "CC BY 4.0",
    license_url: "https://datacatalog.worldbank.org/public-licenses#cc-by",
    attribution: "Source: World Bank, FP.CPI.TOTL",
  },
  {
    id: "vn_cpi",
    kind: "cpi",
    country: "VN",
    name: "IMF Data Portal CPI dataflow (monthly primary) + World Bank FP.CPI.TOTL (annual fallback)",
    license: "IMF: free reuse with attribution; World Bank: CC BY 4.0",
    license_url: "https://www.imf.org/external/terms.htm",
    attribution: "Sources: IMF Data Portal CPI dataflow; World Bank FP.CPI.TOTL",
  },
  {
    id: "fx_ecb",
    kind: "fx",
    country: nil,
    name: "European Central Bank reference rates (via Frankfurter)",
    license: "ECB reference rates — free reuse",
    license_url: "https://www.ecb.europa.eu/services/disclaimer/html/index.en.html",
    attribution: "FX data: European Central Bank reference rates via Frankfurter",
  },
  {
    id: "fx_vnd",
    kind: "fx",
    country: "VN",
    name: "World Bank — PA.NUS.FCRF (VND annual average, annual-granularity fallback)",
    license: "CC BY 4.0",
    license_url: "https://datacatalog.worldbank.org/public-licenses#cc-by",
    attribution: "VND FX: World Bank, PA.NUS.FCRF",
  },
].freeze

Class Method Summary

• .list ⇒ Array<Hash>

  Returns an array of hashes with :id, :kind, :name, :license, :license_url, :attribution, :coverage (string like “1990-01 to 2026-03 (monthly+annual)”).

Class Method Details

.list ⇒ Array<Hash>

Returns an array of hashes with :id, :kind, :name, :license, :license_url, :attribution, :coverage (string like “1990-01 to 2026-03 (monthly+annual)”).

Returns:

• (Array<Hash>)

# File 'lib/timeprice/sources.rb', line 81

def list
  ATTRIBUTIONS.map { |s| s.merge(coverage: Coverage.for(s)) }
end