hyraft-rule 0.1.0.alpha1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7354edfc544227b3eb8c6dfdfa552f8ccc4764a763e975028d423657a851c417
-  data.tar.gz: 02cb548060b83aa6f3516826d08cfc649663733fdf4469155b59608a31089279
+  metadata.gz: 3ceb5f5d19fd16ef3f5f54d282e81d1e15db13cac65137688889280762ab47a1
+  data.tar.gz: 14b7bd672260e3ad84089ed5c3f13282808317b6a564a6f1669a401b820f629f
 SHA512:
-  metadata.gz: c9c71f2963cf91e915bfcde8531985e4105dee516e8ffd472f83d64956add49536a149bb14678285fc5e22e75e0d34b891668f4dfcbbd28ee612f657d8b2346e
-  data.tar.gz: 361550c41628c903ee91f16c491e6bacf106b4ebf5f001e6b1be9310e8369ce37a1a08aca4e95e8cd930f06208e5d37c75540ef5e986421c57c9c62e4336fce9
+  metadata.gz: b76d6da0d1df616cb966c523b900b93e471536a18caed301b605d5adac7ade0535d0e48e5d03076a101a27287cbb36bd8aabdb95fc196ee4d27a4145f1f40f8a
+  data.tar.gz: f1e7505c49b11ec307cfc6592bdc8af86cc6f4eb12b7b5bb1dbbb2f6869b8b3f0f1e4137c5b92fa2eb819a06d43eafb1111031845a89c070c7ab75653d5603d9

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
-## [0.1.0] - 2025-11-12
+## [1.0.0] - 2026-7-12
+### Fixed
+Supports Ruby 4 and above only.
 
-- Initial release
+## [0.1.0.alpha2] - 2025-11-30
+### Fixed
+- Fixed README documentation
+- Add safety flag to disassemble command
+
+## [0.1.0.alpha1] - 2025-11-26
+- Initial release

data/README.md

@@ -7,96 +7,150 @@
 ![Downloads](https://img.shields.io/gem/dt/hyraft-rule)
 ![License](https://img.shields.io/github/license/demjhonsilver/hyraft-rule)
 ![Ruby Version](https://img.shields.io/badge/ruby-%3E%3D%203.4.0-red)
+![Tests](https://github.com/demjhonsilver/hyraft-rule/actions/workflows/ci.yml/badge.svg)
 
 </div>
 
 
 
+This is a standalone command-line interface (CLI) for the Hyraft framework.
 
-# Hyraft Rule - ( CLI ) Command system for Hyraft applications
 
 
-A standalone command system (cli) for Hyraft applications.
+## Syntax ( Command KEY )
+```bash
+
+- hyraft-rule (standard)
+- hyr-rule    (alias)
+
+- hyraft-rule-db (standard / database command)
+- hyr-rule-db    (alias / database command)
+
+```
+
 
-## Installation
+## Usage ( in-api )
 
-Open Gemfile:
-put:
+Generate:
 
 ```bash
-gem 'hyraft-rule'
+hyraft-rule in-api articles title content
+hyraft-rule in-api users name email role
+hyraft-rule in-api products name price stock
+hyraft-rule in-api posts title body author
 ```
+## Usage ( out-data )
 
-Install the gem and add to the application's Gemfile by executing:
+Generate:
 
 ```bash
-bundle install
+
+# Generate storage for any resource
+hyraft-rule out-data articles title content
+hyraft-rule out-data users name email password
+hyraft-rule out-data products name price stock quantity
+hyraft-rule out-data comments body author_id post_id
+hyraft-rule out-data posts title content published
+hyraft-rule out-data categories name description
+hyraft-rule out-data tags name
+
 ```
 
-## Usage ( Assemble / Disassemble )
-- hyr-rule
 
-Package setup:
 
-```bash
-# Default web-app
-hyr-rule assemble articles
-hyr-rule disassemble articles
 
-# Specific app folders
+## Usage ( Engine )
 
-hyr-rule assemble {any-folder-name}/users
+Generate:
 
+```bash
+# Generate engine with attributes
+hyraft-rule engine articles title content
 
-hyr-rule assemble admin-app/users
-hyr-rule disassemble admin-app/users
+# With custom target directory
+hyraft-rule engine articles title content ./myapp
 
-hyr-rule assemble api_app/products
-hyr-rule disassemble api_app/products
+# Without attributes (will show placeholder)
+hyraft-rule engine articles
 ```
 
+## Usage ( Port )
+
+Generate:
+
+```bash
+# Basic usage
+hyraft-rule port articles
 
+# Different resources
+hyraft-rule port users
+hyraft-rule port products
+hyraft-rule port comments
 
-## Usage ( Engine )
-- hyr-rule
+# With custom path
+hyraft-rule port articles ./my_project
+```
+
+## Usage ( Cable )
 
 Generate:
 
 ```bash
+# Generate cable for articles
+hyraft-rule cable articles title content
 
-hyr-rule circuit articles
+# Generate cable for users
+hyraft-rule cable users name email password
 
-hyr-rule port articles
-
-hyr-rule source article
+# Generate cable for products
+hyraft-rule cable products name price stock
 
+# Generate cable for comments
+hyraft-rule cable comments body author_id post_id
 ```
 
-## Usage ( Web Adapter )
-- hyr-rule
+## Usage ( JWT key )
 
 Generate:
 
 ```bash
-hyr-rule web-adapter articles
-hyr-rule web-adapter admin-app/products
+
+hyraft-rule jwt generate
+hyraft-rule jwt g
+hyraft-rule jwt show
+hyraft-rule jwt help
+
 ```
 
-## Usage ( data-gateway )
-- hyr-rule
+## Usage ( Routes )
 
 Generate:
 
 ```bash
-hyr-rule data-gateway articles
-hyr-rule data-gateway admin-app/products
+
+# Add traditional routes for articles
+hyraft-rule routes articles tra
+
+# Add SPA routes for articles
+hyraft-rule routes articles spa
+
+# Default is tra
+hyraft-rule routes articles
+
 ```
 
+## Usage ( API Routes )
 
+Generate:
+
+```bash
+
+hyr-rule api-routes articles
+hyraft-rule api-routes articles
+```
 
 
 ## Usage ( Templates )
-- hyr-rule
 
 Generate:
 
@@ -109,8 +163,8 @@ hyr-rule template admin-app/users
 hyraft-rule template admin-app/users
 ```
 
+
 ## Usage ( For Help )
-- hyr-rule
 
 Generate:
 
@@ -132,37 +186,37 @@ hyraft-rule -h
 
 
 ## Usage ( Database ) 
-- hyr-rule-db
+- hyraft-rule-db
 
 
 Schema:  
       
 
 ```bash
-      hyr-rule-db generate create_users
-      hyr-rule-db generate add_email_to_users
+      hyraft-rule-db generate create_users
+      hyraft-rule-db generate add_email_to_users
 
    - Migration Generation Schema Examples:
    
-      hyr-rule-db generate create_users
-      hyr-rule-db generate create_articles
-      hyr-rule-db generate create_products
-      hyr-rule-db generate create_categories
-      hyr-rule-db generate add_image_file_to_articles
-      hyr-rule-db generate add_price_to_products
-      hyr-rule-db generate remove_status_from_posts
-      hyr-rule-db generate drop_old_tables
+      hyraft-rule-db generate create_users
+      hyraft-rule-db generate create_articles
+      hyraft-rule-db generate create_products
+      hyraft-rule-db generate create_categories
+      hyraft-rule-db generate add_image_file_to_articles
+      hyraft-rule-db generate add_price_to_products
+      hyraft-rule-db generate remove_status_from_posts
+      hyraft-rule-db generate drop_old_tables
 
 
     Examples:
-     hyr-rule-db generate create_articles title content:text
+     hyraft-rule-db generate create_articles title content:text
 
-     hyr-rule-db generate create_products name:string price:decimal description:text user_id:int
-     hyr-rule-db generate create_users username:string age:int email:string active:bool created_at:datetime
+     hyraft-rule-db generate create_products name:string price:decimal description:text user_id:int
+     hyraft-rule-db generate create_users username:string age:int email:string active:bool created_at:datetime
 
-     hyr-rule-db generate create_products name:string price:decimal description:text user_id:int
-     hyr-rule-db generate create_users username age:int email active:bool
-     hyr-rule-db generate create_articles title content:text published_at:datetime views:int
+     hyraft-rule-db generate create_products name:string price:decimal description:text user_id:int
+     hyraft-rule-db generate create_users username age:int email active:bool
+     hyraft-rule-db generate create_articles title content:text published_at:datetime views:int
 
 
 ```
@@ -182,18 +236,18 @@ Migrations:
 
     Examples:
 
-      hyr-rule-db migrate
-      hyr-rule-db status
-      hyr-rule-db rollback
-      hyr-rule-db reset
-      hyr-rule-db help
+      hyraft-rule-db migrate
+      hyraft-rule-db status
+      hyraft-rule-db rollback
+      hyraft-rule-db reset
+      hyraft-rule-db help
 
     Environment Usage:
 
-      hyr-rule-db migrate                     # Current environment (run: hyr s thin)
-      APP_ENV=test hyr-rule-db migrate        # Test environment (run: APP_ENV=test hyr s thin)
-      APP_ENV=development hyr-rule-db migrate # Development environment (run: APP_ENV=development hyr s thin)
-      APP_ENV=production hyr-rule-db migrate  # Production environment (run: APP_ENV=production hyr s thin)
+      hyraft-rule-db migrate                     # Current environment (run: hyr s thin)
+      APP_ENV=test hyraft-rule-db migrate        # Test environment (run: APP_ENV=test hyr s thin)
+      APP_ENV=development hyraft-rule-db migrate # Development environment (run: APP_ENV=development hyr s thin)
+      APP_ENV=production hyraft-rule-db migrate  # Production environment (run: APP_ENV=production hyr s thin)
 
     Quick Reference:
 
@@ -220,11 +274,46 @@ Migrations:
 
 
 
+
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bundle install` to install dependencies.
+
+Then, run `rake test` to run the tests.
+
+```bash
+
+rake test 
+
+comment this: FileUtils.rm_rf(TEST_APP_DIR) located at test_helper.rb
+
+- To generate files
+
+
+# Run single test file
+rake test TEST=test/hyraft/rule/circuit/port_command_test.rb
+
+or
+
+ruby -Ilib:test test/hyraft/rule/circuit/port_command_test.rb
+
+# Run specific test method
+rake test TEST=test/hyraft/rule/circuit/port_command_test.rb -n test_generates_port_file
+
+# Run with pattern
+rake test TEST=test/hyraft/rule/circuit/port_command_test.rb -n /test_generates/
+
+
+
+rake test TEST=test/hyraft/rule/base/in_api_command_test.rb
+rake test TEST=test/hyraft/rule/circuit/engine_command_test.rb
+rake test TEST=test/hyraft/rule/connectors/cable_command_test.rb
+rake test TEST=test/hyraft/rule/base/out_data_command_test.rb
+
+rake test TEST=test/hyraft/rule/jwt/jwt_command_test.rb
+
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 

data/exe/hyraft-rule-db

@@ -1,9 +1,47 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
+#hyarft-rule-db.rb
 
 require 'fileutils'
 require 'sequel'
 
+
+# -------------------------------
+# COLOR HELPER METHODS
+# -------------------------------
+module Colorize
+  COLORS = {
+    red: "\e[31m",
+    green: "\e[32m", 
+    yellow: "\e[33m",
+    blue: "\e[34m",
+    magenta: "\e[35m",
+    cyan: "\e[36m",
+    white: "\e[37m",
+    bold: "\e[1m",
+    reset: "\e[0m"
+  }
+
+  def colorize(text, color)
+    return text unless STDOUT.tty?  # Only colorize if terminal supports it
+    "#{COLORS[color]}#{text}#{COLORS[:reset]}"
+  end
+
+  # Convenience methods
+  def red(text); colorize(text, :red); end
+  def green(text); colorize(text, :green); end
+  def yellow(text); colorize(text, :yellow); end
+  def blue(text); colorize(text, :blue); end
+  def magenta(text); colorize(text, :magenta); end
+  def cyan(text); colorize(text, :cyan); end
+  def bold(text); colorize(text, :bold); end
+end
+
+# Include color methods in main context
+include Colorize
+
+
+
 # -------------------------------
 # Helper: find application root
 # -------------------------------
@@ -29,7 +67,7 @@ $LOAD_PATH.unshift(APP_ROOT) unless $LOAD_PATH.include?(APP_ROOT)
 
 begin
   require File.join(APP_ROOT, 'boot')
-  require File.join(APP_ROOT, 'infra', 'database', 'sequel_connection')
+  require File.join(APP_ROOT, 'setup', 'database', 'sequel_connection')
 rescue LoadError => e
   puts "❌ Error loading dependencies: #{e.message}"
   exit 1
@@ -44,7 +82,7 @@ rescue => e
   exit 1
 end
 
-MIGRATIONS_DIR = File.join(APP_ROOT, 'infra', 'database', 'migrations')
+MIGRATIONS_DIR = File.join(APP_ROOT, 'setup', 'database', 'migrations')
 
 # -------------------------------
 # Generate Migration Methods
@@ -65,19 +103,19 @@ def generate_migration(migration_name, *columns)
   
   File.write(full_path, migration_content)
 
-  puts "✓ Created migration: #{full_path}"
-  puts "Table name detected: #{table_name}" if table_name
+  puts green("✓ Created migration: #{full_path}")
+  puts cyan("Table name detected: #{table_name}") if table_name
   
   if columns.any?
-    puts "Columns added: #{columns.join(', ')}"
+    puts cyan("Columns added: #{columns.join(', ')}")
   end
   
   puts ""
-  puts "To apply this migration, run one of these:"
-  puts "  hyr-rule-db migrate                              # Development environment (default)"
-  puts "  APP_ENV=test hyr-rule-db migrate                 # For test environment"
-  puts "  APP_ENV=development hyr-rule-db migrate          # For development environment"
-  puts "  APP_ENV=production hyr-rule-db migrate           # For production environment"
+  puts yellow("To apply this migration, run one of these:")
+  puts cyan("  hyr-rule-db migrate") + "                              # " + green("Development environment (default)")
+  puts cyan("  APP_ENV=test hyr-rule-db migrate") + "                 # " + yellow("For test environment") 
+  puts cyan("  APP_ENV=development hyr-rule-db migrate") + "          # " + blue("For development environment")
+  puts cyan("  APP_ENV=production hyr-rule-db migrate") + "           # " + red("For production environment")
 end
 
 def extract_table_name(migration_name)
@@ -229,7 +267,7 @@ end
 def run_migrations
   migration_files = Dir.glob(File.join(MIGRATIONS_DIR, "[0-9]*_*.rb")).sort
   if migration_files.empty?
-    puts "No migration files found in #{MIGRATIONS_DIR}"
+    puts yellow("No migration files found in #{MIGRATIONS_DIR}")
     return
   end
 
@@ -255,17 +293,17 @@ def run_migrations
     newly_applied = applied_after - applied_before
 
     if newly_applied.empty?
-      puts "✓ All files migrated successfully: no pending migrations"
+      puts green("✓ All files migrated successfully: no pending migrations")
     else
       if newly_applied.size == 1
-        puts "✓ Migration applied successfully: #{newly_applied.first}"
+        puts green("✓ Migration applied successfully: #{newly_applied.first}")
       else
         puts "✓ #{newly_applied.size} migrations applied successfully:"
         newly_applied.each { |migration| puts "  - #{migration}" }
       end
     end
   rescue => e
-    puts "✗ Migration failed: #{e.message}"
+    puts red("✗ Migration failed: #{e.message}")
     exit 1
   end
 end
@@ -285,17 +323,18 @@ def rollback_migrations
 end
 
 def show_status
-  puts "Migration Status:"
-  puts "Database: #{DB.opts[:database]}"
+  
+  puts bold("Migration Status:")
+  puts cyan("Database: #{DB.opts[:database]}")
 
   migration_files = Dir.glob(File.join(MIGRATIONS_DIR, "[0-9]*_*.rb")).sort
   
   if DB.table_exists?(:schema_migrations)
     applied_migrations = DB[:schema_migrations].order(:filename).map { |r| r[:filename].gsub('.rb', '') }
     latest = applied_migrations.last
-    puts "Schema migrations table: ✓ created"
-    puts "Latest applied migration: #{latest || 'none'}"
-    puts "Applied migrations: #{applied_migrations.size} of #{migration_files.size}"
+    puts green("Schema migrations table: ✓ created")
+    puts cyan("Latest applied migration: #{latest || 'none'}")
+    puts cyan("Applied migrations: #{applied_migrations.size} of #{migration_files.size}")
     
     # Show pending migrations
     pending_migrations = migration_files.reject do |file|
@@ -304,32 +343,33 @@ def show_status
     end
 
     if pending_migrations.any?
-      puts "\nPending migrations:"
-      pending_migrations.each { |f| puts "  - #{File.basename(f)}" }
-      puts "\nRun one of these to apply pending migrations:"
-      puts "  hyr-rule-db migrate                              # Development environment (default)"
-      puts "  APP_ENV=test hyr-rule-db migrate                 # For test environment"
-      puts "  APP_ENV=development hyr-rule-db migrate          # For development environment"
-      puts "  APP_ENV=production hyr-rule-db migrate           # For production environment"
+      puts yellow("\nPending migrations:")
+      pending_migrations.each { |f| puts cyan("  - #{File.basename(f)}") }
+      puts yellow("\nRun one of these to apply pending migrations:")
+      puts cyan("  hyr-rule-db migrate") + "                              # " + green("Development environment (default)")
+      puts cyan("  APP_ENV=test hyr-rule-db migrate") + "                 # " + yellow("For test environment")
+      puts cyan("  APP_ENV=development hyr-rule-db migrate") + "          # " + blue("For development environment") 
+      puts cyan("  APP_ENV=production hyr-rule-db migrate") + "           # " + red("For production environment")
     else
-      puts "✓ All migrations are applied"
+      puts green("✓ All migrations are applied")
     end
   else
-    puts "Schema migrations table: ○ not created yet"
-    puts "Latest applied migration: none"
+    puts yellow("Schema migrations table: ○ not created yet")
+    puts cyan("Latest applied migration: none")
     
     if migration_files.any?
-      puts "\nMigration files:"
-      migration_files.each { |f| puts "  - #{File.basename(f)}" }
-      puts "\nRun one of these to apply pending migrations:"
-      puts "  hyr-rule-db migrate                              # For development environment"
-      puts "  APP_ENV=test hyr-rule-db migrate                 # For test environment"
-      puts "  APP_ENV=development hyr-rule-db migrate          # For development environment"
-      puts "  APP_ENV=production hyr-rule-db migrate           # For production environment"
+      puts yellow("\nMigration files:")
+      migration_files.each { |f| puts cyan("  - #{File.basename(f)}") }
+      puts yellow("\nRun one of these to apply pending migrations:")
+      puts cyan("  hyr-rule-db migrate") + "                              # " + green("Development environment")
+      puts cyan("  APP_ENV=test hyr-rule-db migrate") + "                 # " + yellow("For test environment")
+      puts cyan("  APP_ENV=development hyr-rule-db migrate") + "          # " + blue("For development environment")
+      puts cyan("  APP_ENV=production hyr-rule-db migrate") + "           # " + red("For production environment")
     else
-      puts "No migration files found in #{MIGRATIONS_DIR}"
+      puts yellow("No migration files found in #{MIGRATIONS_DIR}")
     end
   end
+  
 end
 
 

data/hyraft-rule.gemspec

@@ -9,14 +9,20 @@ Gem::Specification.new do |spec|
 
 
   spec.summary = "Hyraft Rule - Command system for Hyraft applications"
-  spec.description = "A standalone command system with migrations for Hyraft applications"
+  spec.description = "This is a standalone command-line interface (CLI) for the Hyraft framework."
   spec.homepage = "https://github.com/demjhonsilver/hyraft-rule"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.4.0"
+  spec.required_ruby_version = ">= 4.0.0"
 
-  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 = {
+    "homepage_uri"     => "https://github.com/demjhonsilver/hyraft-rule",
+    "documentation_uri" => "https://www.rubydoc.info/gems/hyraft-rule",
+    "source_code_uri"  => "https://github.com/demjhonsilver/hyraft-rule/tree/main",
+    "changelog_uri"    => "https://github.com/demjhonsilver/hyraft-rule/blob/main/CHANGELOG.md"
+  }
+  
+   spec.metadata["rubygems_mfa_required"] = "true"
 
   # Manual file listing without git dependency
 # In hyraft-rule.gemspec - update the files section
@@ -28,15 +34,15 @@ Gem::Specification.new do |spec|
     "lib/hyraft/rule.rb",
     "lib/hyraft/rule/version.rb",
     "lib/hyraft/rule/command.rb",
-    "lib/hyraft/rule/engine/source_command.rb",
-    "lib/hyraft/rule/engine/circuit_command.rb",
-    "lib/hyraft/rule/engine/port_command.rb",
-    "lib/hyraft/rule/adapter_request/web_adapter_command.rb",
-    "lib/hyraft/rule/adapter_request/remove_adapter_command.rb",
-    "lib/hyraft/rule/adapter_exhaust/data_gateway_command.rb", 
-    "lib/hyraft/rule/assemble_command.rb", 
-    "lib/hyraft/rule/disassemble_command.rb", 
-     "lib/hyraft/rule/template_command.rb", 
+    "lib/hyraft/rule/base/in_api_command.rb", 
+    "lib/hyraft/rule/base/out_data_command.rb", 
+    "lib/hyraft/rule/connectors/cable_command.rb",
+    "lib/hyraft/rule/circuit/port_command.rb",
+    "lib/hyraft/rule/circuit/engine_command.rb",
+    "lib/hyraft/rule/router/web_routes_command.rb", 
+    "lib/hyraft/rule/router/api_routes_command.rb", 
+    "lib/hyraft/rule/template/template_command.rb", 
+    "lib/hyraft/rule/jwt/jwt_command.rb", 
     "LICENSE.txt",
     "README.md",
     "CHANGELOG.md",
@@ -48,7 +54,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
 
-  
-  spec.add_development_dependency "minitest", "~> 5.0"
-  spec.add_development_dependency "rake", "~> 13.0"
+  # Runtime dependencies
+  spec.add_development_dependency "rake", "~> 13.3"
+  # spec.add_development_dependency "minitest", "~> 5.26"
 end