NAME

Palm::Timesheet - Handler for Timesheet1.5.3 databases.

VERSION

This document refers to version 0.1 of Palm::Timesheet, released Tue Oct 30 2001.

SYNOPSIS

        use Palm::Timesheet;

        my $ts = Palm::Timesheet->new( file => $filename );
        my $clients     = $ts->get_clients;
        my $projects    = $ts->get_projects;
        my $tasks       = $ts->get_tasks;  

        
        while ( my $d = $ts->get_days->each ) {
        while ( my $e = $d->each ) {
                        print join( ";", (      
                                $d->get_day,
                    $clients->get_record($e->get_client),
                    $projects->get_record($e->get_project),
                    $tasks->get_record($e->get_task),
                    sprintf("%02d:%02d", $e->get_hour, $e->get_min ),
                    ($e->get_chargeable)?"Y":" ",
                                        $e->get_comment
                        )) . "\n";
        }
        }

DESCRIPTION

The Timesheet PDB handler is a class that parses Timesheet1.5.3 databases. Timesheet1.5.3 is created by Stuart Nicholson <snic@ihug.co.nz>.

It can be used to read and write Timesheet databases.

Overview

The Palm::Timesheet class parses a Timesheet PDB and collects the data contained in a set of objects. A timesheet entry consists of a client , project, task, date, duration (hour and minutes) a comment and if the entry is chargeable or not.

Constructor and Initialization

For the moment one constructor is available, it takes an existing PDB as a parameter and parses the database.

        my $ts = Palm::Timesheet->new( -file => $filename );

Class and other object methods

write

        # Write to filename
        $ts->write( $filename );

        # Rewrite, using constructor filename.
        $ts->write

get_days

Returns a Palm::Timesheet::DayRecordList

get_preferences

Returns a Palm::Timesheet::PreferenceRecord

get_clients

Returns a Palm::Timesheet::ClientRecordList

get_projects

Returns a Palm::Timesheet::ProjectRecordList

get_tasks

Returns a Palm::Timesheet::TaskRecordList

BUGS

Probably a few ... but it works for now. PDB writing has *not* been thoroughly tested.

AUTHOR

Johan Van den Brande <johan@vandenbrande.com>

CPAN RT