The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

stubby - commandline tool for dumping stub Perl programs sequentialized using Sub::Genius.

SYNOPSIS

    $ stubby init [--run [once|any|all]] -s|--subroutines = "sub1 sub2 sub3 ..."

Example,

    $ stubby init --run once --subroutines "init spawn threadsA criticalsectA threadsB criticalsectB combine" > ./spawn-combine.pl

DESCRIPTION

Commandline tool for generating boilerplate for use with Sub::Genius.

General Development Workflow

Most will want to use this to start their Perl script or module, the workflow over the lifetime of the program might look like this:

  • Dump program using stubby.

  • Annotate PRE ($pre in generated code) to achieve concurrent semantics (see Sub::Genius for more info).

  • Implement subroutine bodies that exist, albeit empty of anything meaningful.

  • ...

  • Profit!

  • Maintain as any other code in your arsenal.

OPTIONS

init

Subcommand, currently only one supported.

-s|--subroutines

Specify a space delimited list of subroutine names to generate stubs and a unannotated PRE.

-R|--run

Choose invocation method to use in the code. The default is once.

Options include:

once - generates code that invokes Sub::Genius::run_once

any - generates code that invokes Sub::Genius::run_any

all - generates code that invokes Sub::Genius::run_once, in a do { ... } while () loop

SEE ALSO

Sub::Genius

BUGS

Probably

COPYRIGHT AND LICENSE

perl5

AUTHOR

OODLER 577 <oodler@cpan.org</gt>