belt 0.2.9 → 0.2.11

data/lib/templates/plugin/Gemfile.erb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :test do
+  gem 'rake', '~> 13.0'
+  gem 'rspec', '~> 3.0'
+  gem 'rubocop', '~> 1.0', require: false
+end

data/lib/templates/plugin/LICENSE.erb

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) <%= Time.now.year %>
+
+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/lib/templates/plugin/README.md.erb

@@ -0,0 +1,63 @@
+# <%= gem_name %>
+
+<%= summary %>.
+
+A [Belt](https://github.com/stowzilla/belt) plugin. Add the gem to a Belt app, then run the generator to install infrastructure and app wiring.
+
+## Installation
+
+Add to your Belt app's Gemfile:
+
+```ruby
+gem '<%= gem_name %>'
+# Or during development:
+# gem '<%= gem_name %>', path: '../<%= gem_name %>'
+```
+
+Then:
+
+```bash
+bundle install
+belt generate <%= plugin_name %>
+```
+
+## What You Get
+
+### From the gem (no generation needed)
+
+```ruby
+# Configure
+<%= constant_path %>.configure do |config|
+  # config.option = value
+end
+```
+
+### From the generator (`belt g <%= plugin_name %>`)
+
+Edit `lib/belt/generators/<%= underscored %>_generator.rb` and templates under
+`lib/belt/<%= underscored %>/templates/` to define what gets installed into apps.
+
+Typical plugin generators create some combination of:
+
+- **Terraform module** — `infrastructure/modules/<%= plugin_name %>/`
+- **Lambda entry point** — `lambda/<%= plugin_name %>.rb`
+- **Lambda config** — `config/lambda/<%= plugin_name %>.yml`
+- **Route / schema injection** — updates to `routes.tf.rb` / `schema.tf.rb`
+- **Optional controller overrides** — `belt g <%= plugin_name %> --controllers`
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec
+```
+
+## Removing
+
+```bash
+belt destroy <%= plugin_name %>
+```
+
+## License
+
+MIT

data/lib/templates/plugin/Rakefile.erb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/templates/plugin/gemspec.erb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative 'lib/belt/<%= underscored %>/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = '<%= gem_name %>'
+  spec.version       = <%= constant_path %>::VERSION
+  spec.authors       = ['Your Name']
+  spec.email         = ['you@example.com']
+
+  spec.summary       = '<%= summary %>'
+  spec.description   = '<%= summary %>. A Belt plugin gem — add to a Belt app Gemfile, then run `belt generate <%= plugin_name %>`.'
+  spec.homepage      = 'https://github.com/example/<%= gem_name %>'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.3'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.files = Dir['lib/**/*', 'LICENSE', 'README.md', 'CHANGELOG.md']
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'belt', '~> 0.2'
+end

data/lib/templates/plugin/gitignore.erb

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.gem
+Gemfile.lock
+.rspec_status

data/lib/templates/plugin/lib/belt/generators/generator.rb.erb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'erb'
+
+module Belt
+  module Generators
+    # Generator registered automatically by Belt::CLI::GeneratorRegistry.
+    # File must live at: lib/belt/generators/<%= underscored %>_generator.rb
+    #
+    # Available as:
+    #   belt generate <%= plugin_name %>
+    #   belt destroy <%= plugin_name %>
+    class <%= generator_class %>
+      TEMPLATE_DIR = File.expand_path('../<%= underscored %>/templates', __dir__)
+
+      def self.description
+        'Install <%= summary %>'
+      end
+
+      def self.run(args)
+        if args.include?('--help') || args.include?('-h')
+          print_help
+          return
+        end
+
+        new(args).generate
+      end
+
+      def self.destroy(args)
+        new(args).destroy
+      end
+
+      def self.print_help
+        puts <<~HELP
+          Install <%= gem_name %> into a Belt application.
+
+          Usage: belt generate <%= plugin_name %> [options]
+
+          Options:
+            --force               Overwrite existing files
+            -h, --help            Show this help
+
+          What gets created (customize this generator):
+            infrastructure/modules/<%= plugin_name %>/   Terraform module (optional)
+            config/lambda/<%= plugin_name %>.yml         Lambda configuration (optional)
+            lambda/<%= plugin_name %>.rb                 Lambda entry point (optional)
+
+          What stays in the gem (no generation needed):
+            <%= constant_path %>                         Runtime library API
+
+          After generation:
+            1. Wire any Terraform module into your environment main.tf
+            2. Configure environment variables / secrets
+            3. Deploy: belt deploy <env>
+
+          Examples:
+            belt g <%= plugin_name %>
+            belt d <%= plugin_name %>
+        HELP
+      end
+
+      def initialize(args)
+        @force = args.include?('--force')
+      end
+
+      def generate
+        # TODO: copy templates into the host app.
+        # Pattern used by belt-messaging / belt-pay:
+        #
+        #   generate_terraform_module
+        #   generate_lambda_config
+        #   generate_lambda_entry_point
+        #   inject_routes
+        #
+        # Templates live under TEMPLATE_DIR. Use ERB + FileUtils.
+        puts "  # TODO: implement <%= generator_class %>#generate"
+        puts "  # Templates directory: #{TEMPLATE_DIR}"
+        print_success
+      end
+
+      def destroy
+        # TODO: remove files created by #generate
+        puts "  # TODO: implement <%= generator_class %>#destroy"
+        puts "\n✓ <%= module_name %> removed!"
+        puts '  Don\'t forget to remove any module references from environment main.tf files.'
+      end
+
+      private
+
+      def print_success
+        puts ''
+        puts "✓ <%= module_name %> installed (scaffold — implement the generator next)!"
+        puts ''
+        puts 'Next steps:'
+        puts "  1. Add ERB templates under lib/belt/<%= underscored %>/templates/"
+        puts "  2. Implement generate/destroy in lib/belt/generators/<%= underscored %>_generator.rb"
+        puts '  3. See belt-messaging or belt-pay for full working examples'
+      end
+
+      # ---- helpers (copy patterns from belt-messaging / belt-pay) ----
+
+      def write_template(relative_template, destination, binding_context = binding)
+        source = File.join(TEMPLATE_DIR, relative_template)
+        unless File.exist?(source)
+          puts "  skip    missing template #{relative_template}"
+          return
+        end
+
+        if File.exist?(destination) && !@force
+          puts "  skip    #{destination} (already exists, use --force to overwrite)"
+          return
+        end
+
+        FileUtils.mkdir_p(File.dirname(destination))
+        content = ERB.new(File.read(source), trim_mode: '-').result(binding_context)
+        File.write(destination, content)
+        puts "  create  #{destination}"
+      end
+    end
+  end
+end

data/lib/templates/plugin/lib/belt/module/configuration.rb.erb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Belt
+  module <%= module_name %>
+    class Configuration
+      # Add plugin-specific settings here.
+      # attr_accessor :api_key, :logger
+      attr_accessor :logger
+
+      def initialize
+        @logger = nil # Falls back to Belt::Observability::Logger if available
+      end
+    end
+  end
+end

data/lib/templates/plugin/lib/belt/module/version.rb.erb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Belt
+  module <%= module_name %>
+    VERSION = '0.0.1'
+  end
+end

data/lib/templates/plugin/lib/belt/module.rb.erb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative '<%= underscored %>/version'
+require_relative '<%= underscored %>/configuration'
+
+module Belt
+  module <%= module_name %>
+    class Error < StandardError; end
+    class ConfigurationError < Error; end
+
+    class << self
+      attr_writer :configuration
+
+      def configuration
+        @configuration ||= Configuration.new
+      end
+
+      def configure
+        yield(configuration)
+      end
+
+      def reset_configuration!
+        @configuration = Configuration.new
+      end
+    end
+  end
+end

data/lib/templates/plugin/lib/entry.rb.erb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'belt/<%= underscored %>'

data/lib/templates/plugin/rspec.erb

@@ -0,0 +1,3 @@
+--require spec_helper
+--color
+--format documentation

data/lib/templates/plugin/spec/configuration_spec.rb.erb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe <%= constant_path %>::Configuration do
+  it 'has a default configuration' do
+    expect(<%= constant_path %>.configuration).to be_a(described_class)
+  end
+
+  it 'accepts configure block' do
+    <%= constant_path %>.configure do |config|
+      config.logger = :test_logger
+    end
+
+    expect(<%= constant_path %>.configuration.logger).to eq(:test_logger)
+  end
+end

data/lib/templates/plugin/spec/spec_helper.rb.erb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'belt/<%= underscored %>'
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+  config.before do
+    <%= constant_path %>.reset_configuration!
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: belt
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.2.11
 platform: ruby
 authors:
 - Stowzilla
@@ -76,6 +76,7 @@ files:
 - lib/belt/cli/console_command.rb
 - lib/belt/cli/deploy_command.rb
 - lib/belt/cli/destroy_command.rb
+- lib/belt/cli/doctor_command.rb
 - lib/belt/cli/env_resolver.rb
 - lib/belt/cli/environment_command.rb
 - lib/belt/cli/environment_config.rb
@@ -88,6 +89,8 @@ files:
 - lib/belt/cli/generator_registry.rb
 - lib/belt/cli/lambda_config_command.rb
 - lib/belt/cli/new_command.rb
+- lib/belt/cli/path_gem_materializer.rb
+- lib/belt/cli/plugin_command.rb
 - lib/belt/cli/routes_command.rb
 - lib/belt/cli/routes_command/route_inference.rb
 - lib/belt/cli/routes_command/schema_loader.rb
@@ -97,10 +100,12 @@ files:
 - lib/belt/cli/tasks_command.rb
 - lib/belt/cli/terraform_command.rb
 - lib/belt/cli/views_command.rb
+- lib/belt/configuration.rb
 - lib/belt/controllers/welcome_controller.rb
 - lib/belt/helpers/cors_origin.rb
 - lib/belt/helpers/error_logging.rb
 - lib/belt/helpers/response.rb
+- lib/belt/http_status.rb
 - lib/belt/inflector.rb
 - lib/belt/lambda_handler.rb
 - lib/belt/observability.rb
@@ -112,6 +117,7 @@ files:
 - lib/belt/version.rb
 - lib/belt/views/welcome/show.html.erb
 - lib/belt_controller/base.rb
+- lib/belt_controller/implicit_response.rb
 - lib/templates/environment/backend.tf.erb
 - lib/templates/environment/main.tf.erb
 - lib/templates/environment/outputs.tf.erb
@@ -147,6 +153,22 @@ files:
 - lib/templates/new_app/lambda/controllers/application_controller.rb.erb
 - lib/templates/new_app/lambda/lib/routes/routes.rb.erb
 - lib/templates/new_app/lambda/models/application_record.rb.erb
+- lib/templates/plugin/AGENTS.md.erb
+- lib/templates/plugin/CHANGELOG.md.erb
+- lib/templates/plugin/Gemfile.erb
+- lib/templates/plugin/LICENSE.erb
+- lib/templates/plugin/README.md.erb
+- lib/templates/plugin/Rakefile.erb
+- lib/templates/plugin/gemspec.erb
+- lib/templates/plugin/gitignore.erb
+- lib/templates/plugin/lib/belt/generators/generator.rb.erb
+- lib/templates/plugin/lib/belt/module.rb.erb
+- lib/templates/plugin/lib/belt/module/configuration.rb.erb
+- lib/templates/plugin/lib/belt/module/version.rb.erb
+- lib/templates/plugin/lib/entry.rb.erb
+- lib/templates/plugin/rspec.erb
+- lib/templates/plugin/spec/configuration_spec.rb.erb
+- lib/templates/plugin/spec/spec_helper.rb.erb
 - lib/templates/views/Edit.jsx.erb
 - lib/templates/views/Form.jsx.erb
 - lib/templates/views/Index.jsx.erb
@@ -160,6 +182,19 @@ metadata:
   source_code_uri: https://github.com/stowzilla/belt
   changelog_uri: https://github.com/stowzilla/belt/blob/master/CHANGELOG.md
   rubygems_mfa_required: 'true'
+post_install_message: |2+
+
+  ╭────────────────────────────────────────────╮
+  │  Belt installed successfully!               │
+  │                                            │
+  │  Run `belt doctor` to verify your setup:   │
+  │    • AWS CLI                               │
+  │    • Terraform                             │
+  │    • AWS credentials & authentication      │
+  │                                            │
+  │  Then: belt new <app_name>                 │
+  ╰────────────────────────────────────────────╯
+
 rdoc_options: []
 require_paths:
 - lib
@@ -178,3 +213,4 @@ rubygems_version: 3.6.9
 specification_version: 4
 summary: Belt - a utility toolkit for Ruby applications
 test_files: []
+...