zas-client 0.0.1

data/LICENSE

@@ -0,0 +1,8 @@
+Copyright (c) 2012 Anthony Eden
+
+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,34 @@
+# Zero Authentication Service - Ruby Client
+
+This is a ruby client libraty for the Zero Authentication Service.
+
+## Usage
+
+Generally:
+
+    client = Zas::Client.new
+    require 'zas/http_basic_credentials'
+    credentials = Zas::HttpBasicCredentials.new('Zm9vOmJhcg==')
+    auth_result = client.authenticate(credentials)
+    if auth_result.authenticated?
+      p "You've been authenticated"
+    else
+      p "I don't know you"
+    end
+
+In irb:
+
+    bundle exec irb -Ilib -rzas
+    => # everything from general usage
+
+
+## Configuration
+  
+    config = Zas::ClientConfiguration.new(:name => 'my-client')
+    client = Zas::Client.new(config)
+
+## Notes
+
+* Zas::Client is not threadsafe
+* When using in irb call client.disconnect or CTRL-C to exit
+

data/lib/zas/client.rb

@@ -0,0 +1,53 @@
+require 'zmq'
+require 'syslogger'
+require 'yajl'
+
+module Zas
+  class Client
+    require 'zas/client_configuration'
+
+    # Initialize the client with the given configuration.
+    #
+    # config - Configuration spec for the client.
+    def initialize(config=ClientConfiguration.new)
+      self.host = config.host
+      self.port = config.port
+      self.context = ZMQ::Context.new
+      self.logger = Syslogger.new(config.name, Syslog::LOG_PID, Syslog::LOG_LOCAL0) 
+    end
+
+    # Authenticate the given credentials.
+    #
+    # credentials - The credentials
+    def authenticate(credentials)
+      begin
+        socket.send credentials.to_wire
+        socket.recv
+      rescue IOError => e
+        logger.error "Shutting down: #{e.message}" 
+      end 
+    end
+
+    def disconnect
+      socket.close
+      @socket = nil
+    end
+
+    private
+    attr_accessor :context
+    attr_accessor :host
+    attr_accessor :port
+    attr_accessor :logger
+
+    def socket
+      @socket ||= build_socket
+    end
+
+    def build_socket
+      socket = context.socket ZMQ::REQ
+      socket.connect "tcp://#{host}:#{port}"
+      Signal.trap(:INT) { disconnect }
+      socket
+    end
+  end
+end

data/lib/zas/client_configuration.rb

@@ -0,0 +1,23 @@
+module Zas
+  # Struct used to configure the Zas::Client.
+  #
+  # host - The IP address of the service. Defaults to 127.0.0.1
+  # port - The port number for the service.
+  # name - The name of the client for logging.
+  class ClientConfiguration < Struct.new(:host, :port, :name)
+    def initialize(attributes={})
+      attributes.each do |k, v|
+        self[k] = v
+      end
+    end
+    def host
+      self[:host] || '127.0.0.1'
+    end
+    def port
+      self[:port] || '5555'
+    end
+    def name
+      self[:name] || 'zas-client'
+    end
+  end
+end

data/lib/zas/http_basic_credentials.rb

@@ -0,0 +1,18 @@
+module Zas
+  # Credentials as taken from HTTP Basic Authentication.
+  class HttpBasicCredentials
+    # Construct the credentials with the base64 encoded value
+    # passed directly from an HTTP request.
+    def initialize(base64_encoded_credentials)
+      self.base64_encoded_credentials = base64_encoded_credentials
+    end
+
+    # Construct a wire representation of the credentials
+    def to_wire
+      Yajl::Encoder.encode({:strategy => :http_basic_auth, :credentials => base64_encoded_credentials})
+    end
+
+    private
+    attr_accessor :base64_encoded_credentials
+  end
+end

data/lib/zas.rb

@@ -0,0 +1,3 @@
+module Zas
+  require 'zas/client'
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: zas-client
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Anthony Eden
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-22 00:00:00.000000000 Z
+dependencies: []
+description: Client for communicating with ZeroAS
+email:
+- anthonyeden+zero-as@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/zas/client.rb
+- lib/zas/client_configuration.rb
+- lib/zas/http_basic_credentials.rb
+- lib/zas.rb
+- LICENSE
+- README.md
+homepage: http://github.com/zero-as/zas-client-ruby
+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: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: Client for ZeroAS
+test_files: []