README

============================================
CurrencyConverter : Java currency conversion
============================================

Project Creator:  Miguel Vaz

(C) Copyright 2009, by Miguel Vaz and Contributors.

This library is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.

This library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
License for more details.

You should have received a copy of the GNU Lesser General Public License
along with this library; if not, write to the Free Software Foundation, Inc.,
59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.


~~~~~~~~~~~~
DESCRIPTION
~~~~~~~~~~~~

This program implements a currency converter, implemented in Java.

It contains
 
 
 source files
 net/mvaz/CurrencyConverter/ConvertCurrency.java     
                           /CurrencyConverter.java
                           /TestCurrencyConverter.java
                           /ExchangeRateUndefinedException.java

 jgrapht-jdk1.6.jar - graph library
 README     - this file
 run.sh     - launches the ConvertCurrency interactive console program


~~~~~~~~~~~~
DEPENDENCIES
~~~~~~~~~~~~

Compiled with JDK 1.6.

JGraphT - free Java library for graph algorithms
http://www.jgrapht.org/
version 0.8.1 (needs JDK 1.6)

JUnit   - free
http://www.junit.org/
version 4.5.0




~~~~~~~~~~~~~
EXAMPLE
~~~~~~~~~~~~~

Example commands:

    Euro -> Schweizer Franken (1.6798)
    Euro -> US Dollar (1.6135)
    Euro -> Britisch Pfund (0.8031)
    US Dollar -> Britisch Pfund (0.9860)
    
    US Dollar, Schweizer Franken (10)

Example session

    CurrencyConverter miguel$ ./run.sh 
    >> Euro -> JPY (100.1)
    OK
    >> Euro -> JPY (100.1 )
    OK
    >> Euro, JPY ( 10)
    1001.0
    >> Euro -> Dollar (0.9)
    OK
    >> Dollar,JPY(1)
    111.22222222222221
    >> Euro -> JPY (100.3)         
    OK
    >> Euro, JPY (10)
    1003.0