jazor 0.0.4 → 0.1.0

data/test/test_rest_client.rb

@@ -1,12 +1,10 @@
 require 'test/unit'
 
-$:.push File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
-require 'jazor'
-
-
 class TestExecute < Test::Unit::TestCase
 
   def test_get
+    require 'jazor'
+
     response = Jazor::RestClient.get('http://ajax.googleapis.com/ajax/services/search/web')
     assert response.code == '200'
     assert response.body =~ /"responseStatus": 400/

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: jazor
 version: !ruby/object:Gem::Version 
-  hash: 23
-  prerelease: false
+  hash: 27
+  prerelease: 
   segments: 
   - 0
+  - 1
   - 0
-  - 4
-  version: 0.0.4
+  version: 0.1.0
 platform: ruby
 authors: 
 - Michael T. Conigliaro
@@ -15,8 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-25 00:00:00 -07:00
-default_executable: 
+date: 2011-08-23 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: json
@@ -32,7 +31,76 @@ dependencies:
         version: "0"
   type: :runtime
   version_requirements: *id001
-description: Jazor is a simple command line JSON parsing tool
+description: |
+  = Jazor
+  
+  Jazor (rhymes with "razor") is a simple command line JSON parsing tool.
+  
+  == Installation
+  
+    gem install jazor
+  
+  == Usage
+  
+    jazor [options] [source] [expression ...]
+  
+  === Options
+  
+  See the *--help* command line option.
+  
+  === Sources
+  
+  The *source* argument refers to a file, URL or string containing a JSON object.
+  Since attempts to implement a full-featured HTTP client within Jazor would have
+  been futile, Jazor also accepts input from STDIN. This means if you ever need
+  to use an advanced HTTP option that Jazor doesn't implement, you can always use
+  a *real* HTTP client (e.g. {cURL}[http://curl.haxx.se/]) and simply pipe the
+  output to Jazor.
+  
+  === Expressions
+  
+  Jazor accepts one or more Ruby *expressions* which are simply eval'ed within
+  the context of your JSON object. After Jazor parses your JSON input into native
+  Ruby data types (Hash, Array, etc.), these expressions are used to slice and
+  dice the data any way you want. The results will be "pretty printed" to STDOUT.
+  
+  Note that hash keys can be accessed via standard Ruby (e.g. foo['bar'],
+  foo.fetch('bar'), etc.) or Javascript (e.g. foo.bar) syntax.
+  
+  === Expression Testing
+  
+  Expression testing (*--test*) allows you to test the "truthiness" of your
+  expression results. If any expression returns a "falsy" value, Jazor will exit
+  with a non-zero return code. This is useful for calling Jazor from within shell
+  scripts.
+  
+  == Examples
+  
+    $ jazor http://github.com/api/v2/json/commits/list/mconigliaro/jazor/master commits.count
+    16
+  
+    $ curl --silent http://github.com/api/v2/json/commits/list/mconigliaro/jazor/master | jazor commits.last.message
+    initial commit
+  
+    $ jazor '{ "foo": "abc", "bar": [1, 2, 3] }' 'foo.split(//)'
+    ["a", "b", "c"]
+  
+    $ jazor '{ "foo": "abc", "bar": [1, 2, 3] }' 'bar.inject { |memo,obj| memo + obj }'
+    6
+  
+    $ jazor '[1, 2, 3, 4, 5]' 'select { |obj| obj.even? }'
+    [2, 4]
+  
+    $ jazor '[1, 2, 3, 4, 5]' 'select { |obj| obj.odd? }'
+    [1, 3, 5]
+  
+    $ jazor '["a", "b", "c"]' self.count
+    3
+  
+  == Author
+  
+  Michael T. Conigliaro <mike [at] conigliaro [dot] org>
+
 email: 
 - mike [at] conigliaro [dot] org
 executables: 
@@ -47,11 +115,10 @@ files:
 - README.rdoc
 - bin/jazor
 - lib/jazor.rb
-- test/test_jazor_bin.rb
 - test/test.json
 - test/test_jazor.rb
+- test/test_jazor_bin.rb
 - test/test_rest_client.rb
-has_rdoc: true
 homepage: http://github.com/mconigliaro/jazor
 licenses: []
 
@@ -81,7 +148,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: jazor
-rubygems_version: 1.3.7
+rubygems_version: 1.8.6
 signing_key: 
 specification_version: 3
 summary: Jazor is a simple command line JSON parsing tool