belt 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9236fac00b7efcb43f17c02fb347626f768cf7dd5d6c1d2162470176043cdfde
-  data.tar.gz: d7998c44bfcdfa42eb4d22acca3fabf62e0005753b355f4112bbdff108682527
+  metadata.gz: b12c5b4c22f46e0d4c80c10de7ee88f41bbcbb8a8e14a68b9033d19979a6c5af
+  data.tar.gz: d699a6f241fb01a111545450cb024d409e099d9e8617b788eee6fa1a47021a20
 SHA512:
-  metadata.gz: 3ec40527e1d14fe89e8e5f3dc412e803354630126d40e9bed1a8c1dc32703ecd5a1fbffec1690ff0262ee2d1ece1895751441fc554f2cc38b86cb1d36e8b4ea8
-  data.tar.gz: 3eaff9879994c9d2b7c3eb6b454a833bc4ae433bd544ac0c8fa3578045de96263a2871915b60d8707eaed8b512e497c88125554b45068d597d19d612a6b87209
+  metadata.gz: c1a17ba50a432b6f84103129394524c1fcaf40abadc89eb59dec7dd93b9e68ef6fda35444c45486c06f030d123816c7ac99b4d7b9320ba02485d9b70716cdb46
+  data.tar.gz: dab18cbb83517e05e404755923b6ce90dd45a8e155516e07649c63285f83f7ef0ec3d5cc8d62f9f7dd08553f8596d5ed0bb0298fc687a8167c0482bee44492dd

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.3'
 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,39 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: belt
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Stowzilla
 bindir: exe
-cert_chain:
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIEdDCCAtygAwIBAgIBATANBgkqhkiG9w0BAQsFADBAMQ4wDAYDVQQDDAVhZ2Vu
-  dDEZMBcGCgmSJomT8ixkARkWCXN0b3d6aWxsYTETMBEGCgmSJomT8ixkARkWA2Nv
-  bTAeFw0yNjA2MDgxOTExNTlaFw0yNzA2MDgxOTExNTlaMEAxDjAMBgNVBAMMBWFn
-  ZW50MRkwFwYKCZImiZPyLGQBGRYJc3Rvd3ppbGxhMRMwEQYKCZImiZPyLGQBGRYD
-  Y29tMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAupBquKI/4WvXOgND
-  pXyqH2GllZs1wG4TWWdn/DoMg45UoCwD+AWEuGrIdInBCpPN8vEJNJWPoM/RrU+b
-  xRBZT4uUk00bnZRW2SYh5GJSqBoBR+rWc2DGkXyGfdRU2sQvkB0+is6ChgQ61WMM
-  33LE9+loBlVsZ6EVtrc18Uh2OW0mJpe0hN2nmBrxZqqOZigxC4DKRMFHvpRkxSb6
-  mD4kit1AcwX9NEWJsXxrPaetL/SB/VbXaEZX93XAvp6USaXvCWt4slkDS2mIvqtn
-  9DtGC43LFC7SDGbnsG9PVenQgVCi8UWFPUAab0PqZSlmi3Qlbhw8qTGPp5Cbv4vz
-  qjC2UGPOQigA/7lbbGRhCohMrjOVHMAQwkcgiIqtolUoYlnvPMIy+m3pdvgDv/PH
-  bsZGvXQ7i0458xsmp1vaKthZocVAR+GboHbuIiYPUnO45ccXUQ00x6365tTe7mZi
-  NvmUYdAGbQmVvFqyxF7IYA6sF74L2Lstu0knSfss557bAe1HAgMBAAGjeTB3MAkG
-  A1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBSnxTL/lNBCeLqpeVIX6AUY
-  kel4zjAeBgNVHREEFzAVgRNhZ2VudEBzdG93emlsbGEuY29tMB4GA1UdEgQXMBWB
-  E2FnZW50QHN0b3d6aWxsYS5jb20wDQYJKoZIhvcNAQELBQADggGBACm9Fjit/UCv
-  FxlKqeiCTIG94cIx+QrWAOJSx9knKydwUec1u04D/DbfZjTn3C2Bj227QgxeUn+6
-  if3e2v7zAk1896hLmGYzML0+nxQPb0vmtdLR7HETUlSKTVabcv1fbwLyjsuGrBvk
-  y51vOEzUEZ508a9yepLYqrQu1kOju4d57c9oA5l3H0mMKWz7av9tFj0B+STvuaWk
-  HRYDWc5HgOEVTyV+w0uFt2Kw4OCb8C42uSvC5RfYYtw78MSP+5Ru+LXJ7XOtmuN0
-  E6GVmofQ17ig9O3rgfFbMendSInrRmvPIGswvM1yivq9NOllFbdck2OJKPx6FCJF
-  7SJIkXQfc9P4B5iASIV1d1FsE0YX+g3jHXPJK/4mGL5bAyBKzpMfQB/mg6vQBzkh
-  aOKPwcreFj7TznBl89R5tNS9wZQfPVR98zgPyocddWhK18eQNMSBUnv4eeJ8PPbk
-  DovL+G8ajHDZ9fjH/+GVYHEMuiVdLarXrKJpHC1VfGTTUAp4NSEpUQ==
-  -----END CERTIFICATE-----
+cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
@@ -76,13 +49,13 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- certs/stowzilla.pem
 - exe/belt
 - lib/belt.rb
 - lib/belt/action_router.rb
 - 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 +104,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

checksums.yaml.gz.sig

@@ -1 +0,0 @@
-�X\h��3
ʙk�e���s���V���EB�p�:y1͸��M�dŸz(�j���{�n����騐��Լ;:�db���Ŵ����H�j$S8/������p���E��������|3��^���5œ��|�%��NΛ(7P�`A#��v���j�v{�%]��R�%�-<Lܟ��2���K��9�[�Ÿ�ud��ęl���:t��̱����#�Z�Ҏ�Ok��>��@vV����;A�8����=rՇ���iy}���p9b��`�c"vl,�r$��{>�䷹��v�ͮ���ȗ������ܡ�="�r��(�,�:�S�`��«��Vl~��&Y�%�N��V�Dtf-���N[�Q���

data/certs/stowzilla.pem

@@ -1,26 +0,0 @@
------BEGIN CERTIFICATE-----
-MIIEdDCCAtygAwIBAgIBATANBgkqhkiG9w0BAQsFADBAMQ4wDAYDVQQDDAVhZ2Vu
-dDEZMBcGCgmSJomT8ixkARkWCXN0b3d6aWxsYTETMBEGCgmSJomT8ixkARkWA2Nv
-bTAeFw0yNjA2MDgxOTExNTlaFw0yNzA2MDgxOTExNTlaMEAxDjAMBgNVBAMMBWFn
-ZW50MRkwFwYKCZImiZPyLGQBGRYJc3Rvd3ppbGxhMRMwEQYKCZImiZPyLGQBGRYD
-Y29tMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAupBquKI/4WvXOgND
-pXyqH2GllZs1wG4TWWdn/DoMg45UoCwD+AWEuGrIdInBCpPN8vEJNJWPoM/RrU+b
-xRBZT4uUk00bnZRW2SYh5GJSqBoBR+rWc2DGkXyGfdRU2sQvkB0+is6ChgQ61WMM
-33LE9+loBlVsZ6EVtrc18Uh2OW0mJpe0hN2nmBrxZqqOZigxC4DKRMFHvpRkxSb6
-mD4kit1AcwX9NEWJsXxrPaetL/SB/VbXaEZX93XAvp6USaXvCWt4slkDS2mIvqtn
-9DtGC43LFC7SDGbnsG9PVenQgVCi8UWFPUAab0PqZSlmi3Qlbhw8qTGPp5Cbv4vz
-qjC2UGPOQigA/7lbbGRhCohMrjOVHMAQwkcgiIqtolUoYlnvPMIy+m3pdvgDv/PH
-bsZGvXQ7i0458xsmp1vaKthZocVAR+GboHbuIiYPUnO45ccXUQ00x6365tTe7mZi
-NvmUYdAGbQmVvFqyxF7IYA6sF74L2Lstu0knSfss557bAe1HAgMBAAGjeTB3MAkG
-A1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBSnxTL/lNBCeLqpeVIX6AUY
-kel4zjAeBgNVHREEFzAVgRNhZ2VudEBzdG93emlsbGEuY29tMB4GA1UdEgQXMBWB
-E2FnZW50QHN0b3d6aWxsYS5jb20wDQYJKoZIhvcNAQELBQADggGBACm9Fjit/UCv
-FxlKqeiCTIG94cIx+QrWAOJSx9knKydwUec1u04D/DbfZjTn3C2Bj227QgxeUn+6
-if3e2v7zAk1896hLmGYzML0+nxQPb0vmtdLR7HETUlSKTVabcv1fbwLyjsuGrBvk
-y51vOEzUEZ508a9yepLYqrQu1kOju4d57c9oA5l3H0mMKWz7av9tFj0B+STvuaWk
-HRYDWc5HgOEVTyV+w0uFt2Kw4OCb8C42uSvC5RfYYtw78MSP+5Ru+LXJ7XOtmuN0
-E6GVmofQ17ig9O3rgfFbMendSInrRmvPIGswvM1yivq9NOllFbdck2OJKPx6FCJF
-7SJIkXQfc9P4B5iASIV1d1FsE0YX+g3jHXPJK/4mGL5bAyBKzpMfQB/mg6vQBzkh
-aOKPwcreFj7TznBl89R5tNS9wZQfPVR98zgPyocddWhK18eQNMSBUnv4eeJ8PPbk
-DovL+G8ajHDZ9fjH/+GVYHEMuiVdLarXrKJpHC1VfGTTUAp4NSEpUQ==
------END CERTIFICATE-----

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'