constable 0.0.1

data/README.md

@@ -0,0 +1,63 @@
+Constable
+=========
+
+Seascape Study with Rain Cloud was painted by John Constable around 1824.
+
+Constable the Gem is a way of providing ImageMagick as a service. I doubt
+anything quite as powerful will be generated using the service, but if you do
+make something nice please let me know!
+
+
+Installing
+----------
+
+The server needs ImageMagick installed. Mostly I do this using `apt-get`:
+
+    apt-get isntall imagemagick
+
+You'll need a broker that talks Stomp somewhere on your network. I use Apache
+Apollo, and I'm not totally sure if the code uses anything that's specific to
+that. I'd love it to be broker-agnostic though, so if you have patches that'll
+bring this closer to reality please send them to me!
+
+
+Usage
+-----
+
+ImageMagick provides a huge nubmer of commands and options. Supporting them
+all is a big task, so I'm implementing just the few that I use. If you need
+something else supported, please do fork and patch the project. Let me know
+and I'll pull your changes.
+
+Run the server, somewhere that has ImageMagick installed:
+
+    constabled --broker stomp://mq.yourdomain.com:61613
+
+Use the services on the command line. You don't need ot have ImageMagick
+installed on your client machines, just constable.
+
+Command names are based on ImageMagick command names, prefixed with
+`constable-`, eg `constable-identify`. All commands will respond to --help
+and will give you a decent explanation of what they do and their options if
+you ask for it.
+
+The commands are designed to take their input on standard input and return
+results on standard output. It's up to you what you do with the input and
+output; write it to a file, pipe it to another process, that's not handled by
+Constable (and I have no plans to handle it).
+
+A brief example of what interacting with Constable looks like, here
+identifying some image file I had lying around on disk:
+
+    $ cat input_file | constable-identify --broker stomp://mq.yourdomain.com:61613
+    constabled-164829495-102948483-1939485.jpg JPEG 640x480 DirectClass 87kb 0.050u 0:01
+
+I explicitly state the broker in the above commands but if you leave out that
+option it'll default to stomp://localhost:61613 ie it expects a broker running
+on your local machine if you don't tell it otherwise.
+
+
+Authors
+-------
+
+Craig R Webster <http://barkingiguana.com/>

data/bin/constable-identify

@@ -0,0 +1,34 @@
+#! /usr/bin/env ruby
+
+image = STDIN.read
+if image.to_s == ''
+  puts "Give me some input!"
+  exit 1
+end
+
+require 'base64'
+encoded_input = Base64.encode64 image
+
+require 'stomp'
+require 'json'
+
+results = '/queue/constable.results-' + Process.pid.to_s + '-' + Time.now.to_i.to_s
+client = Stomp::Client.new ARGV[0]
+client.subscribe results, 'auto-delete' => true do |message|
+  results = JSON.parse message.body
+  if results['exit_code'] == 0
+    print results['stdout']
+  else
+    print results['stderr']
+  end
+  client.close
+end
+
+command = {
+  command: 'identify',
+  input: encoded_input
+}
+command_json = JSON.generate command
+
+client.publish '/queue/constable', command_json, 'reply-to' => results
+client.join

data/bin/constabled

@@ -0,0 +1,107 @@
+#! /usr/bin/env ruby
+
+require 'stomp'
+require 'digest/sha1'
+require 'json'
+require 'tempfile'
+require 'open3'
+require 'base64'
+
+class Job
+  module WorkingEnvironment
+    def with_temp_file
+      temp_file = Tempfile.new serial
+      yield temp_file
+    ensure
+      temp_file.close!
+    end
+
+    def serial
+      @job_id ||= [
+        File.basename($0), Time.now.to_i, rand(1_000_000)
+      ].join '-'
+    end
+
+    def using_file_with_content encoded_content, &block
+      decoded_content = Base64.decode64 encoded_content
+      with_temp_file do |file|
+        file.print decoded_content
+        file.flush
+        yield file
+      end
+    end
+
+    def run_command command
+      puts "Running #{command}"
+      stdin, stdout, stderr, command = Open3.popen3 command
+      {
+        stdout: stdout.readlines.join,
+        stderr: stderr.readlines.join,
+        exit_code: command.value.exitstatus,
+        pid: command.value.pid
+      }
+    end
+  end
+
+  class IdentifyCommand
+    include WorkingEnvironment
+
+    attr_accessor :options
+    private :options, :options=
+
+    def initialize options
+      self.options = options
+    end
+
+    def execute
+      using_file_with_content options['input'] do |file|
+        run_command "identify #{file.path}"
+      end
+    end
+  end
+
+  attr_accessor :options
+  private :options, :options=
+
+  def initialize options
+    self.options = options
+  end
+
+  def execute
+    handler.execute
+  end
+
+  def handler
+    handler_class.new options
+  end
+
+  def handler_class
+    Job.const_get handler_name
+  end
+
+  def handler_name
+    name = command_name
+    name.gsub!(/\/(.?)/) { "::#{$1.upcase}" }
+    name.gsub!(/(?:^|_)(.)/) { $1.upcase }
+    name + 'Command'
+  end
+
+  def command_name
+    options["command"]
+  end
+end
+
+client = Stomp::Client.new ARGV[0]
+client.subscribe '/queue/constable' do |message|
+  puts "Received #{message.headers['message-id']}"
+
+  options = JSON.parse message.body
+  results = Job.new(options).execute
+
+  result_json = JSON.generate results
+  destination = message.headers['reply-to']
+  client.publish destination, result_json
+end
+
+puts "Waiting for clients..."
+client.join

data/lib/constable/version.rb

@@ -0,0 +1,3 @@
+module Constable
+  VERSION = '0.0.1'
+end

data/lib/constable.rb

@@ -0,0 +1 @@
+require 'constable/version'

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: constable
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Craig R Webster
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-30 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: stomp
+  requirement: &70138922339840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70138922339840
+description: Installing ImageMagick and RMagick everywhere sucks, right? So install
+  it in one place and have everything else use that one install.
+email:
+- craig@barkingiguana.com
+executables:
+- constabled
+- constable-identify
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/constable/version.rb
+- lib/constable.rb
+- bin/constable-identify
+- bin/constabled
+- README.md
+homepage: 
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- A broker capable of talking Stomp
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: ImageMagick as a service
+test_files: []