NAME

Alien::InteractiveBrokers - Provides installation and config information for the InteractiveBrokers API

SYNOPSIS

use Alien::InteractiveBrokers;

my $IBAPI     = Alien::InteractiveBrokers->new();
my $path      = $IBAPI->path();
my $includes  = $IBAPI->includes();
my $classpath = $IBAPI->classpath();
my $version   = $IBAPI->version();

DESCRIPTION

This module automates the installation of the InteractiveBrokers API files and source code, and provides accessor functions to describe its location, include paths, etc.

It was developed in conjunction with Finance::InteractiveBrokers::SWIG and POE::Component::Client::InteractiveBrokers, as a way of simplifying distribution and installation of these needed files.

Please see Alien for an explanation of the Alien namespace.

CONSTRUCTOR

new()

my $IBAPI = Alien::InteractiveBrokers->new();

Create a new Alien::InteractiveBrokers object for querying the installed configuration.

ARGUMENTS: None.

RETURNS: blessed $object, or undef on failure.

METHODS

path()

my $path = $IBAPI->path();

Get the base install path of the uncompressed IBJts directory.

ARGUMENTS: None.

RETURNS: Directory $name, with no trailing path separator.

includes()

my $includes = $IBAPI->includes();

Get the required -I include directives, for compiling against this library.

ARGUMENTS: None.

RETURNS: Complete list of -I paths, space-separated.

classpath()

my $classpath = $IBAPI->classpath();

Get the Java CLASSPATH value for the jtsclient.jar file containing the compiled com.ib.client classes.

ARGUMENTS: None.

RETURNS: Full path to jtsclient.jar, ready for the environment.

version()

my $api_version = $IBAPI->version();

Get the version of the installed IB API.

(Not to be confused with Alien::InteractiveBrokers $VERSION, which is the Perl wrapper's version number.)

ARGUMENTS: None.

RETURNS: IB API version number, as read from $path/API_VersionNum.txt

EXPORTS

use Alien::InteractiveBrokers qw( path includes classpath version );

This module OPTIONALLY exports the following subs:

• "path()"

• "includes()"

• "classpath()"

• "version()"

SEE ALSO

POE::Component::Client::InteractiveBrokers

Finance::InteractiveBrokers::API

Finance::InteractiveBrokers::SWIG

Finance::InteractiveBrokers::Java

The POE documentation, POE::Kernel, POE::Session

http://poe.perl.org/ - All about the Perl Object Environment (POE)

http://www.interactivebrokers.com/ - The InteractiveBrokers website

http://www.interactivebrokers.com/php/apiUsersGuide/apiguide.htm - The IB API documentation

The examples/ directory of this module's distribution

AUTHORS

Jason McManus, <infidel at cpan.org>

ACKNOWLEDGEMENTS

Many of the build scripts in this module were modelled on Alien::IE7.

BUGS

Please report any bugs or feature requests to bug-alien-interactivebrokers at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Alien-InteractiveBrokers. The authors will be notified, and then you'll automatically be notified of progress on your bug as changes are made.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Alien::InteractiveBrokers

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Alien-InteractiveBrokers

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Alien-InteractiveBrokers

• CPAN Ratings

  http://cpanratings.perl.org/d/Alien-InteractiveBrokers

• Search CPAN

  http://search.cpan.org/dist/Alien-InteractiveBrokers/

LICENSE AND COPYRIGHT

Copyright (c) 2010-2011 Jason McManus

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

The authors are not associated with InteractiveBrokers, and as such, take no responsibility or provide no warranty for your use of this module or the InteractiveBrokers service. You do so at your own responsibility. No warranty for any purpose is either expressed or implied by your use of this module suite.

The data from InteractiveBrokers are under an entirely separate license that varies according to exchange rules, etc. It is your responsibility to follow the InteractiveBrokers and exchange license agreements with the data.

cpanm Alien::InteractiveBrokers

perl -MCPAN -e shell
install Alien::InteractiveBrokers