tremolo 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ac99676944c67bc64c93a2297aa481518119d8cf
-  data.tar.gz: a4f670b8c599a4f4ea57208f4647a82cbc77cd6e
+  metadata.gz: d2f39dfdbc6fdc05a0fd4e28748784ca1189acf9
+  data.tar.gz: b2081766249b24d542c21250c915a9d3510517a9
 SHA512:
-  metadata.gz: 13ea2e22c5062d2c91626b90776126ee8fd15272197ea03621128b04ede7903acedfd0503fc9d85715ad12a264638d18bd9fbb153d0c23fb5dda768302bba993
-  data.tar.gz: 606d586a2bc999e0c7cc5e276609421bf449265f0e89fbabeb4d7115508c58b86bab5885d5feb95b7877f4321358efbd0e70c64d6ce860d68a14db6ca855b2de
+  metadata.gz: 6fa6eea5b0b46095592ac292ca44c4918245688b38dd29c903e397b88a9ed09588e843348564c1f2dc98b128bf964089e789028f8fbc4b390c981f902bca32e3
+  data.tar.gz: c95cb3da2fd558c8784525317172e55bf8fde339ed35f37b11f2add9b99cc21794631ea86ff817c4564cef1b0e7662c73d92698b4c3b58797dadf31bf2b1b89b

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## Tremolo 0.2.1 ##
+
+*   Add `Tremolo.fetch` in place of using Celluloid
+
+    *Tony Pitale*
+
 ## Tremolo 0.2.0 ##
 
 *   Adds tags to `Tracker` and `Series`

data/README.md

@@ -16,28 +16,32 @@ Or install it yourself as:
 
     $ gem install tremolo
 
-## Is it any good?
+## Is it any good? ##
 
 It's getting there, but some of the nuance of the method API and Celluloid's behavior are still being worked out. I'll let you know when it's settled down a bit more.
 
-## Usage
+## Usage ##
 
 ```ruby
-# Get an unsupervised tracker
-tracker = Tremolo.tracker('0.0.0.0', 4444)
+# Start by creating a supervised tracker
+#   and point it at our InfluxDB server's UDP port
+Tremolo.supervised_tracker(:tracker, '0.0.0.0', 4444)
 
 # options that can be set on the tracker:
 # namespace, a string prefix for all series names on this tracker, joined with '.' (default="")
-tracker = Tremolo.tracker('0.0.0.0', 4444, namespace: 'appname')
+tracker = Tremolo.supervised_tracker(:tracker, '0.0.0.0', 4444, namespace: 'appname')
 
-# tracker is a Celluloid Actor, it will not be GC'd like you would expect so I'd advise against doing it this way.
+# whenever you want to use this tracker, you can fetch it
+tracker = Tremolo.fetch(:tracker)
 
-# Because we're using celluloid, we probably want to create a supervised tracker
-Tremolo.supervised_tracker(:tracker, '0.0.0.0', 4444, namespace: 'appname')
+# if there is no tracker by this name, it will return a NoopTracker
+#   useful when in testing or development
+tracker = Tremolo.fetch(:notreallythere)
+```
 
-# whenever you want to use this supervised tracker, you can always ask Celluloid
-tracker = Celluloid::Actor[:tracker]
+Now that we have our tracker, let's send some data to InfluxDB:
 
+```ruby
 # Write a point to 'series-name' series
 tracker.write_point('series-name', {:value => 121, :otherdata => 998142})
 
@@ -72,7 +76,7 @@ value = series.time { Net::HTTP.get(URI('http://google.com')) }
 
 ## Tags ##
 
-A Hash of `tags` data can be passed to `increment`, `decrement`, `timing`, and `time`, and `write_point`, as the last argument.
+A Hash of `tags` data can be passed to `increment`, `decrement`, `timing`, `time`, and `write_point`, as the last argument. Very useful for segmenting data by some "metadata".
 
 ```ruby
 series.write_point({:value => 18}, {:otherdata => 1986})
@@ -83,7 +87,7 @@ series.write_point({:value => 18}, {:otherdata => 1986})
 Since version 0.7.1 of InfluxDB, multiple databases can be configured for different UDP ports. All
 tracking in Tremolo is done by way of UDP.
 
-So, port 4444 from the above goes to one database as configured, and port 8191 could go to a second DB.
+So, port 4444 from the examples above goes to one database as configured, and port 8191 could go to a second DB.
 
 This somewhat negates the need for the `namespace` option to be set for a `tracker` since each application
 could be configured to go to its own InfluxDB database.

data/lib/tremolo.rb

@@ -16,14 +16,18 @@ module Tremolo
   end
 
   def supervised_tracker(as, host, port, options={})
-    if host.nil? || port.nil?
-      NoopTracker.new(host, port, options)
-    else
+    unless host.nil? || port.nil?
       Celluloid.supervise type: Tracker, as: as.to_sym, args: [host, port, options]
-      Celluloid::Actor[as.to_sym]
     end
+
+    fetch(as, NoopTracker.new(host, port, options))
+  end
+
+  def fetch(as, default = NoopTracker.new(nil, nil))
+    Celluloid::Actor[as.to_sym] || default
   end
 
+  module_function :fetch
   module_function :tracker
   module_function :supervised_tracker
 end

data/lib/tremolo/version.rb

@@ -1,3 +1,3 @@
 module Tremolo
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tremolo
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Tony Pitale
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-06 00:00:00.000000000 Z
+date: 2015-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: celluloid-io