grain 0.0.1

data/lib/tasks/grain.rake

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+namespace :grain do
+  desc "Check every rollup against its source. VERIFY_REPAIR=1 rebuilds what disagrees."
+  task verify: :environment do
+    repair = ENV["VERIFY_REPAIR"] == "1"
+    reports = Grain::Registry.all.map { |rollup| rollup.verify(repair: repair) }
+    reports.each { |report| puts report }
+
+    # A non-zero exit so this can gate a build: a rollup that quietly disagrees
+    # with its source is worse than one that is obviously broken.
+    abort("grain:verify found disagreements") if reports.any? { |report| !report.clean? } && !repair
+  end
+
+  desc "Populate a rollup from data that already exists. ROLLUP=Name [FROM=2026-08-01] [PAUSE=0.5]"
+  task backfill: :environment do
+    name = ENV.fetch("ROLLUP") { abort("grain:backfill needs ROLLUP=SomeRollup") }
+    rollup = Grain::RollupLookup.find!(name)
+    from = ENV["FROM"]
+    slices = rollup.backfill(from: from, pause: ENV.fetch("PAUSE", 0).to_f) do |value, index, total|
+      # Printed so an interrupted backfill can be resumed with FROM= the last
+      # slice reported: they are processed in order and repeating one is harmless.
+      puts "grain: #{rollup} slice #{index}/#{total} #{value}"
+    end
+    puts "grain: #{rollup} backfilled #{slices} #{"slice".pluralize(slices)}"
+  end
+
+  desc "Drain the change log until it is empty."
+  task drain: :environment do
+    applied = Grain::Worker.drain
+    puts "grain: applied #{applied} change log #{"entry".pluralize(applied)}"
+  end
+end

data/sig/grain.rbs

@@ -0,0 +1,4 @@
+module Grain
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: grain
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Oscar Ortega
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+description: |-
+  Grain keeps dashboard aggregates pre-computed and incrementally up to date
+  inside your own Postgres database. You declare the grain of an aggregate
+  once — tenant, time bucket and dimensions — and Grain maintains it with
+  deltas driven by database triggers instead of recomputing everything on a
+  schedule. No new infrastructure, no materialized view refresh storms, and a
+  verify command that proves the aggregate still matches its source.
+email:
+- oscardeveloper14@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/generators/grain/install/install_generator.rb
+- lib/generators/grain/install/templates/create_grain_change_log.rb.erb
+- lib/generators/grain/install/templates/initializer.rb.erb
+- lib/generators/grain/rollup/rollup_generator.rb
+- lib/generators/grain/rollup/templates/rollup.rb.erb
+- lib/generators/grain/table/table_generator.rb
+- lib/generators/grain/table/templates/create_rollup_table.rb.erb
+- lib/grain.rb
+- lib/grain/backfill.rb
+- lib/grain/cells.rb
+- lib/grain/change_log.rb
+- lib/grain/configuration.rb
+- lib/grain/definition.rb
+- lib/grain/definition_validator.rb
+- lib/grain/dimension.rb
+- lib/grain/discrepancy.rb
+- lib/grain/errors.rb
+- lib/grain/fact.rb
+- lib/grain/join_graph.rb
+- lib/grain/measure.rb
+- lib/grain/migration.rb
+- lib/grain/path.rb
+- lib/grain/projection.rb
+- lib/grain/query.rb
+- lib/grain/query_sql.rb
+- lib/grain/railtie.rb
+- lib/grain/ratio.rb
+- lib/grain/recompute.rb
+- lib/grain/registry.rb
+- lib/grain/rollup.rb
+- lib/grain/rollup_lookup.rb
+- lib/grain/schema.rb
+- lib/grain/triggers.rb
+- lib/grain/type_resolver.rb
+- lib/grain/verification.rb
+- lib/grain/verification_query.rb
+- lib/grain/verification_report.rb
+- lib/grain/version.rb
+- lib/grain/watched_columns.rb
+- lib/grain/worker.rb
+- lib/tasks/grain.rake
+- sig/grain.rbs
+homepage: https://github.com/grainrb/grain
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/grainrb/grain
+  changelog_uri: https://github.com/grainrb/grain/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: Incrementally maintained pre-aggregates for Rails dashboards.
+test_files: []