GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
ShipIt::State(3) User Contributed Perl Documentation ShipIt::State(3)

ShipIt::State - holds state between steps

An instance of type ShipIt::State is passed to each ShipIt::Step's 'run' method.

   $state->set_version("1.34");

Set the version of this release. (is done by ShipIt::Step::FindVersion, early in the process, but perhaps you want to write your own version-detecting/selecting step)

   $ver = $state->version

Returns version of release, or dies if not yet set.

    $pt = $state->pt;

Detects/instantiates this project's type (Perl vs autoconf, etc) and returns a newly-created or previously-cached ShipIt::ProjectType instance.

    $vc = $state->vc;

Detects/instantiates the version control system in use (svn, svk, etc) and returns a newly-created or previously-cached ShipIt::VC instance.

    $state->add_changelog_file("CHANGES");

Push a changelog file into the known list.

    @files = $state->changelog_files;

Returns list of known changelog files.

   $dry = $state->dry_run;

Accessor for "dry run" flag. If set, you shouldn't actually commit/tag/upload stuff... just test if everything would've succeeded.

   $dry = $state->skip_tests;

Accessor for "skip tests" flag. If set, you should skip tests. Presumably user already ran shipit, tests passed, and then some later step failed, and they want to ship quickly, without running entire test suite again.

  $state->set_trial(1);
  $trial = $state->trial;

Setter/getter for whether to make a TRIAL release for PAUSE. Unlike using "_" in version strings to indicate developer releases, this way you can keep the normal version numbers everywhere in your code, but the final distribution file is renamed to "-{version}-TRIAL.tar.gz" before uploading, which indicates that this is a trial/beta release.

   $state->set_distfile("foo.tar.gz");
   $file = $state->distfile;

Setter/getter for where the final distfile is. Useful so steps that need to build the whole tree (say, in an early "make test" phase), can keep it around, and later steps (like "make dist") can access it, without recompiling everything again.

2013-02-08 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.