Changeset 16465

Timestamp:

07/25/08 23:03:14 (5 years ago)

Author:

hanekomu

Message:

continued to update distribution to standard style

Location:

lang/perl/Data-Semantic/trunk

Files:

• Changes (modified) (1 diff)
• MANIFEST (modified) (2 diffs)
• MANIFEST.SKIP (modified) (3 diffs)
• Makefile.PL (modified) (1 diff)
• lib/Data/Semantic.pm (modified) (2 diffs)
• lib/Data/Semantic/RegexpAdapter.pm (modified) (3 diffs)
• lib/Data/Semantic/Test.pm (modified) (2 diffs)

lang/perl/Data-Semantic/trunk/Changes

@@ -1 +1 @@
 Revision history for Perl extension Data-Semantic
+
+0.04  Thu Jul 25 15:27:43 CEST 2008 (Marcel Gruenauer <marcel@cpan.org>)
+     - Changed dist style and Changes back to standard. People didn't like it -
+       the nail that sticks out gets hammered down.
+     - Added standard test files; this will also help with CPANTS.
 
 0.03  Thu, 29 May 2008 12:03:26 -0000 (Marcel Gruenauer <marcel@cpan.org>)

lang/perl/Data-Semantic/trunk/MANIFEST

@@ -9 +9 @@
 inc/Module/Install/Makefile.pm
 inc/Module/Install/Metadata.pm
-inc/Module/Install/StandardTests.pm
-inc/Module/Install/Template.pm
 inc/Module/Install/Win32.pm
 inc/Module/Install/WriteAll.pm
@@ -16 +14 @@
 inc/Test/Differences.pm
 inc/Test/More.pm
-inc/UNIVERSAL/require.pm
 lib/Data/Semantic.pm
 lib/Data/Semantic/RegexpAdapter.pm

lang/perl/Data-Semantic/trunk/MANIFEST.SKIP

@@ -10 +10 @@
 ^Build$
 ^blib/
+^pm_to_blib/
 ^_build/
 ^MakeMaker-\d
@@ -27 +28 @@
 \.old$
 \.swp$
+\.tar$
+\.tar\.gz$
 ^#.*#$
 ^\.#
@@ -35 +38 @@
 core
 ^var/
-local/

lang/perl/Data-Semantic/trunk/Makefile.PL

@@ -11 +11 @@
 requires 'Test::CompanionClasses' => '0.03';
 
-build_requires 'Test::Differences';
-build_requires 'Test::More' => '0.70';
+recommends 'Test::Pod';
+recommends 'Test::Pod::Coverage';
 
-process_templates(
-    first_year => 2007,
-    rest_from  => "$ENV{HOME}/.mitlib/standard_pod",
-    start_tag  => '{%',
-    end_tag    => '%}',
-);
+test_requires 'Test::Differences';
+test_requires 'Test::More' => '0.70';
+test_requires 'Test::Compile';
 
-use_standard_tests(without => 'pod_coverage');
 auto_install;
 auto_include;

lang/perl/Data-Semantic/trunk/lib/Data/Semantic.pm

@@ -42 +42 @@
 __END__
 
-{% USE p = PodGenerated %}
+
 
 =head1 NAME
 
-{% p.package %} - Common API for data with semantics attached to them
+Data::Semantic - Common API for data with semantics attached to them
 
 =head1 SYNOPSIS
 
-    {% p.package %}->new;
+    Data::Semantic->new;
 
 =head1 DESCRIPTION
@@ -88 +88 @@
 =over 4
 
-{% p.write_methods %}
+=item new
+
+    my $obj = Data::Semantic->new;
+    my $obj = Data::Semantic->new(%args);
+
+Creates and returns a new object. The constructor will accept as arguments a
+list of pairs, from component name to initial value. For each pair, the named
+component is initialized by calling the method of the same name with the given
+value. If called with a single hash reference, it is dereferenced and its
+key/value pairs are set as described before.
 
 =back
 
-{% p.write_inheritance %}
+Data::Semantic inherits from L<Class::Accessor::Complex>.
 
-{% PROCESS standard_pod %}
+The superclass L<Class::Accessor::Complex> defines these methods and
+functions:
+
+    mk_abstract_accessors(), mk_array_accessors(), mk_boolean_accessors(),
+    mk_class_array_accessors(), mk_class_hash_accessors(),
+    mk_class_scalar_accessors(), mk_concat_accessors(),
+    mk_forward_accessors(), mk_hash_accessors(), mk_integer_accessors(),
+    mk_new(), mk_object_accessors(), mk_scalar_accessors(),
+    mk_set_accessors(), mk_singleton()
+
+The superclass L<Class::Accessor> defines these methods and functions:
+
+    _carp(), _croak(), _mk_accessors(), accessor_name_for(),
+    best_practice_accessor_name_for(), best_practice_mutator_name_for(),
+    follow_best_practice(), get(), make_accessor(), make_ro_accessor(),
+    make_wo_accessor(), mk_accessors(), mk_ro_accessors(),
+    mk_wo_accessors(), mutator_name_for(), set()
+
+The superclass L<Class::Accessor::Installer> defines these methods and
+functions:
+
+    install_accessor()
+
+=head1 BUGS AND LIMITATIONS
+
+No bugs have been reported.
+
+Please report any bugs or feature requests through the web interface at
+L<http://rt.cpan.org>.
+
+=head1 INSTALLATION
+
+See perlmodinstall for information and options on installing Perl modules.
+
+=head1 AVAILABILITY
+
+The latest version of this module is available from the Comprehensive Perl
+Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN
+site near you. Or see <http://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>.
+
+=head1 AUTHORS
+
+Marcel GrE<uuml>nauer, C<< <marcel@cpan.org> >>
+
+=head1 COPYRIGHT AND LICENSE
+
+Copyright 2007-2008 by the authors.
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
 
 =cut

lang/perl/Data-Semantic/trunk/lib/Data/Semantic/RegexpAdapter.pm

@@ -80 +80 @@
 __END__
 
-{% USE p = PodGenerated %}
+
 
 =head1 NAME
 
-{% p.package %} - Adapter for Regexp::Common patterns
+Data::Semantic::RegexpAdapter - Adapter for Regexp::Common patterns
 
 =head1 SYNOPSIS
 
-    {% p.package %}->new;
+    Data::Semantic::RegexpAdapter->new;
 
 =head1 DESCRIPTION
@@ -99 +99 @@
 =over 4
 
-{% p.write_methods %}
+=item clear_keep
+
+    $obj->clear_keep;
+
+Clears the boolean value by setting it to 0.
+
+=item clear_kept
+
+    $obj->clear_kept;
+
+Deletes all keys and values from the hash.
+
+=item clear_re
+
+    $obj->clear_re;
+
+Clears the value.
+
+=item delete_kept
+
+    $obj->delete_kept(@keys);
+
+Takes a list of keys and deletes those keys from the hash.
+
+=item exists_kept
+
+    if ($obj->exists_kept($key)) { ... }
+
+Takes a key and returns a true value if the key exists in the hash, and a
+false value otherwise.
+
+=item keep
+
+    $obj->keep($value);
+    my $value = $obj->keep;
+
+If called without an argument, returns the boolean value (0 or 1). If called
+with an argument, it normalizes it to the boolean value. That is, the values
+0, undef and the empty string become 0; everything else becomes 1.
+
+=item keep_clear
+
+    $obj->keep_clear;
+
+Clears the boolean value by setting it to 0.
+
+=item keep_set
+
+    $obj->keep_set;
+
+Sets the boolean value to 1.
+
+=item kept
+
+    my %hash     = $obj->kept;
+    my $hash_ref = $obj->kept;
+    my $value    = $obj->kept($key);
+    my @values   = $obj->kept([ qw(foo bar) ]);
+    $obj->kept(%other_hash);
+    $obj->kept(foo => 23, bar => 42);
+
+Get or set the hash values. If called without arguments, it returns the hash
+in list context, or a reference to the hash in scalar context. If called
+with a list of key/value pairs, it sets each key to its corresponding value,
+then returns the hash as described before.
+
+If called with exactly one key, it returns the corresponding value.
+
+If called with exactly one array reference, it returns an array whose elements
+are the values corresponding to the keys in the argument array, in the same
+order. The resulting list is returned as an array in list context, or a
+reference to the array in scalar context.
+
+If called with exactly one hash reference, it updates the hash with the given
+key/value pairs, then returns the hash in list context, or a reference to the
+hash in scalar context.
+
+=item kept_clear
+
+    $obj->kept_clear;
+
+Deletes all keys and values from the hash.
+
+=item kept_delete
+
+    $obj->kept_delete(@keys);
+
+Takes a list of keys and deletes those keys from the hash.
+
+=item kept_exists
+
+    if ($obj->kept_exists($key)) { ... }
+
+Takes a key and returns a true value if the key exists in the hash, and a
+false value otherwise.
+
+=item kept_keys
+
+    my @keys = $obj->kept_keys;
+
+Returns a list of all hash keys in no particular order.
+
+=item kept_values
+
+    my @values = $obj->kept_values;
+
+Returns a list of all hash values in no particular order.
+
+=item keys_kept
+
+    my @keys = $obj->keys_kept;
+
+Returns a list of all hash keys in no particular order.
+
+=item re
+
+    my $value = $obj->re;
+    $obj->re($value);
+
+A basic getter/setter method. If called without an argument, it returns the
+value. If called with a single argument, it sets the value.
+
+=item re_clear
+
+    $obj->re_clear;
+
+Clears the value.
+
+=item set_keep
+
+    $obj->set_keep;
+
+Sets the boolean value to 1.
+
+=item values_kept
+
+    my @values = $obj->values_kept;
+
+Returns a list of all hash values in no particular order.
 
 =item LOAD
@@ -138 +276 @@
 =back
 
-{% p.write_inheritance %}
-
-{% PROCESS standard_pod %}
+Data::Semantic::RegexpAdapter inherits from L<Data::Semantic> and
+L<Data::Inherited>.
+
+The superclass L<Data::Semantic> defines these methods and functions:
+
+    new(), is_valid(), normalize()
+
+The superclass L<Class::Accessor::Complex> defines these methods and
+functions:
+
+    mk_abstract_accessors(), mk_array_accessors(), mk_boolean_accessors(),
+    mk_class_array_accessors(), mk_class_hash_accessors(),
+    mk_class_scalar_accessors(), mk_concat_accessors(),
+    mk_forward_accessors(), mk_hash_accessors(), mk_integer_accessors(),
+    mk_new(), mk_object_accessors(), mk_scalar_accessors(),
+    mk_set_accessors(), mk_singleton()
+
+The superclass L<Class::Accessor> defines these methods and functions:
+
+    _carp(), _croak(), _mk_accessors(), accessor_name_for(),
+    best_practice_accessor_name_for(), best_practice_mutator_name_for(),
+    follow_best_practice(), get(), make_accessor(), make_ro_accessor(),
+    make_wo_accessor(), mk_accessors(), mk_ro_accessors(),
+    mk_wo_accessors(), mutator_name_for(), set()
+
+The superclass L<Class::Accessor::Installer> defines these methods and
+functions:
+
+    install_accessor()
+
+The superclass L<Data::Inherited> defines these methods and functions:
+
+    every_hash(), every_list(), flush_every_cache_by_key()
+
+=head1 BUGS AND LIMITATIONS
+
+No bugs have been reported.
+
+Please report any bugs or feature requests through the web interface at
+L<http://rt.cpan.org>.
+
+=head1 INSTALLATION
+
+See perlmodinstall for information and options on installing Perl modules.
+
+=head1 AVAILABILITY
+
+The latest version of this module is available from the Comprehensive Perl
+Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN
+site near you. Or see <http://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>.
+
+=head1 AUTHORS
+
+Marcel GrE<uuml>nauer, C<< <marcel@cpan.org> >>
+
+=head1 COPYRIGHT AND LICENSE
+
+Copyright 2007-2008 by the authors.
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
 
 =cut

lang/perl/Data-Semantic/trunk/lib/Data/Semantic/Test.pm

@@ -79 +79 @@
 __END__
 
-{% USE p = PodGenerated %}
+
 
 =head1 NAME
 
-{% p.package %} - Testing Data::Semantic objects
+Data::Semantic::Test - Testing Data::Semantic objects
 
 =head1 SYNOPSIS
 
-    {% p.package %}->new;
+    Data::Semantic::Test->new;
 
 =head1 DESCRIPTION
@@ -149 +149 @@
 =over 4
 
-{% p.write_methods %}
+
 
 =back
 
-{% p.write_inheritance %}
-
-{% PROCESS standard_pod %}
+Data::Semantic::Test inherits from L<Test::CompanionClasses::Base>.
+
+The superclass L<Test::CompanionClasses::Base> defines these methods and
+functions:
+
+    new(), clear_package(), make_real_object(), package(), package_clear(),
+    planned_test_count()
+
+The superclass L<Class::Accessor::Complex> defines these methods and
+functions:
+
+    mk_abstract_accessors(), mk_array_accessors(), mk_boolean_accessors(),
+    mk_class_array_accessors(), mk_class_hash_accessors(),
+    mk_class_scalar_accessors(), mk_concat_accessors(),
+    mk_forward_accessors(), mk_hash_accessors(), mk_integer_accessors(),
+    mk_new(), mk_object_accessors(), mk_scalar_accessors(),
+    mk_set_accessors(), mk_singleton()
+
+The superclass L<Class::Accessor> defines these methods and functions:
+
+    _carp(), _croak(), _mk_accessors(), accessor_name_for(),
+    best_practice_accessor_name_for(), best_practice_mutator_name_for(),
+    follow_best_practice(), get(), make_accessor(), make_ro_accessor(),
+    make_wo_accessor(), mk_accessors(), mk_ro_accessors(),
+    mk_wo_accessors(), mutator_name_for(), set()
+
+The superclass L<Class::Accessor::Installer> defines these methods and
+functions:
+
+    install_accessor()
+
+The superclass L<Data::Inherited> defines these methods and functions:
+
+    every_hash(), every_list(), flush_every_cache_by_key()
+
+=head1 BUGS AND LIMITATIONS
+
+No bugs have been reported.
+
+Please report any bugs or feature requests through the web interface at
+L<http://rt.cpan.org>.
+
+=head1 INSTALLATION
+
+See perlmodinstall for information and options on installing Perl modules.
+
+=head1 AVAILABILITY
+
+The latest version of this module is available from the Comprehensive Perl
+Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN
+site near you. Or see <http://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>.
+
+=head1 AUTHORS
+
+Marcel GrE<uuml>nauer, C<< <marcel@cpan.org> >>
+
+=head1 COPYRIGHT AND LICENSE
+
+Copyright 2007-2008 by the authors.
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
 
 =cut