Download the Code
for the Blocks SpaceKit for Perl
Before downloading Invisible Worlds' source code, be sure you have read, understand, and agree with the Blocks Public License.
The code is available as either a .zip or a .tar.gz file. The code and ancillary html pages for the Blocks SpaceKit for Perl will extract into a directory called "SpaceKit."
DOWNLOAD as .zip (170K)
DOWNLOAD as .tar.gz (84K)
Blocks SpaceKit for Perl is a collection of Perl modules which provides a simple and consistent application programming interface (API) to the Blocks eXtensible eXchange Protocol (BXXP). The main focus of the library is to provide classes and functions that allow you to write Space clients, also known as mixers. The library also contains modules that are of more general use and even classes that help you implement simple BXXP servers.
In order to install and use this package you will need Perl version 5.004 or better. Some modules within this package depend on other packages that are distributed separately from Perl. We recommend that you have the following packages installed before you install spacekit-perl:
- Data-Dumper
- Digest-MD5
- MIME-Base64
- MIME-Lite
- MIME-Parser
- TimeDate
- Time-HiRes
- XML-Parser
Additional modules are required to use the example client and server applications:
These packages should be available on CPAN.
You install spacekit-perl, as you would install any perl module library, by running these commands:
- perl Makefile.PL
- make
- make test
- make install
You can edit the configuration section of Makefile.PL to select which programs to install in addition to the library itself. If you don't want to install any programs (only the library files) and don't want to mess with the Makefile.PL then pass the '-n' option to Makefile.PL:
perl Makefile.PL -n
If you want to install a private copy of spacekit-perl in your home directory, then you should try to produce the initial Makefile with something like this command:
perl Makefile.PL LIB=~/perl
The Makefile.PL program will start out by checking your perl installation for a few packages that are recommended to be installed together with spacekit-perl.
See lib/Space.pm for an overview of the library. See ChangeLog for recent changes. POD style documentation is included in all modules and scripts. These are normally converted to manual pages and installed as part of the "make install" process. You should also be able to use the 'perldoc' utility to extract and read documentation from the module files directly.
Next: begin the tutorial »The Blocks SpaceKit for Perl.
|
