hledger-forecast 3.1.0 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 914475b3b188c0bf0950e6d2e0a88eb374a4486d41c901603c8cb41332e268f7
-  data.tar.gz: 241b415b6b95b42e757fd5302700cb4b6395bdce105f00782a49b0149be6b2d5
+  metadata.gz: 5acfd1bbab287a58bfe5ce7237576535b6b927d034da9e3651a4c240653e0f33
+  data.tar.gz: 23eb8d2646996b422473440b8f90797215a7390f4d6e2862b470bd361b6d55d5
 SHA512:
-  metadata.gz: cc7ee657e34ec05931165642761b797ec783d1c5c370d6085777d494503782efd32d140aea61e1e9f0d005ce5a6b69f5e28250a3c4150225ce70e5fbcc840a22
-  data.tar.gz: 5e6de9e3a6da7531b7d6a4f47b6126e6c34f92ba387cbdcb21584053530f46447d74c9a472bd34e89b566b731c6f71b56a826d17e2613632ae46f435bdbe9d65
+  metadata.gz: 62a027f56e0faf7641769b13928ed61c91e3851fe6b1623df00efd233ec244be03c57d7b94ea2605f01580ba18e0a916807a59c6ef848118d9b80fa9a3e8be28
+  data.tar.gz: 470b89a138eff0a2f5da24d4a4fe31ffd7e9584646094665020d19a40a9303877073bfcbc95eb35eae1498149fbfa96b899bd44c5ee4eab4225f26acec9b2e11

data/.github/workflows/release.yml

@@ -13,9 +13,36 @@ jobs:
       contents: write
       pull-requests: write
 
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+
     steps:
-      - name: Release 📦
+      - name: Release
+        id: release
         uses: googleapis/release-please-action@v4
         with:
           release-type: ruby
 
+  publish:
+    runs-on: ubuntu-latest
+    needs: release
+    if: needs.release.outputs.release_created == 'true'
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+
+      - name: Publish to RubyGems
+        run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+          gem build *.gemspec
+          gem push *.gem
+        env:
+          GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [3.2.0](https://github.com/olimorris/hledger-forecast/compare/v3.1.0...v3.2.0) (2026-04-13)
+
+
+### Features
+
+* can exclude tags in summarizer ([#16](https://github.com/olimorris/hledger-forecast/issues/16)) ([faee83e](https://github.com/olimorris/hledger-forecast/commit/faee83ee8eb554d146177832c307b87f5ecd4616))
+* from date can have calculations ([#18](https://github.com/olimorris/hledger-forecast/issues/18)) ([e62a693](https://github.com/olimorris/hledger-forecast/commit/e62a69385bf6c34f2d446593d5046fe22a1e7f5f))
+
 ## [3.1.0](https://github.com/olimorris/hledger-forecast/compare/v3.0.0...v3.1.0) (2026-04-02)
 
 

data/README.md

@@ -147,7 +147,7 @@ The CSV file should have a header row with these columns:
 | `type` | string | yes | One of: `monthly`, `quarterly`, `half-yearly`, `yearly`, `once`, `custom` |
 | `frequency` | string | `custom` only | Repeating frequency, using hledger's [periodic rule syntax](https://hledger.org/dev/hledger.html#periodic-transactions) |
 | `account` | string | yes | The account the transaction applies to, e.g. `Assets:Bank` |
-| `from` | date | yes | Start date, e.g. `01/03/2023` |
+| `from` | date | yes | Start date, e.g. `01/03/2023`. Supports `=` prefix for calculated values, e.g. `=01/03/2023+(5*12)` |
 | `to` | date | no | End date, e.g. `01/01/2025`. Supports `+` prefix for calculated values, e.g. `+12` for 12 months |
 | `description` | string | yes | A description of the transaction |
 | `category` | string | yes | The category account, e.g. `Expenses:Food` |
@@ -189,7 +189,17 @@ monthly,,Assets:Bank,01/03/2023,,New Kitchen,Expenses:House,=5000/24,,
 
 ### Calculated dates
 
-The `to` column supports calculated values. Use `+` followed by a number to mean "N months from the `from` date":
+Both `from` and `to` support calculated values.
+
+**`from` column** — prefix with `=` to compute a start date. The formula is `=BASE_DATE+OFFSET` where the offset is evaluated as months:
+
+```csv
+monthly,,Assets:Bank,=01/09/2025+(5*12),,Salary,Income:Salary,-3500,,
+```
+
+That sets the start date to 60 months (5 years) after `01/09/2025`, giving `01/09/2030`.
+
+**`to` column** — use `+` followed by a number to mean "N months from the `from` date":
 
 ```csv
 monthly,,Assets:Bank,01/03/2026,+12,Holiday,Expenses:Holiday,125,,
@@ -235,6 +245,9 @@ hledger-forecast summarize -f forecast.csv --tags=essential
 
 # Multiple tags use OR logic — matches any
 hledger-forecast summarize -f forecast.csv --tags=fixed,living
+
+# Can also exclude tags with a `-` prefix
+hledger-forecast summarize -f forecast.csv --tags=fixed,-essential
 ```
 
 **Querying in hledger** - because the tags are native hledger format, you can query them directly:

data/lib/hledger_forecast/calculator.rb

@@ -8,6 +8,17 @@ module HledgerForecast
       @calc.evaluate(amount.slice(1..-1))
     end
 
+    def self.evaluate_from_date(value)
+      value = value.to_s
+      return Date.parse(value) unless value.start_with?("=")
+
+      date_str, offset_expr = value[1..].split("+", 2)
+      date = Date.parse(date_str)
+      return date unless offset_expr
+
+      date >> @calc.evaluate(offset_expr).to_i
+    end
+
     def self.evaluate_date(from, to)
       return (from >> to) - 1 if to.is_a?(Numeric)
       return Date.parse(to) unless to.start_with?("=") || to.start_with?("+")

data/lib/hledger_forecast/transaction.rb

@@ -24,7 +24,7 @@ module HledgerForecast
     keyword_init: true
   ) do
     def self.from_row(row)
-      from = Date.parse(row[:from].to_s)
+      from = Calculator.evaluate_from_date(row[:from])
       new(
         type: row[:type],
         frequency: row[:frequency],
@@ -42,7 +42,14 @@ module HledgerForecast
 
     def matches_tags?(filter_tags)
       return true if filter_tags.nil? || filter_tags.empty?
-      (tags & filter_tags).any?
+
+      exclude_tags = filter_tags.select { |t| t.start_with?("-") }.map { |t| t[1..] }
+      include_tags = filter_tags.reject { |t| t.start_with?("-") }
+
+      return false if exclude_tags.any? && (tags & exclude_tags).any?
+      return (tags & include_tags).any? if include_tags.any?
+
+      true
     end
 
     def annualised_amount

data/lib/hledger_forecast/version.rb

@@ -1,3 +1,3 @@
 module HledgerForecast
-  VERSION = "3.1.0"
+  VERSION = "3.2.0"
 end

data/spec/calculator_spec.rb

@@ -23,6 +23,24 @@ RSpec.describe HledgerForecast::Calculator do
     end
   end
 
+  describe ".evaluate_from_date" do
+    it "parses a plain date string" do
+      expect(described_class.evaluate_from_date("01/09/2022")).to(eq(Date.parse("2022-09-01")))
+    end
+
+    it "evaluates a date with a month offset" do
+      expect(described_class.evaluate_from_date("=01/09/2022+6")).to(eq(Date.parse("2023-03-01")))
+    end
+
+    it "evaluates a date with a multiplied offset" do
+      expect(described_class.evaluate_from_date("=01/09/2022+(5*12)")).to(eq(Date.parse("2027-09-01")))
+    end
+
+    it "evaluates a formula with no offset" do
+      expect(described_class.evaluate_from_date("=01/09/2022")).to(eq(Date.parse("2022-09-01")))
+    end
+  end
+
   describe ".evaluate_date" do
     let(:from) { Date.parse("2023-03-01") }
 

data/spec/tags_spec.rb

@@ -72,6 +72,32 @@ RSpec.describe "tags" do
     expect(descriptions).to(eq(["Food", "Netflix"]))
   end
 
+  it "excludes transactions by tag with - prefix" do
+    result = HledgerForecast::Summarizer.summarize(config, {tags: ["-fixed"]})
+    descriptions = result[:output].map { |r| r[:description] }
+
+    expect(descriptions).to(eq(["Food", "Netflix"]))
+  end
+
+  it "excludes tags in generator output" do
+    expected = <<~JOURNAL
+      ~ monthly from 2023-03-01  * Food, Netflix
+          Expenses:Food             £500.00;  living:, essential:
+          Expenses:Subscriptions    £15.00 ;  living:
+          Assets:Bank
+
+    JOURNAL
+
+    expect(HledgerForecast::Generator.generate(config, {tags: ["-fixed"]})).to(eq(expected))
+  end
+
+  it "combines include and exclude tags" do
+    result = HledgerForecast::Summarizer.summarize(config, {tags: ["essential", "-fixed"]})
+    descriptions = result[:output].map { |r| r[:description] }
+
+    expect(descriptions).to(eq(["Food"]))
+  end
+
   it "raises an error when --tags is used on a CSV without a tag column" do
     csv_without_tag_column = <<~CSV
       type,frequency,account,from,to,description,category,amount,roll-up,summary_exclude

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hledger-forecast
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.2.0
 platform: ruby
 authors:
 - Oli Morris
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-02 00:00:00.000000000 Z
+date: 2026-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: abbrev
@@ -132,7 +132,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".github/workflows/ci.yml"
-- ".github/workflows/publish_ruby_gem.yml"
 - ".github/workflows/release.yml"
 - ".gitignore"
 - ".mise.toml"
@@ -201,7 +200,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.20
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Generate hledger journal entries and income statements from a CSV forecast

data/.github/workflows/publish_ruby_gem.yml

@@ -1,24 +0,0 @@
-name: Publish Ruby Gem
-
-on:
-  push:
-    tags:
-      - 'v*'
-  workflow_dispatch:
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-      - name: Publish Gem 💎️
-        run: |
-          mkdir -p $HOME/.gem
-          touch $HOME/.gem/credentials
-          chmod 0600 $HOME/.gem/credentials
-          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
-          gem build *.gemspec
-          gem push *.gem
-        env:
-          GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"