Skip to main content

A module to scrape biblehub.com, also cli app

Project description

BibleHubScrapper

A python module that retrieve a single verse and the information on it from biblehub.com. Also a simple commandline application

Instillation

pip3 install BibleHubScrapper

Commandline

To retrieve all the currently available information on a reference, use the '-a' tag:

biblehub -a [Reference]

To only retrieve specific information, pass in the corresponding tag:

biblehub -c [Reference] # Also retrieves the cross-references
biblehub -t [Reference] # Also retrieves the lexicon

As with most cli tools, arguments can be stacked with one hyphen, such as:

biblehub -cl [Reference] # Retrieves the cross-references and lexicon in addition to the passage

Script Usage

You can import the query method to use in scripts.

from BibleHubScrapper import query

biblehub_query = query('Genesis 1:1')
print(biblehub_query.text) # In the beginning...

By default, it will query all possible fields. You can choose not to query certain fields by indicating in the parameters for example: query('Genesis 1:1', get_lexicons=False)

Useful fields

print(biblehub_query.passage) # Genesis 1:1
print(biblehub_query.version) # NIV (default)
print(biblehub_query.lexicons) # Text, Hebrew words, translit, strong, and English defintions
print(biblehub_query.crfs) # Cross References
print(biblehub_query.tos) # Treasury of Scripture
print(biblehub_query.info) # Prints all the info queried on the verse. Also the same as the __str__

there are also biblehub_query.format_[field] method that returns the specified field in an easy to read way.

Todo

  • Possibly support multiple verses
  • Possibly make vim plugin
  • Consider fetching commentaries, or a specific one
  • Implement search function
  • Reformat module structure
  • Create etc config file for formatting (colors, verbosity, etc.)

Contributing

If you feel like improving the codebase, adding a feature, or checking my grammar, feel free! Just make sure to send a pull request against the development branch.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

BibleHubScrapper-1.3.3.tar.gz (5.2 kB view hashes)

Uploaded source

Built Distribution

BibleHubScrapper-1.3.3-py3-none-any.whl (6.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page