NAME

Religion::Bible::Reference - canonicalize shorthand bible references

VERSION

version 0.00_03

$Id$

SYNOPSIS

use Religion::Bible::Reference;

my $quote = bibref("jn8:32");

print "($quote)";   # (John 8:32)
print $quote->book; # John

DESCRIPTION

This module converts simple text descriptions of bible references and ranges into objects that stringify into a canonical form.

FUNCTIONS

bibref($ref_string)

This function is exported by default, and constructs a new Religion::Bible::Reference

METHODS

Religion::Bible::Reference->new($ref_string)

This method acts just like the exported bibref function.

$self->stringify

This method returns a string representing the reference, using the canonical book name.

$class->canonicalize_book($book_abbrev)

If possible, this method returns the canonical name of the book whose abbreviation was passed.

$class->parse_range($range_string)

This method returns a hash reference describing the range described in the passed string.

$class->validate_verse($book, $chapter, $verse)

This method returns true if the given book, chapter, and verse exists; otherwise it returns false.

AUTHOR

Ricardo Signes, <rjbs@cpan.org>

TODO

• allow Text::Abbrev instead of registered abbrevs

• clean up regex/lists

• make public the interface to load modules of books and abbreviations

• make an interface to unload modules

BUGS

Please report any bugs or feature requests to bug-religion-bible-reference@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT

Copyright 2005 Ricardo Signes, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.