belt 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9236fac00b7efcb43f17c02fb347626f768cf7dd5d6c1d2162470176043cdfde
-  data.tar.gz: d7998c44bfcdfa42eb4d22acca3fabf62e0005753b355f4112bbdff108682527
+  metadata.gz: 6527c1a9570ed74381b685347d178f0e20db869d39791c06b5685a45ba94c4dd
+  data.tar.gz: b60a0994c0646820e74eaf8d81918b4b52b95b570f9fc9ca3d74994b36bbfc6b
 SHA512:
-  metadata.gz: 3ec40527e1d14fe89e8e5f3dc412e803354630126d40e9bed1a8c1dc32703ecd5a1fbffec1690ff0262ee2d1ece1895751441fc554f2cc38b86cb1d36e8b4ea8
-  data.tar.gz: 3eaff9879994c9d2b7c3eb6b454a833bc4ae433bd544ac0c8fa3578045de96263a2871915b60d8707eaed8b512e497c88125554b45068d597d19d612a6b87209
+  metadata.gz: eb607dbfcc355a2b79dc82b3117f9e10937f32b9449cf6d3861685130f63271207d9b94992d1d86a5f49396acc0d7756f485b6c0db24d3aa70d738d95601fb6e
+  data.tar.gz: 1aa7b6eee506bc68947a8eaacc3cf773cb4929207831d21b9fac098bcf82de3a6062918faa0244bce389d4d5f680d4508f49a6e2c5a36dc843a82ad1d2164393

data/README.md

@@ -34,6 +34,8 @@ my-app/
 │   ├── routes.tf.rb        # Belt provider route definitions
 │   └── schema.tf.rb        # DynamoDB table schemas
 ├── lambda/
+│   ├── config/
+│   │   └── environment.rb  # App boot file (used by console + Lambda)
 │   ├── controllers/
 │   │   └── posts_controller.rb
 │   ├── models/
@@ -41,6 +43,7 @@ my-app/
 │   ├── lib/
 │   │   └── routes.rb
 │   └── api.rb              # Lambda entry point
+├── .irbrc                  # Console customization (optional)
 ├── Gemfile
 └── Gemfile.lock
 ```
@@ -229,6 +232,22 @@ Belt::Observability::Metrics.track_event("OrderCreated", model: "Order")
 
 Belt includes a command-line interface for project management.
 
+### `belt console` (alias: `belt c`)
+
+Start an interactive Ruby console with your app loaded. Belt uses convention over configuration:
+
+1. Loads `lambda/config/environment.rb` (your app's boot file — AWS setup, models, libs)
+2. Starts IRB with `reload!` available
+3. Reads `.irbrc` from the project root (console-specific customization)
+
+```bash
+belt console           # uses BELT_ENV or defaults to 'dev'
+belt c prod            # specify environment explicitly
+belt c dev02 --run "Customer.first"  # runner mode (execute and exit)
+```
+
+A production safety prompt is shown when the environment is `prod`.
+
 ### `belt routes`
 
 Display route definitions from your `infrastructure/routes.tf.rb`. This is the primary way to inspect what endpoints your app exposes.

data/lib/belt/cli/console_command.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+require 'optparse'
+
+module Belt
+  module CLI
+    class ConsoleCommand
+      def self.run(args)
+        new(args).run
+      end
+
+      def initialize(args)
+        @args = args
+        @options = {}
+        parse_options
+      end
+
+      def run
+        ENV['BUNDLE_GEMFILE'] ||= File.join(Belt.root, 'Gemfile')
+
+        unless File.exist?(ENV['BUNDLE_GEMFILE'])
+          abort "Error: No Gemfile found at #{ENV['BUNDLE_GEMFILE']}. Are you in a Belt project?"
+        end
+
+        @environment = @args.first || ENV['BELT_ENV'] || 'dev'
+        ENV['ENVIRONMENT'] = @environment
+
+        if @options[:run]
+          exec_runner(@options[:run])
+        else
+          exec_console
+        end
+      end
+
+      private
+
+      def parse_options
+        OptionParser.new do |opts|
+          opts.banner = 'Usage: belt console [environment] [options]'
+          opts.on('--run COMMAND', 'Execute a command and exit') { |cmd| @options[:run] = cmd }
+          opts.on('-h', '--help', 'Show this help') do
+            puts opts
+            exit
+          end
+        end.parse!(@args)
+      end
+
+      def exec_console
+        production_guard!
+        boot_app
+        puts banner
+        ARGV.clear
+        require 'irb'
+        IRB.start
+      end
+
+      def exec_runner(command)
+        boot_app
+        result = eval(command) # rubocop:disable Security/Eval
+        puts format_result(result)
+      rescue StandardError => e
+        abort "Error: #{e.class}: #{e.message}\n#{e.backtrace.first(5).join("\n")}"
+      end
+
+      def boot_app
+        require 'bundler/setup'
+
+        environment_file = File.join(Belt.root, 'lambda', 'config', 'environment.rb')
+        if File.exist?(environment_file)
+          load environment_file
+        else
+          require 'belt'
+          load_dir('lib')
+          load_dir('models')
+        end
+
+        define_reload!
+      end
+
+      def load_dir(subdir)
+        dir = File.join(Belt.root, 'lambda', subdir)
+        Dir.glob(File.join(dir, '**', '*.rb')).each { |f| require f } if Dir.exist?(dir)
+      end
+
+      def define_reload!
+        root = Belt.root
+        Kernel.define_method(:reload!) do
+          %w[lib models].each do |subdir|
+            dir = File.join(root, 'lambda', subdir)
+            Dir.glob(File.join(dir, '**', '*.rb')).each { |f| load f } if Dir.exist?(dir)
+          end
+          puts '♻️  Reloaded'
+        end
+      end
+
+      def production_guard!
+        return unless @environment == 'prod'
+
+        $stdout.write "\n⚠️  WARNING: You are entering the PRODUCTION console!\nType 'yes' to continue: "
+        response = $stdin.gets&.chomp
+        abort "\n❌ Cancelled." unless response&.downcase == 'yes'
+        puts "\n✅ Entering production console...\n"
+      end
+
+      def banner
+        <<~BANNER
+
+          Belt Console (#{@environment})
+          Type 'reload!' to reload code.
+
+        BANNER
+      end
+
+      def format_result(result)
+        require 'json'
+        if result.respond_to?(:to_h)
+          JSON.pretty_generate(result.to_h)
+        elsif result.respond_to?(:map) && result.respond_to?(:first) && result.first.respond_to?(:to_h)
+          JSON.pretty_generate(result.map(&:to_h))
+        elsif result.nil?
+          'nil'
+        else
+          result.inspect
+        end
+      end
+    end
+  end
+end

data/lib/belt/cli/new_command.rb

@@ -71,6 +71,7 @@ module Belt
           #{@app_name}/lambda/models
           #{@app_name}/lambda/models/concerns
           #{@app_name}/lambda/lib/routes
+          #{@app_name}/lambda/config
           #{@app_name}/lambda/spec
           #{@app_name}/infrastructure
         ]
@@ -80,8 +81,8 @@ module Belt
         {
           'Gemfile.erb' => "#{@app_name}/Gemfile",
           'Rakefile.erb' => "#{@app_name}/Rakefile",
-          'lambda/Gemfile.erb' => "#{@app_name}/lambda/Gemfile",
           'lambda/api.rb.erb' => "#{@app_name}/lambda/#{@app_name}.rb",
+          'lambda/config/environment.rb.erb' => "#{@app_name}/lambda/config/environment.rb",
           'lambda/models/application_record.rb.erb' => "#{@app_name}/lambda/models/application_record.rb",
           'lambda/models/concerns/timestampable.rb.erb' => "#{@app_name}/lambda/models/concerns/timestampable.rb",
           'lambda/controllers/application_controller.rb.erb' =>

data/lib/belt/cli/routes_command/route_inference.rb

@@ -16,13 +16,7 @@ module Belt
 
           return non_param.map { |s| s.gsub('-', '_') }.join('/') if route.resource? && nested_resource?(segments)
 
-          if route.resource?
-            non_param.first.gsub('-', '_')
-          elsif non_param.length == 1 && segments.length == 1
-            route.lambda.to_s == gateway.name.to_s ? gateway.name.to_s : route.lambda.to_s
-          else
-            non_param.first.gsub('-', '_')
-          end
+          non_param.first.gsub('-', '_')
         end
 
         def infer_action(route, _gateway)

data/lib/belt/cli.rb

@@ -13,6 +13,7 @@ require_relative 'cli/setup_command'
 require_relative 'cli/terraform_command'
 require_relative 'cli/routes_command'
 require_relative 'cli/tasks_command'
+require_relative 'cli/console_command'
 
 module Belt
   module CLI
@@ -20,6 +21,7 @@ module Belt
       'new' => Belt::CLI::NewCommand,
       %w[generate g] => Belt::CLI::GenerateCommand,
       'routes' => Belt::CLI::RoutesCommand,
+      %w[console c] => Belt::CLI::ConsoleCommand,
       %w[tasks --tasks -T] => Belt::CLI::TasksCommand,
       'setup' => Belt::CLI::SetupCommand,
       'deploy' => lambda { |args|
@@ -79,6 +81,8 @@ module Belt
           generate views <resource> [fields...]       Generate React pages for REST actions
           generate environment <name>                 Create a new environment
           routes [-g PATTERN] [-f json]               Show route definitions
+          console                                     Start an interactive console (IRB)
+          c                                           Alias for console
           tasks [-g PATTERN] [-a]                     List available rake tasks
           -T [-g PATTERN] [-a]                        Alias for tasks
           setup state                                 Create/select S3 state bucket

data/lib/belt/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Belt
-  VERSION = '0.1.1'
+  VERSION = '0.1.2'
 end

data/lib/templates/new_app/Gemfile.erb

@@ -2,4 +2,6 @@
 
 source 'https://rubygems.org'
 
+gem 'activeitem'
 gem 'belt'
+gem 'lambda_loadout'

data/lib/templates/new_app/gitignore.erb

@@ -1,13 +1,13 @@
 /.bundle
 /vendor/bundle
 *.gem
-Gemfile.lock
 
 # Terraform
 .terraform/
 *.tfstate
 *.tfstate.backup
 .terraform.lock.hcl
+*.tfvars
 
 # Lambda build artifacts
 /lambda/vendor/

data/lib/templates/new_app/lambda/config/environment.rb.erb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Boot the application. Used by `belt console` and Lambda at runtime.
+
+require 'belt'
+require 'activeitem'
+
+ENV['APP_NAME'] ||= '<%= @app_name %>'
+ENV['AWS_REGION'] ||= 'us-east-1'
+
+ActiveItem.configure do |config|
+  config.table_prefix = ENV['APP_NAME']
+  config.environment = ENV['ENVIRONMENT']
+end
+
+# Load lib and models
+Dir[File.join(__dir__, '..', 'lib', '**', '*.rb')].sort.each { |f| require f }
+Dir[File.join(__dir__, '..', 'models', '**', '*.rb')].sort.each { |f| require f }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: belt
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Stowzilla
@@ -83,6 +83,7 @@ files:
 - lib/belt/cli.rb
 - lib/belt/cli/app_detection.rb
 - lib/belt/cli/bucket_security.rb
+- lib/belt/cli/console_command.rb
 - lib/belt/cli/env_resolver.rb
 - lib/belt/cli/environment_command.rb
 - lib/belt/cli/frontend_command.rb
@@ -131,8 +132,8 @@ files:
 - lib/templates/new_app/gitignore.erb
 - lib/templates/new_app/infrastructure/routes.tf.rb.erb
 - lib/templates/new_app/infrastructure/schema.tf.rb.erb
-- lib/templates/new_app/lambda/Gemfile.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

data/lib/templates/new_app/lambda/Gemfile.erb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-gem 'activeitem'
-gem 'belt'
-gem 'lambda_loadout'