Initial pass at documentation for ILS::Item

Delete unused access method

Add code to build HTML documentation from the podfiles.

Finish first pass at documentation for ILS module

Minor code cleanups

Adjust tests to agree with the code.  Since the server reports
that a patron is valid, but the password was wrong, we need to
make sure that that's what the tests expect.

Sequence numbers are a single digit, so when it hits 10, wrap
around to 0.

Adjust the test data so that it works with the test cases.

If the patron is valid, but the patron password is provided, and
wrong, still report that the patron's good.  This seems to be
what clients are expecting, and since we can "trust" them, we
will give them full disclosure.

'0' is a valid sequence number (it comes after '9'), so we have
to see if the sequence number is set, not just if it's true.

minor cleanups

Add a bunch of tests, and stock field checks

Make sure to set BL: Patron Valid when the patron is, in fact,
valid (uncovered by the tests)

Fix formatting, export FID_PATRON_BIRTHDATE FID_PATRON_CLASS

Add support for FID_PATRON_BIRTHDATE (PB) and FID_PATRON_CLASS
(PC) to Patron Information Response, for Envisionware terminals.

Add stub methods sip_birthdate and ptype, to support Envisionware
terminals (and probably others).

Change port for raw socket connection from 5300 (chosen at random
by your's truly) to 6001, as per Envisionware email.

Very basic tests.  This will be a big test case.  I suspect that
the test harness will have to be enhanced in a variety of ways,
including some way of indicating fields that SHOULD NOT appear,
as well as just fields that are required.

Generalize handling of tagged fields, so we can reuse field
specifications between test scenarios.

Fix Patron Information message handling to parallel the situation
in the handling of Patron Status messages: if the password's not
provided by the terminal, then we don't worry about checking the
password, but if the terminal gives us the password, then it has
to match before we say anything about the patron.

Replace call to nonexistent method 'hold_items_count' with
correct code.

Return an item title, even if the checkout failed (assuming that
the item ID was valid).

Clean up handling of Patron Status Response messages when there's
no password provided by the terminal.  I have a strong suspicion
that there exist terminals that expect to get patron status or
patron information even if they don't provide a password.

Create code to test tagged field values, create tests for Patron
Status message

Initial test environment

Clean up handling of SIP boolean flags, and fix interface to
write_msg().  Since it never used the $server parameter, get rid
of it, and add an optional $file parameter, so that write_msg()
can be use by the test harness.

Remove hold_items_count method, and move the code to drop a hold
into a Patron method, rather than embedding it in the ils
transaction level.

Implement code to handle Renew All messages.

Minor cleanups.

Move add_count() into Sip.pm

Consistently use methods to access fields in Transaction status
objects.

Minor cleanups.

Minor cleanups.

move available() method out of Transaction and into Item.

add messages for Renew, Renew All, and Patron Enable

Move add_count() to Sip.pm from Sip::MsgType.pm

Implement stubs necessary for Renew All support.

Consistently use methods to access fields rather than getting
at the fields directly.

Switch to AUTOLOAD-based field access

Stub code to handle renewals

Add stub code necessary to support item renewal

Add support for Renew message

Change IP on service so that it will work regardless of the IP of
the host.

Stub code to handle status returned by a "hold" transaction.

Clean up some test messages so they work against the existing
test stub.  Add messages for placing and cancelling a hold.

Add support for Hold message

Add support for placing, altering, and cancelling holds

Use the new $patron->block() method.  Implement support for the
Patron Enable message

Move block() from the ILS into the ILS::Patron.  Create the
opposite enable() method to support the Patron Enable message

Get handling of institution IDs right.  Make "block_patron" a
method of the ILS::Patron object, rather than an ILS method

Add support for Status Update message

Add stub to handle Status Update message

use the new ILS::check_inst_id to verify the institution ID that
we receive from the terminal.

Also implement support for Item Information message.

Added stub routines that provide support for the Item Information
Response message.

Sip::timestamp now takes an optional parameter (seconds since the
epoch) and generates a timestamp for that time.  Default
continues to be timestamp of 'now'.

new ILS takes an institution configuration as input, so the name
of the ILS institution is the $institution->{id}

Added code to verify the institution id, and to manage due dates
within the stub item db.

Delete handling of "FID_FEE_ITEMS", since it doesn't exist (the
Patron Information Response message documentation is wrong).
Correct handling of Address, Email, and Home Phone fields in
Patron Information Response in response to corrections from 3M

Delete non-existent "FID_FEE_ITEMS", since we heard back from 3M
that the documentation about the Patron Information Response
message was incorrect.

Don't use "ILS::pay_fee()", use "$ils->pay_fee()"

Change label for tag generation

More documentation

Initial documentation for the ILS.pm portable interface between
the SIP code and the ILS.

adding loadable module support

Base makefile that just simplifies some common operations

Stub for Fee Paid functionality.  Right now this is all handled
in the Transaction module itself.

Implement stub support for Checkin operations in the ILS

Implement Superclass handlers necessary for Checkin and Fee Paid

Implement Checking and Fee Paid response messages

Fix calculation of ends of lists of items used in the Patron
Status Response message

Add support necessary for Checkin operation

Implement Checkin and Fee Payment stubs

Strip off error detection fields, since they're automatically
generated by the (Python) test harness anyway.  This way it's
easier to cut/paste messages into the interactive test session (I
really must develop a real test harness).

Change some fields to match the test database hardcoded into the
ILS module.

Add support for End Patron Session message

Add end_patron_session stub

Added Patron Information request message

Move $last_response here from Sip/MsgType.pm

Restructure code to handle Patron Information message, move more
code into Sip.pm

Create stub APIs that provide information needed for Patron
Information Response message

Defined field identify FID_FEE_ITEMS.  This field id isn't
defined by the specification, but it's required by the Patron
Information Response message.  The current value is a place
holder (and a guess at the true value), until we can hear back
from 3M about what the correct value is.

Moved utility functions from Sip::Msgtype to here.

Add support for "Patron Information" message and move some
utility functions into Sip.pm, in an attempt to manage the size
of this file.  In the long run, MsgType.pm will probably be split
into a set of files that collect similar sorts of messages
together.

changed service IP address

Create fields to store pending "screen message" and "print line",
initially needed for "Block Patron" messages.

"block patron" stub implemented.  Basically just flag all the
patron actions as not allowed.

Block Patron implemented.  This required extracting the guts of
the "Patron Status" message handler out into a utility function
since both "Block Patron" and "Patron Status" messages require a
"Patron Status Response" message.

Deleted sub y_or_n(), since it duplicates
Sip::MsgType::sipbool(), and that module is the only place it's
used.

Define subs that provide status information necessary for
handle_acs_status()

Delete vestigal build_checkout_failed subroutine, convert
handle_acs_status() to query status from ILS rather than from
configuration file.

Implement Checkout message type based on the new ILS interfaces.

Checkout transaction stub module.  Derived from the Transaction
superclass.

Beginnings of the stub Transaction class.  All ILS transactions
(checkout, renew, etc.) are derived from this base class.

Implement Checkout operation stub using the Transaction and
Transaction::Checkout modules.

Beginnings of the Item stub module: support for the Checkout
operation

Fix package name, initialize ILS module.

Initial revision