racksh 0.9

data/README.markdown

@@ -0,0 +1,52 @@
+racksh
+======
+
+About
+-----
+
+**racksh** (Rack::Shell) is a console for Rack based ruby web applications.
+
+It's like Rails' _script/console_ or Merb's _merb -i_, but for any app built on Rack. You can use it to load application environment for Rails, Merb, Sinatra, Camping, Ramaze or your own framework provided there is _config.ru_ file in app's root directory.
+
+It's purpose is to allow developer to introspect his application and/or make some initial setup, ie. running _DataMapper.auto_migrate!_. It's mainly aimed at apps that don't have similar facility (like Sinatra) but can be used without problems with Merb or Rails apps.
+
+How it works?
+-------------
+
+It loads whole application environment like Rack web server, but it doesn't run the app. Simply, methods like _use_ or _run_ which are normally invoked on Rack::Builder instance are being stubbed.
+
+Installation
+------------
+
+    gem install racksh -s http://gemcutter.org
+
+Usage
+-----
+
+To open console run following inside rack application directory (containing config.ru file):
+
+    racksh
+
+Specifying location of config.ru:
+
+    CONFIG_RU=~/projects/foobar/config.ru racksh
+
+Executing ruby code inside application environment and printing results:
+
+    racksh Order.all
+    racksh "Order.first :created_at => Date.today"
+
+Specifying Rack environment (default is development):
+
+    RACK_ENV=production racksh
+
+Bugs & feature requests
+---------------------------------
+
+Please report bugs and/or feature requests on the github issue tracker for the project located [here](http://github.com/sickill/racksh/issues).
+
+Authors
+-------
+
+ * Marcin Kulik - [sickill.net](http://sickill.net/)
+

data/VERSION

@@ -0,0 +1 @@
+0.9

data/bin/racksh

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+if ARGV.empty?
+  exec "irb -r racksh"
+else
+  require 'racksh'
+  p eval(ARGV.join(" "))
+end

data/lib/racksh.rb

@@ -0,0 +1,20 @@
+ENV['RACK_ENV'] ||= 'development'
+
+def use(*args, &blk); end
+def run(*args, &blk); end
+def map(*args, &blk); end
+
+config_ru = ENV['CONFIG_RU'] || 'config.ru'
+
+begin
+  load config_ru
+  version = File.read(File.join(File.dirname(__FILE__), '..', 'VERSION'))
+  puts "Rack::Shell v#{version} started." if ARGV.empty?
+rescue LoadError => e
+  if e.message =~ /config\.ru$/
+    puts "Rack::Shell couldn't find #{config_ru}"
+    exit(1)
+  else
+    raise e
+  end
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+name: racksh
+version: !ruby/object:Gem::Version 
+  version: "0.9"
+platform: ruby
+authors: 
+- Marcin Kulik
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-15 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: 
+email: marcin.kulik@gmail.com
+executables: 
+- racksh
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/racksh
+- lib/racksh.rb
+- VERSION
+- README.markdown
+has_rdoc: true
+homepage: http://github.com/sickill/racksh
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Console for any Rack based ruby web app
+test_files: []
+