belt 0.2.10 → 0.2.12

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.10
+  version: 0.2.12
 platform: ruby
 authors:
 - Stowzilla
@@ -74,6 +74,7 @@ files:
 - lib/belt/cli/backup_runner.rb
 - lib/belt/cli/bucket_security.rb
 - lib/belt/cli/console_command.rb
+- lib/belt/cli/contracts_command.rb
 - lib/belt/cli/deploy_command.rb
 - lib/belt/cli/destroy_command.rb
 - lib/belt/cli/doctor_command.rb
@@ -90,6 +91,7 @@ files:
 - 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
@@ -143,15 +145,31 @@ files:
 - lib/templates/new_app/Gemfile.erb
 - lib/templates/new_app/README.md.erb
 - lib/templates/new_app/Rakefile.erb
+- lib/templates/new_app/config/contracts.rb.erb
 - lib/templates/new_app/config/lambda/api.yml.erb
-- lib/templates/new_app/config/routes.tf.rb.erb
-- lib/templates/new_app/config/schema.tf.rb.erb
+- lib/templates/new_app/config/routes.rb.erb
 - lib/templates/new_app/gitignore.erb
 - lib/templates/new_app/lambda/api.rb.erb
 - lib/templates/new_app/lambda/config/environment.rb.erb
 - 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