NAME

KinoSearch::Util::ToolSet - strict, warnings, and more

PRIVATE CLASS

This is a private class and the interface may change radically and without warning. Do not use it on its own.

SYNOPSIS

use KinoSearch::Util::ToolSet;

DESCRIPTION

KinoSearch::Util::ToolSet uses David Golden's ToolSet module to create a default environment and replace several lines of code at the top of each module with one. The line...

use KinoSearch::Util::ToolSet;

... is effectively an alias for...

use strict;   # strict and warnings really are turned on!
use warnings;
use bytes; no bytes;
use Carp qw( carp croak cluck confess );
use Scalar::Util qw( 
                     refaddr
                     blessed 
                     dualvar 
                     isweak 
                     refaddr 
                     reftype 
                     tainted 
                     weaken 
                     isvstring 
                     looks_like_number 
                     );
use KinoSearch qw( K_DEBUG kdump );
use KinoSearch::Util::VerifyArgs qw( verify_args a_isa_b );

Two issues deserve special attention.

First, the use bytes; no bytes; combo ensures that subroutines within the bytes:: namespace, such as bytes::length, will be available, while still keeping character semantics enabled by default -- so regexes work as expected, etc.

Second, the use KinoSearch line does a LOT more than it appears to at first glance -- it loads ALL of the XS routines in the entire KinoSearch suite. See KinoSearch::Docs::DevGuide for an explanation.

COPYRIGHT

Copyright 2005-2006 Marvin Humphrey

LICENSE, DISCLAIMER, BUGS, etc.

See KinoSearch version 0.05_03.