Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
Bigtop::ScriptHelp::StUser3Contributed Perl DocumeBigtop::ScriptHelp::Style(3)

NAME
       Bigtop::ScriptHelp::Style - Factory for scripts'	command	line and
       standard	in handlers

SYNOPSIS
	   use Bigtop::ScriptHelp;
	   use Bigtop::ScriptHelp::Style;

	   my $style = ...

	   my $style_helper = Bigtop::ScriptHelp::Style->get_style( $style );

	   # pass this style as	the first parameter to
	   #   Bigtop::ScriptHelp->get_big_default
	   #   Bigtop::ScriptHelp->augment_tree

DESCRIPTION
       This module factors command line	argument and standard in handling out
       of scripts and ScriptHelp.  It is a simple factory.  Call "get_style"
       with the	name of	a style	module,	to receive a style suitable for
       passing to "<Bigtop::ScriptHelp-"get_big_default>> and
       "<Bigtop::ScriptHelp-"augment_tree>>.  All styles live in the
       Bigtop::ScriptHelp::Style:: namespace.  The default style is
       'Kickstart'.

       Each stye must implement	"get_db_layout"	which is the only method
       called by "Bigtop::ScriptHelp" methods.	See below for what it receives
       and returns.

METHODS
       get_style
	   Factory method.

	   Parameter: style name.  This	must be	the name of a module in	the
	   Bigtop::ScriptHelp::Style:: namespace.

	   Returns: and	object of the named style which	responds to
	   "get_db_layout".

       new Trivial constructor used internally to make an object solely	to
	   provide dispatching to "get_db_layout".  All	Styles should subclass
	   from	this class, but	they are welcome to override or	augment	"new".

SUBCLASS METHODS
       All subclasses should live in the Bigtop::ScriptHelp::Style:: namespace
       and implement one method:

       get_db_layout
	   Parameters:

	   invocant
	       usually useless

	   art all command line	args joined by spaces.	Note that flags	should
	       have already been consumed by some script.

	   tables
	       a hash reference	keyed by existing table	name, the values are
	       always 1

	   Returns: a single hash reference with these keys:

	   all_tables
	       the tables hash from the	passed in parameters with an extra key
	       for each	new table

	   new_tables
	       an array	reference of new tables	names

	   joiners
	       ( Optional )

	       an array	reference of new three way join	tables

	   foreigners
	       ( Optional )

	       a hash reference	keyed by table name storing an array reference
	       of the table's new foreign keys

AUTHOR
       Phil Crow, <crow.phil@gmail.com>

COPYRIGHT AND LICENSE
       Copyright (C) 2007, Phil	Crow

       This library is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself, either Perl	version	5.8.6 or, at
       your option, any	later version of Perl 5	you may	have available.

perl v5.32.0			  2020-08-29	  Bigtop::ScriptHelp::Style(3)
NAME | SYNOPSIS | DESCRIPTION | METHODS | SUBCLASS METHODS | AUTHOR | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Bigtop::ScriptHelp::Style&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help