statsmix 0.1.7 → 0.1.8

data/README.md

@@ -0,0 +1,75 @@
+A Ruby gem for the StatsMix API - http://www.statsmix.com/developers
+
+## What is StatsMix?
+
+StatsMix makes it easy to track, chart, and share application and business metrics. Use StatsMix to:
+
+* Log every time a particular event happens (such as a user creating a new blog post)
+* View a real-time chart of these application events in StatsMix's web UI
+* Share the charts with users inside and outside your organization
+* Create and share custom dashboards that aggregate multiple metrics together
+    * Example dashboard: http://www.statsmix.com/d/0e788d59208900e7e3bc
+    * Example embedded dashboard: http://www.statsmix.com/example-embedded
+
+To get started, you'll need an API key for StatsMix. You can get a free developer account here: http://www.statsmix.com/try?plan=developer
+
+Full gem documentation is at  http://www.statsmix.com/developers/ruby_gem
+
+## Quick Start
+
+Install the gem from the command line.
+
+	gem install statsmix
+
+The basic pattern in your code:
+
+	require "statsmix"
+	StatsMix.api_key = "YOUR API KEY"
+	StatsMix.track(name_of_metric, value = 1, options = {})
+
+Push a stat with the value 1 (default) to a metric called "My First Metric":
+
+	StatsMix.track("My First Metric")
+
+Push the value 20:
+
+	StatsMix.track("My First Metric",20)
+
+Add metadata via the `:meta` option in the options hash. Metadata is useful for adding granularity to your stats. This example tracks file uploads by file type:
+
+	StatsMix.track("File Uploads", 1, {:meta => {"file type" => "PDF"}})
+
+If you need the ability to update a stat after the fact, you can pass in a unique identifier `ref_id` (scoped to that metric, so you can use the same `ref_id` across metrics). This example use's today's date, which is useful if you want to do intraday updates to a stat:
+
+	StatsMix.track("File Uploads", 1, {:ref_id => Time.now.strftime('%Y-%m-%d'), :meta => {"file type" => "PDF"}})
+
+If you need to timestamp the stat for something other than now, pass in a UTC datetime called `:generated_at`:
+
+	StatsMix.track("File Uploads", 1, {:generated_at => 1.days.ago})
+
+To turn off tracking in your development environment:
+
+	StatsMix.ignore = true
+
+To redirect all stats in dev environment to a test metric:
+
+	StatsMix.test_metric_name = "My Test Metric"
+
+## More Documentation
+
+The StatsMix gem supports all the methods documented at http://www.statsmix.com/developers/documentation
+
+## Contributing to statsmix
+ 
+* 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 StatsMix, Inc. See LICENSE.txt for further details.

data/VERSION

@@ -1 +1 @@
-0.1.7
+0.1.8

data/lib/statsmix.rb

@@ -5,7 +5,7 @@ require 'json'
 class StatsMix
   
   BASE_URI = 'https://statsmix.com/api/v2/'
-  
+  RootCA = '/etc/ssl/certs'
   GEM_VERSION = File.exist?('../VERSION') ? File.read('../VERSION') : ""
 
   # Track an event
@@ -263,10 +263,20 @@ class StatsMix
     if @api_key.nil?
       raise "API key not set. You must set it first with StatsMix.api_key = [your api key]"
     end
+    
     # Resources available: stats, metrics, TODO: profiles
     @url = URI.parse(BASE_URI + resource)
     @connection = Net::HTTP.new(@url.host, @url.port)
     @connection.use_ssl = (@url.scheme == 'https')
+    
+    if File.directory? RootCA
+      @connection.ca_path = RootCA
+      @connection.verify_mode = OpenSSL::SSL::VERIFY_PEER
+      @connection.verify_depth = 5
+    else
+      @connection.verify_mode = OpenSSL::SSL::VERIFY_NONE
+    end
+    
     @request = Hash.new
     @request["User-Agent"] = @user_agent
     @params = Hash.new

data/statsmix.gemspec

@@ -5,23 +5,23 @@
 
 Gem::Specification.new do |s|
   s.name = %q{statsmix}
-  s.version = "0.1.7"
+  s.version = "0.1.8"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Tom Markiewicz", "Derek Scruggs"]
-  s.date = %q{2011-07-06}
+  s.date = %q{2011-08-09}
   s.description = %q{A Ruby gem for the StatsMix API - http://www.statsmix.com/developers}
   s.email = ["tmarkiewicz@gmail.com", "me@derekscruggs.com"]
   s.extra_rdoc_files = [
     "LICENSE.txt",
-    "README.txt"
+    "README.md"
   ]
   s.files = [
     ".document",
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
-    "README.txt",
+    "README.md",
     "Rakefile",
     "VERSION",
     "lib/statsmix.rb",

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: statsmix
 version: !ruby/object:Gem::Version 
-  hash: 21
+  hash: 11
   prerelease: false
   segments: 
   - 0
   - 1
-  - 7
-  version: 0.1.7
+  - 8
+  version: 0.1.8
 platform: ruby
 authors: 
 - Tom Markiewicz
@@ -16,11 +16,14 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-06 00:00:00 -06:00
+date: 2011-08-09 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  type: :development
+  prerelease: false
+  name: shoulda
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -29,12 +32,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
   type: :development
-  name: shoulda
   prerelease: false
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  name: bundler
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -45,12 +48,12 @@ dependencies:
         - 0
         - 0
         version: 1.0.0
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
   type: :development
-  name: bundler
   prerelease: false
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  name: jeweler
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -61,12 +64,12 @@ dependencies:
         - 5
         - 1
         version: 1.5.1
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
   type: :development
-  name: jeweler
   prerelease: false
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  name: rcov
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
@@ -75,12 +78,12 @@ dependencies:
         segments: 
         - 0
         version: "0"
+  requirement: *id004
+- !ruby/object:Gem::Dependency 
   type: :development
-  name: rcov
   prerelease: false
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  name: json
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -91,10 +94,7 @@ dependencies:
         - 5
         - 1
         version: 1.5.1
-  type: :development
-  name: json
-  prerelease: false
-  version_requirements: *id005
+  requirement: *id005
 description: A Ruby gem for the StatsMix API - http://www.statsmix.com/developers
 email: 
 - tmarkiewicz@gmail.com
@@ -105,13 +105,13 @@ extensions: []
 
 extra_rdoc_files: 
 - LICENSE.txt
-- README.txt
+- README.md
 files: 
 - .document
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
-- README.txt
+- README.md
 - Rakefile
 - VERSION
 - lib/statsmix.rb

data/README.txt

@@ -1,59 +0,0 @@
-A Ruby gem for the StatsMix API - http://www.statsmix.com/developers
-
-WARNING: This gem is undergoing rapid improvements. Please use caution and check for updates accordingly.
-
-StatsMix makes it easy to track, chart, and share application and business metrics.
-
-To get started, you'll need a API key for StatsMix. You can get a free developer account here: http://www.statsmix.com/try?plan=developer
-
-Full gem documentation is at  http://www.statsmix.com/developers/ruby_gem
-
-== Quick Start ==
-
-#install the gem from the command line
-gem install statsmix
-
-#in your code
-require "statsmix"
-StatsMix.api_key = "YOUR API KEY"
-
-#push a stat with the value 1 (default) to a metric called "My First Metric"
-StatsMix.track("My First Metric")
-
-#push the value 20
-StatsMix.track("My First Metric",20)
-
-#add metadata - you can use this to add granularity to your chart via Chart Settings in StatsMix
-#this example tracks file uploads by file type
-StatsMix.track("File Uploads", 1, {:meta => {"file type" => "PDF"}})
-
-#if you need the ability to update a stat after the fact, you can pass in a unique identifier ref_id (scoped to that metric)
-StatsMix.track("File Uploads", 1, {:ref_id => "abc123", :meta => {"file type" => "PDF"}})
-
-#if you need to timestamp the stat for something other than now, pass in a UTC datetime called generated_at
-StatsMix.track("File Uploads", 1, {:generated_at => 1.days.ago })
-
-#to turn off tracking in your development environment
-StatsMix.ignore = true
-
-#to redirect all stats in dev environment to a test metric
-StatsMix.test_metric_name = "My Test Metric"
-
-== More Documentation ==
-
-The StatsMix gem supports all the methods documented at http://www.statsmix.com/developers/documentation
-
-== Contributing to statsmix
- 
-* 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 StatsMix, Inc. See LICENSE.txt for further details.