hledger-forecast 0.1.8 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e4232c29fd944d0483590e646c0c5e1566357ec8dfc9f942007cdea6121dcad
-  data.tar.gz: 2a8636024b63cdce5cfe7bbec937c123a9f78492bfb53ac873f40e9aa00d204d
+  metadata.gz: f6dc9ef51b0f8d7927eb2b798d66257b740fad83be62d86c8207a5982aac752f
+  data.tar.gz: aec51b551655e2927de40237c64db32cfd4f4ebc40c855cd2bf97601e27112e2
 SHA512:
-  metadata.gz: 0a725ff17d252a8d2427ba4e2dd2c6fa90d10e4cc9e853a6d9293eebde6aa9a594c96a9e57f387c858767b03b56e3bb3717b49bee7adc64d32a47bcd93118ebe
-  data.tar.gz: 118d14cde7575795a9e6632b856b4a9a60392aa19d88ce4030e555f49b580aa0cd924a61e9d6970bfe1e26306b848af756337f50eb2fc48203662714f1edd4a3
+  metadata.gz: bf00818fbbb03977e633c1e4c4eba8dd3596a6150e87117aa04e2d4b0df94c83593bef598200fa524a5d7c1777ce0be4bec2c0c4f4f0f8c9cc362732a3c8a1dc
+  data.tar.gz: 7a093260f8624ba0a27ead898fcda52926a00cfa12ed9f3bf67e020eb8d3df0cdfe0aa498164f0d07975f7c39efac9f0c39dd282fdd14e6684328d94b3ebbac1

data/README.md

@@ -59,7 +59,9 @@ where:
 - `transactions.journal` might be your bank transactions (your "_actuals_")
 - `my_forecast.journal` is the generated forecast file
 
-### A simple config file
+## :gear: Configuration
+
+### The YAML file
 
 > **Note**: See the [example.yml](https://github.com/olimorris/hledger-forecast/blob/main/example.yml) file for an example of a complex config file
 
@@ -89,9 +91,7 @@ Let's examine what's going on in this config file:
 - Notice we're also using [virtual postings](https://hledger.org/1.29/hledger.html#virtual-postings) (designated by the brackets). This makes it easy to filter them out with the `-R` or `--real` option in Hledger
 - We also have not specified a currency; the default (`USD`) will be used
 
-### Extending the config file
-
-#### Periods
+### Periods
 
 Besides monthly recurring transactions, the app also supports the following periods:
 
@@ -101,12 +101,11 @@ Besides monthly recurring transactions, the app also supports the following peri
 - `once` - Generate _one-time_ transactions on a specified date
 - `custom` - Generate transactions every _n days/weeks/months_
 
-##### Custom period
+#### Custom period
 
 A custom period allows you to specify a given number of days, weeks or months for a transaction to repeat within. These can be included in the config file as follows:
 
 ```yaml
-# forecast.yml
 custom:
   - description: Fortnightly hair and beauty spend
     recurrence:
@@ -126,18 +125,17 @@ Where `quantity` is an integer and `period` is one of:
 - weeks
 - months
 
-#### Date constraints
+### Dates
 
 The core of any solid forecast is predicting the correct periods that costs will fall into. When running the app from the CLI, you can specify specific dates to generate transactions over (see the [usage](#rocket-usage) section).
 
 You can further control the dates at a period/top-level as well as at a transaction level:
 
-##### Top level
+#### Top level
 
 In the example below, all transactions in the `monthly` block will be constrained by the end date:
 
 ```yaml
-# forecast.yml
 monthly:
   - account: "[Assets:Bank]"
     start: "2023-03-01"
@@ -146,12 +144,11 @@ monthly:
       # details omitted for brevity
 ```
 
-##### Transaction level
+#### Transaction level
 
-In the example below, only the single transaction will be constrained by the end date:
+In the example below, only the single transaction will be constrained by the end date and controlled via an additional start date:
 
 ```yaml
-# forecast.yml
 monthly:
   - account: "[Assets:Bank]"
     start: "2023-03-01"
@@ -159,15 +156,17 @@ monthly:
       - amount: 2000
         category: "[Expenses:Mortgage]"
         description: Mortgage
+        start: "2023-05-01"
         end: "2025-01-01"
 ```
 
-#### Additional settings
+The addition of the `start` key means that while the block will start on 2023-03-01, the transaction for the mortgage won't start until `2023-05-01`.
+
+### Additional settings
 
 Additional settings in the config file to consider:
 
 ```yaml
-# forecast.yml
 settings:
   currency: GBP                 # Specify the currency to use
   show_symbol: true             # Show the currency symbol?
@@ -175,7 +174,9 @@ settings:
   thousands_separator: true     # Separate thousands with a comma?
 ```
 
-### Summarizing the config file
+## :rainbow: Helpers
+
+### Summarizing the forecast file
 
 As your config file grows, it can be helpful to sum up the total amounts and output them in the CLI. This can be achieved by:
 

data/example.yml

@@ -2,13 +2,19 @@ monthly:
   - account: "[Assets:Bank]"
     start: "2023-03-01"
     transactions:
+      - amount: -100
+        category: "[Income:Bonus]"
+        description: Bonus
+      - amount: -2000
+        category: "[Income:Salary]"
+        description: Salary
+      - amount: 500.00
+        category: "[Expenses:Food]"
+        description: Food
       - amount: 1000.00
         category: "[Expenses:Mortgage]"
         description: Mortgage
         end: "2024-01-01"
-      - amount: 500.00
-        category: "[Expenses:Food]"
-        description: Food
 
 quarterly:
   - account: "[Assets:Bank]"

data/lib/hledger_forecast/generator.rb

@@ -1,7 +1,6 @@
 module HledgerForecast
   # Generates journal entries based on a YAML forecast file.
   # on forecast data and optional existing transactions.
-  #
   class Generator
     class << self
       attr_accessor :settings
@@ -26,7 +25,7 @@ module HledgerForecast
       formatted_transaction = transaction.clone
 
       formatted_transaction['amount'] =
-        Money.from_cents(formatted_transaction['amount'].to_i * 100, @settings[:currency]).format(
+        Money.from_cents(formatted_transaction['amount'].to_f * 100, @settings[:currency]).format(
           symbol: @settings[:show_symbol],
           sign_before_symbol: @settings[:sign_before_symbol],
           thousands_separator: @settings[:thousands_separator] ? ',' : nil
@@ -89,9 +88,12 @@ module HledgerForecast
 
         if date_matches
           forecast['transactions'].each do |transaction|
-            end_date = transaction['end'] ? Date.parse(transaction['end']) : nil
+            transaction_start_date = transaction['start'] ? Date.parse(transaction['start']) : nil
+            transaction_end_date = transaction['end'] ? Date.parse(transaction['end']) : nil
 
-            next unless end_date.nil? || date <= end_date
+            if (transaction_start_date && date < transaction_start_date) || (transaction_end_date && date > transaction_end_date)
+              next
+            end
 
             write_transactions(output_file, date, account, format_transaction(transaction))
           end

data/lib/hledger_forecast/summarize.rb

@@ -1,132 +1,135 @@
 module HledgerForecast
   # Summarise a forecast YAML file and output it to the CLI
   class Summarize
-    def self.sum_transactions(forecast_data, period)
-      category_totals = Hash.new(0)
-      forecast_data[period]&.each do |entry|
-        entry['transactions'].each do |transaction|
-          category_totals[transaction['category']] += transaction['amount']
-        end
-      end
-
-      category_totals
-    end
+    @table = nil
+    @generator = nil
 
-    def self.print_category_totals(period, category_totals, generator)
-      puts "#{period.capitalize}:"
-      period_total = 0
+    def self.init_table
+      table = Terminal::Table.new
 
-      category_totals.each do |category, amount|
-        formatted_amount = generator.format_transaction({ 'amount' => amount })['amount']
-        formatted_amount = amount.to_i < 0 ? formatted_amount.green : formatted_amount.red
-        puts "  #{category.ljust(40)}#{formatted_amount}"
-        period_total += amount
-      end
+      table.add_row([{ value: 'FORECAST SUMMARY'.bold, colspan: 3, alignment: :center }])
+      table.add_separator
 
-      formatted_period_total = generator.format_transaction({ 'amount' => period_total })['amount']
-      formatted_period_total = period_total.to_i < 0 ? formatted_period_total.green : formatted_period_total.red
-      puts "  TOTAL".ljust(42) + formatted_period_total
+      @table = table
     end
 
-    def self.sum_all_periods(forecast_data)
-      periods = %w[monthly quarterly half-yearly yearly once]
-      total = {}
-      grand_total = 0
+    def self.init_generator(forecast_data)
+      generator = HledgerForecast::Generator
+      generator.configure_settings(forecast_data)
 
-      (periods + ['custom']).each do |period|
-        total[period] = sum_transactions(forecast_data, period)
-        grand_total += total[period]
+      @generator = generator
+    end
+
+    def self.sum_transactions(forecast_data, period)
+      category_total = Hash.new(0)
+      forecast_data[period]&.each do |entry|
+        entry['transactions'].each do |transaction|
+          category_total[transaction['category']] += transaction['amount']
+        end
       end
 
-      total['total'] = grand_total
-      total
+      category_total
     end
 
     def self.sum_custom_transactions(forecast_data)
-      category_totals = Hash.new(0)
+      category_total = Hash.new(0)
       custom_periods = []
 
       forecast_data['custom']&.each do |entry|
         period_data = {}
         period_data[:quantity] = entry['recurrence']['quantity']
         period_data[:period] = entry['recurrence']['period']
-        period_data[:description] = entry['transactions'].first['description']
         period_data[:category] = entry['transactions'].first['category']
         period_data[:amount] = entry['transactions'].first['amount']
 
         entry['transactions'].each do |transaction|
-          category_totals[transaction['category']] += transaction['amount']
+          category_total[transaction['category']] += transaction['amount']
         end
 
         custom_periods << period_data
       end
 
-      { totals: category_totals, periods: custom_periods }
+      { totals: category_total, periods: custom_periods }
     end
 
-    def self.generate(forecast)
-      forecast_data = YAML.safe_load(forecast)
-
-      category_totals_by_period = {}
-      %w[monthly quarterly half-yearly yearly once custom].each do |period|
-        category_totals_by_period[period] = sum_transactions(forecast_data, period)
-      end
+    def self.format_amount(amount)
+      formatted_amount = @generator.format_transaction({ 'amount' => amount })['amount']
+      amount.to_f < 0 ? formatted_amount.green : formatted_amount.red
+    end
 
-      grand_total = category_totals_by_period.values.map(&:values).flatten.sum
+    def self.add_rows_to_table(row_data, period_total, custom: false)
+      if custom
+        row_data[:periods].each do |period|
+          @table.add_row [{ value: period[:category], alignment: :left },
+                          { value: "every #{period[:quantity]} #{period[:period]}", alignment: :right },
+                          { value: format_amount(period[:amount]), alignment: :right }]
 
-      generator = HledgerForecast::Generator
-      generator.configure_settings(forecast_data)
+          period_total += period[:amount]
+        end
+      else
+        row_data.each do |category, amount|
+          @table.add_row [{ value: category, colspan: 2, alignment: :left },
+                          { value: format_amount(amount), alignment: :right }]
 
-      table = Terminal::Table.new
+          period_total += amount
+        end
+      end
 
-      table.add_row([{ value: 'FORECAST SUMMARY', colspan: 3, alignment: :center }])
-      table.add_separator
+      period_total
+    end
 
+    def self.add_categories_to_table(categories, forecast_data)
       first_period = true
-      category_totals_by_period.each do |period, category_totals|
-        non_zero_totals = category_totals.select { |_, amount| amount != 0 }
-        next if non_zero_totals.empty?
+      categories.each do |period, total|
+        category_total = total.reject { |_, amount| amount == 0 }
+        next if category_total.empty?
+
+        sorted_category_total = sort_transactions(category_total)
 
-        table.add_separator unless first_period
-        table.add_row([{ value: period.capitalize, colspan: 3, alignment: :center }])
+        @table.add_separator unless first_period
+        @table.add_row([{ value: period.capitalize.bold, colspan: 3, alignment: :center }])
 
         period_total = 0
+        period_total += if period == 'custom'
+                          add_rows_to_table(sum_custom_transactions(forecast_data), period_total, custom: true)
+                        else
+                          add_rows_to_table(sorted_category_total, period_total)
+                        end
 
-        if period == 'custom'
-          custom_periods_data = sum_custom_transactions(forecast_data)
-          custom_periods_data[:periods].each do |custom_period|
-            formatted_amount = generator.format_transaction({ 'amount' => custom_period[:amount] })['amount']
-            formatted_amount = custom_period[:amount].to_i < 0 ? formatted_amount.green : formatted_amount.red
-            table.add_row [{ value: custom_period[:category], alignment: :left },
-                           { value: "every #{custom_period[:quantity]} #{custom_period[:period]}", alignment: :right }, { value: formatted_amount, alignment: :right }]
-            period_total += custom_period[:amount]
-          end
-        else
-          non_zero_totals.each do |category, amount|
-            formatted_amount = generator.format_transaction({ 'amount' => amount })['amount']
-            formatted_amount = amount.to_i < 0 ? formatted_amount.green : formatted_amount.red
-
-            table.add_row [{ value: category, colspan: 2, alignment: :left },
-                           { value: formatted_amount, alignment: :right }]
-            period_total += amount
-          end
-        end
+        format_total("#{period.capitalize} TOTAL", period_total)
+        first_period = false
+      end
+    end
 
-        formatted_period_total = generator.format_transaction({ 'amount' => period_total })['amount']
-        formatted_period_total = period_total.to_i < 0 ? formatted_period_total.green : formatted_period_total.red
-        table.add_row [{ value: "#{period.capitalize} TOTAL", colspan: 2, alignment: :left },
-                       { value: formatted_period_total, alignment: :right }]
+    def self.sort_transactions(category_total)
+      negatives = category_total.select { |_, amount| amount < 0 }.sort_by { |_, amount| amount }
+      positives = category_total.select { |_, amount| amount > 0 }.sort_by { |_, amount| -amount }
 
-        first_period = false
+      negatives.concat(positives).to_h
+    end
+
+    def self.format_total(text, total)
+      @table.add_row [{ value: text.bold, colspan: 2, alignment: :left },
+                      { value: format_amount(total).bold, alignment: :right }]
+    end
+
+    def self.generate(forecast)
+      forecast_data = YAML.safe_load(forecast)
+
+      init_table
+      init_generator(forecast_data)
+
+      category_totals = {}
+      %w[monthly quarterly half-yearly yearly once custom].each do |period|
+        category_totals[period] = sum_transactions(forecast_data, period)
       end
 
-      table.add_separator
-      formatted_grand_total = generator.format_transaction({ 'amount' => grand_total })['amount']
-      formatted_grand_total = grand_total.to_i < 0 ? formatted_grand_total.green : formatted_grand_total.red
-      table.add_row [{ value: 'TOTAL', colspan: 2, alignment: :left },
-                     { value: formatted_grand_total, alignment: :right }]
+      add_categories_to_table(category_totals, forecast_data)
+
+      @table.add_separator
+      format_total("TOTAL", category_totals.values.map(&:values).flatten.sum)
 
-      puts table
+      puts @table
     end
   end
 end

data/lib/hledger_forecast/version.rb

@@ -1,3 +1,3 @@
 module HledgerForecast
-  VERSION = "0.1.8"
+  VERSION = "0.1.9"
 end

data/spec/start_date_spec.rb

@@ -0,0 +1,12 @@
+require_relative '../lib/hledger_forecast'
+RSpec.describe 'generate' do
+  it 'generates a forecast with correct MONTHLY transactions that have a START DATE' do
+    transactions = File.read('spec/stubs/transactions.journal')
+    forecast = File.read('spec/stubs/start_date/forecast_startdate.yml')
+
+    generated_journal = HledgerForecast::Generator.create_journal_entries(transactions, forecast, '2023-03-01', '2023-08-30')
+
+    expected_output = File.read('spec/stubs/start_date/output_startdate.journal')
+    expect(generated_journal).to eq(expected_output)
+  end
+end

data/spec/stubs/modifiers/forecast_modifiers.yml

@@ -0,0 +1,13 @@
+monthly:
+  - account: "[Assets:Bank]"
+    start: "2023-03-01"
+    transactions:
+      - amount: 2000
+        category: "[Expenses:Mortgage]"
+        description: Mortgage
+        modifier:
+          amount: 2.0
+          period: yearly
+
+settings:
+  currency: GBP

data/spec/stubs/modifiers/output_modifiers.journal

@@ -0,0 +1,44 @@
+2023-02-01 * Opening balance
+    Assets:Bank                             £1,000.00
+    Equity:Opening balance
+
+2023-02-05 * Mortgage payment
+    Expenses:Mortgage                 £1,500.00
+    Assets:Bank
+
+2023-03-01 * Mortgage
+    [Expenses:Mortgage]                £2,000.00
+    [Assets:Bank]
+
+2023-03-01 * Food
+    [Expenses:Food]                £100.00
+    [Assets:Bank]
+
+2023-03-01 * Savings
+    [Assets:Bank]                -£1,000.00
+    [Assets:Savings]
+
+2023-04-01 * Mortgage
+    [Expenses:Mortgage]                £2,000.00
+    [Assets:Bank]
+
+2023-04-01 * Food
+    [Expenses:Food]                £100.00
+    [Assets:Bank]
+
+2023-04-01 * Savings
+    [Assets:Bank]                -£1,000.00
+    [Assets:Savings]
+
+2023-05-01 * Mortgage
+    [Expenses:Mortgage]                £2,000.00
+    [Assets:Bank]
+
+2023-05-01 * Food
+    [Expenses:Food]                £100.00
+    [Assets:Bank]
+
+2023-05-01 * Savings
+    [Assets:Bank]                -£1,000.00
+    [Assets:Savings]
+

data/spec/stubs/monthly/forecast_monthly.yml

@@ -2,7 +2,7 @@ monthly:
   - account: "[Assets:Bank]"
     start: "2023-03-01"
     transactions:
-      - amount: 2000
+      - amount: 2000.55
         category: "[Expenses:Mortgage]"
         description: Mortgage
       - amount: 100

data/spec/stubs/monthly/output_monthly.journal

@@ -7,7 +7,7 @@
     Assets:Bank
 
 2023-03-01 * Mortgage
-    [Expenses:Mortgage]                £2,000.00
+    [Expenses:Mortgage]                £2,000.55
     [Assets:Bank]
 
 2023-03-01 * Food
@@ -19,7 +19,7 @@
     [Assets:Savings]
 
 2023-04-01 * Mortgage
-    [Expenses:Mortgage]                £2,000.00
+    [Expenses:Mortgage]                £2,000.55
     [Assets:Bank]
 
 2023-04-01 * Food
@@ -31,7 +31,7 @@
     [Assets:Savings]
 
 2023-05-01 * Mortgage
-    [Expenses:Mortgage]                £2,000.00
+    [Expenses:Mortgage]                £2,000.55
     [Assets:Bank]
 
 2023-05-01 * Food

data/spec/stubs/start_date/forecast_startdate.yml

@@ -0,0 +1,26 @@
+settings:
+  currency: GBP
+
+monthly:
+  - start: "2023-03-01"
+    account: "[Assets:Bank]"
+    transactions:
+      - description: Monthly Mortgage
+        start: "2023-06-01"
+        category: "[Expenses:Mortgage]"
+        amount: 2000
+      - description: Monthly Food
+        category: "[Expenses:Food]"
+        amount: 100
+
+quarterly:
+  - start: "2023-04-01"
+    account: "[Assets:Bank]"
+    transactions:
+      - description: Quarterly Mortgage
+        start: "2023-07-01"
+        category: "[Expenses:Mortgage]"
+        amount: 1000
+      - description: Quarterly Food
+        category: "[Expenses:Food]"
+        amount: 50

data/spec/stubs/start_date/output_startdate.journal

@@ -0,0 +1,56 @@
+2023-02-01 * Opening balance
+    Assets:Bank                             £1,000.00
+    Equity:Opening balance
+
+2023-02-05 * Mortgage payment
+    Expenses:Mortgage                 £1,500.00
+    Assets:Bank
+
+2023-03-01 * Monthly Food
+    [Expenses:Food]                £100.00
+    [Assets:Bank]
+
+2023-04-01 * Monthly Food
+    [Expenses:Food]                £100.00
+    [Assets:Bank]
+
+2023-04-01 * Quarterly Food
+    [Expenses:Food]                £50.00
+    [Assets:Bank]
+
+2023-05-01 * Monthly Food
+    [Expenses:Food]                £100.00
+    [Assets:Bank]
+
+2023-06-01 * Monthly Mortgage
+    [Expenses:Mortgage]                £2,000.00
+    [Assets:Bank]
+
+2023-06-01 * Monthly Food
+    [Expenses:Food]                £100.00
+    [Assets:Bank]
+
+2023-07-01 * Monthly Mortgage
+    [Expenses:Mortgage]                £2,000.00
+    [Assets:Bank]
+
+2023-07-01 * Monthly Food
+    [Expenses:Food]                £100.00
+    [Assets:Bank]
+
+2023-07-01 * Quarterly Mortgage
+    [Expenses:Mortgage]                £1,000.00
+    [Assets:Bank]
+
+2023-07-01 * Quarterly Food
+    [Expenses:Food]                £50.00
+    [Assets:Bank]
+
+2023-08-01 * Monthly Mortgage
+    [Expenses:Mortgage]                £2,000.00
+    [Assets:Bank]
+
+2023-08-01 * Monthly Food
+    [Expenses:Food]                £100.00
+    [Assets:Bank]
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hledger-forecast
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.9
 platform: ruby
 authors:
 - Oli Morris
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-17 00:00:00.000000000 Z
+date: 2023-04-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: highline
@@ -109,6 +109,7 @@ files:
 - spec/monthly_spec.rb
 - spec/once_spec.rb
 - spec/quarterly_spec.rb
+- spec/start_date_spec.rb
 - spec/stubs/custom/forecast_custom_days.yml
 - spec/stubs/custom/forecast_custom_months.yml
 - spec/stubs/custom/forecast_custom_weeks.yml
@@ -119,6 +120,8 @@ files:
 - spec/stubs/custom/output_custom_weeks_twice.journal
 - spec/stubs/half-yearly/forecast_half-yearly.yml
 - spec/stubs/half-yearly/output_half-yearly.journal
+- spec/stubs/modifiers/forecast_modifiers.yml
+- spec/stubs/modifiers/output_modifiers.journal
 - spec/stubs/monthly/forecast_monthly.yml
 - spec/stubs/monthly/forecast_monthly_enddate.yml
 - spec/stubs/monthly/forecast_monthly_enddate_top.yml
@@ -131,6 +134,8 @@ files:
 - spec/stubs/once/output_once.journal
 - spec/stubs/quarterly/forecast_quarterly.yml
 - spec/stubs/quarterly/output_quarterly.journal
+- spec/stubs/start_date/forecast_startdate.yml
+- spec/stubs/start_date/output_startdate.journal
 - spec/stubs/transactions.journal
 - spec/stubs/yearly/forecast_yearly.yml
 - spec/stubs/yearly/output_yearly.journal
@@ -165,6 +170,7 @@ test_files:
 - spec/monthly_spec.rb
 - spec/once_spec.rb
 - spec/quarterly_spec.rb
+- spec/start_date_spec.rb
 - spec/stubs/custom/forecast_custom_days.yml
 - spec/stubs/custom/forecast_custom_months.yml
 - spec/stubs/custom/forecast_custom_weeks.yml
@@ -175,6 +181,8 @@ test_files:
 - spec/stubs/custom/output_custom_weeks_twice.journal
 - spec/stubs/half-yearly/forecast_half-yearly.yml
 - spec/stubs/half-yearly/output_half-yearly.journal
+- spec/stubs/modifiers/forecast_modifiers.yml
+- spec/stubs/modifiers/output_modifiers.journal
 - spec/stubs/monthly/forecast_monthly.yml
 - spec/stubs/monthly/forecast_monthly_enddate.yml
 - spec/stubs/monthly/forecast_monthly_enddate_top.yml
@@ -187,6 +195,8 @@ test_files:
 - spec/stubs/once/output_once.journal
 - spec/stubs/quarterly/forecast_quarterly.yml
 - spec/stubs/quarterly/output_quarterly.journal
+- spec/stubs/start_date/forecast_startdate.yml
+- spec/stubs/start_date/output_startdate.journal
 - spec/stubs/transactions.journal
 - spec/stubs/yearly/forecast_yearly.yml
 - spec/stubs/yearly/output_yearly.journal