yoker 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1363e81437edece05648573f73cd9b68e8545b969a6a862cedffbbd753a52261
+  data.tar.gz: 057c0bdecb48574f069401362c1055e5c47236cde5241609a922241f38c14fd5
+SHA512:
+  metadata.gz: b8d0862dc46af8411281d731dbe39eb963073a608b0830a465978bc2dbeb8cdad93b03ce0f3dce8b9c3fd40363736095d75d7113ff52c1cc986e29ecf15d908e
+  data.tar.gz: 700d09620026d2697116d6b47a5513498f633e353cb68024f10823bf6c690bcf02f576dbb66bb391d6cc92e521c35cd8b24186b86726c1e470589615395b90b2

data/.rubocop.yml

@@ -0,0 +1,8 @@
+AllCops:
+  TargetRubyVersion: 3.1
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Lance Taylor
+
+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,223 @@
+# Yoker
+
+> Automated development environment setup for Rails applications
+
+Yoker eliminates the tedious manual configuration of Rails development environments by providing intelligent, automated setup with support for multiple databases, version managers, and containerization options.
+
+## ✨ Features
+
+- **Smart Detection**: Automatically detects existing Rails apps, database configs, and version managers
+- **Multiple Database Support**: PostgreSQL, MySQL, and SQLite3
+- **Version Manager Integration**: mise, rbenv, and rvm support
+- **Containerization Options**: Docker Compose, standalone Docker, or native setup
+- **Interactive & Automated Modes**: Guided setup or command-line automation
+- **Modern Tooling**: Built for Rails 7+ with cutting-edge development tools
+
+## 🚀 Quick Start
+
+```bash
+# Install the gem
+gem install yoker
+
+# Navigate to your Rails app
+cd my-rails-app
+
+# Interactive setup (recommended for first-time users)
+yoker init --interactive
+
+# Or automated setup with specific options
+yoker init \
+  --database=postgresql \
+  --version-manager=mise \
+  --container=docker-compose \
+  --ruby-version=3.2.0
+
+# Run the generated setup
+./bin/setup
+```
+
+## 📋 Requirements
+
+- Ruby 3.0+
+- Rails application (any version)
+- Docker (if using containerization)
+- mise, rbenv, or rvm (if using version management)
+
+## 🛠️ Configuration Options
+
+### Databases
+- **PostgreSQL** (recommended) - Latest PostgreSQL 18 with Alpine Linux
+- **MySQL** - MySQL 8.0 with optimized configuration
+- **SQLite3** - For simple development setups
+
+### Version Managers
+- **mise** (recommended) - Modern, fast tool version management
+- **rbenv** - Simple Ruby version management
+- **rvm** - Ruby Version Manager
+- **none** - Use system Ruby
+
+### Containerization
+- **docker-compose** (recommended) - Full orchestration with services
+- **docker** - Standalone database containers
+- **none** - Native installation
+
+## 📁 Generated Files
+
+Yoker creates and configures:
+
+```
+your-rails-app/
+├── bin/setup                    # Enhanced setup script
+├── config/database.yml          # Database configuration
+├── docker-compose.yml           # Service orchestration
+├── Dockerfile                   # Container definition
+├── mise.toml                    # Tool version management
+└── docker/
+    └── init.sql                 # Database initialization
+```
+
+## 🎯 Example Configurations
+
+### PostgreSQL + mise + Docker Compose
+Perfect for modern Rails development with full containerization:
+
+```bash
+yoker init \
+  --database=postgresql \
+  --version-manager=mise \
+  --container=docker-compose
+```
+
+Generates:
+- PostgreSQL 18 service with persistent data
+- mise configuration with Ruby and Node.js
+- Docker Compose with health checks
+- Enhanced bin/setup with smart detection
+
+### MySQL + rbenv + Standalone Docker
+Great for teams preferring rbenv with containerized database:
+
+```bash
+yoker init \
+  --database=mysql \
+  --version-manager=rbenv \
+  --container=docker
+```
+
+### SQLite + Native Setup
+Minimal setup for simple projects:
+
+```bash
+yoker init \
+  --database=sqlite3 \
+  --container=none
+```
+
+## 🔧 Advanced Features
+
+### Additional Services
+When using Docker Compose, you can include additional services:
+
+- **Redis** - For caching and background jobs
+- **Sidekiq** - Background job processing
+- **Mailcatcher** - Email testing in development
+
+```bash
+yoker init --interactive
+# Select additional services during interactive setup
+```
+
+### mise Integration
+Yoker generates comprehensive mise configurations:
+
+```toml
+[tools]
+ruby = "3.2.0"
+node = "20.0.0"
+postgres = "16"  # When using native setup
+
+[tasks."dev:setup"]
+run = "./bin/setup"
+
+[tasks."dev:server"]
+run = "bin/rails server"
+
+[env]
+DATABASE_URL = "postgresql://postgres:password@localhost:5432/myapp_development"
+```
+
+### Smart Setup Script
+The generated `bin/setup` script includes:
+
+- ✅ Dependency installation with verification
+- ✅ Tool version management integration
+- ✅ Database container orchestration
+- ✅ Health checks and wait conditions
+- ✅ Database preparation and migrations
+- ✅ Clear success/error messaging
+
+## 📊 Status Checking
+
+Check your current development environment:
+
+```bash
+yoker status
+```
+
+Output:
+```
+✅ Rails application detected
+  Rails version: 7.1.2
+✅ Database: postgresql
+✅ Version manager: mise
+  Ruby version: 3.2.0
+✅ Docker Compose configuration found
+✅ Setup script ready (bin/setup)
+```
+
+## 🤝 Contributing
+
+We welcome contributions! This gem aims to standardize Rails development environment setup across the community.
+
+### Development Setup
+
+```bash
+git clone https://github.com/ecnal/yoker.git
+cd yoker
+bundle install
+bundle exec rspec
+```
+
+### Contributing Guidelines
+
+1. **Fork** the repository
+2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
+3. **Add** tests for your changes
+4. **Ensure** tests pass (`bundle exec rspec`)
+5. **Commit** your changes (`git commit -m 'Add amazing feature'`)
+6. **Push** to the branch (`git push origin feature/amazing-feature`)
+7. **Open** a Pull Request
+
+## 🐛 Bug Reports & Feature Requests
+
+Please use [GitHub Issues](https://github.com/ecnal/yoker/issues) for:
+
+- 🐛 Bug reports with reproduction steps
+- 💡 Feature requests with use cases
+- 📖 Documentation improvements
+- ❓ Questions about usage
+
+## 📜 License
+
+Yoker is released under the [MIT License](LICENSE).
+
+## 🙏 Acknowledgments
+
+- Rails team for the excellent framework
+- mise developers for modern tool management
+- Docker team for containerization technology
+- The Ruby community for continuous innovation
+
+---
+
+**Made with ❤️ for the Rails community**

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/exe/yoker

@@ -0,0 +1,177 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Add the lib directory to the load path
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+
+require "yoker"
+require "yoker/cli/base"
+require "yoker/cli/init"
+require "yoker/cli/update"
+
+module Yoker
+  module CLI
+    class Main < Base
+      desc "init", "Initialize development environment setup for Rails application"
+      method_option :database,
+                    type: :string,
+                    enum: %w[postgresql mysql sqlite3],
+                    desc: "Database adapter to use"
+
+      method_option :version_manager,
+                    type: :string,
+                    enum: %w[mise rbenv rvm none],
+                    desc: "Ruby version manager to use"
+
+      method_option :container,
+                    type: :string,
+                    enum: %w[docker-compose docker none],
+                    desc: "Containerization approach"
+
+      method_option :ruby_version,
+                    type: :string,
+                    desc: "Ruby version to use"
+
+      method_option :interactive,
+                    type: :boolean,
+                    default: false,
+                    aliases: %w[-i],
+                    desc: "Run in interactive mode"
+
+      method_option :force,
+                    type: :boolean,
+                    default: false,
+                    aliases: %w[-f],
+                    desc: "Overwrite existing files"
+
+      def init
+        Init.new([], options).generate
+      end
+
+      desc "update", "Update existing development environment setup"
+      method_option :database,
+                    type: :string,
+                    enum: %w[postgresql mysql sqlite3],
+                    desc: "Change database adapter"
+
+      method_option :version_manager,
+                    type: :string,
+                    enum: %w[mise rbenv rvm none],
+                    desc: "Change Ruby version manager"
+
+      method_option :container,
+                    type: :string,
+                    enum: %w[docker-compose docker none],
+                    desc: "Change containerization approach"
+
+      method_option :ruby_version,
+                    type: :string,
+                    desc: "Update Ruby version"
+
+      method_option :add_service,
+                    type: :array,
+                    enum: %w[redis sidekiq mailcatcher],
+                    desc: "Add additional services"
+
+      method_option :remove_service,
+                    type: :array,
+                    enum: %w[redis sidekiq mailcatcher],
+                    desc: "Remove services"
+
+      method_option :interactive,
+                    type: :boolean,
+                    default: false,
+                    aliases: %w[-i],
+                    desc: "Run in interactive mode"
+
+      method_option :backup,
+                    type: :boolean,
+                    default: true,
+                    desc: "Backup existing files before updating"
+
+      method_option :dry_run,
+                    type: :boolean,
+                    default: false,
+                    desc: "Show what would be changed without making changes"
+
+      def update
+        Update.new([], options).execute
+      end
+
+      desc "version", "Show yoker version"
+      def version
+        puts "yoker #{Yoker::VERSION}"
+      end
+
+      desc "status", "Show current development environment status"
+      def status
+        detect_rails_app!
+
+        info "Development Environment Status"
+        puts ""
+
+        # Rails detection
+        if Detectors::RailsDetector.rails_app?
+          success "Rails application detected"
+          if version = Detectors::RailsDetector.rails_version
+            puts "  Rails version: #{version}"
+          end
+        else
+          error "Not a Rails application"
+          return
+        end
+
+        # Database detection
+        if db = Detectors::DatabaseDetector.detect
+          success "Database: #{db}"
+        else
+          warning "No database adapter detected"
+        end
+
+        # Version manager detection
+        if vm = Detectors::VersionManagerDetector.detect
+          success "Version manager: #{vm}"
+          if ruby_version = Detectors::VersionManagerDetector.ruby_version_from_file
+            puts "  Ruby version: #{ruby_version}"
+          end
+        else
+          warning "No version manager detected"
+        end
+
+        # Container detection
+        if File.exist?("docker-compose.yml")
+          success "Docker Compose configuration found"
+        elsif File.exist?("Dockerfile")
+          success "Dockerfile found"
+        else
+          info "No containerization setup detected"
+        end
+
+        # Setup script detection
+        if File.exist?("bin/setup")
+          if File.executable?("bin/setup")
+            success "Setup script ready (bin/setup)"
+          else
+            warning "Setup script exists but not executable (bin/setup)"
+          end
+        else
+          info "No setup script found"
+        end
+      end
+
+      # Default task when no command is provided
+      def self.exit_on_failure?
+        true
+      end
+    end
+  end
+end
+
+# Run the CLI
+begin
+  Yoker::CLI::Main.start(ARGV)
+rescue StandardError => e
+  puts "\n❌ Error: #{e.message}"
+  puts e.backtrace.join("\n") if ENV["DEBUG"]
+  exit 1
+end

data/exe/yoker (Copy)

@@ -0,0 +1,87 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+
+require_relative "../lib/yoker"
+require_relative "../lib/yoker/cli/init"
+
+module Yoker
+  module CLI
+    class Main < Base
+      desc "init", "Initialize development environment setup for Rails application"
+      def init
+        Init.new.generate
+      end
+
+      desc "update", "Update existing development environment setup"
+      def update
+        Update.new.run
+      end
+
+      desc "version", "Show yoker version"
+      def version
+        puts "yoker #{Yoker::VERSION}"
+      end
+
+      desc "status", "Show current development environment status"
+      def status
+        detect_rails_app!
+
+        info "Development Environment Status"
+        puts ""
+
+        # Rails detection
+        if Detectors::RailsDetector.rails_app?
+          success "Rails application detected"
+          if version = Detectors::RailsDetector.rails_version
+            puts "  Rails version: #{version}"
+          end
+        else
+          error "Not a Rails application"
+          return
+        end
+
+        # Database detection
+        if db = Detectors::DatabaseDetector.detect
+          success "Database: #{db}"
+        else
+          warning "No database adapter detected"
+        end
+
+        # Version manager detection
+        if vm = Detectors::VersionManagerDetector.detect
+          success "Version manager: #{vm}"
+          if ruby_version = Detectors::VersionManagerDetector.ruby_version_from_file
+            puts "  Ruby version: #{ruby_version}"
+          end
+        else
+          warning "No version manager detected"
+        end
+
+        # Container detection
+        if File.exist?("docker-compose.yml")
+          success "Docker Compose configuration found"
+        elsif File.exist?("Dockerfile")
+          success "Dockerfile found"
+        else
+          info "No containerization setup detected"
+        end
+
+        # Setup script detection
+        if File.exist?("bin/setup")
+          if File.executable?("bin/setup")
+            success "Setup script ready (bin/setup)"
+          else
+            warning "Setup script exists but not executable (bin/setup)"
+          end
+        else
+          info "No setup script found"
+        end
+      end
+    end
+  end
+end
+
+# Only run if this file is executed directly
+Yoker::CLI::Main.start(ARGV) if __FILE__ == $PROGRAM_NAME

data/lib/yoker/cli/base.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require "thor"
+require "tty-prompt"
+require "tty-spinner"
+require "pastel"
+require "fileutils"
+
+module Yoker
+  module CLI
+    class Base < Thor
+      include Thor::Actions
+
+      def self.source_root
+        Yoker.template_path
+      end
+
+      def template(source, destination, context = {})
+        # Read the template file
+        template_path = File.join(self.class.source_root, source)
+
+        unless File.exist?(template_path)
+          error "Template not found: #{template_path}"
+          return
+        end
+
+        # Create the binding with the context
+        template_content = File.read(template_path)
+
+        # Use ERB to render the template
+        require "erb"
+        require "ostruct"
+
+        # Convert hash to OpenStruct for easier access in templates
+        binding_context = context.is_a?(Hash) ? OpenStruct.new(context) : context
+        rendered = ERB.new(template_content, trim_mode: "-").result(binding_context.instance_eval { binding })
+
+        # Write the file
+        create_file(destination, rendered, force: true)
+      end
+
+      def create_file(path, content, options = {})
+        return if File.exist?(path) && !options[:force] && !prompt.yes?("File #{path} exists. Overwrite?")
+
+        # Create directory if it doesn't exist
+        dir = File.dirname(path)
+        FileUtils.mkdir_p(dir) unless Dir.exist?(dir)
+
+        # Write the file
+        File.write(path, content)
+        success "Created #{path}"
+      end
+
+      def append_to_file(path, content)
+        File.open(path, "a") { |f| f.write(content) }
+        info "Updated #{path}"
+      end
+
+      private
+
+      def prompt
+        @prompt ||= TTY::Prompt.new
+      end
+
+      def pastel
+        @pastel ||= Pastel.new
+      end
+
+      def success(message)
+        puts pastel.green("✅ #{message}")
+      end
+
+      def info(message)
+        puts pastel.blue("ℹ️  #{message}")
+      end
+
+      def warning(message)
+        puts pastel.yellow("⚠️  #{message}")
+      end
+
+      def error(message)
+        puts pastel.red("❌ #{message}")
+      end
+
+      def spinner(message)
+        TTY::Spinner.new("[:spinner] #{message}", format: :dots)
+      end
+
+      def detect_rails_app!
+        return if Detectors::RailsDetector.rails_app?
+
+        error "This doesn't appear to be a Rails application directory"
+        error "Please run this command from the root of a Rails project"
+        exit 1
+      end
+
+      def current_directory_name
+        File.basename(Dir.pwd)
+      end
+
+      def sanitize_name(name)
+        name.gsub(/[^a-zA-Z0-9]/, "_").downcase
+      end
+    end
+  end
+end