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

racksh 0.9.3 → 0.9.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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