tallakt-picopc 0.1.0 → 0.1.1

data/README.rdoc

@@ -16,7 +16,11 @@ To run the tests, you must install the rspec gem and the free Matrikon OPC Simul
 
 == Examples
 
-this simple example covers most functionality
+=== Simple example
+
+This simple example covers most functionality:
+
+	require 'picopc'
 
 	PicOpc.connect 'Matrikon.OPC.Simulation' do |opc|
 		# Read a variable
@@ -38,12 +42,17 @@ this simple example covers most functionality
 Note that all exceptions thrown are of the class +PicOpcException+.
 
 
+=== Without a block
+
 If you don't want to use a block you can do this:
 
 	opc = PicOpc::Client.new 'Matrikon.OPC.Simulation'
 	puts opc.read('Random.Int1')
 	opc.cleanup
 
+
+=== Cache option
+
 Sometimes you may want to tweak the :cache option
 	
 	PicOpc.connect 'Matrikon.OPC.Simulation', :cache => true { |opc| ... }
@@ -51,8 +60,29 @@ Sometimes you may want to tweak the :cache option
 Using cached reads is a lot faster, but depends on your OPC server to update the values from it's source (usually the PLC). Default behaviour is to read from the device. 
 
 
+=== Adding a common tag prefix
+
+The :prefix options allows you to add a common prefix to all tags added to the PicOpc client object
+
+	PicOpc.connect 'Matrikon.OPC.Simulation', :prefix => 'Bucket Brigade.' do |opc|
+    # prefix is added to tagname
+		opc.write('String', 'PicOpc Rules!')
+		opc['String'] = 'PicOpc Rules!'
+
+		opc.tag 'String', :bbs
+		opc.bbs = 'PicOpc Rules!'
+	end
+
+
 
 == Install
 
+If you have not yet converted to gemcutter, first perform:
+
+  [sudo] gem install gemcutter
+  [sudo] gem tumble
+
+Then:
+
 	[sudo] gem install tallakt-picopc
 

data/Rakefile

@@ -17,7 +17,7 @@ begin
     # generates an error, no big deal
     # gem.platform = Gem::Platform::WIN32
     gem.rdoc_options << '--title' << 'PicOpc -- Tiny Ruby OPC' <<
-                           '--main' << 'README' <<
+                           '--main' << 'README.rdoc' <<
                                                   '--line-numbers'
 
 

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/lib/picopc/picopc.rb

@@ -45,6 +45,7 @@ module PicOpc
         else
           @source = OPCDataSource::OPCDevice
         end
+        @prefix = options[:prefix].to_s || ''
       rescue Exception => e
         PicOpcException[e] # wrap all exceptions in this type
       end
@@ -61,7 +62,7 @@ module PicOpc
 
     def add_item(name)
       if not @items.key? name
-        @items[name] = @opc_items.AddItem(name, @handle)
+        @items[name] = @opc_items.AddItem(@prefix + name, @handle)
         @handle += 1
       end
       @items[name]

data/spec/picopc_spec.rb

@@ -8,6 +8,7 @@ describe PicOpc do
     po.read('Random.Int1').should_not be_nil
     po['Random.Int1'].should_not be_nil
   end
+
   it 'Should be able to write a tag from Matrikon.OPC.Simulator' do
     tag = 'Bucket Brigade.String'
     po = PicOpc::Client.new MATRIKON
@@ -56,4 +57,16 @@ describe PicOpc do
       m.int.should == 6
     end
   end
+
+  it 'Sould add a prefix to tag names if :prefix option is set' do
+    PicOpc.connect MATRIKON, :prefix => 'Bucket Brigade.' do |m|
+      (97..98).each do |x|
+        m['Int1'] = x
+        m['Int1'].should == x
+      end
+      m.tag :int, 'Int1'
+      m.int = 99
+      m.int.should == 99
+    end
+  end
 end

data/tallakt-picopc.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{tallakt-picopc}
-  s.version = "0.1.0"
+  s.version = "0.1.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Tallak Tveide"]
@@ -31,7 +31,7 @@ Gem::Specification.new do |s|
      "tallakt-picopc.gemspec"
   ]
   s.homepage = %q{http://github.com/tallakt/picopc}
-  s.rdoc_options = ["--charset=UTF-8", "--title", "PicOpc -- Tiny Ruby OPC", "--main", "README", "--line-numbers"]
+  s.rdoc_options = ["--charset=UTF-8", "--title", "PicOpc -- Tiny Ruby OPC", "--main", "README.rdoc", "--line-numbers"]
   s.require_paths = ["lib"]
   s.required_ruby_version = Gem::Requirement.new(">= 1.9.0")
   s.requirements = ["To run tests, you must install Matrikon OPC Simulator", "PicOpc will only run on Windows systems due to DCOM dependency"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: tallakt-picopc
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors: 
 - Tallak Tveide
@@ -54,7 +54,7 @@ rdoc_options:
 - --title
 - PicOpc -- Tiny Ruby OPC
 - --main
-- README
+- README.rdoc
 - --line-numbers
 require_paths: 
 - lib