arfi 0.5.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fbce7dd0e18813da12d98c7a402ffa750d71283cac00183048dcb55ec5608f6
-  data.tar.gz: e10e86e097d6721148d50ab0d74dd1375f8d74bdd69c280f54dcb9fa05d29c50
+  metadata.gz: 5bf85a9c94dff04b2907eb38de2c9d93ee81a3181b2c20fefe1c06175040b7d2
+  data.tar.gz: a3c95aceeaa4d699c945f43388f36bc5d8f386f85e9c011b5bc896d786fce69a
 SHA512:
-  metadata.gz: d221778200c55dcd83ba1416ca7d211f14c9f102acee8083dc6749f7c3b3cfad3e8e4bc75759099247cf5d653b1ba36223096d26992de3ad264f243b108da1e9
-  data.tar.gz: 6fdf8381a14d79a51b30a43e318af00cc1b5e578f2e605611332d77daf064d48f74cf87982025ab0d3e849019939d993fcca0a7e55c0bedd4a678515ea66c90e
+  metadata.gz: a213ffc24830392dc6cbb212a4d7b664078fefd0a52df1e48780ea81d5a1f950915811bc5af76ad75c8728630a2ec90a8dfcc9c5c782c4f05c4f749ffb2b9275
+  data.tar.gz: 315adf729a16f687bebb3d66d20951f8a09495e7863e0731516c0821fcd4c4adca660cbf173815264245158a17db21092b4f3a813f4f358b531139565c0cc6d2

data/.env.sample

@@ -0,0 +1,2 @@
+ARFI_POSTGRES_URL=postgresql://postgres:postgres@localhost:5432/arfi_test
+ARFI_MYSQL_URL=mysql2://root:password@127.0.0.1:3306/arfi_test# or trilogy://root:password@127.0.0.1:3306/arfi_test

data/.rspec

@@ -1,3 +1,4 @@
 --format documentation
 --color
 --require spec_helper
+--require rails_helper

data/.rubocop.yml

@@ -1,9 +1,16 @@
+inherit_from: .rubocop_todo.yml
+
 AllCops:
-  TargetRubyVersion: 3.1
+  TargetRubyVersion: 2.7
   NewCops: enable
   Exclude:
     - lib/arfi/extensions/active_record/connection_adapters/postgresql/database_statements.rb
     - 'vendor/**/*'
 
+plugins:
+  - rubocop-sorted_methods_by_call
+  - rubocop-rspec
+  - rubocop-performance
+
 Gemspec/DevelopmentDependencies:
   EnforcedStyle: gemspec

data/.rubocop_todo.yml

@@ -0,0 +1,12 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-06-13 13:57:26 UTC using RuboCop version 1.87.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 164

data/CHANGELOG.md

@@ -1,5 +1,99 @@
 ## [Unreleased]
 
+### v1.0.0 - 2026-06-13
+
+#### Added
+
+- **Database adapters**: MySQL, MariaDB, and Trilogy (Rails 7.1+) support — built-in, not a third-party gem
+- **Multi-database Rails support**: iterate over all DB configs for the current environment; works with suffixed Rake tasks (`db:migrate:animals`) and non-suffixed tasks
+- **Runtime recovery**: `PG::UndefinedFunction` auto-reload — catches the error, reloads function files on the same connection, retries the query once (thread-guarded)
+- **CLI (Thor-based)**:
+  - `arfi init` — bootstrap `db/functions/` directory structure
+  - `arfi functions create/destroy` — manage function SQL files
+  - `--template` option for custom Ruby templates (variables: `function_name`, `schema_name`, `qualified_name`, `original_ref`)
+  - `--adapter postgresql|mysql|trilogy` for adapter-specific placement and skeletons
+  - `--schema <name>` for PostgreSQL schema-qualified functions
+  - Backward-compatible aliases: `arfi project create`, `arfi f_idx create/destroy`
+- **Directory layout (1.0.0+)**: `db/functions/public/`, `db/functions/postgresql/{public,schema}/`, `db/functions/mysql/public/` with adapter-over-generic override resolution
+- **Rake integration**: hooks into `db:migrate`, `db:prepare`, `db:setup`, `db:test:prepare`, `db:schema:load` for both single-DB and multi-DB
+- **RBS type signatures** for all public and private methods (`sig/`)
+- **Steep type checking** in CI
+- **RuboCop** with sorted-methods-by-call enforcement
+- **RSpec test suite** with Docker Compose (PostgreSQL + MySQL) for integration specs
+- **GitHub Actions CI**: lint, typecheck, docscribe verification, matrix tests (Rails 6.0–8.1, Ruby 2.7–4.0, MariaDB)
+- **Docscribe integration** for YARD documentation validation
+- **Community files**: `CONTRIBUTING.md`, `SECURITY.md`, `CODE_OF_CONDUCT.md`, issue/PR templates
+
+#### Fixed
+
+- **Multi-DB connection restore**: `populate_multiple_db` now saves the original connection config before iterating databases and restores it in `ensure`, matching the pattern used in `run_with_connection_switch` (db.rake). Previously the original connection was never restored.
+
+#### Changed
+
+- **CLI architecture**: migrated from Rake-based commands to Thor CLI with `functions` and `init` command groups
+- **YARD documentation**: auto-generated via docscribe with `--rbs-collection` flag
+- **Dependency management**: unified Gemfile with versioned gemfiles for Rails 6.0–8.1
+
+#### Removed
+
+- SQL function versioning system (single-file-per-function current-state model replaces versioned SQL files)
+
+### [0.5.1] - 2025-06-13
+
+#### Fixed
+
+- Connection creation with ActiveRecord (`sql_function_loader.rb`) — improved compatibility with various AR connection pool configurations (#11)
+
+### [0.5.0] - 2025-05-25
+
+#### Added
+
+- **YARD documentation generator**: `rakelib/yard_docs_generator.rake` for automated YARD docs generation
+- **RBS signatures** for CLI and project commands
+- **CI improvements**: expanded GitHub Actions workflow with broader Ruby/Rails matrix coverage
+- **README documentation**: expanded with configuration details and usage examples
+
+#### Changed
+
+- **CLI commands**: updated project and f_idx commands with improved output formatting
+- **SQL function loader**: refined SQL content extraction logic
+- **Database statements**: added annotation to PostgreSQL database_statements extension
+
+### [0.4.0] - 2025-05-18
+
+#### Added
+
+- **Multi-database support**: iterate over all DB configs for the current environment; works with suffixed Rake tasks (`db:migrate:animals`) and non-suffixed tasks
+- **Rake tasks for multi-DB**: `db.rake` handles multiple database configurations
+- **RBS signatures**: complete RBS type signatures for all public modules and classes
+- **Steepfile**: Steep type checking configuration
+- **rbs_collection**: dependency management for RBS types
+
+#### Changed
+
+- **SQL function loader**: refactored to support multiple database connections
+- **Railtie**: updated to register tasks for multi-DB environments
+- **CI workflow**: expanded to test against Rails 6.0–8.0 across multiple Ruby versions
+- **CLI commands**: updated to accept database configuration parameters
+
+### [0.3.1] - 2025-05-06
+
+#### Added
+
+- **Custom SQL templates**: `--template` flag with Ruby evaluation for standardized function patterns (supports `function_name`, `schema_name`, `qualified_name`, `original_ref` variables)
+- **RBS type signatures**: initial type signatures for commands, errors, extensions, and SQL function loader
+- **RSpec test suite**: specs for CLI commands and functional index management
+- **GitHub Actions CI**: automated linting, type checking, and test runs
+
+#### Fixed
+
+- **Rake task registration**: non-migration tasks (`db:create`, `db:drop`) no longer interfere with Rails' default task execution (#2)
+
+#### Changed
+
+- **Gem renamed to `arfi`**: `ActiveRecord Functions Integration` — previously had a different gem name
+- **CLI migrated to Thor**: added `arfi` executable with `project` and `f_idx` command groups
+
 ## [0.1.0] - 2025-04-22
 
 - Initial release

data/CODE_OF_CONDUCT.md

@@ -60,7 +60,7 @@ representative at an online or offline event.
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
 reported to the community leaders responsible for enforcement at
-[INSERT CONTACT METHOD].
+https://github.com/unurgunite/arfi/issues.
 All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the
@@ -126,7 +126,11 @@ For answers to common questions about this code of conduct, see the FAQ at
 [https://www.contributor-covenant.org/translations][translations].
 
 [homepage]: https://www.contributor-covenant.org
+
 [v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+
 [Mozilla CoC]: https://github.com/mozilla/diversity
+
 [FAQ]: https://www.contributor-covenant.org/faq
+
 [translations]: https://www.contributor-covenant.org/translations

data/CONTRIBUTING.md

@@ -0,0 +1,26 @@
+# Contributing
+
+Bug reports and pull requests are welcome.
+
+## Pull Requests
+
+1. Fork the repository.
+2. Create a feature branch from `master`: `git checkout -b feature/my-change`
+3. Make your changes.
+4. Run the tests: `bundle exec rspec`
+5. Run the linter: `bundle exec rubocop`
+6. Run the type checker: `bundle exec steep check`
+7. If you changed any YARD-documented methods, regenerate docs:
+   ```shell
+   bundle exec docscribe lib spec --rbs-collection
+   ```
+8. Commit with a conventional commit message (e.g. `feat:`, `fix:`, `docs:`, `refactor:`, `chore:`).
+9. Push your branch and open a pull request.
+
+## Development Setup
+
+See [Development](README.md#development) in the README.
+
+## Code of Conduct
+
+This project follows the [Contributor Covenant](CODE_OF_CONDUCT.md).