titan 0.0.3 → 0.1.0

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.1.0 (November 26, 2010)
+
+!!! Cleaned up the API. Now, everything is available through Titan::Thread.
+
 ## 0.0.3 (November 25, 2010)
 
 - Bug fixes

data/README.md

@@ -39,35 +39,27 @@ It's also possible to change the identifier after creation:
 
 The identifier must be unique.
 
-If you want to access the thread in the future, Titan::Manager is the tool of your choice:
-
-    thread = Titan::Thread.new(:id => "my_new_thread") do
-      sleep(15)
-      puts "I'm awake!"
-    end
-    Titan::Manager.add(thread)
-
-It manages threads and saves them in a special .titan file that can be found in your home folder.
+Titan manages created threads and saves them in a special .titan file that can be found in your home folder.
 
 You can easily list all available threads:
 
-    Titan::Manager.all_threads
+    Titan::Thread.all
 
-By using the manager you can find currently managed threads by using their identifier:
+By using the Thread class you can find currently managed threads by using their identifier:
 
-    thread  = Titan::Manager.find("my_new_thread")
+    thread  = Titan::Thread.find("my_new_thread")
 
 A thread can be forced to exit:
 
     thread.kill if thread.alive?
 
-If you want to remove threads from the manager, that aren't running any longer, you can do this by:
+If you want to remove threads from Titan, that aren't running any longer, you can do this by:
 
-    Titan::Manager.remove_dead_threads
+    Titan::Thread.remove_dead_threads
 
 Furthermore, you can check if a single thread is alive:
 
-    thread = Titan::Manager.find("my_new_thread")
+    thread = Titan::Thread.find("my_new_thread")
     thread.alive? # returns true or false
 
 Requirements

data/lib/titan.rb

@@ -1,6 +1,5 @@
 require "titan/version"
 
 module Titan
-  autoload :Manager,  "titan/manager"
   autoload :Thread,   "titan/thread"
 end

data/lib/titan/thread.rb

@@ -1,3 +1,5 @@
+require "yaml"
+
 module Titan
   #
   # Titan::Thread helps you creating daemon threads that are independent from your application.
@@ -5,8 +7,12 @@ module Titan
   # that gets created automatically.
   #
   class Thread
+    TITAN_FILE = "#{File.expand_path('~')}/.titan"
+
     attr_accessor :id, :pid
 
+    @@threads = {}
+
     #
     # Creates a new daemonized thread
     #
@@ -22,7 +28,7 @@ module Titan
       end
 
       Process.detach(@pid)
-      self
+      Thread.add(self)
     end
 
     #
@@ -41,5 +47,56 @@ module Titan
     rescue Errno::ESRCH
       false
     end
+
+    class << self
+      def add(thread)
+        load_threads
+        @@threads[thread.id] = thread
+        save_threads
+        thread
+      end
+
+      #
+      # Returns a thread that has the given id
+      #
+      def find(id)
+        load_threads
+        @@threads[id]
+      end
+
+      def kill(id)
+        find(id).kill
+      end
+
+      #
+      # Returns all Titan-managed threads
+      #
+      def all
+        load_threads
+        @@threads
+      end
+
+      #
+      # Loads threads from the TITAN_FILE
+      #
+      def load_threads
+        return unless File.exists?(TITAN_FILE)
+        @@threads = YAML::load(File.open(TITAN_FILE)) || {}
+      end
+
+      #
+      # Saves threads to the TITAN_FILE
+      #
+      def save_threads
+        File.open(TITAN_FILE, 'w') { |file| file.write(YAML::dump(@@threads)) }
+      end
+
+      #
+      # Removes threads that are not living anymore
+      #
+      def remove_dead_threads
+        @@threads.each_value { |thread| @@threads.delete(thread.id) unless thread.alive? }
+      end
+    end
   end
 end

data/lib/titan/version.rb

@@ -1,3 +1,3 @@
 module Titan
-  VERSION = "0.0.3"
+  VERSION = "0.1.0"
 end

metadata

@@ -1,13 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: titan
 version: !ruby/object:Gem::Version 
-  hash: 25
   prerelease: false
   segments: 
   - 0
+  - 1
   - 0
-  - 3
-  version: 0.0.3
+  version: 0.1.0
 platform: ruby
 authors: 
 - Stefan Sprenger
@@ -15,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-25 00:00:00 +01:00
+date: 2010-11-26 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -26,7 +25,6 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 13
         segments: 
         - 1
         - 2
@@ -44,7 +42,6 @@ extra_rdoc_files:
 - LICENSE
 - README.md
 files: 
-- lib/titan/manager.rb
 - lib/titan/thread.rb
 - lib/titan/version.rb
 - lib/titan.rb
@@ -65,7 +62,6 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
@@ -74,7 +70,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"

data/lib/titan/manager.rb

@@ -1,63 +0,0 @@
-require "yaml"
-
-module Titan
-  #
-  # Titan::Manager provides access to created threads.
-  # It serializes and deserializes them using YAML.
-  #
-  class Manager
-    TITAN_FILE = "#{File.expand_path('~')}/.titan"
-
-    @@threads = {}
-
-    class << self
-      def add(thread)
-        load_threads
-        @@threads[thread.id] = thread
-        save_threads
-      end
-
-      #
-      # Returns a thread that has the given id
-      #
-      def find(id)
-        load_threads
-        @@threads[id]
-      end
-
-      def kill(id)
-        find(id).kill
-      end
-
-      #
-      # Returns all Titan-managed threads
-      #
-      def all_threads
-        load_threads
-        @@threads
-      end
-
-      #
-      # Loads threads from the TITAN_FILE
-      #
-      def load_threads
-        return unless File.exists?(TITAN_FILE)
-        @@threads = YAML::load(File.open(TITAN_FILE)) || {}
-      end
-
-      #
-      # Saves threads to the TITAN_FILE
-      #
-      def save_threads
-        File.open(TITAN_FILE, 'w') { |file| file.write(YAML::dump(@@threads)) }
-      end
-
-      #
-      # Removes threads that are not living anymore
-      #
-      def remove_dead_threads
-        @@threads.each_value { |thread| @@threads.delete(thread.id) unless thread.alive? }
-      end
-    end
-  end
-end