RubyGems - timeprice - Versions diffs - 0.6.0 → 0.8.0 - Mend

timeprice 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (84) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +99 -0
data/README.md +73 -2
data/data/cpi/au.json +419 -0
data/data/cpi/br.json +529 -0
data/data/cpi/ca.json +1501 -0
data/data/cpi/ch.json +549 -0
data/data/cpi/cn.json +487 -0
data/data/cpi/cz.json +500 -0
data/data/cpi/eu.json +1 -1
data/data/cpi/hk.json +351 -0
data/data/cpi/hu.json +537 -0
data/data/cpi/id.json +550 -0
data/data/cpi/il.json +549 -0
data/data/cpi/in.json +549 -0
data/data/cpi/jp.json +2 -2
data/data/cpi/kr.json +550 -0
data/data/cpi/mx.json +550 -0
data/data/cpi/my.json +429 -0
data/data/cpi/no.json +549 -0
data/data/cpi/nz.json +94 -0
data/data/cpi/ph.json +309 -0
data/data/cpi/pl.json +539 -0
data/data/cpi/ru.json +487 -0
data/data/cpi/se.json +549 -0
data/data/cpi/sg.json +369 -0
data/data/cpi/th.json +309 -0
data/data/cpi/tr.json +549 -0
data/data/cpi/uk.json +1 -1
data/data/cpi/us.json +1007 -5
data/data/cpi/vn.json +32 -32
data/data/cpi/za.json +549 -0
data/data/fx/usd/1999.json +5982 -262
data/data/fx/usd/2000.json +6999 -258
data/data/fx/usd/2001.json +7142 -257
data/data/fx/usd/2002.json +7170 -258
data/data/fx/usd/2003.json +7170 -258
data/data/fx/usd/2004.json +7282 -262
data/data/fx/usd/2005.json +7226 -260
data/data/fx/usd/2006.json +7170 -258
data/data/fx/usd/2007.json +7169 -258
data/data/fx/usd/2008.json +7184 -259
data/data/fx/usd/2009.json +6941 -259
data/data/fx/usd/2010.json +6995 -261
data/data/fx/usd/2011.json +6968 -260
data/data/fx/usd/2012.json +6941 -259
data/data/fx/usd/2013.json +6914 -258
data/data/fx/usd/2014.json +6914 -258
data/data/fx/usd/2015.json +6941 -259
data/data/fx/usd/2016.json +6968 -260
data/data/fx/usd/2017.json +6914 -258
data/data/fx/usd/2018.json +7148 -258
data/data/fx/usd/2019.json +7170 -258
data/data/fx/usd/2020.json +7226 -260
data/data/fx/usd/2021.json +7254 -261
data/data/fx/usd/2022.json +7226 -260
data/data/fx/usd/2023.json +7170 -258
data/data/fx/usd/2024.json +7198 -259
data/data/fx/usd/2025.json +7170 -258
data/data/fx/usd/2026.json +2561 -92
data/data/fx/usd/_annual.json +46 -1
data/data/manifest.json +565 -2
data/lib/timeprice/cli/presenters/compare.rb +44 -8
data/lib/timeprice/cli.rb +24 -7
data/lib/timeprice/compare/series.rb +120 -0
data/lib/timeprice/compare.rb +108 -15
data/lib/timeprice/cpi_lookup.rb +14 -8
data/lib/timeprice/data_loader.rb +8 -17
data/lib/timeprice/date.rb +62 -0
data/lib/timeprice/exchange.rb +49 -23
data/lib/timeprice/forecast/cagr.rb +96 -0
data/lib/timeprice/forecast/cpi_forecaster.rb +90 -0
data/lib/timeprice/forecast/fx_forecaster.rb +173 -0
data/lib/timeprice/forecast.rb +21 -0
data/lib/timeprice/inflation.rb +12 -4
data/lib/timeprice/metadata.rb +121 -0
data/lib/timeprice/metadata_snapshot.rb +23 -0
data/lib/timeprice/point.rb +11 -3
data/lib/timeprice/schema.rb +78 -0
data/lib/timeprice/sources.rb +1 -1
data/lib/timeprice/supported.rb +16 -0
data/lib/timeprice/version.rb +1 -1
data/lib/timeprice.rb +48 -3
metadata +49 -2

data/data/manifest.json CHANGED Viewed

@@ -1,25 +1,483 @@
 {
   "countries": [
+    {
+      "code": "AU",
+      "cpi_file": "cpi/au.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2024",
+          "min": "1960"
+        },
+        "quarterly": {
+          "max": "2026-Q1",
+          "min": "1948-Q3"
+        }
+      },
+      "currency": "AUD",
+      "granularities": [
+        "quarterly",
+        "annual"
+      ]
+    },
+    {
+      "code": "BR",
+      "cpi_file": "cpi/br.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1980"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1990-01"
+        }
+      },
+      "currency": "BRL",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "CA",
+      "cpi_file": "cpi/ca.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1914"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1914-01"
+        }
+      },
+      "currency": "CAD",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "CH",
+      "cpi_file": "cpi/ch.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1990-01"
+        }
+      },
+      "currency": "CHF",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "CN",
+      "cpi_file": "cpi/cn.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1986"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1993-01"
+        }
+      },
+      "currency": "CNY",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "CZ",
+      "cpi_file": "cpi/cz.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1991"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1991-01"
+        }
+      },
+      "currency": "CZK",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
     {
       "code": "EU",
       "cpi_file": "cpi/eu.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1996"
+        },
+        "monthly": {
+          "max": "2025-12",
+          "min": "1996-01"
+        }
+      },
       "currency": "EUR",
       "granularities": [
         "monthly",
         "annual"
       ]
     },
+    {
+      "code": "HK",
+      "cpi_file": "cpi/hk.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1981"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "2004-10"
+        }
+      },
+      "currency": "HKD",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "HU",
+      "cpi_file": "cpi/hu.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1972"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1990-01"
+        }
+      },
+      "currency": "HUF",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "ID",
+      "cpi_file": "cpi/id.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-04",
+          "min": "1990-01"
+        }
+      },
+      "currency": "IDR",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "IL",
+      "cpi_file": "cpi/il.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1990-01"
+        }
+      },
+      "currency": "ILS",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "IN",
+      "cpi_file": "cpi/in.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1990-01"
+        }
+      },
+      "currency": "INR",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
     {
       "code": "JP",
       "cpi_file": "cpi/jp.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2024",
+          "min": "1960"
+        }
+      },
       "currency": "JPY",
       "granularities": [
         "annual"
       ]
     },
+    {
+      "code": "KR",
+      "cpi_file": "cpi/kr.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-04",
+          "min": "1990-01"
+        }
+      },
+      "currency": "KRW",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "MX",
+      "cpi_file": "cpi/mx.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-04",
+          "min": "1990-01"
+        }
+      },
+      "currency": "MXN",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "MY",
+      "cpi_file": "cpi/my.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "2000-01"
+        }
+      },
+      "currency": "MYR",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "NO",
+      "cpi_file": "cpi/no.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1990-01"
+        }
+      },
+      "currency": "NOK",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "NZ",
+      "cpi_file": "cpi/nz.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2024",
+          "min": "1960"
+        }
+      },
+      "currency": "NZD",
+      "granularities": [
+        "annual"
+      ]
+    },
+    {
+      "code": "PH",
+      "cpi_file": "cpi/ph.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "2010-01"
+        }
+      },
+      "currency": "PHP",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "PL",
+      "cpi_file": "cpi/pl.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1970"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1990-01"
+        }
+      },
+      "currency": "PLN",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "RU",
+      "cpi_file": "cpi/ru.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1992"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1992-01"
+        }
+      },
+      "currency": "RUB",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "SE",
+      "cpi_file": "cpi/se.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1990-01"
+        }
+      },
+      "currency": "SEK",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "SG",
+      "cpi_file": "cpi/sg.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "2005-01"
+        }
+      },
+      "currency": "SGD",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "TH",
+      "cpi_file": "cpi/th.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "2010-01"
+        }
+      },
+      "currency": "THB",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
+    {
+      "code": "TR",
+      "cpi_file": "cpi/tr.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1990-01"
+        }
+      },
+      "currency": "TRY",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
+    },
     {
       "code": "UK",
       "cpi_file": "cpi/uk.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1988"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1988-01"
+        }
+      },
       "currency": "GBP",
       "granularities": [
         "monthly",
@@ -29,6 +487,16 @@
     {
       "code": "US",
       "cpi_file": "cpi/us.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2024",
+          "min": "1913"
+        },
+        "monthly": {
+          "max": "2026-04",
+          "min": "1913-01"
+        }
+      },
       "currency": "USD",
       "granularities": [
         "monthly",
@@ -38,22 +506,117 @@
     {
       "code": "VN",
       "cpi_file": "cpi/vn.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1995"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "2001-12"
+        }
+      },
       "currency": "VND",
       "granularities": [
         "monthly",
         "annual"
       ]
+    },
+    {
+      "code": "ZA",
+      "cpi_file": "cpi/za.json",
+      "cpi_ranges": {
+        "annual": {
+          "max": "2025",
+          "min": "1960"
+        },
+        "monthly": {
+          "max": "2026-03",
+          "min": "1990-01"
+        }
+      },
+      "currency": "ZAR",
+      "granularities": [
+        "monthly",
+        "annual"
+      ]
     }
   ],
   "fx": {
     "annual_file": "fx/usd/_annual.json",
+    "annual_only_currencies": [
+      "RUB",
+      "VND"
+    ],
     "base": "USD",
     "currencies": [
+      "AUD",
+      "BGN",
+      "BRL",
+      "CAD",
+      "CHF",
+      "CNY",
+      "CZK",
+      "DKK",
       "EUR",
       "GBP",
+      "HKD",
+      "HUF",
+      "IDR",
+      "ILS",
+      "INR",
+      "ISK",
       "JPY",
-      "VND"
+      "KRW",
+      "MXN",
+      "MYR",
+      "NOK",
+      "NZD",
+      "PHP",
+      "PLN",
+      "RON",
+      "RUB",
+      "SEK",
+      "SGD",
+      "THB",
+      "TRY",
+      "VND",
+      "ZAR"
+    ],
+    "daily_currencies": [
+      "AUD",
+      "BGN",
+      "BRL",
+      "CAD",
+      "CHF",
+      "CNY",
+      "CZK",
+      "DKK",
+      "EUR",
+      "GBP",
+      "HKD",
+      "HUF",
+      "IDR",
+      "ILS",
+      "INR",
+      "ISK",
+      "JPY",
+      "KRW",
+      "MXN",
+      "MYR",
+      "NOK",
+      "NZD",
+      "PHP",
+      "PLN",
+      "RON",
+      "SEK",
+      "SGD",
+      "THB",
+      "TRY",
+      "ZAR"
     ],
+    "daily_max": "2026-05-15",
+    "daily_min": "1999-01-04",
     "daily_years": [
       1999,
       2000,
@@ -85,6 +648,6 @@
       2026
     ]
   },
-  "generated_at": "2026-05-11",
+  "generated_at": "2026-05-16",
   "schema_version": 4
 }

data/lib/timeprice/cli/presenters/compare.rb CHANGED Viewed

@@ -15,30 +15,66 @@ module Timeprice
         end
         def json_hash
-          @result.to_h.merge(
+          base = @result.to_h.merge(
             amount: round_money(@result.amount, @result.to_currency),
             original_amount: round_money(@result.original_amount, @result.from_currency),
             converted_amount: round_money(@result.converted_amount, @result.to_currency),
             fx_rate: @result.fx_rate.to_f.round(6),
             cpi_ratio: @result.cpi_ratio.to_f.round(6)
           )
+          if @result.forecast
+            fc = @result.forecast
+            base[:forecast] = fc.merge(
+              low: round_money(fc[:low], @result.to_currency),
+              high: round_money(fc[:high], @result.to_currency)
+            )
+          else
+            base.delete(:forecast)
+          end
+          base
         end
         # Headline + left-to-right chain so the FX + CPI composition reads naturally.
         def text_lines
-          final = "#{fmt_money(@result.amount, @result.to_currency)} #{@result.to_currency}"
-          original = "#{fmt_money(@result.original_amount, @result.from_currency)} #{@result.from_currency}"
+          final     = "#{fmt_money(@result.amount, @result.to_currency)} #{@result.to_currency}"
+          original  = "#{fmt_money(@result.original_amount, @result.from_currency)} #{@result.from_currency}"
           converted = "#{fmt_money(@result.converted_amount, @result.to_currency)} #{@result.to_currency}"
-          step1 = "fx @ #{fmt_rate(@result.fx_rate)}"
-          step2 = "inflate x#{format("%.4f", @result.cpi_ratio)} #{@result.country}"
-          width = [step1.length, step2.length].max
-          [
-            "#{final}  in #{@result.to_date}",
+          step1     = "fx @ #{fmt_rate(@result.fx_rate)}"
+          step2     = "inflate x#{format("%.4f", @result.cpi_ratio)} #{@result.country}"
+          width     = [step1.length, step2.length].max
+          headline = if @result.forecast
+                       "#{final}  in #{@result.to_date}  (forecast)"
+                     else
+                       "#{final}  in #{@result.to_date}"
+                     end
+          lines = [
+            headline,
             "  #{original} (#{@result.from_date})",
             format("    -> %-#{width}s -> %s (%s)", step1, converted, @result.from_date),
             format("    -> %-#{width}s -> %s (%s, %s)", step2, final, @result.to_date,
                    Granularity.humanize(@result.granularity)),
           ]
+          @result.forecast ? lines + forecast_lines(final) : lines
+        end
+        private
+        def forecast_lines(mid_str)
+          fc       = @result.forecast
+          low_str  = "#{fmt_money(fc[:low], @result.to_currency)} #{@result.to_currency}"
+          high_str = "#{fmt_money(fc[:high], @result.to_currency)} #{@result.to_currency}"
+          extra = [
+            "",
+            "  range     #{low_str}  —  #{mid_str}  —  #{high_str}",
+            "            (low -1σ)        (most likely)      (high +1σ)",
+            "",
+            "  basis     trailing #{fc[:window_years]}y CAGR · last data #{fc[:last_known_date]}",
+            "            sigma ±#{format("%.1f", fc[:sigma_pct] * 100)}%/yr · horizon +#{fc[:horizon_months]}mo",
+          ]
+          if fc[:warnings].include?("horizon_exceeds_cap")
+            extra << "  caveat    long-horizon forecast: results are illustrative, not predictive"
+          end
+          extra
         end
       end
     end