Show
Ignore:
Timestamp:
07/25/08 23:03:14 (6 years ago)
Author:
hanekomu
Message:

continued to update distribution to standard style

Location:
lang/perl/Data-Semantic/trunk
Files:
7 modified

Legend:

Unmodified
Added
Removed
  • lang/perl/Data-Semantic/trunk/Changes

    r16330 r16465  
    11Revision history for Perl extension Data-Semantic 
     2 
     30.04  Thu Jul 25 15:27:43 CEST 2008 (Marcel Gruenauer <marcel@cpan.org>) 
     4     - Changed dist style and Changes back to standard. People didn't like it - 
     5       the nail that sticks out gets hammered down. 
     6     - Added standard test files; this will also help with CPANTS. 
    27 
    380.03  Thu, 29 May 2008 12:03:26 -0000 (Marcel Gruenauer <marcel@cpan.org>) 
  • lang/perl/Data-Semantic/trunk/MANIFEST

    r16330 r16465  
    99inc/Module/Install/Makefile.pm 
    1010inc/Module/Install/Metadata.pm 
    11 inc/Module/Install/StandardTests.pm 
    12 inc/Module/Install/Template.pm 
    1311inc/Module/Install/Win32.pm 
    1412inc/Module/Install/WriteAll.pm 
     
    1614inc/Test/Differences.pm 
    1715inc/Test/More.pm 
    18 inc/UNIVERSAL/require.pm 
    1916lib/Data/Semantic.pm 
    2017lib/Data/Semantic/RegexpAdapter.pm 
  • lang/perl/Data-Semantic/trunk/MANIFEST.SKIP

    r9762 r16465  
    1010^Build$ 
    1111^blib/ 
     12^pm_to_blib/ 
    1213^_build/ 
    1314^MakeMaker-\d 
     
    2728\.old$ 
    2829\.swp$ 
     30\.tar$ 
     31\.tar\.gz$ 
    2932^#.*#$ 
    3033^\.# 
     
    3538core 
    3639^var/ 
    37 local/ 
  • lang/perl/Data-Semantic/trunk/Makefile.PL

    r9762 r16465  
    1111requires 'Test::CompanionClasses' => '0.03'; 
    1212 
    13 build_requires 'Test::Differences'; 
    14 build_requires 'Test::More' => '0.70'; 
     13recommends 'Test::Pod'; 
     14recommends 'Test::Pod::Coverage'; 
    1515 
    16 process_templates( 
    17     first_year => 2007, 
    18     rest_from  => "$ENV{HOME}/.mitlib/standard_pod", 
    19     start_tag  => '{%', 
    20     end_tag    => '%}', 
    21 ); 
     16test_requires 'Test::Differences'; 
     17test_requires 'Test::More' => '0.70'; 
     18test_requires 'Test::Compile'; 
    2219 
    23 use_standard_tests(without => 'pod_coverage'); 
    2420auto_install; 
    2521auto_include; 
  • lang/perl/Data-Semantic/trunk/lib/Data/Semantic.pm

    r9762 r16465  
    4242__END__ 
    4343 
    44 {% USE p = PodGenerated %} 
     44 
    4545 
    4646=head1 NAME 
    4747 
    48 {% p.package %} - Common API for data with semantics attached to them 
     48Data::Semantic - Common API for data with semantics attached to them 
    4949 
    5050=head1 SYNOPSIS 
    5151 
    52     {% p.package %}->new; 
     52    Data::Semantic->new; 
    5353 
    5454=head1 DESCRIPTION 
     
    8888=over 4 
    8989 
    90 {% p.write_methods %} 
     90=item new 
     91 
     92    my $obj = Data::Semantic->new; 
     93    my $obj = Data::Semantic->new(%args); 
     94 
     95Creates and returns a new object. The constructor will accept as arguments a 
     96list of pairs, from component name to initial value. For each pair, the named 
     97component is initialized by calling the method of the same name with the given 
     98value. If called with a single hash reference, it is dereferenced and its 
     99key/value pairs are set as described before. 
    91100 
    92101=back 
    93102 
    94 {% p.write_inheritance %} 
     103Data::Semantic inherits from L<Class::Accessor::Complex>. 
    95104 
    96 {% PROCESS standard_pod %} 
     105The superclass L<Class::Accessor::Complex> defines these methods and 
     106functions: 
     107 
     108    mk_abstract_accessors(), mk_array_accessors(), mk_boolean_accessors(), 
     109    mk_class_array_accessors(), mk_class_hash_accessors(), 
     110    mk_class_scalar_accessors(), mk_concat_accessors(), 
     111    mk_forward_accessors(), mk_hash_accessors(), mk_integer_accessors(), 
     112    mk_new(), mk_object_accessors(), mk_scalar_accessors(), 
     113    mk_set_accessors(), mk_singleton() 
     114 
     115The superclass L<Class::Accessor> defines these methods and functions: 
     116 
     117    _carp(), _croak(), _mk_accessors(), accessor_name_for(), 
     118    best_practice_accessor_name_for(), best_practice_mutator_name_for(), 
     119    follow_best_practice(), get(), make_accessor(), make_ro_accessor(), 
     120    make_wo_accessor(), mk_accessors(), mk_ro_accessors(), 
     121    mk_wo_accessors(), mutator_name_for(), set() 
     122 
     123The superclass L<Class::Accessor::Installer> defines these methods and 
     124functions: 
     125 
     126    install_accessor() 
     127 
     128=head1 BUGS AND LIMITATIONS 
     129 
     130No bugs have been reported. 
     131 
     132Please report any bugs or feature requests through the web interface at 
     133L<http://rt.cpan.org>. 
     134 
     135=head1 INSTALLATION 
     136 
     137See perlmodinstall for information and options on installing Perl modules. 
     138 
     139=head1 AVAILABILITY 
     140 
     141The latest version of this module is available from the Comprehensive Perl 
     142Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN 
     143site near you. Or see <http://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>. 
     144 
     145=head1 AUTHORS 
     146 
     147Marcel GrE<uuml>nauer, C<< <marcel@cpan.org> >> 
     148 
     149=head1 COPYRIGHT AND LICENSE 
     150 
     151Copyright 2007-2008 by the authors. 
     152 
     153This library is free software; you can redistribute it and/or modify 
     154it under the same terms as Perl itself. 
     155 
    97156 
    98157=cut 
  • lang/perl/Data-Semantic/trunk/lib/Data/Semantic/RegexpAdapter.pm

    r9762 r16465  
    8080__END__ 
    8181 
    82 {% USE p = PodGenerated %} 
     82 
    8383 
    8484=head1 NAME 
    8585 
    86 {% p.package %} - Adapter for Regexp::Common patterns 
     86Data::Semantic::RegexpAdapter - Adapter for Regexp::Common patterns 
    8787 
    8888=head1 SYNOPSIS 
    8989 
    90     {% p.package %}->new; 
     90    Data::Semantic::RegexpAdapter->new; 
    9191 
    9292=head1 DESCRIPTION 
     
    9999=over 4 
    100100 
    101 {% p.write_methods %} 
     101=item clear_keep 
     102 
     103    $obj->clear_keep; 
     104 
     105Clears the boolean value by setting it to 0. 
     106 
     107=item clear_kept 
     108 
     109    $obj->clear_kept; 
     110 
     111Deletes all keys and values from the hash. 
     112 
     113=item clear_re 
     114 
     115    $obj->clear_re; 
     116 
     117Clears the value. 
     118 
     119=item delete_kept 
     120 
     121    $obj->delete_kept(@keys); 
     122 
     123Takes a list of keys and deletes those keys from the hash. 
     124 
     125=item exists_kept 
     126 
     127    if ($obj->exists_kept($key)) { ... } 
     128 
     129Takes a key and returns a true value if the key exists in the hash, and a 
     130false value otherwise. 
     131 
     132=item keep 
     133 
     134    $obj->keep($value); 
     135    my $value = $obj->keep; 
     136 
     137If called without an argument, returns the boolean value (0 or 1). If called 
     138with an argument, it normalizes it to the boolean value. That is, the values 
     1390, undef and the empty string become 0; everything else becomes 1. 
     140 
     141=item keep_clear 
     142 
     143    $obj->keep_clear; 
     144 
     145Clears the boolean value by setting it to 0. 
     146 
     147=item keep_set 
     148 
     149    $obj->keep_set; 
     150 
     151Sets the boolean value to 1. 
     152 
     153=item kept 
     154 
     155    my %hash     = $obj->kept; 
     156    my $hash_ref = $obj->kept; 
     157    my $value    = $obj->kept($key); 
     158    my @values   = $obj->kept([ qw(foo bar) ]); 
     159    $obj->kept(%other_hash); 
     160    $obj->kept(foo => 23, bar => 42); 
     161 
     162Get or set the hash values. If called without arguments, it returns the hash 
     163in list context, or a reference to the hash in scalar context. If called 
     164with a list of key/value pairs, it sets each key to its corresponding value, 
     165then returns the hash as described before. 
     166 
     167If called with exactly one key, it returns the corresponding value. 
     168 
     169If called with exactly one array reference, it returns an array whose elements 
     170are the values corresponding to the keys in the argument array, in the same 
     171order. The resulting list is returned as an array in list context, or a 
     172reference to the array in scalar context. 
     173 
     174If called with exactly one hash reference, it updates the hash with the given 
     175key/value pairs, then returns the hash in list context, or a reference to the 
     176hash in scalar context. 
     177 
     178=item kept_clear 
     179 
     180    $obj->kept_clear; 
     181 
     182Deletes all keys and values from the hash. 
     183 
     184=item kept_delete 
     185 
     186    $obj->kept_delete(@keys); 
     187 
     188Takes a list of keys and deletes those keys from the hash. 
     189 
     190=item kept_exists 
     191 
     192    if ($obj->kept_exists($key)) { ... } 
     193 
     194Takes a key and returns a true value if the key exists in the hash, and a 
     195false value otherwise. 
     196 
     197=item kept_keys 
     198 
     199    my @keys = $obj->kept_keys; 
     200 
     201Returns a list of all hash keys in no particular order. 
     202 
     203=item kept_values 
     204 
     205    my @values = $obj->kept_values; 
     206 
     207Returns a list of all hash values in no particular order. 
     208 
     209=item keys_kept 
     210 
     211    my @keys = $obj->keys_kept; 
     212 
     213Returns a list of all hash keys in no particular order. 
     214 
     215=item re 
     216 
     217    my $value = $obj->re; 
     218    $obj->re($value); 
     219 
     220A basic getter/setter method. If called without an argument, it returns the 
     221value. If called with a single argument, it sets the value. 
     222 
     223=item re_clear 
     224 
     225    $obj->re_clear; 
     226 
     227Clears the value. 
     228 
     229=item set_keep 
     230 
     231    $obj->set_keep; 
     232 
     233Sets the boolean value to 1. 
     234 
     235=item values_kept 
     236 
     237    my @values = $obj->values_kept; 
     238 
     239Returns a list of all hash values in no particular order. 
    102240 
    103241=item LOAD 
     
    138276=back 
    139277 
    140 {% p.write_inheritance %} 
    141  
    142 {% PROCESS standard_pod %} 
     278Data::Semantic::RegexpAdapter inherits from L<Data::Semantic> and 
     279L<Data::Inherited>. 
     280 
     281The superclass L<Data::Semantic> defines these methods and functions: 
     282 
     283    new(), is_valid(), normalize() 
     284 
     285The superclass L<Class::Accessor::Complex> defines these methods and 
     286functions: 
     287 
     288    mk_abstract_accessors(), mk_array_accessors(), mk_boolean_accessors(), 
     289    mk_class_array_accessors(), mk_class_hash_accessors(), 
     290    mk_class_scalar_accessors(), mk_concat_accessors(), 
     291    mk_forward_accessors(), mk_hash_accessors(), mk_integer_accessors(), 
     292    mk_new(), mk_object_accessors(), mk_scalar_accessors(), 
     293    mk_set_accessors(), mk_singleton() 
     294 
     295The superclass L<Class::Accessor> defines these methods and functions: 
     296 
     297    _carp(), _croak(), _mk_accessors(), accessor_name_for(), 
     298    best_practice_accessor_name_for(), best_practice_mutator_name_for(), 
     299    follow_best_practice(), get(), make_accessor(), make_ro_accessor(), 
     300    make_wo_accessor(), mk_accessors(), mk_ro_accessors(), 
     301    mk_wo_accessors(), mutator_name_for(), set() 
     302 
     303The superclass L<Class::Accessor::Installer> defines these methods and 
     304functions: 
     305 
     306    install_accessor() 
     307 
     308The superclass L<Data::Inherited> defines these methods and functions: 
     309 
     310    every_hash(), every_list(), flush_every_cache_by_key() 
     311 
     312=head1 BUGS AND LIMITATIONS 
     313 
     314No bugs have been reported. 
     315 
     316Please report any bugs or feature requests through the web interface at 
     317L<http://rt.cpan.org>. 
     318 
     319=head1 INSTALLATION 
     320 
     321See perlmodinstall for information and options on installing Perl modules. 
     322 
     323=head1 AVAILABILITY 
     324 
     325The latest version of this module is available from the Comprehensive Perl 
     326Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN 
     327site near you. Or see <http://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>. 
     328 
     329=head1 AUTHORS 
     330 
     331Marcel GrE<uuml>nauer, C<< <marcel@cpan.org> >> 
     332 
     333=head1 COPYRIGHT AND LICENSE 
     334 
     335Copyright 2007-2008 by the authors. 
     336 
     337This library is free software; you can redistribute it and/or modify 
     338it under the same terms as Perl itself. 
     339 
    143340 
    144341=cut 
  • lang/perl/Data-Semantic/trunk/lib/Data/Semantic/Test.pm

    r9762 r16465  
    7979__END__ 
    8080 
    81 {% USE p = PodGenerated %} 
     81 
    8282 
    8383=head1 NAME 
    8484 
    85 {% p.package %} - Testing Data::Semantic objects 
     85Data::Semantic::Test - Testing Data::Semantic objects 
    8686 
    8787=head1 SYNOPSIS 
    8888 
    89     {% p.package %}->new; 
     89    Data::Semantic::Test->new; 
    9090 
    9191=head1 DESCRIPTION 
     
    149149=over 4 
    150150 
    151 {% p.write_methods %} 
     151 
    152152 
    153153=back 
    154154 
    155 {% p.write_inheritance %} 
    156  
    157 {% PROCESS standard_pod %} 
     155Data::Semantic::Test inherits from L<Test::CompanionClasses::Base>. 
     156 
     157The superclass L<Test::CompanionClasses::Base> defines these methods and 
     158functions: 
     159 
     160    new(), clear_package(), make_real_object(), package(), package_clear(), 
     161    planned_test_count() 
     162 
     163The superclass L<Class::Accessor::Complex> defines these methods and 
     164functions: 
     165 
     166    mk_abstract_accessors(), mk_array_accessors(), mk_boolean_accessors(), 
     167    mk_class_array_accessors(), mk_class_hash_accessors(), 
     168    mk_class_scalar_accessors(), mk_concat_accessors(), 
     169    mk_forward_accessors(), mk_hash_accessors(), mk_integer_accessors(), 
     170    mk_new(), mk_object_accessors(), mk_scalar_accessors(), 
     171    mk_set_accessors(), mk_singleton() 
     172 
     173The superclass L<Class::Accessor> defines these methods and functions: 
     174 
     175    _carp(), _croak(), _mk_accessors(), accessor_name_for(), 
     176    best_practice_accessor_name_for(), best_practice_mutator_name_for(), 
     177    follow_best_practice(), get(), make_accessor(), make_ro_accessor(), 
     178    make_wo_accessor(), mk_accessors(), mk_ro_accessors(), 
     179    mk_wo_accessors(), mutator_name_for(), set() 
     180 
     181The superclass L<Class::Accessor::Installer> defines these methods and 
     182functions: 
     183 
     184    install_accessor() 
     185 
     186The superclass L<Data::Inherited> defines these methods and functions: 
     187 
     188    every_hash(), every_list(), flush_every_cache_by_key() 
     189 
     190=head1 BUGS AND LIMITATIONS 
     191 
     192No bugs have been reported. 
     193 
     194Please report any bugs or feature requests through the web interface at 
     195L<http://rt.cpan.org>. 
     196 
     197=head1 INSTALLATION 
     198 
     199See perlmodinstall for information and options on installing Perl modules. 
     200 
     201=head1 AVAILABILITY 
     202 
     203The latest version of this module is available from the Comprehensive Perl 
     204Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN 
     205site near you. Or see <http://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>. 
     206 
     207=head1 AUTHORS 
     208 
     209Marcel GrE<uuml>nauer, C<< <marcel@cpan.org> >> 
     210 
     211=head1 COPYRIGHT AND LICENSE 
     212 
     213Copyright 2007-2008 by the authors. 
     214 
     215This library is free software; you can redistribute it and/or modify 
     216it under the same terms as Perl itself. 
     217 
    158218 
    159219=cut