bud 0.9.0 → 0.9.1

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bud
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
   prerelease: 
 platform: ruby
 authors:
@@ -13,11 +13,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-22 00:00:00.000000000 Z
+date: 2012-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: eventmachine
-  requirement: &70208102945340 !ruby/object:Gem::Requirement
+  requirement: &70136220748940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -25,10 +25,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208102945340
+  version_requirements: *70136220748940
 - !ruby/object:Gem::Dependency
   name: fastercsv
-  requirement: &70208102944840 !ruby/object:Gem::Requirement
+  requirement: &70136220747220 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -36,10 +36,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208102944840
+  version_requirements: *70136220747220
 - !ruby/object:Gem::Dependency
   name: gchart
-  requirement: &70208102944420 !ruby/object:Gem::Requirement
+  requirement: &70136220763100 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -47,10 +47,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208102944420
+  version_requirements: *70136220763100
 - !ruby/object:Gem::Dependency
   name: getopt
-  requirement: &70208102944000 !ruby/object:Gem::Requirement
+  requirement: &70136220762540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -58,43 +58,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208102944000
-- !ruby/object:Gem::Dependency
-  name: i18n
-  requirement: &70208102943580 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: *70208102943580
-- !ruby/object:Gem::Dependency
-  name: json
-  requirement: &70208102943100 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: *70208102943100
+  version_requirements: *70136220762540
 - !ruby/object:Gem::Dependency
   name: msgpack
-  requirement: &70208102942640 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: *70208102942640
-- !ruby/object:Gem::Dependency
-  name: nestful
-  requirement: &70208102942180 !ruby/object:Gem::Requirement
+  requirement: &70136220761500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -102,10 +69,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208102942180
+  version_requirements: *70136220761500
 - !ruby/object:Gem::Dependency
   name: ruby-graphviz
-  requirement: &70208102941740 !ruby/object:Gem::Requirement
+  requirement: &70136220760140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -113,10 +80,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208102941740
+  version_requirements: *70136220760140
 - !ruby/object:Gem::Dependency
   name: ruby2ruby
-  requirement: &70208102941180 !ruby/object:Gem::Requirement
+  requirement: &70136220759200 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - <
@@ -124,10 +91,10 @@ dependencies:
         version: 1.3.1
   type: :runtime
   prerelease: false
-  version_requirements: *70208102941180
+  version_requirements: *70136220759200
 - !ruby/object:Gem::Dependency
   name: ruby_parser
-  requirement: &70208102940620 !ruby/object:Gem::Requirement
+  requirement: &70136220758700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -135,10 +102,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208102940620
+  version_requirements: *70136220758700
 - !ruby/object:Gem::Dependency
   name: superators19
-  requirement: &70208102939800 !ruby/object:Gem::Requirement
+  requirement: &70136220758040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -146,10 +113,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208102939800
+  version_requirements: *70136220758040
 - !ruby/object:Gem::Dependency
   name: syntax
-  requirement: &70208102938500 !ruby/object:Gem::Requirement
+  requirement: &70136220757320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -157,10 +124,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208102938500
+  version_requirements: *70136220757320
 - !ruby/object:Gem::Dependency
   name: uuid
-  requirement: &70208102937500 !ruby/object:Gem::Requirement
+  requirement: &70136220756700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -168,10 +135,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70208102937500
+  version_requirements: *70136220756700
 - !ruby/object:Gem::Dependency
   name: minitest
-  requirement: &70208102937020 !ruby/object:Gem::Requirement
+  requirement: &70136220756180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -179,7 +146,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70208102937020
+  version_requirements: *70136220756180
 description: A prototype of the Bloom distributed programming language as a Ruby DSL.
 email:
 - bloomdevs@gmail.com
@@ -193,9 +160,6 @@ extra_rdoc_files: []
 files:
 - lib/bud/aggs.rb
 - lib/bud/bud_meta.rb
-- lib/bud/bust/bust.rb
-- lib/bud/bust/client/idempotence.rb
-- lib/bud/bust/client/restclient.rb
 - lib/bud/collections.rb
 - lib/bud/depanalysis.rb
 - lib/bud/errors.rb
@@ -224,7 +188,6 @@ files:
 - docs/bfs.md
 - docs/bfs_arch.png
 - docs/bloom-loop.png
-- docs/bust.md
 - docs/cheat.md
 - docs/getstarted.md
 - docs/intro.md
@@ -236,15 +199,11 @@ files:
 - docs/visualizations.md
 - examples/basics/hello.rb
 - examples/basics/paths.rb
-- examples/bust/bustclient-example.rb
-- examples/bust/bustinspector.html
-- examples/bust/bustserver-example.rb
-- examples/bust/README.md
 - examples/chat/chat.rb
 - examples/chat/chat_protocol.rb
 - examples/chat/chat_server.rb
 - examples/chat/README.md
-- examples/README
+- examples/README.md
 - README.md
 - LICENSE
 - History.txt

data/docs/bust.md

@@ -1,83 +0,0 @@
-BUST stands for BUd State Transfer and it is a REST interface to Bud.  BUST consists of a Bud implementation of a client and server.  The client implements bindings to a subset of the Ruby Nestful library, and the server is a lightweight HTTP server written in Ruby.  Note that the BUST server currently sets the "Access-Control-Allow-Origin: *" HTTP header to override web browsers' same-origin policy.
-
-Right now BUST supports "GET" and "POST" requests, and may support "DELETE" and "PUT" requests in the future.
-
-# BUST Server
-
-For the BUST server, a "GET" request corresponds to retrieving a subset of rows of a table, and a "POST" request corresponds to inserting a row into a table.  For example, the following "GET" request (assuming BUST is running on port 8080):
-
-    GET localhost:8080/foo?bar=hello&baz=world
-
-would retrieve all rows in table "foo" where named schema attribute "bar" is equal to the string "hello", and named schema attribute "baz" is equal to the string "world".  Right now, one limitation of BUST is that only strings are supported.
-
-To use BUST in your program, ensure you have the json gem installed.  Add the "require" line for BUST:
-
-    require "bud/bust/bust"
-
-In your class, make sure to:
-
-    include Bust
-
-That's it!  Now a BUST server will be started up when your class is instantiated.  This server will listen on an open port; it will print out "Bust server listening on port xxxxx" to let you know which port it has selected.  But you can select a specific port by passing a port via the "bust_port" option when you instantiate your class.
-
-You can test out the BUST server using Ruby's "net/http" library if you want, and you can also check out "BUST Inspector", a sample AJAX application that allows you to view the state of a bud instance.
-
-## net/http Example
-
-Try running "bustserver-example.rb" in the "examples/bust" directory:
-
-    ruby bustserver-example.rb
-
-Now, let's interact with our example using "net/http" from within IRB.  Start up an IRB instance:
-
-    irb
-    irb(main):001:0> require 'net/http'
-    => true
-
-bustexample.rb defines a single relation called "foo":
-
-    table :foo, [:bar, :baz, :qux]
-
-Let's fire off some requests.  First, let's put a new foo fact in:
-
-    irb(main):002:0> res = Net::HTTP.post_form(URI.parse('http://localhost:8080/foo'), {:bar => "a", :baz => "b", :qux => "c"})
-    => #<Net::HTTPOK 200 /OK readbody=true>
-
-Now, let's retrieve all foo facts where the "qux" attribute is "c", and the "baz" attribute is "b":
-
-    irb(main):003:0> res = Net::HTTP.get(URI.parse('http://localhost:8080/foo?qux=c&baz=b'))
-    => "[[\"a\",\"b\",\"c\"]]"
-
-Note that the response is a JSON array.
-
-
-## BUST Inspector
-
-BUST Inspector -- an example app that uses XMLHttpRequests to inspect state in a Bud program using BUST is included -- (bust/bustinspector.html).  Right now, it assumes that the Bud instance you're trying to inspect is listening on "localhost" at port "8080".  BUST Inspector is tested to work in Firefox, and may or may not work in other browsers.  BUST Inspector will query your Bud instance every second for metadata describing the tables and their schema.  It will display a list of the tables in a pane on the left of the screen, with a checkbox next to each table.  Selecting a checkbox renders the current table contents in the right pane (these are also updated every second while the box is checked).
-
-
-# BUST Client
-
-The BUST client (located in the "bust/client" folder) allows Bud applications to access REST services (including a Bud client hosting a BUST instance). The REST client is basically a wrapper for the Ruby nestful library. You'll need to ensure you have the "nestful" gem installed before you can use the REST client. To use it in your application, you need to put the require line:
-
-    require 'bud/bust/client/restclient'
-
-and the include line:
-
-    include RestClient
-
-To make requests, insert into the rest_req interface, whose definition is reproduced below:
-
-    interface input, :rest_req, [:rid, :verb, :form, :url, :params]
-
-"rid" is a unique ID for the request, "verb" is one of ":get" or ":post", "form" is the format of the request, for example, you might use ":json", or if you're doing a form post, you'd use "form". If set to nil, "form" defaults to ":form" for ":post", and is omitted from a ":get". For ":get" requests, the "form" parameter seems to be appended onto the end of "url". For example, if you do a ":get" for "http://example.com/ex" with "form" set to ":json", the library sends an HTTP GET to "http://example.com/ex.json". "params" is a hash, which comprises the query string for a ":get", and the contents of the body in a ":post" with "form" set to ":form".
-
-The output interface is:
-
-    interface output, :rest_response, [:rid, :resp, :exception]
-
-"rid" is the unique ID supplied when the request was made, "resp" is the parsed response from the server. For example, if you do a ":json" ":get", then "resp" will contain whatever JSON object was returned converted into a Ruby object, e.g., array, hash, etc. If there is an exception, then "resp" will contain a string describing the exception, and "exception" will be set to true; otherwise, "exception" will be set to false.
-
-A simple example is included (bustclient-example.rb) that does an HTTP GET on Twitter's public timeline, returning the most recent statuses, and prints them to stdout.  The example is in "examples/bust/client".
-
-The BUST client does not yet support OAuth. Also unsupported so far is HTTP DELETE and PUT.

data/examples/bust/README.md

@@ -1,9 +0,0 @@
-To run the bust twitter example client, do the following:
-
-    # ruby bustclient-example.rb
-
-To test out bust inspector, do the following:
-
-    # ruby bustserver-example.rb
-
-Then, launch bustinspector.html in a web browser (only Firefox 4 has been tested thus far) on either the computer where you launched bustserver-example.rb, or any computer that has TCP port 8080 forwarded to the computer where you launched bustserver-example.rb.

data/examples/bust/bustclient-example.rb

@@ -1,23 +0,0 @@
-require 'rubygems'
-require 'bud'
-require 'bud/bust/client/restclient'
-
-class TwitterExample # :nodoc: all
-  include Bud
-  include RestClient
-
-  bootstrap do
-    # get the 20 most recent tweets from twitter
-    rest_req <= [[1, :get, :json,
-                  'http://api.twitter.com/1/statuses/public_timeline']]
-  end
-
-  bloom :print_recent_tweets do
-    # print the tweets with user screen names
-    stdio <~ rest_response do |r|
-      [r.resp.map {|s| s["user"]["screen_name"] + ": " + s["text"]}] if r.rid==1
-    end
-  end
-end
-
-TwitterExample.new.run_fg

data/examples/bust/bustinspector.html

@@ -1,135 +0,0 @@
-<html>
-<head>
-<title>BUST Inspector</title>
-
-<script type="text/javascript">
-function pollState()
-{
-
-// 1. GET the list of tables
-var xmlhttp = new XMLHttpRequest();
-xmlhttp.open("GET","http://localhost:8080/t_table_info",false);
-xmlhttp.send();
-
-if (xmlhttp.readyState==4) {
-if (xmlhttp.status == 404){
-alert("error fetching 't_table_info'");
-}
-if (xmlhttp.status == 200){
-tableArray = JSON.parse(xmlhttp.responseText);
-
-var tablenames = document.getElementById("tablenames");
-
-for (var i = 0; i <  tableArray.length; i++) {
-var tablename = tableArray[i][0]
-// if the collection is new
-if (!document.getElementById("coll_" + tablename)) {
-var newspan = document.createElement("span");
-newspan.innerHTML = '<input type="checkbox" id="coll_' + tablename + '"/>' + tablename + '(<small><b>' + tableArray[i][1] + '</b></small>) <br/>'
-while (newspan.firstChild) {
-tablenames.appendChild(newspan.firstChild);
-}
-}
-}
-
-}
-}
-
-
-// 2. GET the schema table
-var schemareq = new XMLHttpRequest();
-schemareq.open("GET","http://localhost:8080/t_table_schema",false);
-schemareq.send();
-
-if (schemareq.status == 404) {
-alert("error fetching schema info");
-}
-if (schemareq.status == 200) {
-schemaArray = JSON.parse(schemareq.responseText)
-}
-
-
-// 3. GET the list of checked tables
-form_elts = document.forms[0].elements
-for (var i = 0; i < form_elts.length; i++) {
-var tablename = form_elts[i].id.substr(5);
-
-//look it up in the schema
-var schemaIdx;
-var found = false;
-for (schemaIdx = 0; schemaIdx < schemaArray.length; schemaIdx++) {
-if (schemaArray[schemaIdx][0] == tablename) {
-found = true;
-break;
-}
-}
-if (!found) {
-alert ("no schema information for table " + tablename);
-}
-
-var ourSchema = schemaArray[schemaIdx][1];
-
-if (form_elts[i].checked) {
-var tablereq = new XMLHttpRequest();
-tablereq.open("GET","http://localhost:8080/"+tablename,false);
-tablereq.send();
-
-if (tablereq.status == 404){
-alert("error fetching table " + tablename);
-}
-if (tablereq.status == 200){
-responseArray = JSON.parse(tablereq.responseText)
-
-//schema
-tableText = "<table style='border-width: 1px; border-spacing: 2px; border-style: outset; border-color: gray; border-collapse: separate;'><tr>";
-for (var j = 0; j < ourSchema.length; j++) {
-tableText += "<td style='border-width: 1px; padding: 1px; border-style: inset; border-color: gray;'><b>" + ourSchema[j] + "</b></td>";
-}
-tableText += "</tr>";
-
-//data
-for (var k = 0; k < responseArray.length; k++) {
-tableText += "<tr>";
-for (var l = 0; l < responseArray[k].length; l++) {
-tableText += "<td style='border-width: 1px; padding: 1px; border-style: inset; border-color: gray;'>" + responseArray[k][l] + "</td>";
-}
-tableText += "</tr>";
-}
-tableText += "</table>";
-
-if (!document.getElementById("disp_" + tablename)) {
-document.getElementById("tabledisplay").innerHTML += '<div style="border: 1px solid black; float:left; padding: 0px; margin:5px;" id="disp_' + tablename + '"><h4 style="margin-top:0px;">' + tablename + '</h4>' + tableText + '</div>';
-} else {
-document.getElementById("disp_" + tablename).innerHTML = '<h4 style="margin-top:0px;">' + tablename + '</h4>' + tableText;
-}
-}
-} else { //if not checked
-if (document.getElementById("disp_" + tablename)) {
-document.getElementById("tabledisplay").removeChild(document.getElementById("disp_" + tablename))
-}
-}
-
-} //end for
-
-
-setTimeout('pollState()', 1000);
-}
-
-</script>
-
-</head>
-
-<body onLoad="setTimeout('pollState()', 1000);">
-
-  <div style="width:100%;"><h3>BUST Inspector</h3></div>
-  <div style="height:100%; border: 1px solid black; float:left; padding:0px; margin:5px;">
-    <h4 style="margin-top:0px;">Collections</h4>
-    <form id="tableform">
-      <span id="tablenames">
-      </span>
-    </form>
-  </div>
-  <span id="tabledisplay">
-  </span>
-</body>
-</html>

data/examples/bust/bustserver-example.rb

@@ -1,18 +0,0 @@
-require 'rubygems'
-require 'bud'
-require 'bud/bust/bust'
-
-class BustExample # :nodoc: all
-  include Bud
-  include Bust
-
-  state do
-    table :foo, [:bar, :baz, :qux]
-  end
-
-  bloom do
-    stdio <~ foo {|t| [t.inspect]}
-  end
-end
-
-BustExample.new(:bust_port => 8080).run_fg

data/lib/bud/bust/bust.rb

@@ -1,137 +0,0 @@
-require 'rubygems'
-require 'bud'
-require 'json'
-require 'socket'
-require 'uri'
-require 'cgi'
-
-HTTP_VERBS = ["GET", "POST"] #, "DELETE"]
-
-# a RESTful interface to Bloom code
-module Bust
-  include Bud
-  attr_reader :bust_port
-
-  # used this for inspiration:
-  # http://blogs.msdn.com/b/abhinaba/archive/2005/10/14/474841.aspx
-
-  bootstrap do
-    # copied from peter's code; this should probably be in the Bud runtime or in
-    # some meta module
-    @tables.each do |t|
-      t_table_schema << [t[0], t[1].cols.clone]
-      t_table_info << [t[0], t[1].class.to_s]
-    end
-
-    q = Queue.new
-    Thread.start(self) do |bud|
-      BustClass.new(bud, q)
-    end
-    # Wait for socket to be ready before we return from bootstrap.
-    r = q.pop
-    if r.class <= Exception
-      raise r
-    else
-      @bust_port = r
-    end
-  end
-
-  class BustClass
-    class BustHandler
-      def initialize(session, request, body, bud)
-        @session = session
-        @request = request
-        @body = body
-        @bud = bud
-      end
-
-      def serve()
-        puts "Request: " + @request
-        puts "Body: " + @body.inspect if @body
-
-        for type in HTTP_VERBS
-          if @request =~ Regexp.new(type + " .* HTTP*")
-            break reqstr = @request.gsub(Regexp.new(type + " "), '').gsub(/ HTTP.*/, '')
-          end
-        end
-
-        uri = URI.parse(reqstr)
-        uri_params = {}
-        uri_params = CGI.parse(uri.query) if uri.query
-        table_name = uri.path[1..-1].split(".")[0] # hack; we always return JSON
-        # "Access-Control-Allow-Origin: *" disables same-origin policy to allow
-        # XMLHttpRequests from any origin
-        success = "HTTP/1.1 200 OK\r\nServer: Bud\r\nContent-type: application/json\r\nAccess-Control-Allow-Origin: *\r\n\r\n"
-        failure = "HTTP/1.1 404 Object Not Found\r\nServer: Bud\r\nAccess-Control-Allow-Origin: *\r\n\r\n"
-
-        begin
-          if @request =~ /GET .* HTTP*/
-            puts "GET shouldn't have body" if @body
-            # select the appropriate elements from the table
-            desired_elements = @bud.send(table_name.to_sym).find_all do |t|
-              uri_params.all? {|k, v|
-                (eval "t." + k.to_s) == v[0]
-              }
-            end
-            @session.print success
-            desired_elements = desired_elements .map{|elem|
-              elem.class <= Struct ? elem.to_a : elem
-            }
-            @session.print desired_elements.to_json
-          elsif @request =~ /POST .* HTTP*/
-            # instantiate a new tuple
-            tuple_to_insert = []
-            @body.each do |k, v|
-              index = @bud.send(table_name.to_sym).cols.find_index(k.to_sym)
-              for i in (tuple_to_insert.size..index)
-                tuple_to_insert << nil
-              end
-              tuple_to_insert[index] = v[0]
-            end
-            # actually insert the puppy
-            @bud.async_do {
-              @bud.send(table_name.to_sym) <+ [tuple_to_insert]
-            }
-            @session.print success
-          end
-        rescue Exception
-          puts "exception: #{$!}"
-          @session.print failure
-        ensure
-          @session.close
-        end
-      end
-    end
-
-    def initialize(bud, q)
-      # allow user-configurable port
-      begin
-        server = TCPServer.new(bud.ip, (bud.options[:bust_port] or 0))
-        port = server.addr[1]
-        puts "Bust server listening on #{bud.ip}:#{port}"
-        # We're now ready to accept connections
-        q << port
-      rescue Exception => e
-        # Avoid deadlock on queue, report exception to caller
-        q << e
-      end
-
-      loop do
-        session = server.accept
-        request = session.gets
-        length = nil
-        body = nil
-        while req = session.gets
-          length = Integer(req.split(" ")[1]) if req.match(/^Content-Length:/)
-          if req.match(/^\r\n$/)
-            body = CGI.parse(session.read(length)) if length
-            break
-          end
-        end
-        Thread.start(session, request, body, bud) do |session, request, body, bud|
-          BustHandler.new(session, request, body, bud).serve()
-        end
-      end
-    end
-  end
-end

data/lib/bud/bust/client/idempotence.rb

@@ -1,10 +0,0 @@
-require 'rubygems'
-require 'bud'
-
-module Idempotence #:nodoc: all
-  state do
-    table :dead, [:dead]
-  end
-
-  def bust_idempotent(r) (dead.include? r) ? false : dead.insert(r) end
-end