hyraft-rule 0.1.0.alpha1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7354edfc544227b3eb8c6dfdfa552f8ccc4764a763e975028d423657a851c417
+  data.tar.gz: 02cb548060b83aa6f3516826d08cfc649663733fdf4469155b59608a31089279
+SHA512:
+  metadata.gz: c9c71f2963cf91e915bfcde8531985e4105dee516e8ffd472f83d64956add49536a149bb14678285fc5e22e75e0d34b891668f4dfcbbd28ee612f657d8b2346e
+  data.tar.gz: 361550c41628c903ee91f16c491e6bacf106b4ebf5f001e6b1be9310e8369ce37a1a08aca4e95e8cd930f06208e5d37c75540ef5e986421c57c9c62e4336fce9

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-11-12
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Hyraft-rule  Demjhon Silver
+
+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/README.md

@@ -0,0 +1,239 @@
+
+<div align="center">
+
+# Hyraft Rule
+
+[![Gem Version](https://badge.fury.io/rb/hyraft-rule.svg?icon=si%3Arubygems&icon_color=%23ffffff)](https://badge.fury.io/rb/hyraft-rule)
+![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)
+
+</div>
+
+
+
+
+# Hyraft Rule - ( CLI ) Command system for Hyraft applications
+
+
+A standalone command system (cli) for Hyraft applications.
+
+## Installation
+
+Open Gemfile:
+put:
+
+```bash
+gem 'hyraft-rule'
+```
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle install
+```
+
+## Usage ( Assemble / Disassemble )
+- hyr-rule
+
+Package setup:
+
+```bash
+# Default web-app
+hyr-rule assemble articles
+hyr-rule disassemble articles
+
+# Specific app folders
+
+hyr-rule assemble {any-folder-name}/users
+
+
+hyr-rule assemble admin-app/users
+hyr-rule disassemble admin-app/users
+
+hyr-rule assemble api_app/products
+hyr-rule disassemble api_app/products
+```
+
+
+
+## Usage ( Engine )
+- hyr-rule
+
+Generate:
+
+```bash
+
+hyr-rule circuit articles
+
+hyr-rule port articles
+
+hyr-rule source article
+
+```
+
+## Usage ( Web Adapter )
+- hyr-rule
+
+Generate:
+
+```bash
+hyr-rule web-adapter articles
+hyr-rule web-adapter admin-app/products
+```
+
+## Usage ( data-gateway )
+- hyr-rule
+
+Generate:
+
+```bash
+hyr-rule data-gateway articles
+hyr-rule data-gateway admin-app/products
+```
+
+
+
+
+## Usage ( Templates )
+- hyr-rule
+
+Generate:
+
+```bash
+
+hyr-rule template articles
+hyraft-rule template articles
+
+hyr-rule template admin-app/users
+hyraft-rule template admin-app/users
+```
+
+## Usage ( For Help )
+- hyr-rule
+
+Generate:
+
+```bash
+
+hyr-rule h
+
+hyr-rule help
+
+hyr-rule -h
+
+hyraft-rule h
+
+hyraft-rule help
+
+hyraft-rule -h
+
+```
+
+
+## Usage ( Database ) 
+- hyr-rule-db
+
+
+Schema:  
+      
+
+```bash
+      hyr-rule-db generate create_users
+      hyr-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
+
+
+    Examples:
+     hyr-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
+
+     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
+
+
+```
+Migrations:
+
+```bash
+    Hyraft Rule Database Commands
+
+    Commands:
+
+      migrate, up        - Run all pending migrations
+      rollback, down     - Rollback all migrations
+      status             - Show migration status
+      reset              - Rollback and re-run all migrations
+      generate <name>    - Create a new migration file
+      help               - Show this help
+
+    Examples:
+
+      hyr-rule-db migrate
+      hyr-rule-db status
+      hyr-rule-db rollback
+      hyr-rule-db reset
+      hyr-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)
+
+    Quick Reference:
+
+      # Generate and run migrations for a new table
+      hyr-rule-db generate create_users
+      hyr-rule-db migrate
+
+      # Add a column to existing table
+      hyr-rule-db generate add_email_to_users
+      hyr-rule-db migrate
+
+      # Check what needs to be applied
+      hyr-rule-db status
+
+      # Rollback if something went wrong
+      hyr-rule-db rollback
+
+```
+
+
+
+
+
+
+
+
+## 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.
+
+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
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/demjhonsilver/hyraft-rule. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/demjhonsilver/hyraft-rule/blob/master/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Hyraft::Rule project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/demjhonsilver/hyraft-rule/blob/master/CODE_OF_CONDUCT.md).

data/exe/hyr-rule

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+# Short alias for hyraft-rule
+exec("hyraft-rule", *ARGV)

data/exe/hyr-rule-db

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+# Short alias for hyraft-rule-db
+exec("hyraft-rule-db", *ARGV)

data/exe/hyraft-rule

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "hyraft/rule"
+
+Hyraft::Rule::Command.start(ARGV)

data/exe/hyraft-rule-db

@@ -0,0 +1,404 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'sequel'
+
+# -------------------------------
+# Helper: find application root
+# -------------------------------
+def find_app_root
+  dir = Dir.pwd
+  while dir != '/'
+    boot_path = File.join(dir, 'boot.rb')
+    return dir if File.exist?(boot_path)
+    dir = File.dirname(dir)
+  end
+  nil
+end
+
+APP_ROOT = find_app_root
+
+if APP_ROOT.nil?
+  puts "❌ Error: Could not find boot.rb"
+  puts "Please run from your Hyraft application directory"
+  exit 1
+end
+
+$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')
+rescue LoadError => e
+  puts "❌ Error loading dependencies: #{e.message}"
+  exit 1
+end
+
+begin
+  Sequel.extension :migration
+  DB = SequelConnection.db
+  DB.test_connection
+rescue => e
+  puts "❌ Database connection failed: #{e.message}"
+  exit 1
+end
+
+MIGRATIONS_DIR = File.join(APP_ROOT, 'infra', 'database', 'migrations')
+
+# -------------------------------
+# Generate Migration Methods
+# -------------------------------
+def generate_migration(migration_name, *columns)
+  timestamp = Time.now.strftime("%Y%m%d%H%M%S")
+  filename = "#{timestamp}_#{migration_name}.rb"
+  full_path = File.join(MIGRATIONS_DIR, filename)
+
+  FileUtils.mkdir_p(MIGRATIONS_DIR)
+  
+  table_name = extract_table_name(migration_name)
+  migration_content = if migration_name.start_with?('create_') && table_name
+    create_table_template(table_name, *columns)
+  else
+    migration_template(migration_name)
+  end
+  
+  File.write(full_path, migration_content)
+
+  puts "✓ Created migration: #{full_path}"
+  puts "Table name detected: #{table_name}" if table_name
+  
+  if columns.any?
+    puts "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"
+end
+
+def extract_table_name(migration_name)
+  case migration_name
+  when /^create_(.+)$/
+    $1
+  when /^add_(.+)_to_(.+)$/
+    $2
+  when /^remove_(.+)_from_(.+)$/
+    $2
+  when /^drop_(.+)$/
+    $1
+  else
+    nil
+  end
+end
+
+def migration_template(migration_name)
+  table_name = extract_table_name(migration_name)
+  
+  if migration_name.start_with?('create_') && table_name
+    create_table_template(table_name)
+  elsif migration_name.start_with?('add_') && table_name
+    column_name = migration_name.match(/^add_(.+)_to_#{table_name}$/)[1]
+    add_column_template(table_name, column_name)
+  elsif migration_name.start_with?('remove_') && table_name
+    column_name = migration_name.match(/^remove_(.+)_from_#{table_name}$/)[1]
+    remove_column_template(table_name, column_name)
+  elsif migration_name.start_with?('drop_') && table_name
+    drop_table_template(table_name)
+  else
+    generic_template(migration_name)
+  end
+end
+
+
+def create_table_template(table_name, *columns)
+  # Parse columns with data types (format: name:string, age:int, price:decimal)
+  columns_code = if columns.any?
+    columns.map do |col|
+      if col.include?(':')
+        col_name, col_type = col.split(':', 2)
+        case col_type.downcase
+        when 'int', 'integer'
+          "Integer :#{col_name}, null: false"
+        when 'string', 'str', 'varchar', 'var'
+          "String :#{col_name}, size: 255, null: false"
+        when 'text'
+          "String :#{col_name}, text: true, null: false"
+        when 'decimal', 'float', 'numeric'
+          "Decimal :#{col_name}, size: [10, 2], null: false"
+        when 'bool', 'boolean'
+          "TrueClass :#{col_name}, null: false"
+        when 'date'
+          "Date :#{col_name}, null: false"
+        when 'datetime', 'timestamp'
+          "DateTime :#{col_name}, null: false"
+        else
+          "String :#{col_name}, size: 255, null: false" # default fallback
+        end
+      else
+        # Default to string if no type specified
+        "String :#{col}, size: 255, null: false"
+      end
+    end.map { |line| "      #{line}" }.join("\n")
+  else
+    "      # Add #{table_name} columns here"
+  end
+
+  <<~RUBY
+    Sequel.migration do
+      up do
+        create_table(:#{table_name}) do
+          primary_key :id, type: :bigint
+    #{columns_code}
+          
+          DateTime :created_at, default: Sequel::CURRENT_TIMESTAMP
+          DateTime :updated_at, default: Sequel::CURRENT_TIMESTAMP
+        end
+      end
+
+      down do
+        drop_table(:#{table_name})
+      end
+    end
+  RUBY
+end
+
+
+
+
+
+
+
+
+def add_column_template(table_name, column_name)
+  <<~RUBY
+    Sequel.migration do
+      change do
+        alter_table(:#{table_name}) do
+          add_column :#{column_name}, String
+        end
+      end
+    end
+  RUBY
+end
+
+
+
+
+
+def remove_column_template(table_name, column_name)
+  <<~RUBY
+    Sequel.migration do
+      change do
+        alter_table(:#{table_name}) do
+          drop_column :#{column_name}
+        end
+      end
+    end
+  RUBY
+end
+
+def drop_table_template(table_name)
+  <<~RUBY
+    Sequel.migration do
+      change do
+        drop_table(:#{table_name})
+      end
+    end
+  RUBY
+end
+
+def generic_template(migration_name)
+  <<~RUBY
+    Sequel.migration do
+      change do
+        # Migration: #{migration_name}
+        # Add your custom migration code here
+      end
+    end
+  RUBY
+end
+
+# -------------------------------
+# Migration methods
+# -------------------------------
+
+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}"
+    return
+  end
+
+  begin
+    # Get current applied migrations before migration
+    applied_before = if DB.table_exists?(:schema_migrations)
+      DB[:schema_migrations].order(:filename).map { |r| r[:filename].gsub('.rb', '') }
+    else
+      []
+    end
+
+    # Run migrations
+    Sequel::Migrator.run(DB, MIGRATIONS_DIR)
+    
+    # Get applied migrations after migration
+    applied_after = if DB.table_exists?(:schema_migrations)
+      DB[:schema_migrations].order(:filename).map { |r| r[:filename].gsub('.rb', '') }
+    else
+      []
+    end
+
+    # Find which migrations were just applied
+    newly_applied = applied_after - applied_before
+
+    if newly_applied.empty?
+      puts "✓ All files migrated successfully: no pending migrations"
+    else
+      if newly_applied.size == 1
+        puts "✓ 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}"
+    exit 1
+  end
+end
+
+
+
+
+def rollback_migrations
+  puts "Rolling back all migrations..."
+  begin
+    Sequel::Migrator.run(DB, MIGRATIONS_DIR, target: 0)
+    puts "✓ Rollback completed successfully"
+  rescue => e
+    puts "✗ Rollback failed: #{e.message}"
+    exit 1
+  end
+end
+
+def show_status
+  puts "Migration Status:"
+  puts "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}"
+    
+    # Show pending migrations
+    pending_migrations = migration_files.reject do |file|
+      filename = File.basename(file, '.rb')
+      applied_migrations.include?(filename)
+    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"
+    else
+      puts "✓ All migrations are applied"
+    end
+  else
+    puts "Schema migrations table: ○ not created yet"
+    puts "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"
+    else
+      puts "No migration files found in #{MIGRATIONS_DIR}"
+    end
+  end
+end
+
+
+def show_help
+  puts <<~HELP
+    Hyraft Rule Database Commands
+    Commands:
+      migrate, up        - Run all pending migrations
+      rollback, down     - Rollback all migrations
+      status             - Show migration status
+      reset              - Rollback and re-run all migrations
+      generate <name>    - Create a new migration file
+      help               - Show this help
+
+    Examples:
+      hyr-rule-db migrate
+      hyr-rule-db status
+      hyr-rule-db generate create_users
+      hyr-rule-db generate create_articles title content published_at
+      hyr-rule-db generate create_products name price description user_id
+
+    Migration Generation Examples:
+      hyr-rule-db generate create_users
+      hyr-rule-db generate create_articles title content published_at
+      hyr-rule-db generate create_products name price description
+      hyr-rule-db generate create_orders user_id total_amount status
+      hyr-rule-db generate add_email_to_users
+      hyr-rule-db generate remove_status_from_posts
+      hyr-rule-db generate drop_old_tables
+  HELP
+end
+
+# -------------------------------
+# Main execution
+# -------------------------------
+command = ARGV[0] || "help"
+migration_name = ARGV[1]
+
+case command
+when "migrate", "up"
+  run_migrations
+when "rollback", "down"
+  rollback_migrations
+when "status"
+  show_status
+when "reset"
+  rollback_migrations
+  run_migrations
+when "generate", "g"
+  if ARGV[1]
+    migration_name = ARGV[1]
+    columns = ARGV[2..-1] || []  # Get all remaining arguments as columns
+    generate_migration(migration_name, *columns)
+  else
+    puts "Error: Migration name required"
+    puts ""
+    puts "Usage: hyr-rule-db generate <migration_name> [column1 column2 ...]"
+    puts ""
+    puts "Examples:"
+    puts "  hyr-rule-db generate create_users"
+    puts "  hyr-rule-db generate create_products name price description"
+    puts "  hyr-rule-db generate create_orders user_id total_amount status"
+    puts "  hyr-rule-db generate add_email_to_users"
+    exit 1
+  end
+when "help", "-h", "--help"
+  show_help
+else
+  puts "Unknown command: #{command}"
+  show_help
+  exit 1
+end