beambridge 0.9.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NTQwMTk5ZGE3MTQ3Y2M4M2NkYWVkMmIwZDg4ZTBhZWVkMmFmOGExNg==
+  data.tar.gz: !binary |-
+    M2Y2NGQwZWUyZDVlM2RlOTY3NzAxMTQzY2M0ZWQwYTQ5M2ViY2M5NA==
+SHA512:
+  metadata.gz: !binary |-
+    OWIwZDViMGEyMjlkYmIzNGExMjY1MjE4ZTEzZjYwZDA0YzNkMGQ4ZTYwZDg0
+    N2VlNWUwMzdmOGU3MzEzMDRiOWZmMGQ1OWYyMmUwMjNiNTRlODAyOThmNjE1
+    NDNiNjg3NThjNzY0ODlkYmI0MGRkMjk2YjVlZGMwYmQyNWVmNGU=
+  data.tar.gz: !binary |-
+    NDdkMDc5NDIzMWMyZWJiNzk4OGRlMGI4ZWQ2MDEwYmZhNTEwYzQzMDk3N2Q1
+    Zjk4NzU1YjU0NTFmNjVjMWFhMjg0YzQ3MmJiNDhhNDQzNWIzNGQ3MmU2OGE3
+    NTFkMGQ0YjM2M2JlNjVhODA2OWI5ZDVjZjQ1MjhjZjZmOTEwMmE=

data/.gitignore

@@ -0,0 +1,23 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+ext/Makefile
+ext/decoder.bundle
+ext/decoder.o
+*.beam
+*.dump
+.DS_Store
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in beambridge.gemspec
+gemspec

data/History.txt

@@ -0,0 +1,35 @@
+== 1.1.1 / 2009-10-28
+  * Bug Fixes
+    * Fix bignum encoding
+    * Prevent stack overflow for massive binaries in c decoder
+    * Optimize strings in c decoder
+
+== 1.1.0 / 2009-10-08
+  * Minor Improvements
+    * Implement Bignum encoding
+    * Fix tests on Erlang R13B
+
+== 1.0.2 / 2009-06-03
+  * Bug Fixes
+    * Fix decoding of atoms [github.com/bwbuchanan]
+    * Work around Ruby's reluctance to convert the empty string to
+      a symbol [github.com/bwbuchanan]
+
+== 1.0.1 / 2009-05-03
+  * Bug Fixes
+    * Fix premature null byte termination on binary decode
+
+== 1.0.0 / 2009-04-29
+  * Backward Incompatible Changes
+    * Implicit array call for f.when(:echo, String) must now be called as
+      f.when([:echo, String]) to eliminate ambiguity
+    * Implicit array call for f.send!(:ok, "foo") must now be called as
+      f.send!([:ok, "foo"]) to eliminate ambiguity
+    * The receive loop now defaults to using file descriptors 3 and 3
+      instead of STDIN and STDOUT. This prevents inadvertent output
+      statements from silently corrupting the transfer protocol.
+    * Erlang atoms 'true' and 'false' are now converted into Ruby booleans
+    * Erlectricity::Decoder.read_any_from -> Erlectricity::Decoder.decode
+  * Major Enhancements
+    * Calling `rake` now runs tests (with and without compiled C extensions)
+    * Package management is now done by Jeweler

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Scott Fleckenstein and Tom Preston-Werner
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,130 @@
+# Beambridge #
+
+https://github.com/mathieul/beambridge
+
+Fork of Erlectricity by Scott Fleckenstein, Tom Preston-Werner (http://github.com/mojombo/erlectricity).
+
+The original erlectricity gem doesn't seem to be supported and updated anymore,
+no commit in 4 years, a pull request pending for the last 3 years.
+
+So I've forked the repository origin of the pending pull request and did cherry pick
+most of the pull request commits. And I had to rename the gem so I could publish it.
+
+Development Status: port for 1.9.3, 2.0.x, 2.1.x in progress
+
+
+Description
+-----------
+
+Beambridge allows a Ruby program to receive and respond to Erlang messages
+sent over the Erlang binary protocol.
+
+
+Install
+-------
+
+$ gem install beambridge
+
+
+The Simplest Example
+--------------------
+
+### Ruby side (echo.rb)
+
+    require 'beambridge'
+
+    receive do |f|
+      f.when([:echo, String]) do |text|
+        f.send!([:result, "You said: #{text}"])
+        f.receive_loop
+      end
+    end
+
+### Erlang side (echo.erl)
+
+    -module(echo).
+    -export([test/0]).
+
+    test() ->
+      Cmd = "ruby echo.rb",
+      Port = open_port({spawn, Cmd}, [{packet, 4}, nouse_stdio, exit_status, binary]),
+      Payload = term_to_binary({echo, <<"hello world!">>}),
+      port_command(Port, Payload),
+      receive
+        {Port, {data, Data}} ->
+          {result, Text} = binary_to_term(Data),
+          io:format("~p~n", [Text])
+      end.
+
+
+Data Type Conversions and Matching
+----------------------------------
+
+    % Port is the port opened via open_port({spawn, Cmd}, [{packet, 4}, ...])
+    % Message is the Erlang term to encode and send to the port
+    send(Port, Message) ->
+      port_command(Port, term_to_binary(Message)).
+
+    # Each triplet below represents:
+    # (line 1) the Erlang call
+    # (line 2) the Ruby matcher
+    # (line 3) the Ruby output
+
+    send(Port, test).
+    f.when(:test) { p :ok }
+    # :ok
+
+    send(Port, {atom, symbol}).
+    f.when([:atom, Symbol]) { |sym| p sym }
+    # :symbol
+
+    send(Port, {number, 1}).
+    f.when([:number, Fixnum]) { |num| p num }
+    # 1
+
+    send(Port, {string, <<"foo">>}).
+    f.when([:string, String]) { |str| p str }
+    # "foo"
+
+    send(Port, {array, [1,2,3]}).
+    f.when([:array, Array]) { |arr| p arr }
+    # [1, 2, 3]
+
+    send(Port, {array, [<<"abc">>, <<"def">>]}).
+    f.when([:array, Array]) { |arr| p arr }
+    # ["abc", "def"]
+
+    send(Port, {hash, [{key,val}]}).
+    f.when([:hash, Erl.hash]) { |hash| p hash }
+    # {:key=>:val}
+
+    send(Port, {object, {1,{2},3,<<"four">>}}).
+    f.when([:object, Any]) { |any| p any }
+    # [1, [2], 3, "four"]
+
+
+Contribute
+----------
+
+If you'd like to hack on Beambridge, start by forking my repo on GitHub:
+
+https://github.com/mathieul/beambridge
+
+To get all of the dependencies, install the gem first. The best way to get
+your changes merged back into core is as follows:
+
+1. Clone down your fork
+1. Create a topic branch to contain your change
+1. Hack away
+1. Add tests and make sure everything still passes by running `rake`
+1. If you are adding new functionality, document it in the README.md
+1. Do not change the version number, I will do that on my end
+1. If necessary, rebase your commits into logical chunks, without errors
+1. Push the branch up to GitHub
+1. Send me (mojombo) a pull request for your branch
+
+
+Copyright
+---------
+
+Copyright (c) 2009 Scott Fleckenstein and Tom Preston-Werner. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,44 @@
+require "bundler/gem_tasks"
+
+require "rake/testtask"
+
+desc "Default: run unit tests."
+task default: :test
+
+desc "Test the beambridge plugin."
+task :test do
+  require 'open3'
+  require 'fileutils'
+
+  puts "\nCleaning extension build files and running all specs in native ruby mode..."
+  `rm -f ext/*.bundle` && puts("rm -f ext/*.bundle")
+  `rm -f ext/*.o` && puts("rm -f ext/*.o")
+  Open3.popen3("ruby test/spec_suite.rb") do |stdin, stdout, stderr|
+    while !stdout.eof?
+      print stdout.read(1)
+    end
+  end
+
+  puts "\nRunning `make` to build extensions and rerunning decoder specs..."
+  Dir.chdir('ext') { `ruby extconf.rb` }
+  Dir.chdir('ext') { `make` }
+  Open3.popen3("ruby test/decode_spec.rb") do |stdin, stdout, stderr|
+    while !stdout.eof?
+      print stdout.read(1)
+    end
+  end
+end
+
+begin
+  require "rdoc/task"
+  desc "Generate documentation for the beambridge plugin."
+  RDoc::Task.new(:rdoc) do |rdoc|
+    rdoc.rdoc_dir = "rdoc"
+    rdoc.title    = "Beambridge"
+    rdoc.options << "--line-numbers"
+    rdoc.rdoc_files.include("README*")
+    rdoc.rdoc_files.include("lib/**/*.rb")
+  end
+rescue LoadError
+  puts "RDoc::Task is not supported on this platform"
+end

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:minor: 1
+:patch: 1
+:major: 1

data/beambridge.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "beambridge/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "beambridge"
+  spec.version       = Beambridge::VERSION
+  spec.authors       = ["Scott Fleckenstein", "Tom Preston-Werner"]
+  spec.email         = ["mathieul@gmail.com"]
+  spec.description   = %q{Asset pipeline CLI to be executed from a different language.}
+  spec.summary       = %q{A command to pre-process web assets using Ruby tools, intended to be called from a different language.}
+  spec.homepage      = "https://github.com/mathieul/beambridge"
+  spec.license       = "Scott Fleckenstein and Tom Preston-Werner"
+
+  # spec.required_ruby_version = "~> 1.9.3"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+  spec.extensions    = ["ext/extconf.rb"]
+
+  spec.extra_rdoc_files = ["LICENSE", "README.md"]
+
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "pry-nav"
+end

data/benchmarks/bench.rb

@@ -0,0 +1,21 @@
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+
+require 'beambridge'
+require 'benchmark'
+
+data = [:ok, [:foo, :bar, [99, "bottles", "of", "beer", 3.14], [true, false]]]
+bert = Beambridge::Encoder.encode(data)
+
+p bert
+
+Benchmark.bm do|b|
+  b.report("Decoder") do
+    100_000.times { Erl::Decoder.decode(bert) }
+  end
+end
+
+#               user        system     total    real
+# C Decoder      0.400000   0.000000   0.400000 (  0.425373)
+# Ruby Decoder  30.250000   0.220000  30.470000 ( 32.140890)
+#
+# C decoder is 75.56x faster than Ruby decoder on this data

data/examples/echo/README.md

@@ -0,0 +1,12 @@
+This is a simple echo server example showing off basic Erlectricity usage.
+
+    $ cd examples/echo
+    $ erl
+    Erlang (BEAM) emulator version 5.6.4 [source] [smp:2] [async-threads:0] [kernel-poll:false]
+
+    Eshell V5.6.4  (abort with ^G)
+    1> c(echo).
+    {ok,echo}
+    2> echo:test().
+    <<"You said: hello world!">>
+    ok

data/examples/echo/echo.erl

@@ -0,0 +1,13 @@
+-module(echo).
+-export([test/0]).
+
+test() ->
+  Cmd = "ruby echo.rb",
+  Port = open_port({spawn, Cmd}, [{packet, 4}, nouse_stdio, exit_status, binary]), 
+  Payload = term_to_binary({echo, <<"hello world!">>}),
+  port_command(Port, Payload),
+  receive
+    {Port, {data, Data}} ->
+      {result, Text} = binary_to_term(Data),
+      io:format("~p~n", [Text])
+  end.

data/examples/echo/echo.rb

@@ -0,0 +1,10 @@
+$:.unshift File.join(File.dirname(__FILE__), *%w[../../lib])
+
+require 'beambridge'
+
+receive do |f|
+  f.when([:echo, String]) do |text|
+    f.send!([:result, "You said: #{text}"])
+    f.receive_loop
+  end
+end

data/examples/gruff/gruff.erl

@@ -0,0 +1,61 @@
+-module(gruff).
+-export([start/0, stop/0, plot/4]).
+
+start() ->
+  spawn(fun() ->
+    register(gruff, self()),
+    process_flag(trap_exit, true),
+    Cmd = "ruby ./gruff_provider.rb",
+    Port = open_port({spawn, Cmd}, [{packet, 4}, nouse_stdio, exit_status, binary]),
+    port_loop(Port)
+  end).
+
+stop() -> gruff ! stop.
+
+plot(Name, Font, Data, Labels) ->
+  gruff ! {plot, self(), Name, Font, Data, Labels},
+  receive
+    {result, Bin} -> Bin
+  end.
+
+send_data(_Port, []) -> ok;
+send_data(Port, [{Name, Points}|Rest]) ->
+  Data = {data, Name, Points},
+  Port ! {self(), {command, term_to_binary(Data)}},
+  send_data(Port, Rest).
+
+send_labels(Port, Labels) ->
+  Data = {labels, Labels},
+  Port ! {self(), {command, term_to_binary(Data)}}.
+
+port_loop(Port) ->
+  receive
+    {plot, Caller, Name, Font, Data, Labels} ->
+      PlotData = term_to_binary({plot, Name, 'Line', Font}),
+      Port ! {self(), {command, PlotData}},
+
+      send_data(Port, Data),
+      send_labels(Port, Labels),
+
+      EndData = term_to_binary('end'),
+      Port ! {self(), {command, EndData}},
+      Result = get_result(Port),
+      Caller ! {result, Result },
+
+      port_loop(Port);
+
+    stop ->
+      Port ! {self(), close},
+      receive
+        {Port, closed} -> exit(normal)
+      end
+  end.
+
+get_result(Port) ->
+  receive
+    {Port, {data, Data}} ->
+      {result, Bin} = binary_to_term(Data),
+      Bin;
+    {'EXIT', Port, Reason} ->
+      exit({port_terminated,Reason})
+    end.

data/examples/gruff/gruff_provider.rb

@@ -0,0 +1,30 @@
+$:.unshift File.join(File.dirname(__FILE__), *%w[../../lib])
+
+require 'beambridge'
+require 'gruff'
+
+receive do |f|
+  f.when([:plot, String, Symbol, String]) do |name, style, font|
+    graph = Gruff.const_get(style).new
+    graph.title = name
+    graph.font = font
+    graph.legend_font_size = 10
+
+    f.receive do |g|
+      g.when([:data, Symbol, Array]) do |name, points|
+        graph.data name, points
+        g.receive_loop
+      end
+
+      g.when([:labels, Erl.hash]) do |label_data|
+        graph.labels = label_data
+        g.receive_loop
+      end
+
+      g.when(:end) { :ok }
+    end
+
+    f.send!([:result, graph.to_blob])
+    f.receive_loop
+  end
+end