ratamin 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 657e9468e290eff1deeeb657db061a98dca992bece11887421737f1094bbfa28
-  data.tar.gz: 2d0672f141d7cd9596ccd108e848a0fbd7418f77de46b3f67e6a2aa6a1efe7b9
+  metadata.gz: 02ee6e23e9d84b754a71528330d35e2e19337d1dc4e9dc2573c0ead727e6f196
+  data.tar.gz: cba72054dff87188c6c1764ff69ad78ecc0d11383138fa6068d5fb486016535a
 SHA512:
-  metadata.gz: 93d38f02ff57591d942ed0f463ed5098a46e084a1270b0aadbdf6b1f3496d23e7a4ec5a30c95f6c6fec23baa92dbe63ee82a5763991d4b4be7ae8cbf4d7dba98
-  data.tar.gz: 15cf1c96fd1193292b98ef73626ea02859ee34c5d6f565c612a93a3d3adddaa62e1b3796185dadb2caa185e7fff0eddd4c43eade57a3e49560163a42fa813acb
+  metadata.gz: 9516cf7d76cf5e85907cf6a4d5e0f2cee6d990b772259a7c86b970a47a1d5fd7d70e87bea8c544ec5b9d7ec8c382aa5bb0814f46665fee35b6ef027f006336ff
+  data.tar.gz: 9d33dc214b7353fb81d867598ffaa5eb100a7e748dd4f247e833637f7df469803530fd715fd145f58f0acd8ef0ebbb0bdb70aca86ada03fcfd22e2aa3940e01d

data/.claude/skills/release-gem/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: release-gem
+description: Release a new version of the gem to RubyGems, update CHANGELOG.md, create a GitHub Release, and push a git tag. Use when the user wants to publish a new gem version.
+argument-hint: [version]
+---
+
+Release the gem. If $ARGUMENTS is provided, that is the new version number. Otherwise read the current version from `lib/ratamin/version.rb`.
+
+Steps:
+
+1. **Confirm version**: Read `lib/ratamin/version.rb`. If $ARGUMENTS differs from the current version, update the file and commit the change.
+
+2. **Run tests**: `bundle exec rspec` — abort if any tests fail.
+
+3. **Update CHANGELOG.md**: Add a new section for this version at the top (below the `## [Unreleased]` header if present), using Keep a Changelog format:
+   ```
+   ## [X.Y.Z] - YYYY-MM-DD
+   ### Added / Changed / Fixed
+   - ...
+   ```
+   Ask the user what to put in the changelog if there is nothing obvious from recent commits. Commit the changelog update together with any version bump.
+
+4. **Build the gem**: `gem build ratamin.gemspec`
+
+5. **Push to RubyGems**: `gem push ratamin-X.Y.Z.gem`
+
+6. **Create git tag**: `git tag vX.Y.Z`
+
+7. **Push commits and tag**: `git push origin main --tags`
+
+8. **Create GitHub Release**: Extract the release notes for this version from CHANGELOG.md and run:
+   ```
+   gh release create vX.Y.Z --title "vX.Y.Z" --notes-file <(extracted notes)
+   ```
+
+Report the RubyGems page and GitHub Release URL when done.

data/CHANGELOG.md

@@ -1,5 +1,40 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
 ## [Unreleased]
 
+## [0.2.0] - 2026-03-14
+
+### Added
+- `has_ratamin` DSL on models to declare which columns to display and override labels/widths
+- `Ratamin::Railtie` (opt-in via `require "ratamin/railtie"`) — injects `has_ratamin`/`Model.ratamin` into all AR models and `scope.ratamin` into `AR::Relation`
+- Default sort order is now newest-first (descending primary key) when no explicit order is given
+
+### Fixed
+- `has_ratamin` columns now inherit type and editability from the AR schema; explicitly passed options override the schema defaults
+- `Model.ratamin` no longer causes `SystemStackError` when the Railtie is not loaded
+- Forms where all columns are read-only no longer trap the user — `Esc` and `Enter` always work
+- Pagination fallback order now uses a table-qualified `ORDER BY "table"."id"` to avoid ambiguous column errors on joined scopes
+
 ## [0.1.0] - 2026-03-14
 
-- Initial release
+### Added
+- TUI admin console built on `ratatui_ruby` with table view and inline form editing
+- `ArrayDataSource` for in-memory data with a duck-type `DataSource` protocol
+- `ScopeDataSource` for ActiveRecord scopes with automatic column inference
+- Pagination support for AR scopes (limit/offset with configurable `per_page`)
+- `$EDITOR` integration for `:text` type fields (respects arguments in `$EDITOR`)
+- Non-editable fields (`id`, `created_at`, `updated_at`) protected from editing
+- Save failure handling — validation errors displayed inline in the form
+- Dirty tracking — only changed fields are sent to `update_row`
+- Zeitwerk autoloading
+- RSpec test suite with in-memory SQLite for ActiveRecord integration tests
+- GitHub Actions CI on Ruby 3.3, 3.4, and 4.0
+
+[Unreleased]: https://github.com/onyxblade/ratamin/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/onyxblade/ratamin/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/onyxblade/ratamin/releases/tag/v0.1.0

data/README.md

@@ -14,18 +14,47 @@ gem "ratamin"
 
 ## Usage
 
-### With ActiveRecord
+### Rails integration (recommended)
+
+Add the Railtie to an initializer to unlock `Model.ratamin` and `scope.ratamin` across your entire app:
+
+```ruby
+# config/initializers/ratamin.rb
+require "ratamin/railtie"
+```
+
+Then define which columns to show in your model:
+
+```ruby
+class User < ApplicationRecord
+  has_ratamin do
+    column :name, label: "Full Name", width: 20
+    column :email, width: 30
+    column :bio                        # type and editable inferred from schema
+  end
+end
+```
+
+Open the console and run:
+
+```ruby
+User.ratamin                           # all records, newest first
+User.where(role: "admin").ratamin      # filtered scope
+```
+
+Column type (`:text` vs `:string`) and editability (`id`, `created_at`, `updated_at` are read-only by default) are inferred from the schema. Any option explicitly passed to `column` overrides the inferred default.
+
+Without the Railtie, `scope.ratamin` is unavailable. You can still call `User.ratamin` after manually including `Ratamin::ModelMixin` in the model.
+
+### Manual usage (without Railtie)
 
 ```ruby
 require "ratamin"
 
-# Edit all users
+# Columns are inferred from the schema automatically
 Ratamin::App.new(Ratamin::ScopeDataSource.new(User.all)).run
 
-# Edit a filtered scope
-Ratamin::App.new(Ratamin::ScopeDataSource.new(User.where(role: "admin"))).run
-
-# Specify which columns to show
+# Or specify columns explicitly
 columns = [
   Ratamin::Column.new(key: :name, label: "Name", width: 20),
   Ratamin::Column.new(key: :email, label: "Email", width: 30),

data/lib/ratamin/model_config.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Ratamin
+  class ModelConfig
+    attr_reader :column_specs
+
+    def initialize
+      @column_specs = []
+    end
+
+    # Stores only the explicitly provided overrides; schema defaults are applied
+    # later by ScopeDataSource when it merges with AR column metadata.
+    def column(key, **overrides)
+      @column_specs << {key: key.to_sym, **overrides}
+    end
+  end
+end

data/lib/ratamin/model_mixin.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Ratamin
+  module ModelMixin
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+      # Define column config for the TUI:
+      #
+      #   class User < ApplicationRecord
+      #     has_ratamin do
+      #       column :name, label: "Full Name", width: 20
+      #       column :email, width: 30
+      #     end
+      #   end
+      #
+      def has_ratamin(&block)
+        @ratamin_config = ModelConfig.new
+        @ratamin_config.instance_eval(&block)
+      end
+
+      def ratamin_config
+        @ratamin_config
+      end
+
+      # Open the TUI for this model (defaults to all records, newest first):
+      #
+      #   User.ratamin
+      #
+      def ratamin
+        scope = all.order(arel_table[primary_key].desc)
+        App.new(ScopeDataSource.new(scope)).run
+      end
+    end
+  end
+
+  module RelationMixin
+    def ratamin
+      source = ScopeDataSource.new(self)
+      App.new(source).run
+    end
+  end
+end

data/lib/ratamin/railtie.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "ratamin"
+require "rails"
+
+module Ratamin
+  class Railtie < Rails::Railtie
+    initializer "ratamin.extend_active_record" do
+      ActiveSupport.on_load(:active_record) do
+        include Ratamin::ModelMixin
+        ActiveRecord::Relation.include(Ratamin::RelationMixin)
+      end
+    end
+  end
+end

data/lib/ratamin/scope_data_source.rb

@@ -77,7 +77,7 @@ module Ratamin
     def ordered_scope
       s = @scope.reset
       if s.order_values.empty?
-        s.order(s.klass.arel_table[s.klass.primary_key])
+        s.order(s.klass.arel_table[s.klass.primary_key].desc)
       else
         s
       end
@@ -93,14 +93,26 @@ module Ratamin
 
     def infer_columns
       model = @scope.klass
-      model.column_names.map do |name|
+      schema_defaults = build_schema_defaults(model)
+
+      if model.respond_to?(:ratamin_config) && (config = model.ratamin_config)
+        return config.column_specs.map do |spec|
+          Column.new(**schema_defaults.fetch(spec[:key], {}).merge(spec))
+        end
+      end
+
+      schema_defaults.values.map { |attrs| Column.new(**attrs) }
+    end
+
+    def build_schema_defaults(model)
+      model.column_names.each_with_object({}) do |name, hash|
         col = model.columns_hash[name]
-        Column.new(
+        hash[name.to_sym] = {
           key: name.to_sym,
           type: map_ar_type(col.type),
           width: guess_width(name, col.type),
           editable: !READONLY_COLUMNS.include?(name)
-        )
+        }
       end
     end
 

data/lib/ratamin/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ratamin
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratamin
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - merely
@@ -45,6 +45,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".claude/skills/release-gem/SKILL.md"
 - ".github/workflows/ci.yml"
 - ".gitmodules"
 - CHANGELOG.md
@@ -60,6 +61,9 @@ files:
 - lib/ratamin/editor_bridge.rb
 - lib/ratamin/form_state.rb
 - lib/ratamin/form_view.rb
+- lib/ratamin/model_config.rb
+- lib/ratamin/model_mixin.rb
+- lib/ratamin/railtie.rb
 - lib/ratamin/scope_data_source.rb
 - lib/ratamin/table_view.rb
 - lib/ratamin/update_result.rb