minirails 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 771b7f597898182a1fa53aface49303f6eb3185f
+  data.tar.gz: af5236b60849641f505d8a2a81fceccdfa12896f
+SHA512:
+  metadata.gz: 89cb680f0c831cabb870674a5ecf0a4bf67ddd90c22b283168bcc192681e121ab79a1e74c4bff83082a6d30af82199106cc4e7b72057175db4e951eb4df1db91
+  data.tar.gz: 37fe4d4613b58e30f15e22a24b39aaff7b5503940ad222f6407cbd27c63c2327334b7849846ad20b7ecfb7ab54d21a44159158ee5fe58354a4fbe0f84106dde4

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in minirails.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Tymon Tobolski
+
+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,138 @@
+# Minirails
+
+> Run example rails app from single file
+
+Inspired by [The Smallest Rails App](http://thesmallestrailsapp.com/), I wanted to easily try various concepts inside rails apps without having to deal with all that bloat from standard rails directory structure.
+
+I went even further, not only reducing full rails app into single file (that has already been done) but to reducing a set of rails apps into single file :sunglasses:
+
+More seriously, you can now create whole microservice architecture within a singe file and somebody else will be able to grasp it all and execute it locally. Or you can easily make a single file app and post it to StackOverflow (and people can actually run this code)
+
+Just think about it. Proof of Concepts. Asking questions. Explaining concepts.
+
+## Installation
+
+```
+$ gem install minirails
+```
+
+## Basic usage
+
+Create a file `myapp.rb` with the following content
+
+```ruby
+# myapp.rb
+define do |app|
+  class ::MainController < ActionController::Base
+    def index
+      render text: "Hello"
+    end
+  end
+
+  app.routes.draw do
+    get "/", to: "main#index"
+  end
+end
+```
+
+then run
+```
+$ minirails myapp.rb
+```
+
+and that's it - you now have fully functional rails app running on port 5000!
+
+## Advanced usage
+
+### Multiple apps
+
+You can run multiple applications from singe file
+
+```ruby
+# file: multiple.rb
+# usage: $ minirails multiple.rb
+define "one" do |app|
+  app.routes.draw do
+    get "/", to: proc {|*| [200, {}, "Hello".lines] }
+  end
+end
+
+define "two" do |app|
+  app.routes.draw do
+    get "/", to: proc {|*| [200, {}, "World".lines] }
+  end
+end
+```
+
+They will be run on ports 5000 and 5100 (and 5200 etc.)
+
+### Database setup
+
+You can also use full ActiveRecord capabilities.
+The database (specified with `ENV["DATABASE_URL"]`) will be recreated (drop & create & migrate) on every run
+
+```ruby
+# file: database.rb
+# usage: $ minirails database.rb
+define "source" do |app|
+  # Configuration
+  ENV["DATABASE_URL"] = "postgresql://localhost/minirails_test"
+
+  # Migrations
+  class CreateUsers < ActiveRecord::Migration
+    def change
+      create_table :users do |t|
+        t.string :name
+        t.string :email
+      end
+    end
+  end
+
+  # Seeds (using migartions)
+  class CreateSomeUsersToStartWith < ActiveRecord::Migration
+    def change
+      User.create! [
+        {name: "Jon", email: "jon@example.com"},
+        {name: "Hodor", email: "hodor@example.com"}
+      ]
+    end
+  end
+
+
+  # Models
+  class User < ActiveRecord::Base
+  end
+
+  # Controllers
+  class UsersController < ActionController::Base
+    def index
+      render json: User.all
+    end
+  end
+
+  # Routes
+  app.routes.draw do
+    resources :users
+  end
+end
+```
+
+## FAQ
+
+- **How to speed up loading?**
+
+  Run `$ minirails --fast` and then use `bin/minirails myapp.rb` instead
+
+
+- **I'm getting "constant not found" errors!**
+
+  You need to prefix your classes with `::` to put them in top level scope
+
+
+## Contributing
+
+1. Fork it ( https://github.com/teamon/minirails/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "minirails"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/minirails

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+$: << File.expand_path("../../lib", __FILE__)
+require "minirails"
+
+Minirails.run(ARGV)

data/lib/minirails/version.rb

@@ -0,0 +1,3 @@
+module Minirails
+  VERSION = "0.1.0"
+end

data/lib/minirails.rb

@@ -0,0 +1,165 @@
+require "minirails/version"
+
+module Minirails
+  class << self
+    def run(argv)
+      case argv[0]
+      when "--init"
+        init
+      when "--fast"
+        fast
+      when "--help", nil
+        help
+      else
+        if argv[0].start_with?("--")
+          help
+        else
+          start(argv[0], argv[1])
+        end
+      end
+    end
+
+    def help
+      puts <<-EOS
+Usage: #$0 [OPTIONS] [FILE]
+
+$ #$0 myapp.rb
+
+OPTIONS:
+  --help  Show this message
+  --init  Create new sample app
+  --fast  Setup faster app loading
+      EOS
+    end
+
+    def init
+      File.open("myapp.rb", "w") do |f|
+        f.write File.read(File.expand_path("../../test/apps/hello.rb", __FILE__))
+      end
+
+      puts "You new app has been created! You can strat it with $ minirails myapp.rb"
+    end
+
+    def fast
+      File.open("Gemfile", "w") do |f|
+        f.puts %Q|source "https://rubygems.org"|
+        f.puts %Q|gem "minirails"|
+      end
+
+      system "bundle install"
+      system "bundle binstubs minirails --force"
+
+      puts "Now you can use much faster bin/minirails instead of minirails"
+    end
+
+    def start(specfile, num = nil)
+      builder = Builder.new(specfile)
+      num ? builder.start(num.to_i) : builder.spawn
+    end
+  end
+
+
+  class Builder < Struct.new(:specfile)
+    # DSL API
+    def define(name = nil, &block)
+      apps << App.new(name, block)
+    end
+
+    # internals
+    def start(num)
+      boot
+
+      $stderr.puts "--> loading rails"
+      require "action_controller"
+      require "rails"
+      $stderr.puts "--> loading app"
+
+      Rack::Handler::WEBrick.run(endpoint(num), :Port => ENV["PORT"])
+    end
+
+    def endpoint(num)
+      apps[num].endpoint
+    rescue NameError => e
+      # autoloading has some crazy weird error
+      # and we can't just require activerecord upfront
+      # because if app is not using it there will
+      # be no database configuration
+      case e.message
+      when /uninitialized constant.*ActiveRecord/
+        $stderr.puts "--> loading activerecord"
+        require "active_record/railtie"
+      else
+        raise e
+      end
+
+      endpoint(num)
+    end
+
+    def spawn
+      boot
+
+      require "foreman/engine/cli"
+
+      engine = Foreman::Engine::CLI.new
+      apps.each.with_index do |app, index|
+        engine.register(
+          app.name || "web-#{index}",
+          "#{File.expand_path($0)} #{File.expand_path(specfile)} #{index}",
+          cwd: Dir.pwd
+        )
+      end
+
+      engine.start
+    end
+
+    protected
+
+    def apps
+      @apps ||= []
+    end
+
+    def boot
+      eval File.read(specfile)
+    end
+  end
+
+  class App < Struct.new(:name, :block)
+    def build
+      # basic rails app bootstrap
+      app = Class.new(Rails::Application) do
+        config.eager_load = false
+        config.secret_key_base = SecureRandom.hex
+        config.logger = Logger.new(STDERR)
+      end
+
+      # ActiveRecord specific configuration
+      if app.config.respond_to?(:active_record)
+        app.config.active_record.dump_schema_after_migration = false
+      end
+
+      # initialize app
+      app.initialize!
+
+      # execute 'define' block
+      block.call(app)
+
+      # ActiveRecord post functions
+      if app.config.respond_to?(:active_record)
+        # load rake tasks
+        app.load_tasks
+
+        # create and migrate database
+        Rake::Task["db:drop"].invoke
+        Rake::Task["db:create"].invoke
+        ActiveRecord::Migration.descendants.each {|e| e.migrate :up }
+      end
+
+      # and finally return app object
+      app
+    end
+
+    def endpoint
+      @endpoint ||= build
+    end
+  end
+end

data/minirails.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'minirails/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "minirails"
+  spec.version       = Minirails::VERSION
+  spec.authors       = ["Tymon Tobolski"]
+  spec.email         = ["i@teamon.eu"]
+
+  spec.summary       = %q{Smallest Rails Apps launcher}
+  spec.description   = %q{Smallest Rails Apps launcher}
+  spec.homepage      = "http://github.com/teamon/minirails"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "foreman",      "~> 0.78.0"
+  spec.add_dependency "rack",         "~> 1.6.4"
+  spec.add_dependency "railties",     "~> 4.2.4"
+  spec.add_dependency "activerecord", "~> 4.2.4"
+  spec.add_dependency "pg",           "~> 0.18.3"
+
+  spec.add_development_dependency "bundler", "~> 1.8"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

metadata

@@ -0,0 +1,154 @@
+--- !ruby/object:Gem::Specification
+name: minirails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tymon Tobolski
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-12-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: foreman
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.78.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.78.0
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.4
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.2.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.2.4
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.2.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.2.4
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.18.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.18.3
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: Smallest Rails Apps launcher
+email:
+- i@teamon.eu
+executables:
+- minirails
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/minirails
+- lib/minirails.rb
+- lib/minirails/version.rb
+- minirails.gemspec
+homepage: http://github.com/teamon/minirails
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Smallest Rails Apps launcher
+test_files: []