inquiry_attrs 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 615f0028c78433e7cd13171ce70724af8e5c535c9bc3ddac9127b6121cec6cc2
-  data.tar.gz: 95d371d0ee8d484e6f80b353a62dc49c92d19df63eeb08c35abaccccacb1738f
+  metadata.gz: e38ba51363664abde16b95c0369e6c81a59d5328a5040a3ae16f6b90ebc89fca
+  data.tar.gz: 8f90df1580bff8741d69d5654b16cf35ca81f5a31167a3a89563ebec7f2c4b10
 SHA512:
-  metadata.gz: f1327f64dc6cc2aec05aa5ae6b97619ba1bfa95cfe394633c44f7e7ca67a8d2fc4da5cb9cd58c114b234dde4eef3e5db973a35ed19e9678c23befd188b4d4b5b
-  data.tar.gz: a4ce3e81aab2b778aff6abf4c8532e5ed74765f457b49efc9a90134bf803d94f4396e5a3706875b73fa32159634e816779f4ad973b365f0ea105bc7ecd4bb8e5
+  metadata.gz: fc6265f245d6f36cba27d4f98f82e0e2778eccf657c0ea549ab46519db81fe7865a6f3c552f8a293b11bfd434124b04552f82698bacf0950750c31d01735b1b8
+  data.tar.gz: a9acf7294f8d6c55fe5dd5ab36871d9e5b35355665888276d875ab0fd6e3a330067e6c00544b0a4a61a1f23052e5a96b59377721c3b63e7580af5b2f9efcac37

data/CHANGELOG.md

@@ -1,11 +1,84 @@
 # Changelog
 
+All notable changes to `inquiry_attrs` are documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+---
+
 ## [1.0.0] — 2026-02-27
 
 ### Added
-- `InquiryAttrs::Concern` with `.inquirer(*attrs)` class macro
-- `InquiryAttrs::SymbolInquiry` — predicate wrapper for Symbol attributes
-- `InquiryAttrs::NilInquiry::INSTANCE` — frozen singleton for blank/nil attributes
-- Auto-include into `ActiveRecord::Base` via `ActiveSupport.on_load(:active_record)`
-- Support for StoreModel and plain Ruby classes via explicit `include`
-- LLM context files in `llms/`
+
+#### Core
+
+- **`InquiryAttrs::Concern`** — `ActiveSupport::Concern` that adds the
+  `.inquirer(*attrs)` class macro to any model. Automatically included into
+  `ActiveRecord::Base` via the generated initializer; opt-in for StoreModel
+  and plain Ruby classes via explicit `include`.
+
+- **`InquiryAttrs::NilInquiry`** — frozen singleton (`INSTANCE`) returned when
+  an inquired attribute is blank. Every `?`-predicate returns `false`; behaves
+  like `nil` in comparisons (`== nil`, `== ""`). Eliminates `NoMethodError` on
+  nil attributes.
+
+- **`InquiryAttrs::SymbolInquiry`** — `SimpleDelegator` subclass returned when
+  an inquired attribute holds a `Symbol`. Predicate methods match against the
+  symbol name; compares equal to both `Symbol` and `String`; `is_a?(Symbol)`
+  returns `true`.
+
+- **Return-type dispatch in `.inquirer`** — blank → `NilInquiry::INSTANCE`,
+  Symbol → `SymbolInquiry`, anything else → `ActiveSupport::StringInquirer`
+  (standard `"value".inquiry`).
+
+- **`instance_method` capture pattern** — the original attribute reader is
+  captured with `instance_method(attr)` and called via `bind_call` inside the
+  wrapper, so `attr_accessor`, StoreModel, and AR readers all work without
+  relying on `super()`.
+
+- **`remove_method` before `define_method`** — clears the reader from the
+  class's own method table before redefining, silencing Ruby's "method
+  redefined" warning that fires when AR/StoreModel define readers via
+  `define_method` and `inquirer` overwrites them.
+
+#### Install task
+
+- **`InquiryAttrs::Installer`** — pure Ruby class with `install!(rails_root)`
+  and `uninstall!(rails_root)` class methods. Accepts `Pathname` or `String`.
+  Returns `:created` / `:skipped` / `:removed` symbols. Testable without Rails
+  or Rake by passing a `Dir.mktmpdir` path.
+
+- **`InquiryAttrs::Railtie`** — loaded when `Rails::Railtie` is defined;
+  exposes `rails inquiry_attrs:install` and `rails inquiry_attrs:uninstall` to
+  the host application via `rake_tasks { load ... }`.
+
+- **`rails inquiry_attrs:install`** — writes
+  `config/initializers/inquiry_attrs.rb` containing the
+  `ActiveSupport.on_load(:active_record)` block. Skips silently if the file
+  already exists.
+
+- **`rails inquiry_attrs:uninstall`** — removes the generated initializer.
+  Skips silently if the file is absent.
+
+#### Developer experience
+
+- **`Rakefile`** — `bundle exec rake` / `bundle exec rake test` runs the full
+  Minitest suite.
+
+- **LLM context** — `AGENTS.md`, `CLAUDE.md`, `llms/overview.md`,
+  `llms/usage.md` shipped inside the gem for AI-assisted development.
+
+### Compatibility
+
+- Ruby ≥ 3.0
+- Rails 7.x and 8.x (`activesupport`, `activerecord`, `railties` — `>= 7.0, < 9`)
+
+---
+
+[Unreleased]: https://github.com/pniemczyk/inquiry_attrs/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/pniemczyk/inquiry_attrs/releases/tag/v1.0.0

data/README.md

@@ -34,6 +34,13 @@ gem 'inquiry_attrs'
 
 ### ActiveRecord — zero configuration
 
+Use rake task to install or uninstall the initializer:
+
+```bash
+rails inquiry_attrs:install                              # Install an initializer that auto-includes InquiryAttrs::Concern into ActiveRecord
+rails inquiry_attrs:uninstall                            # Remove the inquiry_attrs initializer
+```
+
 `inquiry_attrs` auto-includes itself into every `ActiveRecord::Base` subclass
 via `ActiveSupport.on_load(:active_record)`. Just call `.inquirer` in any model:
 

data/lib/inquiry_attrs/railtie.rb

@@ -6,7 +6,7 @@ module InquiryAttrs
 
     # Expose `rails inquiry_attrs:install` to the host application.
     rake_tasks do
-      load File.expand_path('../../tasks/inquiry_attrs.rake', __dir__)
+      load File.expand_path('../tasks/inquiry_attrs.rake', __dir__)
     end
   end
 end

data/lib/inquiry_attrs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module InquiryAttrs
-  VERSION = '1.0.0'
+  VERSION = '1.0.1'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inquiry_attrs
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Pawel Niemczyk
@@ -16,6 +16,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -23,6 +26,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
@@ -30,6 +36,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -37,6 +46,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement
@@ -44,6 +56,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -51,6 +66,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 description: |
   InquiryAttrs wraps ActiveRecord/ActiveModel (and StoreModel/Dry::Struct) attributes with
   predicate-style inquiry methods. Write user.status.active? instead of
@@ -58,7 +76,8 @@ description: |
   predicate — no more NoMethodError on nil. Run `rails inquiry_attrs:install`
   to generate an initializer that auto-includes the concern into every
   ActiveRecord model.
-email: []
+email:
+- pniemczyk.info@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -78,13 +97,12 @@ files:
 - lib/tasks/inquiry_attrs.rake
 - llms/overview.md
 - llms/usage.md
-homepage: https://github.com/your-org/inquiry_attrs
+homepage: https://github.com/pniemczyk/inquiry_attrs
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/your-org/inquiry_attrs
-  source_code_uri: https://github.com/your-org/inquiry_attrs
-  changelog_uri: https://github.com/your-org/inquiry_attrs/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/pniemczyk/inquiry_attrs
+  changelog_uri: https://github.com/pniemczyk/inquiry_attrs/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib