.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "PTSB 1p"
.TH PTSB 1p "2018-06-29" "perl v5.26.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
ptsb \- Interact with you Permanent TSB homebanking from your shell!
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
ptsb [options]
.SS "Print accounts balance:"
.IX Subsection "Print accounts balance:"
.ie n .IP """ptsb [ \-F \fI/path/of/conf/file\fP ] \-b""" 4
.el .IP "\f(CWptsb [ \-F \f(CI/path/of/conf/file\f(CW ] \-b\fR" 4
.IX Item "ptsb [ -F /path/of/conf/file ] -b"
.SS "Print account statement:"
.IX Subsection "Print account statement:"
.PD 0
.ie n .IP """ptsb [ \-F \fI/path/of/conf/file\fP ] \-s \-a c \-n <4digits"" \-f yyyy/mm/dd  \-t yyyy/mm/dd>" 4
.el .IP "\f(CWptsb [ \-F \f(CI/path/of/conf/file\f(CW ] \-s \-a c \-n <4digits\fR \-f yyyy/mm/dd  \-t yyyy/mm/dd>" 4
.IX Item "ptsb [ -F /path/of/conf/file ] -s -a c -n <4digits -f yyyy/mm/dd -t yyyy/mm/dd>"
.PD
.PP
If your are running Linux you can use the \fIdate \-\-date\fR command to simplify the date range definition.
You can put these aliases on your \fI~/.bashrc\fR:
.PP
.Vb 2
\&    alias ptsb_stat=\*(Aqptsb \-\-statement \-a c \-n xyzt\*(Aq
\&    alias ptst_last_month="statement_current \-f \`date +%Y/%m/%d \-\-date=\*(Aq1 month ago\*(Aq\` \-t \`date +%Y/%m/%d\`"
.Ve
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-h | \-\-help\fR" 8
.IX Item "-h | --help"
this help usage message!
.IP "\fB\-D | \-\-debug\fR" 8
.IX Item "-D | --debug"
Enable debug. This will be more verbose and will leave html
on the current working directory.
.IP "\fB\-F \f(BI/path/to/config/file\fB | \-\-file \f(BI/path/to/config/file\fB\fR" 8
.IX Item "-F /path/to/config/file | --file /path/to/config/file"
filename configuration file path (default: \fI~/.ptsbrc\fR).
Please refer to manual page to see how this file is built.
.IP "\fB\-b | \-\-balance\fR" 8
.IX Item "-b | --balance"
print account balance
.IP "\fB\-s | \-\-statement\fR" 8
.IX Item "-s | --statement"
print account statement
.IP "\fB\-T type | \-\-transation\-type type\fR" 8
.IX Item "-T type | --transation-type type"
Type of transaction to look on the statement.
Type can be: \s-1ALL, WITHDRAWAL, DEPOSIT\s0
.IP "\fB\-f | \-\-from\*(--date yyyy/mm/dd\fR" 8
.IX Item "-f | --fromdate yyyy/mm/dd"
from date
.IP "\fB\-t | \-\-to\-date yyyy/mm/dd\fR" 8
.IX Item "-t | --to-date yyyy/mm/dd"
to date
.IP "\fB\-a [c | v] | \-\-account\-type [c | v]\fR" 8
.IX Item "-a [c | v] | --account-type [c | v]"
account type: can be 'c' (current account) or 'v' for (visa card)
.IP "\fB\-n digits | \-\-account\-num digits\fR" 8
.IX Item "-n digits | --account-num digits"
4 digits representing the last 4 digits of the account number or visa
card number.
.IP "\fB\-N | \-\-no\-balance\fR" 8
.IX Item "-N | --no-balance"
Do not print balance when printing statement.
.IP "\fB\-r | \-\-regexp\fR" 8
.IX Item "-r | --regexp"
When printing statement grep using the regexp provided
.IP "\fB\-e | \-\-expr\fR" 8
.IX Item "-e | --expr"
where expression is a mathematical expression like
.Sp
.Vb 1
\&    \*(Aq<300\*(Aq
\&
\&    \*(Aq=300\*(Aq
\&
\&    \*(Aq>=300\*(Aq
.Ve
.Sp
the expression will test the euro amount column
only lines matching the expression will be printed
.IP "\fB\-g | \-\-graph\fR" 8
.IX Item "-g | --graph"
Print graph of the statement using gnuplot. Gnuplot is required!
.IP "\fB\-i \f(BIpath\fB | \-\-image \f(BIpath\fB\fR" 8
.IX Item "-i path | --image path"
Save \s-1PNG\s0 image in path.
.IP "\fB\-o \f(BIfilename\fB | \-\-output \f(BIfilename\fB\fR" 8
.IX Item "-o filename | --output filename"
Save the output of the statement inside a \s-1CSV\s0 file named \fIfilename\fR.
\&\s-1CSV\s0 format is:
.Sp
date,description,amount,balance
.Sp
last field presence depends on the \-N flag.
.IP "\fB\-v | \-\-version\fR" 8
.IX Item "-v | --version"
Print version
.SH "CONFIGURATION FILE"
.IX Header "CONFIGURATION FILE"
Configuration file default location is \fI~/.ptsbrc\fR and it looks like this:
.PP
.Vb 1
\&    \-\-\-\-\-\-\-8< \-\- ~/.ptsbrc \-\->8\-\-\-\-\-\-\-\-\-\-
\&
\&    open24_number=your_open24_number
\&
\&    password=your_internet_password
\&
\&    pan=your_personal_access_number
\&
\&    \-\-\-\-\-\-\-8< \-\-\-\-\-\-\-\-\-\-\-\-\-\-\->8\-\-\-\-\-\-\-\-\-\-
.Ve
.PP
However you can put wherever you want. Just remember to use then the
option \-F \fI/path/to/your/location\fR.
.PP
Lines beginning with # will be interpreted as comment.
.PP
Starting from release 0.08 ptsb will use GnuPG to encrypt the
configuration file using the private key of the user.
Therefore you'll have to create your key if you didn't do this yet.
.PP
In case you want to decrypt your ptsbrc file use this command:
.PP
.Vb 1
\&    $ gpg \-d /path/to/your/ptsbrc
.Ve
.PP
This will print the encrypted file on the standard output.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.IP "\(bu" 4
\&\fBOfficial \s-1CPAN\s0 page for Finance::Bank::IE::PermanentTSB\fR
.Sp
<http://search.cpan.org/~pallotron/Finance\-Bank\-IE\-PermanentTSB/lib/Finance/Bank/IE/PermanentTSB.pm>
.IP "\(bu" 4
\&\fBAuthor homepage\fR
.Sp
<http://www.pallotron.net>
.IP "\(bu" 4
\&\fBAuthor Blog (italian)\fR
.Sp
<http://www.vitadiunsysadmin.net>
.IP "\(bu" 4
\&\fBAuthor homepage on \s-1CPAN\s0\fR
.Sp
<http://search.cpan.org/~pallotron/>
.SH "AUTHOR"
.IX Header "AUTHOR"
Angelo \*(L"pallotron\*(R" Failla \- <pallotron@freaknet.org>
.SH "BUGS"
.IX Header "BUGS"
Please report bugs to the author, no bug tracking system is set up yet.
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright (C) 2009 by Angelo \*(L"pallotron\*(R" Failla
.PP
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.8 or,
at your option, any later version of Perl 5 you may have available.