Permalink
Browse files

importing latest updates, see Changes file.

  • Loading branch information...
barbie committed Apr 5, 2009
1 parent 42eebbc commit efbdd4efeb9f794e11bf116ced19e06d635b5881
View
@@ -1,5 +1,9 @@
# Changes log for Data::Phrasebook
+0.30 current
+ - removed 5.006 dependency
+ - upgrade to Test::CPAN::Meta.
+
0.29 02/03/2007
- RT#25089 - if delimiters are set via new(), the default settings no
longer reset in Generic.pm. (Thanks to Javier Gonzalez).
View
@@ -16,7 +16,7 @@ recommends:
Test::More: 0.47
Test::Pod: 1.00
Test::Pod::Coverage: 0.08
- Test::YAML::Meta: 0
+ Test::CPAN::Meta: 0.12
build_requires:
Test::More: 0.47
View
@@ -6,7 +6,7 @@ WriteMakefile(
'Module::Pluggable' => '2.7',
'Test::More' => '0.47',
},
- NO_META => 1,
+ NO_META => 1,
($] >= 5.005 ?
(ABSTRACT_FROM => 'lib/Data/Phrasebook.pm',
View
1 README
@@ -29,6 +29,7 @@ For testing purposes, the following modules are desireable, but not essential:
Test::Pod >= 1.00
Test::Pod::Coverage >= 0.08
Pod::Coverage
+ Test::CPAN::Meta >= 0.12
INSTALLATION
View
@@ -1,5 +1,5 @@
To see examples for this distribution, it is recommended you read the test
-scripts included under ./t, which cover basic phrasebooks and SQL phrasebooks.
+scripts included under ./t, which cover the basic usage of the modules.
I may add further examples should the need ever arise. If you have any example
scripts that use the distribution in an unusual way or make good use of all the
View
@@ -4,7 +4,7 @@ use warnings FATAL => 'all';
use base qw( Data::Phrasebook::Debug );
use Carp qw( croak );
-our $VERSION = '0.29';
+my $VERSION = '0.30';
=head1 NAME
@@ -64,7 +64,7 @@ keyword.
The SQL class allows specific database handling. Phrases are retrieved via the
query() method. The query() method internally retrieves the SQL phrase, then
-returns the statement handler object, which the user can then perform a
+returns the statement handler object, which the user can then perform a
prepare/execute/fetch/finish sequence on. For more details see
Data::Phrasebook::SQL.
@@ -172,7 +172,7 @@ as:
platform=Windows
The phrasebook object is then created and used as:
-
+
my $q = Data::Phrasebook->new(
class => 'Plain',
loader => 'Ini',
@@ -201,7 +201,7 @@ file and the dictionary passed are not the ones currently loaded.
=head2 Multiple Dictionaries
-As of version 0.25, the ability to provide prescendence over multiple
+As of version 0.25, the ability to provide prescendence over multiple
dictionaries for the same phrasebook. Using Data::Phrasebook::Loader::Ini
again as an example, the phrasebook might be laid out as:
@@ -218,7 +218,7 @@ again as an example, the phrasebook might be laid out as:
platform=Windows
The phrasebook object is then created and used as:
-
+
my $q = Data::Phrasebook->new(
class => 'Plain',
loader => 'Ini',
@@ -230,7 +230,7 @@ The phrasebook object is then created and used as:
my $platform = $q->fetch('platform'); # retrieves 'Windows'
my $network = $q->fetch('nework'); # retrieves 'WLAN'
-The first dictionary, if not specified and supported by the Loader module, is
+The first dictionary, if not specified and supported by the Loader module, is
still used as the default dictionary.
The dictionaries can be specified, or reordered, using the object method:
@@ -241,12 +241,12 @@ A subsequent reload will occur with the next fetch call.
=head1 DEDICATION
-Much of the work original class framework is from Iain's original code. My
-code was alot simpler and was tied to using just an INI data source. Merging
+Much of the work original class framework is from Iain's original code. My
+code was alot simpler and was tied to using just an INI data source. Merging
all the ideas and code together we came up with this distribution.
Unfortunately Iain died in December 2003, so he never got to see or play
-with the final working version. I can only thank him for his thoughts and
+with the final working version. I can only thank him for his thoughts and
ideas in getting this distribution into a state worthy of release.
Iain Campbell Truskett (16.07.1979 - 29.12.2003)
@@ -3,7 +3,7 @@ use strict;
use warnings FATAL => 'all';
use Carp qw( croak );
-our $VERSION = '0.29';
+my $VERSION = '0.30';
=head1 NAME
@@ -44,7 +44,7 @@ are several different levels of debugging, detailed as follows:
The first three are simple strings that are recorded during the processing.
However, the latter is specifically for dumping the contents of significant
-variables.
+variables.
Through the use of the debug() method, the debugging can be switched on and
off at significant points. The clear() method will clear the current trail of
@@ -149,7 +149,7 @@ Please see the README file.
Copyright (C) 2004-2007 Barbie for Miss Barbell Productions.
- This module is free software; you can redistribute it and/or
+ This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
The full text of the licenses can be found in the F<Artistic> and
@@ -5,7 +5,7 @@ use Data::Phrasebook::Loader;
use base qw( Data::Phrasebook::Debug );
use Carp qw( croak );
-our $VERSION = '0.29';
+my $VERSION = '0.30';
=head1 NAME
@@ -57,7 +57,7 @@ sub new {
my $self = bless {}, $class;
- # set default delimiters, in case custom delimiters
+ # set default delimiters, in case custom delimiters
# are provided in the hash
$self->{delimiters} = qr{ :(\w+) }x;
@@ -171,7 +171,7 @@ or
my @dicts = $pb->dicts( $path );
-=cut
+=cut
sub dicts {
my $self = shift;
@@ -196,7 +196,7 @@ sub dicts {
=head2 keywords
Having instantiated the C<Data::Phrasebook> object class, using the C<dict>
-attribute as required, the object can return a list of the current keywords
+attribute as required, the object can return a list of the current keywords
available (provided the plugin supports it) as:
my $pb = Data::Phrasebook->new(
@@ -214,7 +214,7 @@ or
Note the list will be a combination of the default and any named dictionary.
However, not all Loader plugins may support the second usage.
-=cut
+=cut
sub keywords {
my $self = shift;
@@ -238,7 +238,7 @@ sub keywords {
=head2 data
-Loads the data source, if not already loaded, and returns the data block
+Loads the data source, if not already loaded, and returns the data block
associated with the given key.
my $data = $self->data($key);
@@ -304,7 +304,7 @@ __END__
=head1 SEE ALSO
-L<Data::Phrasebook>,
+L<Data::Phrasebook>,
L<Data::Phrasebook::Loader>.
=head1 SUPPORT
@@ -6,7 +6,7 @@ use Carp qw( croak );
use Module::Pluggable search_path => ['Data::Phrasebook::Loader'];
-our $VERSION = '0.29';
+my $VERSION = '0.30';
=head1 NAME
@@ -4,7 +4,7 @@ use warnings FATAL => 'all';
use base qw( Data::Phrasebook::Debug );
use Carp qw( croak );
-our $VERSION = '0.29';
+my $VERSION = '0.30';
my $something = 0;
@@ -18,7 +18,7 @@ Data::Phrasebook::Loader::Base - Base loader plugin class.
=head1 DESCRIPTION
-C<Data::Phrasebook::Loader::Base> acts as a base class for phrasebook
+C<Data::Phrasebook::Loader::Base> acts as a base class for phrasebook
plugins.
=head1 CONSTRUCTOR
@@ -96,7 +96,7 @@ Please see the README file.
Copyright (C) 2004-2007 Barbie for Miss Barbell Productions.
- This module is free software; you can redistribute it and/or
+ This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
The full text of the licenses can be found in the F<Artistic> and
@@ -5,7 +5,7 @@ use base qw( Data::Phrasebook::Loader::Base Data::Phrasebook::Debug );
use Carp qw( croak );
use IO::File;
-our $VERSION = '0.29';
+my $VERSION = '0.30';
=head1 NAME
@@ -30,10 +30,10 @@ Data::Phrasebook::Loader::Text - Absract your phrases with plain text files.
=head1 DESCRIPTION
-This loader plugin implements phrasebook patterns using plain text files.
+This loader plugin implements phrasebook patterns using plain text files.
-Phrases can be contained within one or more dictionaries, with each phrase
-accessible via a unique key. Phrases may contain placeholders, please see
+Phrases can be contained within one or more dictionaries, with each phrase
+accessible via a unique key. Phrases may contain placeholders, please see
L<Data::Phrasebook> for an explanation of how to use these. Groups of phrases
are kept in a dictionary. In this implementation a single file is one
complete dictionary.
@@ -42,7 +42,7 @@ An example plain text file:
foo=Welcome to :my world. It is a nice :place.
-Within the phrase text placeholders can be used, which are then replaced with
+Within the phrase text placeholders can be used, which are then replaced with
the appropriate values once the get() method is called. The default style of
placeholders can be altered using the delimiters() method.
@@ -160,7 +160,7 @@ sub dicts {
=head2 keywords
Having instantiated the C<Data::Phrasebook> object class, using the C<file>
-and C<dict> attributes as required, the object can return a list of the
+and C<dict> attributes as required, the object can return a list of the
current keywords available as:
my $pb = Data::Phrasebook->new(
@@ -175,10 +175,10 @@ or
my @keywords = $pb->keywords( $path, $dict );
-Note that $path can either be the directory path, where $dict must be the
+Note that $path can either be the directory path, where $dict must be the
specific file name of the dictionary, or the full path of the dictionary file.
-In the second instance, the function will not load a dictionary, but can be
+In the second instance, the function will not load a dictionary, but can be
used to interrogate the contents of a known dictionary.
=cut
@@ -225,7 +225,7 @@ Please see the README file.
Copyright (C) 2004-2007 Barbie for Miss Barbell Productions.
- This module is free software; you can redistribute it and/or
+ This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
The full text of the licenses can be found in the F<Artistic> and
@@ -4,7 +4,7 @@ use warnings FATAL => 'all';
use base qw( Data::Phrasebook::Generic Data::Phrasebook::Debug );
use Carp qw( croak );
-our $VERSION = '0.29';
+my $VERSION = '0.30';
=head1 NAME
@@ -31,14 +31,14 @@ Data::Phrasebook::Plain - The Simple Phrasebook Model.
=head1 DESCRIPTION
-This module is the fallback or default phrasebook class. It doesn't do much
+This module is the fallback or default phrasebook class. It doesn't do much
except act as a very simple templating facility.
=head1 METHODS
=head2 fetch
-Retrieves the specified C<template> and substitutes any C<keywords> for
+Retrieves the specified C<template> and substitutes any C<keywords> for
C<values>.
Thus, given:
@@ -90,7 +90,7 @@ __END__
=head1 SEE ALSO
-L<Data::Phrasebook>,
+L<Data::Phrasebook>,
L<Data::Phrasebook::Generic>.
=head1 SUPPORT
Oops, something went wrong.

0 comments on commit efbdd4e

Please sign in to comment.