rrd-ffi 0.2.13 → 0.2.14

data/README.rdoc

@@ -8,11 +8,11 @@ rrd-ffi uses ffi to wrap the librrd C bindings, not system calls.
 
 IMPORTANT: You need librrd installed (version 1.3.1 or above, version 1.4.2 RECOMMENDED) in your system for this gem to work
 
-= Basics 
+= Basics
 
 Here's what you need to know before starting.
 
-== Installation 
+== Installation
 
 === Notes
 
@@ -49,7 +49,7 @@ From source:
   rrd = RRD::Base.new("myrrd.rrd")
   # Restoring a rrd file from xml
   # Notice that all '-' on flags become '_' like --force-overwrite => :force_overwrite
-  rrd.restore("myrrd.xml", :force_overwrite => true) 
+  rrd.restore("myrrd.xml", :force_overwrite => true)
 
   # Fetching data from rrd
   rrd.fetch(:average).each {|line| puts line.inspect}
@@ -59,11 +59,11 @@ From source:
 
   # Updating rrd (this rrd example has 3 datasources)
   rrd.update Time.now, 500, nil, 30
-  
-  # Looking for the first and last entered dates 
+
+  # Looking for the first and last entered dates
   puts rrd.starts_at
   puts rrd.ends_at
-  
+
   # Growing or Shrinking a rrd_file (create a resize.rrd file)
   # You need to know the RRA number (starting from 0)
   rrd.resize(0, :grow => 10.days)
@@ -73,6 +73,9 @@ From source:
   rrd.fetch(:unknown_function) # should return false
   puts rrd.error
 
+  # For raising exceptions in methods, use the '!' at its end
+  rrd.fetch!(:unknown_function) # raises an error
+
 === DSLs
 
   # Creating a new rrd
@@ -81,7 +84,7 @@ From source:
     datasource "memory", :type => :gauge, :heartbeat => 10.minutes, :min => 0, :max => :unlimited
     archive :average, :every => 10.minutes, :during => 1.year
   end
-  
+
   # Generating a graph with memory and cpu usage from myrrd.rrd file
   RRD.graph "graph.png", :title => "Test", :width => 800, :height => 250, :color => ["FONT#000000", "BACK#FFFFFF"] do
     area "myrrd.rrd", :cpu0 => :average, :color => "#00FF00", :label => "CPU 0"
@@ -89,6 +92,13 @@ From source:
     line "myrrd.rrd", :memory => :average, :color => "#0000FF", :label => "Memory"
   end
 
+  # Generating a graph or raising an exception if something bad happens
+  RRD.graph! "graph.png", :title => "Test", :width => 800, :height => 250, :color => ["FONT#000000", "BACK#FFFFFF"] do
+    area "myrrd.rrd", :cpu0 => :average, :color => "#00FF00", :label => "CPU 0"
+    line "myrrd.rrd", :cpu0 => :average, :color => "#007f3f"
+    line "myrrd.rrd", :memory => :average, :color => "#0000FF", :label => "Memory"
+  end
+
   # Generating a more complex graph using advanced DSL
   RRD.graph IMG_FILE, :title => "Test", :width => 800, :height => 250, :start => Time.now - 1.day, :end => Time.now do
     for_rrd_data "cpu0", :cpu0 => :average, :from => RRD_FILE
@@ -121,7 +131,7 @@ Normal methods return false on error, or the expected result otherwise.
 	# Fetching average data
   RRD::Wrapper.fetch "myrrd.rrd", "AVERAGE"
 
-	# Looking for the first entered dates 
+	# Looking for the first entered dates
   RRD::Wrapper.first "myrrd.rrd"
 
 	# Creating a graph
@@ -130,21 +140,21 @@ Normal methods return false on error, or the expected result otherwise.
 	# Getting info on a rrd file
   RRD::Wrapper.info("myrrd.rrd")
 
-  # Looking for the last entered dates 
+  # Looking for the last entered dates
 	RRD::Wrapper.last "myrrd.rrd"
-	
-	# Getting last data inserted on a rrd 
+
+	# Getting last data inserted on a rrd
 	RRD::Wrapper.last_update "myrrd.rrd"
-	
+
 	# Resizing a rrd file RRA
   RRD::Wrapper.resize "myrrd.rrd", "0", "GROW", "10"
-	
+
   # Restoring a rrd file from xml
   RRD::Wrapper.restore "myrrd.xml", "myrrd.rrd"
 
 	# Tuning a rrd file
   RRD::Wrapper.tune "myrrd.rrd", "--minimum", "memory:5"
-  
+
   # Updating rrd with a new value
   RRD::Wrapper.update "myrrd.rrd", "N:500000000"
 

data/lib/rrd/graph.rb

@@ -5,7 +5,7 @@ module RRD
     DEF_OPTIONS= [:from]
     GRAPH_FLAGS = [:only_graph, :full_size_mode, :rigid, :alt_autoscale, :no_gridfit,
              :alt_y_grid, :logarithmic, :no_legend, :force_rules_legend, :lazy,
-             :pango_markup, :slope_mode, :interlaced] 
+             :pango_markup, :slope_mode, :interlaced, :disable_rrdtool_tag]
     
     attr_accessor :output, :parameters, :definitions, :printables
     
@@ -123,4 +123,4 @@ module RRD
       printable
     end
   end
-end
+end

data/lib/rrd/version.rb

@@ -3,7 +3,7 @@ module RRD
   module Version  #:nodoc: all
     MAJOR = 0
     MINOR = 2
-    PATCH = 13
+    PATCH = 14
     STRING = "#{MAJOR}.#{MINOR}.#{PATCH}"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rrd-ffi
 version: !ruby/object:Gem::Version
-  version: 0.2.13
+  version: 0.2.14
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-13 00:00:00.000000000 Z
+date: 2013-02-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
-  requirement: &2156342600 !ruby/object:Gem::Requirement
+  requirement: &2153919560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2156342600
+  version_requirements: *2153919560
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &2156354480 !ruby/object:Gem::Requirement
+  requirement: &2153918020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2156354480
+  version_requirements: *2153918020
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2156362240 !ruby/object:Gem::Requirement
+  requirement: &2153913680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,7 +43,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2156362240
+  version_requirements: *2153913680
 description: Provides bindings for many RRD functions (using ffi gem and librrd),
   as well as DSLs for graphic and rrd building. You must have librrd in your system!
 email: