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>

COPYRIGHT

Copyright (c) 2001, Johan Van den Brande. All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.