Religion::Bible::Reference - canonicalize shorthand bible references
version 0.014
use Religion::Bible::Reference; my $quote = bibref("jn8:32"); print "($quote)"; # (John 8:32) print $quote->book; # John
This module converts simple text descriptions of bible references and ranges into objects that stringify into a canonical form.
WARNING! This module is mostly an idea and not so much a guaranteed interface or well-tested implementation. If you're interested in either of those existing, you should let me know.
This function is exported by default, and constructs a new Religion::Bible::Reference
Reference strings must be a book followed by a list of chapters, verses, or ranges. The following are all valid ranges:
Pro 23:12, 23:15-17 st.jn8:32 Song of Solomon 8:7-8 2 John 1
This method acts just like the exported bibref function.
bibref
This method returns a string representing the reference, using the canonical book name.
This method returns a string representing the reference, using the short book name.
In other words, John 8:32 would be Jn 8:32. All short forms should safely round-trip back via parsing.
If possible, this method returns the canonical name of the book whose abbreviation was passed.
validate_verse
$class->validate_verse($book, $chapter, $verse)
This method returns true if the given book, chapter, and verse exists; otherwise it returns false.
iterator
my $iterator = $bibref->iterator; while (my $verse = $iterator->next) { my $text = retrieve($verse); print "$text\n"; }
Ricardo Signes, <rjbs@cpan.org>
<rjbs@cpan.org>
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
Please report any bugs or feature requests 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 2005-2006 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.
To install Religion::Bible::Reference, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Religion::Bible::Reference
CPAN shell
perl -MCPAN -e shell install Religion::Bible::Reference
For more information on module installation, please visit the detailed CPAN module installation guide.