=================================================================== RCS file: /cvs/todotxt/Text-Todo/lib/Text/Todo.pm,v retrieving revision 1.14 retrieving revision 1.24 diff -u -r1.14 -r1.24 --- todotxt/Text-Todo/lib/Text/Todo.pm 2010/01/10 22:39:26 1.14 +++ todotxt/Text-Todo/lib/Text/Todo.pm 2010/01/22 18:15:06 1.24 @@ -1,6 +1,6 @@ package Text::Todo; -# $RedRiver: Todo.pm,v 1.13 2010/01/10 07:07:46 andrew Exp $ +# $AFresh1: Todo.pm,v 1.23 2010/01/22 01:30:45 andrew Exp $ use warnings; use strict; @@ -10,14 +10,17 @@ use Text::Todo::Entry; use File::Spec; -use version; our $VERSION = qv('0.0.1'); +use version; our $VERSION = qv('0.1.1'); { - my %path_of; - my %list_of; - my %loaded_of; + my @attr_refs = \( + my %path_of, + my %list_of, + my %loaded_of, + ); + sub new { my ( $class, $options ) = @_; @@ -203,7 +206,7 @@ if ($pri) { $pri = uc $pri; if ( $pri !~ /^[A-Z]$/xms ) { - croak "PRIORITY must a single letter from A to Z."; + croak 'PRIORITY must a single letter from A to Z.'; } @list = grep { defined $_->priority && $_->priority eq $pri } $self->list; @@ -260,19 +263,19 @@ } sub listproj { - my ( $self ) = @_; + my ($self) = @_; return $self->listtag('project'); } sub listcon { - my ( $self ) = @_; + my ($self) = @_; return $self->listtag('context'); } sub listtag { my ( $self, $tag ) = @_; my $ident = ident($self); - + my $accessor = $tag . 's'; my %available; @@ -284,7 +287,7 @@ my @tags = sort keys %available; - return wantarray ? @tags: \@tags; + return wantarray ? @tags : \@tags; } sub archive { @@ -382,6 +385,17 @@ croak "Invalid entry [$entry]!"; } + + sub DESTROY { + my ($self) = @_; + my $ident = ident $self; + + foreach my $attr_ref (@attr_refs) { + delete $attr_ref->{$ident}; + } + + return; + } } 1; # Magic true value required at end of module @@ -389,7 +403,7 @@ =head1 NAME -Text::Todo - Perl interface to todo_txt files +Text::Todo - Perl interface to todotxt files =head1 VERSION @@ -397,7 +411,7 @@ Since the $VERSION can't be automatically included, here is the RCS Id instead, you'll have to look up $VERSION. - $Id: Todo.pm,v 1.14 2010/01/10 22:39:26 andrew Exp $ + $Id: Todo.pm,v 1.24 2010/01/22 18:15:06 andrew Exp $ =head1 SYNOPSIS @@ -470,6 +484,7 @@ then, $todo_file eq 'todo/todo.txt' =head2 load +- Reads a list from a file into the current object. Allows you to load a different file into the object. @@ -478,35 +493,53 @@ This effects the other functions that act on the list. =head2 save +- Writes the list to disk. $todo->save(['new/path/to/todo']); -Writes the list to the file. Either the current working file or something +Either writes the current working file or the passed in argument that can be recognized by file(). If you specify a filename it will save to that file and update the paths. Additional changes to the object work on that file. =head2 list +- get the curently loaded list my @todo_list = $todo->list; +In list context returns a list, it scalar context returns an array reference to the list. + =head2 listpri +- get the list items that are marked priority Like list, but only returns entries that have priority set. my @priority_list = $todo->listpri; -=head2 listproj +Since this is so easy to write as: -Returns projects in the list sorted by name. -If there were projects +GarageSale and +Shopping + my @priority_list = grep { $_->priority } $todo->list; - my @projects = $todo->listproj; +I think it may become depreciated unless there is demand. +=head2 listtag + +Returns tags found in the list sorted by name. + +If there were projects +GarageSale and +Shopping then + + my @projects = $todo->listtag('project'); + is the same as @projects = ( 'GarageSale', 'Shopping' ); + +=head2 listcon +- Shortcut to listtag('context') + +=head2 listproj +- Shortcut to listtag('project') =head2 add