RubyGems - racksh - Versions diffs - 0.9.3 → 0.9.4 - Mend

racksh 0.9.3 → 0.9.4

Files changed (8) hide show

data/README.markdown CHANGED Viewed

@@ -9,8 +9,9 @@ environment for Rails, Merb, Sinatra, Camping, Ramaze or your own framework prov
 directory.
 It's purpose is to allow developer to introspect his application and/or make some initial setup. You can for example run
-_DataMapper.auto_migrate!_ or make a request to "/users/666" and check response details. It's mainly aimed at apps that don't
-have console-like component (ie. app built with Sinatra) but all frameworks can benefit from interactive Rack stack introspection.
+_DataMapper.auto_migrate!_ or make a request to _/users/666_ and check response details. It's mainly aimed at apps that don't
+have console-like component (ie. app built with Sinatra) but all frameworks can benefit from interactive Rack stack and request
+introspection.
 ## How it works?
@@ -28,8 +29,8 @@ Additionally it exposes _$rack_ variable which allows you to make simulated HTTP
 To start racksh session run following inside rack application directory (containing config.ru file):
     % racksh
-    Rack::Shell v0.9.3 started in development environment.
-    irb(main):001:0>
+    Rack::Shell v0.9.4 started in development environment.
+    >>
 Specifying location of config.ru:
@@ -43,14 +44,14 @@ Executing ruby code inside application environment and printing results:
 Specifying Rack environment (default is development):
     % RACK_ENV=production racksh
-    Rack::Shell v0.9.3 started in production environment.
-    irb(main):001:0>
+    Rack::Shell v0.9.4 started in production environment.
+    >>
-### Making simulated HTTP requests to your app:
+### Making simulated HTTP requests to your app
     % racksh
-    Rack::Shell v0.9.3 started in development environment.
-    irb(main):001:0> $rack.get "/"
+    Rack::Shell v0.9.4 started in development environment.
+    >> $rack.get "/"
     => #<Rack::MockResponse:0xb68fa7bc @body="<html>...", @headers={"Content-Type"=>"text/html", "Content-Length"=>"1812"}, @status=200, ...
 _$rack_ variable contains following methods (thanks to [rack-test](http://github.com/brynary/rack-test) gem):
@@ -85,9 +86,18 @@ _$rack_ variable contains following methods (thanks to [rack-test](http://github
     # follow redirect from previous request
     $rack.follow_redirect!
+    # last request object
+    $rack.last_request
+    # last response object
+    $rack.last_response
     # access your Rack app
     $rack.app
+    # name of environment
+    $rack.env
 Check [test.rb from brynary's rack-test](http://github.com/brynary/rack-test/blob/master/lib/rack/test.rb) for implementation of
 above methods.
@@ -97,6 +107,23 @@ Examples:
     $rack.header "User-Agent", "Firefox"
     $rack.post "/users", :user => { :name => "Jola", :email => "jola@misi.ak" }
+### Configuration files
+Rack::Shell supports configuration file _.rackshrc_ which is loaded from two places during startup: user's home dir and
+application directory (in this order). You can put any ruby code in it, but it's purpose is to setup your session, ie. setting
+headers which will be used for all $rack.get/post/... requests.
+For example to set user agent to Firefox and re-migrate db if loaded environment is _test_ put following in _.rackshrc_:
+    $rack.header "User-Agent", "Firefox"
+    DataMapper.auto_migrate! if $rack.env == "test"
+You can also make requests:
+    $rack.put "/signin", :login => "jola", :password => "misiacz"
+This will ensure you are always logged in when you start _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).

data/bin/racksh CHANGED Viewed

@@ -1,8 +1,10 @@
 #!/usr/bin/env ruby
+ENV['RACK_ENV'] ||= 'development'
 if ARGV.empty?
   racksh_path = File.join(File.expand_path(File.dirname(__FILE__)), "..", "lib", "racksh.rb")
-  exec "irb -r #{racksh_path}"
+  exec "irb -r irb/completion -r #{racksh_path} --simple-prompt"
 else
   require 'racksh'
   p eval(ARGV.join(" "))

data/lib/racksh/init.rb ADDED Viewed

@@ -0,0 +1,41 @@
+require 'rack'
+module Rack
+  module Shell
+    File = ::File
+    def self.start!
+      # prevent STDOUT & STDERR to be reopened (apps do this to be able to log under Passenger)
+      def STDOUT.reopen(*args); end
+      def STDERR.reopen(*args); end
+      # build Rack app
+      config_ru = ENV['CONFIG_RU'] || 'config.ru'
+      rack_app = Object.class_eval("Rack::Builder.new { #{File.read(config_ru)} }")
+      $rack = Rack::Shell::Session.new(rack_app)
+      # run ~/.rackshrc
+      rcfile = File.expand_path("~/.rackshrc")
+      eval(File.read(rcfile)) if File.exists?(rcfile)
+      # run local .rackshrc (from app dir)
+      rcfile = File.expand_path(File.join(File.dirname(config_ru), ".rackshrc"))
+      eval(File.read(rcfile)) if File.exists?(rcfile)
+      # print startup info
+      if STDOUT.tty? && ENV['TERM'] != 'dumb' # we have color terminal, let's pimp our info!
+        env_color = ($rack.env == 'production' ? "\e[31m\e[1m" : "\e[36m\e[1m")
+        puts "\e[32m\e[1mRack\e[0m\e[33m\e[1m::\e[0m\e[32m\e[1mShell\e[0m v#{VERSION} started in #{env_color}#{$rack.env}\e[0m environment."
+      else
+        puts "Rack::Shell v#{VERSION} started in #{$rack.env} environment."
+      end
+    rescue Errno::ENOENT => e
+      if e.message =~ /config\.ru$/
+        puts "Rack::Shell couldn't find #{config_ru}"
+        exit(1)
+      else
+        raise e
+      end
+    end
+  end
+end

data/lib/racksh/session.rb ADDED Viewed

@@ -0,0 +1,18 @@
+require 'rack/test'
+module Rack
+  module Shell
+    class Session
+      include Rack::Test::Methods
+      attr_reader :app
+      def initialize(app)
+        @app = app
+      end
+      def env
+        ENV['RACK_ENV']
+      end
+    end
+  end
+end

data/lib/racksh/version.rb ADDED Viewed

@@ -0,0 +1,5 @@
+module Rack
+  module Shell
+    VERSION = '0.9.4'.freeze
+  end
+end

data/lib/racksh.rb CHANGED Viewed

@@ -1,30 +1,5 @@
-require "rubygems"
-require "rack"
-require "rack/test"
+require 'rubygems'
+dir = File.join(File.expand_path(File.dirname(__FILE__)), 'racksh')
+%w(session version init).each { |f| require File.join(dir, f) }
-ENV['RACK_ENV'] ||= 'development'
-module Rack
-  class Shell
-    include Rack::Test::Methods
-    attr_reader :app
-    def initialize(app)
-      @app = app
-    end
-  end
-end
-begin
-  config_ru = ENV['CONFIG_RU'] || 'config.ru'
-  rack_application = eval("Rack::Builder.new { #{File.read(config_ru)} }")
-  $rack = Rack::Shell.new(rack_application)
-  version = File.read(File.join(File.dirname(__FILE__), '..', 'VERSION')).strip
-  puts "Rack::Shell v#{version} started in #{ENV['RACK_ENV']} environment."
-rescue Errno::ENOENT => e
-  if e.message =~ /config\.ru$/
-    puts "Rack::Shell couldn't find #{config_ru}"
-    exit(1)
-  else
-    raise e
-  end
-end
+Rack::Shell.start!

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: racksh
 version: !ruby/object:Gem::Version
-  version: 0.9.3
+  version: 0.9.4
 platform: ruby
 authors:
 - Marcin Kulik
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
-date: 2009-11-17 00:00:00 +01:00
+date: 2009-11-19 00:00:00 +01:00
 default_executable:
 dependencies:
 - !ruby/object:Gem::Dependency
@@ -43,7 +43,9 @@ extra_rdoc_files: []
 files:
 - bin/racksh
 - lib/racksh.rb
-- VERSION
+- lib/racksh/init.rb
+- lib/racksh/session.rb
+- lib/racksh/version.rb
 - README.markdown
 has_rdoc: true
 homepage: http://github.com/sickill/racksh

data/VERSION DELETED Viewed

	@@ -1 +0,0 @@
1	- 0.9.3