FluxTuna 0.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rvmrc

@@ -0,0 +1,27 @@
+ruby_string="ruby-1.9.2-p180"
+gemset_name="whitecloth"
+
+if rvm list strings | grep -q "${ruby_string}" ; then
+
+  # Load or create the specified environment
+  if [[ -d "${rvm_path:-$HOME/.rvm}/environments" \
+    && -s "${rvm_path:-$HOME/.rvm}/environments/${ruby_string}@${gemset_name}" ]] ; then
+    \. "${rvm_path:-$HOME/.rvm}/environments/${ruby_string}@${gemset_name}"
+  else
+    rvm --create  "${ruby_string}@${gemset_name}"
+  fi
+
+  # Ensure that Bundler is installed, install it if it is not.
+  if ! command -v bundle ; then
+    gem install bundler
+  fi
+
+  # Bundle while reducing excess noise.
+  bundle | grep -v 'Using' | grep -v 'complete' | sed '/^$/d'
+
+else
+
+  # Notify the user to install the desired interpreter before proceeding.
+  echo "${ruby_string} was not found, please run 'rvm install ${ruby_string}' and then cd back into the project directory."
+
+fi

data/Gemfile

@@ -0,0 +1,51 @@
+###
+### Sources
+###
+
+# Main Ruby Gems site
+source "http://rubygems.org"
+
+###
+### Core Gems. These are required in _all_ environments (additional environments
+###            follow).
+###
+
+# Additional data structures
+gem "algorithms"
+
+# GUID library
+gem "uuidtools"
+
+# Gem required for linking to the Redis server
+gem "hiredis", "~> 0.3.1"
+gem "em-synchrony"
+gem "redis", "~> 2.2.0", :require => ["redis/connection/synchrony", "redis"]
+
+# Command line parser
+gem "cli"
+gem "cri"
+
+# Simpler access to the OpenSSL library
+gem "gibberish"
+
+###
+### Development Gems. All _additional_ gems required by development (as opposed to
+###                   production environments). If it is required at run-time, it
+###                   belongs above.
+group :development do
+
+  # Gem management tools
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.0"
+  
+  # Documentation Tools
+  gem "yard", "~> 0.6.0"
+  gem "vclog"
+  
+  # Testing Tools
+  gem "minitest", ">= 0"
+  gem "rcov", ">= 0"
+  gem "riot"
+  gem "reek", "~> 1.2.8"
+
+end

data/Gemfile.lock

@@ -0,0 +1,61 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    algorithms (0.3.0)
+    ansi (1.2.5)
+    cli (0.0.1.2)
+    cri (1.0.1)
+    em-synchrony (0.2.0)
+      eventmachine (>= 0.12.9)
+    eventmachine (0.12.10)
+    facets (2.9.1)
+    gibberish (1.0.2)
+    git (1.2.5)
+    hiredis (0.3.1)
+    jeweler (1.6.0)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    minitest (2.1.0)
+    rake (0.8.7)
+    rcov (0.9.9)
+    redis (2.2.0)
+    reek (1.2.8)
+      ruby2ruby (~> 1.2)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    riot (0.12.3)
+      rr
+    rr (1.0.2)
+    ruby2ruby (1.2.5)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    ruby_parser (2.0.6)
+      sexp_processor (~> 3.0)
+    sexp_processor (3.0.5)
+    uuidtools (2.1.2)
+    vclog (1.8.1)
+      ansi (>= 1.2)
+      facets (>= 2.4)
+    yard (0.6.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  algorithms
+  bundler (~> 1.0.0)
+  cli
+  cri
+  em-synchrony
+  gibberish
+  hiredis (~> 0.3.1)
+  jeweler (~> 1.6.0)
+  minitest
+  rcov
+  redis (~> 2.2.0)
+  reek (~> 1.2.8)
+  riot
+  uuidtools
+  vclog
+  yard (~> 0.6.0)

data/HISTORY

@@ -0,0 +1,16 @@
+RELEASE HISTORY
+
+HEAD / 2011-05-17
+
+Current Development (David Love)
+
+Changes:
+
+* 1 Patch Enhancements
+
+    * Basic framework for the application added. No functionality yet.
+
+* 1 General Enhancements
+
+    * Initial commit to WhiteCloth.
+

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2011 David Love <david@homeunix.org.uk>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/README.rdoc

@@ -0,0 +1,20 @@
+= WhiteCloth
+
+This is an _experimental_ language framework, attempting to put my theoretical work on semi-formal structures to work. At the moment it doesn't do a lot: hopefully that will change soon.  
+
+
+== Contributing to WhiteCloth
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 David Love. See LICENSE for
+further details.
+

data/Rakefile

@@ -0,0 +1,100 @@
+# Copyright (c) 2011 David Love
+#
+# Permission to use, copy, modify, and/or distribute this software for 
+# any purpose with or without fee is hereby granted, provided that the 
+# above copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+#
+# encoding: utf-8
+
+###
+### Set-up. Actions to run before all tasks
+###
+
+## Use Bundler to make sure the gem environment is up-to-date
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+###
+### Gemspec. Mangage the creation of the relevant gem and gemspec files. Most of this
+###          is delegated to Jeweler
+###
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "FluxTuna"
+  gem.homepage = "http://github.com/dlove24/FluxTuna"
+  gem.license = "ISC"
+  gem.summary = "Experimental Framework for exploiting Semi-Formal Structures"
+  gem.description = "See: http://research.homeunix.org.uk"
+  gem.email = "david@homeunix.org.uk"
+  gem.authors = ["David Love"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+###
+### Testing. Run the unit/system/integration tests
+###
+
+require 'rake/testtask'
+
+desc "Run all our tests"
+task :test do
+  Rake::TestTask.new do |t|
+    t.libs << "test"
+    t.verbose = false
+    
+    # List of files. We need to specifiy these explicity so they
+    # are loaded in the correct order: init, data, then the tests
+    # themselves
+    t.test_files = ["test/init_test.rb",
+                    
+                    "test/data/data_test.rb",
+                    
+                    "test/dir_walk/create_witness_test.rb"]
+  end
+end
+
+## Set testing as the default action
+task :default => :test
+
+###
+### Documentation. Generate/update the project documentation
+###
+
+## Use Yard to generate the documentations
+require 'yard'
+YARD::Rake::YardocTask.new
+
+###
+### Release. Additional actions to take when releasing the gem
+###
+
+## Additional actions for the release task
+task :before_release do
+  # Update the HISTORY file
+  `vclog history -f gnu  > HISTORY`
+end
+
+## Update the HISTORY file before a version bump
+Rake::Task["version:bump:major"].enhance([:before_release])
+Rake::Task["version:bump:minor"].enhance([:before_release])
+Rake::Task["version:bump:patch"].enhance([:before_release])
+  

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/whitecloth

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+
+### Copyright (c) 2011 David Love <david@homeunix.org.uk>
+###
+### Permission to use, copy, modify, and/or distribute this software for 
+### any purpose with or without fee is hereby granted, provided that the 
+### above copyright notice and this permission notice appear in all copies.
+###
+### THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 
+### WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 
+### MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 
+### ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 
+### WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 
+### ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 
+### OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+###
+
+### @author David Love
+###
+### Bootstraping Command. Used to initalize various aspects of the Mercury
+### environment.
+###
+### @note The sub-commands provided by the bootstrap command assume (at-least)
+### a minimally working Ruby environment, with the required gems installed. Various
+### 'First Boot' scripts are available in the `scripts` directory for different
+### platforms which will achive at least this minimal state
+###
+
+# Add lib to load path
+$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + '/../lib'))
+
+# Load the rubygems library
+require 'rubygems'
+
+# Load core application library
+require 'whitecloth'
+
+# Load command line handler
+require 'whitecloth/cli'
+
+# Load the commands from the cmds dir
+plugin_dir = File.expand_path(File.dirname(__FILE__) + '/../cmds')
+
+Dir[plugin_dir + '/*.rb'].sort.each{|file|
+  require file
+}
+
+# Run base
+WhiteCloth::CLI::Base.new.run(ARGV)

data/lib/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Denis Defreyne and contributors
+
+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/lib/WhiteCloth.rb

@@ -0,0 +1,24 @@
+### Copyright (c) 2010, David Love
+###
+### Permission to use, copy, modify, and/or distribute this software for 
+### any purpose with or without fee is hereby granted, provided that the 
+### above copyright notice and this permission notice appear in all copies.
+###
+### THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 
+### WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 
+### MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 
+### ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 
+### WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 
+### ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 
+### OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+###
+
+module WhiteCloth
+
+  ## Define Application Global constants
+
+  # The current WhiteCloth client version.
+  VERSION = '0.1'
+
+end
+

data/lib/whitecloth/cli/base.rb

@@ -0,0 +1,102 @@
+# Copyright (c) 2009 Denis Defreyne, 2010-2011 David Love
+#
+# Permission to use, copy, modify, and/or distribute this software for 
+# any purpose with or without fee is hereby granted, provided that the 
+# above copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+#
+
+# @author Denis Defreyne
+# @author David Love
+#
+# The +CLI+ module acts as the gathering place for all the gloabl options
+# and the sub-commands which the +whitecloth+ command can deal with. 
+# Sub-commands are themselves defined in the {WhiteCloth::CLI::Commands} 
+# module 
+module WhiteCloth::CLI
+
+  # @author Denis Defreyne
+  # @author David Love
+  #
+  # Details the global options applicable to all commands, and the code necessary
+  # to process those options. Each sub-command also needs to be registered with 
+  # this class for it to work: strange things will happen if the sub-command is
+  # not set-up here!
+  #
+  # When creating a new sub-command, the constructor for that sub-command needs
+  # to be added to the {Base#initialize} function of *this* class as well. Be sure to 
+  # also add the path to the file where the sub-command is defined to the file 
+  # +lib/whitecloth/cli/commands.rb+, otherwise you will get warnings of unknown
+  # classes.
+  class Base < Cri::Base
+
+    # Instantiates the sub-commands by creating a single reference to each
+    # known sub-command.
+    # 
+    # @note This means that if your sub-command is not in this constructor
+    #   it *will not* be found, and *will not* appear as a valid sub-command.
+    #   If something is missing from the 'help' command, check this method! 
+    def initialize
+      super('whitecloth')
+
+      # Add help command
+      self.help_command = WhiteCloth::CLI::Commands::Help.new
+      add_command(self.help_command)
+
+      # Add other commands
+      add_command(WhiteCloth::CLI::Commands::Bootstrap.new)
+      add_command(WhiteCloth::CLI::Commands::Show.new)
+    end
+
+    # Returns the list of global option definitionss.
+    def global_option_definitions
+      [
+        {
+          :long => 'help', :short => 'h', :argument => :forbidden,
+          :desc => 'show this help message and quit'
+        },
+        {
+          :long => 'no-color', :short => 'C', :argument => :forbidden,
+          :desc => 'disable color'
+        },
+        {
+          :long => 'version', :short => 'v', :argument => :forbidden,
+          :desc => 'show version information and quit'
+        },
+        {
+          :long => 'verbose', :short => 'V', :argument => :forbidden,
+          :desc => 'make whitecloth output more detailed'
+        }
+      ]
+    end
+
+    # Process the global options, and set/change the application state from them
+    def handle_option(option)
+      # Handle version option
+      if option == :version
+        puts "WhiteCloth Bootstrap Client #{WhiteCloth::VERSION} (c) 2011 David Love."
+        puts "Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) running on #{RUBY_PLATFORM}"
+        exit 0
+      # Handle verbose option
+      elsif option == :verbose
+        WhiteCloth::CLI::Logger.instance.level = :low
+      # Handle no-color option
+      elsif option == :'no-color'
+        WhiteCloth::CLI::Logger.instance.color = false
+      # Handle help option
+      elsif option == :help
+        show_help
+        exit 0
+      end
+    end
+
+  end
+
+end

data/lib/whitecloth/cli/commands/bootstrap.rb

@@ -0,0 +1,103 @@
+# Copyright (c) 2009 Denis Defreyne, 2010-2011 David Love
+#
+# Permission to use, copy, modify, and/or distribute this software for 
+# any purpose with or without fee is hereby granted, provided that the 
+# above copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+module WhiteCloth::CLI::Commands
+
+  # @author David Love
+  #
+  # The +bootstrap+ command prepared the basic WhiteCloth realms (if 
+  # needed), and then links the current host to those realms. The basic
+  # realms consists of
+  #
+  # +Realm 0+: *Namespace*. All the named realms stored in this domain.
+  # 
+  # +Realm 1+: *Realm Handlers*. The basic gateways needed to create/store/update
+  # other realms.
+  # 
+  # +Realm 5+: *Realm Code*. Libraries and other code which the realm handlers
+  # should use by preference when conducting operations on the realms.
+  #
+  # If the IP address of a server (or a server name) is given to as an argument
+  # to this command, then we will use that IP address (name) for as the WhiteCloth
+  # realm server to contact. Otherwise we will look for the same data from the file
+  # +/etc/whitecloth.conf+: aborting if the file cannot be found.
+  #
+  # Once we have made contact with the server, we look at the basic realms listed
+  # above, and attempt to ensure they can be found. If not, an attempt is made to
+  # create the basic realms: aborting if this attempt fails.
+  #
+  # Finally, once everything has been set-up, we upload the core realm code (or 
+  # update the existing code)
+  class Bootstrap < Cri::Command
+
+    # The name of the sub-command (as it appears in the command line app)
+    def name
+      'bootstrap'
+    end
+
+    # The aliases this sub-command is known by
+    def aliases
+      []
+    end
+
+    # A short help text describing the purpose of this command
+    def short_desc
+      'Create a link between this host and the whitecloth servers.'
+    end
+
+    # A longer description, detailing both the purpose and the
+    # use of this command
+    def long_desc
+      'Look for the specified server, adding the data required to link the ' +
+      'current host to that server. If the found server has not been set-up ' +
+      'then this command also performs the setup of the base realms as well. '
+    end
+
+    # Show the user the basic syntax of this command
+    def usage
+      "whitecloth bootstrap [-s server]"
+    end
+    
+    # Define the options for this command
+    def option_definitions
+      [
+        { :short => 's', :long => 'server', :argument => :optional }
+      ]
+    end
+
+    # Execute the command
+    def run(options, arguments)
+      
+      # The first thing we need to do is to find the relevant server. So we 
+      # check the options and see if they can help
+      unless options[:server].nil? or options[:server].empty? then
+        #
+      else
+      
+        # The user has not specified a server, so we will attempt to get one
+        # from the system configuration
+        if File.exists?("/etc/whitecloth.conf") then
+          #
+        
+        # Everything has failed, so we abort        
+        else
+          WhiteCloth::CLI::Logger.instance.log_level(:high, :error, "Cannot locate a WhiteCloth server. Either specify the server to connect to using the 'server' option, or create an appropriate configuration file.")
+        end
+      end  
+    end
+
+  end
+
+end