| version 1.16, 2010/01/12 19:40:52 |
version 1.26, 2010/02/14 06:08:07 |
|
|
| package Text::Todo; |
package Text::Todo; |
| |
|
| # $AFresh1: Todo.pm,v 1.15 2010/01/11 19:52:06 andrew Exp $ |
# $AFresh1: Todo.pm,v 1.25 2010/02/13 23:26:44 andrew Exp $ |
| |
|
| use warnings; |
use warnings; |
| use strict; |
use strict; |
|
|
| use Text::Todo::Entry; |
use Text::Todo::Entry; |
| use File::Spec; |
use File::Spec; |
| |
|
| use version; our $VERSION = qv('0.0.1'); |
use version; our $VERSION = qv('0.1.1'); |
| |
|
| { |
{ |
| |
|
| my %path_of; |
my @attr_refs = \( |
| my %list_of; |
my %path_of, |
| my %loaded_of; |
|
| |
|
| |
my %list_of, |
| |
my %loaded_of, |
| |
my %known_tags_of, |
| |
); |
| |
|
| sub new { |
sub new { |
| my ( $class, $options ) = @_; |
my ( $class, $options ) = @_; |
| |
|
|
|
| done_file => undef, |
done_file => undef, |
| }; |
}; |
| |
|
| |
my %tags = ( |
| |
context => q{@}, |
| |
project => q{+}, |
| |
); |
| |
|
| if ($options) { |
if ($options) { |
| if ( ref $options eq 'HASH' ) { |
if ( ref $options eq 'HASH' ) { |
| foreach my $opt ( keys %{$options} ) { |
foreach my $opt ( keys %{$options} ) { |
| if ( exists $path_of{$ident}{$opt} ) { |
if ( exists $path_of{$ident}{$opt} ) { |
| $self->_path_to( $opt, $options->{$opt} ); |
$self->_path_to( $opt, $options->{$opt} ); |
| } |
} |
| |
elsif ( $opt eq 'tags' |
| |
&& ref $options->{$opt} eq 'HASH' ) |
| |
{ |
| |
%tags = ( %tags, %{ $options->{$opt} } ); |
| |
} |
| else { |
else { |
| |
|
| #carp "Invalid option [$opt]"; |
#carp "Invalid option [$opt]"; |
|
|
| } |
} |
| } |
} |
| |
|
| |
$known_tags_of{$ident} = \%tags; |
| |
|
| my $file = $self->_path_to('todo_file'); |
my $file = $self->_path_to('todo_file'); |
| if ( defined $file && -e $file ) { |
if ( defined $file && -e $file ) { |
| $self->load(); |
$self->load(); |
|
|
| $file = $self->file($file); |
$file = $self->file($file); |
| |
|
| if ( $list_of{$ident} = $self->listfile($file) ) { |
if ( $list_of{$ident} = $self->listfile($file) ) { |
| |
$self->known_tags; |
| $loaded_of{$ident} = $file; |
$loaded_of{$ident} = $file; |
| return 1; |
return 1; |
| } |
} |
|
|
| if ($pri) { |
if ($pri) { |
| $pri = uc $pri; |
$pri = uc $pri; |
| if ( $pri !~ /^[A-Z]$/xms ) { |
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 } |
@list = grep { defined $_->priority && $_->priority eq $pri } |
| $self->list; |
$self->list; |
|
|
| my $ident = ident($self); |
my $ident = ident($self); |
| |
|
| if ( !ref $entry ) { |
if ( !ref $entry ) { |
| $entry = Text::Todo::Entry->new($entry); |
$entry = Text::Todo::Entry->new( |
| |
{ text => $entry, |
| |
tags => $known_tags_of{$ident}, |
| |
} |
| |
); |
| } |
} |
| elsif ( ref $entry ne 'Text::Todo::Entry' ) { |
elsif ( ref $entry ne 'Text::Todo::Entry' ) { |
| croak( |
croak( |
|
|
| |
|
| push @{ $list_of{$ident} }, $entry; |
push @{ $list_of{$ident} }, $entry; |
| |
|
| |
$self->known_tags; |
| |
|
| return $entry; |
return $entry; |
| } |
} |
| |
|
|
|
| } |
} |
| |
|
| sub listproj { |
sub listproj { |
| my ( $self ) = @_; |
my ($self) = @_; |
| return $self->listtag('project'); |
return $self->listtag('project'); |
| } |
} |
| |
|
| sub listcon { |
sub listcon { |
| my ( $self ) = @_; |
my ($self) = @_; |
| return $self->listtag('context'); |
return $self->listtag('context'); |
| } |
} |
| |
|
| sub listtag { |
sub listtag { |
| my ( $self, $tag ) = @_; |
my ( $self, $tag ) = @_; |
| my $ident = ident($self); |
my $ident = ident($self); |
| |
|
| my $accessor = $tag . 's'; |
my $accessor = $tag . 's'; |
| |
|
| my %available; |
my %available; |
|
|
| |
|
| my @tags = sort keys %available; |
my @tags = sort keys %available; |
| |
|
| return wantarray ? @tags: \@tags; |
return wantarray ? @tags : \@tags; |
| } |
} |
| |
|
| |
sub learn_tag { |
| |
my ( $self, $tag, $sigal ) = @_; |
| |
|
| |
$known_tags_of{ ident $self}{$tag} = $sigal; |
| |
$self->known_tags; |
| |
|
| |
return 1; |
| |
} |
| |
|
| |
sub known_tags { |
| |
my ($self) = @_; |
| |
my $ident = ident($self); |
| |
|
| |
my @list = $self->list; |
| |
my %tags = %{ $known_tags_of{$ident} }; |
| |
|
| |
foreach my $e (@list) { |
| |
my $kt = $e->known_tags; |
| |
foreach my $t ( keys %{$kt} ) { |
| |
if ( !exists $tags{$t} ) { |
| |
$tags{$t} = $kt->{$t}; |
| |
} |
| |
} |
| |
} |
| |
|
| |
foreach my $e (@list) { |
| |
my $kt = $e->known_tags; |
| |
foreach my $t ( keys %tags ) { |
| |
if ( !exists $kt->{$t} || $tags{$t} ne $kt->{$t} ) { |
| |
$e->learn_tag( $t, $tags{$t} ); |
| |
} |
| |
} |
| |
} |
| |
|
| |
$known_tags_of{$ident} = \%tags; |
| |
|
| |
return $known_tags_of{$ident}; |
| |
} |
| |
|
| sub archive { |
sub archive { |
| my ($self) = @_; |
my ($self) = @_; |
| my $ident = ident($self); |
my $ident = ident($self); |
|
|
| |
|
| croak "Invalid entry [$entry]!"; |
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 |
1; # Magic true value required at end of module |
|
|
| |
|
| =head1 NAME |
=head1 NAME |
| |
|
| Text::Todo - Perl interface to todo_txt files |
Text::Todo - Perl interface to todotxt files |
| |
|
| |
|
| =head1 VERSION |
=head1 VERSION |
|
|
| |
|
| I think it may become depreciated unless there is demand. |
I think it may become depreciated unless there is demand. |
| |
|
| =head2 listtag |
=head2 known_tags |
| |
|
| |
Returns a reference to a hash of the tags known to the list. |
| |
|
| |
=head2 learn_tag($tag, $sigal) |
| |
|
| |
Let the entire list learn a new tag. |
| |
If you are working with a list you should use this instead of |
| |
$entry->learn_tag because it will update all entries. |
| |
|
| |
=head2 listtag($tag) |
| |
|
| Returns tags found in the list sorted by name. |
Returns tags found in the list sorted by name. |
| |
|