Change 1027
Rework structure slightly.
What was P4.so is now called
P4api.so and a new P4.rb module is added. P4api.so
contains the raw bridge to the Perforce API whilst P4.rb
contains extensions to it written purely in Ruby. Both
define and extend the P4 class and P4.rb requires P4api.so
so user code is unaffected.
The intent is to give me a place to write Ruby code rather
than having to work solely in C++.
The first method added using this new structure is
P4#method_missing, so now Perforce commands all appear as
methods on the P4 object (prefixed by "run_" ). e.g
p4 = P4.new
p4.run_info()
p4.run_users()
p4.run_protect( "-o" )
This change also adds support for shortcut methods for
form editing. fetch* and save* methods have been added as
shortcuts for "p4 <cmd> -o" and "p4 <cmd> -i" respectively.
For example:
p4 = P4.new
p4.parse_forms()
client_spec = p4.fetch_client()
client_spec[ "Owner" ] = tony
p4.save_client( client_spec )
Note that unlike the run* methods, these accessor methods
do not return an array, but return a single result - a string
normally, or a hash in parse_forms mode.
Ruby's arcane build/install system means that you have to
install the P4.rb file yourself. "make install" doesn't
take care of it.
What was P4.so is now called
P4api.so and a new P4.rb module is added. P4api.so
contains the raw bridge to the Perforce API whilst P4.rb
contains extensions to it written purely in Ruby. Both
define and extend the P4 class and P4.rb requires P4api.so
so user code is unaffected.
The intent is to give me a place to write Ruby code rather
than having to work solely in C++.
The first method added using this new structure is
P4#method_missing, so now Perforce commands all appear as
methods on the P4 object (prefixed by "run_" ). e.g
p4 = P4.new
p4.run_info()
p4.run_users()
p4.run_protect( "-o" )
This change also adds support for shortcut methods for
form editing. fetch* and save* methods have been added as
shortcuts for "p4 <cmd> -o" and "p4 <cmd> -i" respectively.
For example:
p4 = P4.new
p4.parse_forms()
client_spec = p4.fetch_client()
client_spec[ "Owner" ] = tony
p4.save_client( client_spec )
Note that unlike the run* methods, these accessor methods
do not return an array, but return a single result - a string
normally, or a hash in parse_forms mode.
Ruby's arcane build/install system means that you have to
install the P4.rb file yourself. "make install" doesn't
take care of it.