nucleon 0.1.14 → 0.1.15

data/README.rdoc

@@ -1,17 +1,47 @@
-= Nucleon
+== Nucleon
 
-A framework that provides a simple foundation for building apps that are:
+=== Description
 
-1. Distributively configured
-2. Extremely pluggable and extendable
-3. Easily parallel
+Nucleon is built to provide an easy and minimal, yet extremely powerful, 
+framework for building applications that are highly distributable in nature.
 
-More coming soon!
+See: ARCHITECTURE.rdoc
+
+=== Installation / Dependencies
+
+See the Gemfile for all Nucleon gem dependencies.
+
+If the project plugin is used, you will probably need Git installed on the 
+system.  If you do not and you use the project plugin Git providers, Git 
+projects will not do anything and will give you persistence warnings.
+
+To install:
+
+  gem install nucleon
+
+or put something like this in your Gemfile (for Bundler)
+
+  gem "nucleon", "~> 0.1"
+
+Then you can require as needed and use what you need.
+
+This library has so far been developed and tested on an Ubuntu environment but 
+the groundwork has been laid for development and testing on other platforms.  
+The library also currently lacks unit tests, which will be coming before the 
+1.0 (first production) release.
+
+Consider this library experimental, but you are welcome to play around with it 
+and tell us what you think or how we could improve it.
+
+
+=== Usage
+
+=== Links
 
 Note: This library is still very early in development!
 
 
-== Contributing to Nucleon
+=== Contributing to Nucleon
  
 * Check out the latest {major}.{minor} branch to make sure the feature hasn't 
   been implemented or the bug hasn't been fixed yet.
@@ -26,9 +56,9 @@ Note: This library is still very early in development!
   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
 
-Licensed under GPLv3.  See LICENSE.txt for further details.
+Licensed under the Apache License 2.0.  See LICENSE.txt for further details.
 
-Copyright (c) 2014  Adrian Webb <adrian.webb@coralnexus.com>
-Coral Technology Group LLC
+Copyright (c) 2013-2014  Adrian Webb <adrian.webb@coralnexus.com>
+Coral Technology Group LLC

data/TODO.rdoc

@@ -0,0 +1,15 @@
+== Nucleon tasks to complete before 1.0 release
+
+* Namespace implementation
+* Meta (composite) actions
+* Execution plans
+* Error handling improvements
+* Full code documentation
+* Full coverage unit tests (starting with core Nucleon unit testing library)
+* Performance improvements
+* Ensure fault tolerance for Actor managers
+* Deeper GitHub API integration in project provider
+* UI console color profiles
+* Localization improvements
+* Logging consolidation (eliminate redundant log entries)
+* Fix bugs :-(

data/VERSION

@@ -1 +1 @@
-0.1.14
+0.1.15

data/lib/core/config.rb

@@ -68,7 +68,7 @@ class Config
   #---
   
   def has_key?(keys)
-    get(keys) ? true : false
+    get(keys).nil? ? false : true
   end
       
   #-----------------------------------------------------------------------------

data/lib/core/facade.rb

@@ -7,11 +7,33 @@ module Parallel
   
   def self.included(klass)
     if Nucleon.parallel?
-      klass.send :include, Celluloid
+      klass.send :include, Celluloid      
     end
+    klass.send :include, InstanceMethods
     klass.extend ClassMethods
   end
   
+  #---
+  
+  module InstanceMethods
+    def parallel(method, split_args, *shared_args)
+      results    = []
+      split_args = [ split_args ] unless split_args.is_a?(Array)
+  
+      if Nucleon.parallel?
+        split_args.each do |arg|
+          results << future.send(method, arg, *shared_args)
+        end
+        results.map { |future| future.value } # Wait for all to finish.
+      else
+        split_args.each do |arg|
+          results << send(method, arg, *shared_args)
+        end  
+      end
+      results
+    end
+  end
+  
   #---
 
   module ClassMethods

data/lib/core/util/disk.rb

@@ -6,8 +6,6 @@ class Disk
   #-----------------------------------------------------------------------------
   # Properties
  
-  @@files = {}
-  
   @@separator   = false
   @@description = ''
   
@@ -28,42 +26,17 @@ class Disk
   
   #---
   
-  def self.open(file_name, options = {}, reset = false)
-    mode          = options[:mode].to_s
-    
-    @@separator   = ( options[:separator] ? options[:separator] : false )
-    @@description = ( options[:description] ? options[:description] : '' )
-    
-    if @@files.has_key?(file_name) && ! reset
-      reset = true if ! mode.empty? && mode != @@files[file_name][:mode]
-    end
-    
-    @@file_lock.synchronize do
-      if ! @@files.has_key?(file_name) || ! @@files[file_name][:file] || reset
-        @@files[file_name][:file].close if @@files[file_name] && @@files[file_name][:file]
-        unless mode.empty? || ( mode == 'r' && ! ::File.exists?(file_name) )
-          @@files[file_name] = {
-            :file => ::File.open(file_name, mode),
-            :mode => mode,
-          }
-        end
-      end
-    end
-    return nil unless @@files[file_name]
-    return @@files[file_name][:file]
-  end
-  
-  #---
-  
   def self.read(file_name, options = {})
     result = nil
     options[:mode] = ( options[:mode] ? options[:mode] : 'r' )
-    file           = open(file_name, options)
     
-    if file
-      @@file_lock.synchronize do
-        file.pos = 0 if options[:mode] == 'r'
-        result = file.read
+    @@file_lock.synchronize do
+      begin
+        if file = ::File.open(file_name, options[:mode])
+          result = file.read
+          file.close
+        end
+      rescue # TODO: Only catch error if file is not found.
       end
     end
     return result
@@ -72,18 +45,13 @@ class Disk
   #---
   
   def self.write(file_name, data, options = {})
+    result = nil
     options[:mode] = ( options[:mode] ? options[:mode] : 'w' )
-    file           = open(file_name, options)
-    result         = nil
-    
-    if file
-      @@file_lock.synchronize do
-        file.pos = 0 if options[:mode] == 'w'
+        
+    @@file_lock.synchronize do
+      if file = ::File.open(file_name, options[:mode])
         result = file.write(data)
-        begin
-          file.flush
-        rescue # In case the file is already closed
-        end
+        file.close
       end
     end
     return result
@@ -103,29 +71,13 @@ class Disk
   
   def self.log(data, options = {})
     reset = ( options[:file_name] || options[:mode] )
-    file  = open(( options[:file_name] ? options[:file_name] : 'log.txt' ), options, reset)    
-    if file
-      @@file_lock.synchronize do      
+      
+    @@file_lock.synchronize do      
+      if file = ::File.open(( options[:file_name] ? options[:file_name] : 'log.txt' ), options[:mode]) 
         file.write("--------------------------------------\n") if @@separator
         file.write("#{@@description}\n") if @@description       
         file.write("#{data}\n")
-      end
-    end
-  end
-  
-  #---
-  
-  def self.close(file_names = [])
-    file_names = @@files.keys unless file_names && ! file_names.empty?
-    
-    unless file_names.is_a?(Array)
-      file_names = [ file_names ]
-    end
-    
-    file_names.each do |file_name|
-      @@file_lock.synchronize do
-        @@files[file_name][:file].close if @@files[file_name] && @@files[file_name][:file]
-        @@files.delete(file_name)
+        file.close
       end
     end
   end

data/lib/nucleon/project/github.rb

@@ -57,31 +57,21 @@ class Github < Git
       ssh_key = public_key_str
       
       if private_key && ssh_key
-        begin
-          deploy_keys = client.deploy_keys(plugin_name)
-          github_id   = nil
-          keys_match  = true
+        deploy_keys = client.deploy_keys(plugin_name)
+        github_id   = nil
+        keys_match  = true
                    
-          deploy_keys.each do |key_resource|
-            if key_resource.title == key_id
-              github_id  = key_resource.id              
-              keys_match = false if key_resource.key != ssh_key
-              break
-            end  
-          end
-                     
-          client.remove_deploy_key(myself.plugin_name, github_id) if github_id && ! keys_match
-          client.add_deploy_key(myself.plugin_name, key_id, ssh_key)
-          verify_key
-          
-                  
-        rescue Exception => error
-          logger.error(error.inspect)
-          logger.error(error.message)
-          logger.error(Util::Data.to_yaml(error.backtrace))
-
-          ui.error(error.message, { :prefix => false }) if error.message
+        deploy_keys.each do |key_resource|
+          if key_resource.title == key_id
+            github_id  = key_resource.id              
+            keys_match = false if key_resource.key != ssh_key
+            break
+          end  
         end
+                     
+        client.remove_deploy_key(myself.plugin_name, github_id) if github_id && ! keys_match
+        client.add_deploy_key(myself.plugin_name, key_id, ssh_key)
+        verify_key
       end
     end  
   end

data/nucleon.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: nucleon 0.1.14 ruby lib
+# stub: nucleon 0.1.15 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "nucleon"
-  s.version = "0.1.14"
+  s.version = "0.1.15"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]
   s.authors = ["Adrian Webb"]
-  s.date = "2014-04-15"
+  s.date = "2014-04-24"
   s.description = "\nA framework that provides a simple foundation for building Ruby applications that are:\n\n* Highly configurable (with both distributed and persistent configurations)\n* Extremely pluggable and extendable\n* Easily parallel\n\nNote: This framework is still very early in development!\n"
   s.email = "adrian.webb@coralnexus.com"
   s.executables = ["nucleon"]
@@ -21,11 +21,13 @@ Gem::Specification.new do |s|
   ]
   s.files = [
     ".document",
+    "ARCHITECTURE.rdoc",
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
     "README.rdoc",
     "Rakefile",
+    "TODO.rdoc",
     "VERSION",
     "bin/nucleon",
     "lib/core/codes.rb",

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nucleon
 version: !ruby/object:Gem::Version
-  version: 0.1.14
+  version: 0.1.15
 platform: ruby
 authors:
 - Adrian Webb
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-15 00:00:00.000000000 Z
+date: 2014-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: log4r
@@ -280,11 +280,13 @@ extra_rdoc_files:
 - README.rdoc
 files:
 - ".document"
+- ARCHITECTURE.rdoc
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
 - README.rdoc
 - Rakefile
+- TODO.rdoc
 - VERSION
 - bin/nucleon
 - lib/core/codes.rb