thecore_generators 3.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9f829a0f19f22655ce14f10be2c9c748dd67acc8a9432aced696cd9ca3ba7f8a
+  data.tar.gz: '08b6468f673411496eab954f7d2511c4345242aa5aa1a020d7a3860ad42580bc'
+SHA512:
+  metadata.gz: 92ad6a86068b45d71a7a077cee5c083fb893724767314bb49d914a567cd09b4708091c97fa7d5772470e4f37bd068447f63b9b600081807fa73ed842455f9353
+  data.tar.gz: 1e5430b20ea00057c7dea7b48736c31f2cbc64dc236550fc5957d90874dd3d42b1435968fb996bfcb2022ad9d3b7fe4b4cf79bcf6f4bd5b1fad358a9c0388cfa

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2026 Gabriele Tassoni
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,54 @@
+# thecore_generators
+
+Part of the [Thecore framework](https://github.com/gabrieletassoni/thecore/tree/release/3).
+
+Rails-native generators for Thecore 3 apps and ATOMs — replacing the scaffolding logic
+currently duplicated in the [Thecore VS Code extension](https://github.com/gabrieletassoni/thecore_code_extension).
+Wherever Rails already has a native generator command to override (`rails generate
+model`/`migration`), this gem hooks it instead of inventing new vocabulary; operations with
+no Rails-native equivalent (ATOM creation, action scaffolding, app bootstrapping) get their
+own `thecore:*`-namespaced generators or an application template. See
+[`docs/adr/0002-thecore-generators-gem-and-generator-hook-mechanism.md`](https://github.com/gabrieletassoni/thecore/blob/release/3/docs/adr/0002-thecore-generators-gem-and-generator-hook-mechanism.md)
+in the thecore repo for the full design.
+
+**Status:** bootstrap only. This release makes the gem buildable, testable, and
+publishable — it ships no generator behaviour yet. `ThecoreGenerators::Railtie`
+(`lib/thecore_generators/railtie.rb`) is a deliberate no-op; the `config.app_generators.orm`
+hook lands in a follow-up ticket.
+
+## Installation
+
+Add to your host app's or ATOM's `Gemfile`:
+
+```ruby
+gem "thecore_generators", "~> 3.0"
+```
+
+## Running tests locally
+
+Tests use a `Rails::Generators::TestCase`-based harness against the `test/dummy` Rails
+app included in this repo (needed to exercise generators the way a real host app would).
+
+```bash
+bundle install
+bundle exec rake test
+```
+
+`bundle exec rake` alone runs the same suite (`test` is the default Rake task).
+
+To run a single test file:
+
+```bash
+bundle exec ruby -Itest test/generators/placeholder_generator_test.rb
+```
+
+## Releasing
+
+Version lives in `lib/thecore_generators/version.rb`. Pushing a commit that bumps it
+triggers `.github/workflows/gempush.yml`, which tags the commit with that version and
+publishes to RubyGems (skipped if the tag already exists) — the same pattern used by the
+other gems in this ecosystem (`model_driven_api`, `thecore_backend_commons`, etc.).
+
+## License
+
+MIT — see [`MIT-LICENSE`](MIT-LICENSE).

data/Rakefile

@@ -0,0 +1,14 @@
+require "bundler/setup"
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task default: :test

data/lib/thecore_generators/railtie.rb

@@ -0,0 +1,13 @@
+module ThecoreGenerators
+  # Boot-time hook point for this gem. Intentionally empty for now: no
+  # generator behaviour ships in this release. A future ticket will add
+  #
+  #   config.app_generators.orm :thecore, migration: true, timestamps: true
+  #
+  # here, following the same mechanism ActiveRecord's own Railtie and
+  # Mongoid both use to hook `rails generate model`/`migration` (see
+  # docs/adr/0002-thecore-generators-gem-and-generator-hook-mechanism.md in
+  # the thecore repo).
+  class Railtie < ::Rails::Railtie
+  end
+end

data/lib/thecore_generators/version.rb

@@ -0,0 +1,3 @@
+module ThecoreGenerators
+  VERSION = "3.0.0"
+end

data/lib/thecore_generators.rb

@@ -0,0 +1,5 @@
+require "thecore_generators/version"
+require "thecore_generators/railtie"
+
+module ThecoreGenerators
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: thecore_generators
+version: !ruby/object:Gem::Version
+  version: 3.0.0
+platform: ruby
+authors:
+- Gabriele Tassoni
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.2'
+description: Hooks Rails' own generator commands (model, migration) and adds thecore:*-namespaced
+  generators plus a check_practices rake task, replacing scaffolding logic previously
+  duplicated in the Thecore VS Code extension. See docs/adr/0002-thecore-generators-gem-and-generator-hook-mechanism.md
+  in the thecore repo for the design rationale.
+email:
+- g.tassoni@bancolini.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/thecore_generators.rb
+- lib/thecore_generators/railtie.rb
+- lib/thecore_generators/version.rb
+homepage: https://github.com/gabrieletassoni/thecore_generators
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/gabrieletassoni/thecore_generators
+  source_code_uri: https://github.com/gabrieletassoni/thecore_generators
+  changelog_uri: https://github.com/gabrieletassoni/thecore_generators/blob/release/3/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Rails-native generators for the Thecore 3 scaffolding framework.
+test_files: []