Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Wrapper for English Standard Version (ESV) Bible Web Service. See ESV API docs http://www.esvapi.org/
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
lib
spec
.document
.gitignore
LICENSE
README.rdoc
Rakefile
VERSION
esv.gemspec

README.rdoc

esv

Wrapper for English Standard Version (ESV) Bible Web Service. See ESV API docs www.esvapi.org/

This is a work in progress. Things are still in flux.

Source: github.com/gdagley/esv Build status: runcoderun.com/gdagley/esv

SYNOPSIS:

Application use:

b = ESV::Bible.new

Default response for most actions is HTML
b.passage_query('John 1:1') # => "<div class=\"esv\"><h2>John 1:1 <object type=\"application/x-shockwave-flash\"  data=\"http://www.esvapi.org/assets/play.swf?myUrl=hw%2F43001001\" width=\"40\" height=\"12\" class=\"audio\"><param name=\"movie\" value=\"http://www.esvapi.org/assets/play.swf?myUrl=hw%2F43001001\" /><param name=\"wmode\" value=\"transparent\" /></object></h2>\n<div class=\"esv-text\"><h3 id=\"p43001001.01-1\">The Word Became Flesh</h3>\n<p class=\"chapter-first\" id=\"p43001001.05-1\"><span class=\"chapter-num\" id=\"v43001001-1\">1:1&nbsp;</span>In the beginning was the Word, and the Word was with God, and the Word was God.  (<a href=\"http://www.esv.org\" class=\"copyright\">ESV</a>)</p>\n</div>\n</div>"

XML responses are converted to Hashes
b.passage_query('John 1:1', 'output-format' => 'crossway-xml-1.0') # =>  {"crossway_bible"=>{"class"=>"passage-query", "passage"=>{"reference"=>"John 1:1", "surrounding_chapters"=>{"previous"=>"Luke 24", "current"=>"John 1", "next"=>"John 2"}, "content"=>{"verse_unit"=>"<markerclass=\"begin-verse\" mid=\"v43001001\"></marker><begin_chapternum=\"1\"></begin_chapter><heading>The Word Became Flesh</heading><begin_paragraphclass=\"chapter-first\"></begin_paragraph><verse_numbegin_chapter=\"1\">1</verse_num>In the beginning was the Word, and the Word was with God, and the Word was God.<end_paragraph></end_paragraph>"}}, "copyright"=>"The Holy Bible, English Standard Version copyright (c)2001 by Crossway Bibles, a division of Good News Publishers. Used by permission. All rights reserved. http://www.esv.org"}}

Command line use:

'esv' - for looking up verses and passages

> esv John 1:1
======                                                    John 1:1
_______________________________________________________
The Word Became Flesh

   [1:1]In the beginning was the Word, and the Word was with God, and the 
Word was God. (ESV)

'esv_daily_verse' - for retrieving the ESV Daily Verse

> esv_daily_verse
======                                                    Romans 8:38-39
   [38]For I am sure that neither death nor life, nor angels nor rulers, 
nor things present nor things to come, nor powers, [39]nor height nor 
depth, nor anything else in all creation, will be able to separate us 
from the love of God in Christ Jesus our Lord. (ESV)

TODO

  • Add command line binaries for:

    • 'esv_daily_reading' - for retrieving the ESV Daily Reading Plan

  • Finish specs

  • Make more Ruby-like

REQUIREMENTS:

  • httparty

INSTALL:

  • sudo gem install gdagley-esv

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.

Copyright

Copyright © 2009 Geoffrey Dagley. See LICENSE for details.

The Holy Bible, English Standard Version copyright ©2001 by Crossway Bibles, a publishing ministry of Good News Publishers. Used by permission. All rights reserved.

Something went wrong with that request. Please try again.