{"id":27972696,"url":"https://github.com/neocl/freebible","last_synced_at":"2025-05-07T23:13:41.733Z","repository":{"id":57432184,"uuid":"119813796","full_name":"neocl/freebible","owner":"neocl","description":"Free holy bibles data and toolkit for Python developers","archived":false,"fork":false,"pushed_at":"2019-09-24T09:35:00.000Z","size":2907,"stargazers_count":24,"open_issues_count":1,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-07T23:13:36.684Z","etag":null,"topics":["bible","bible-api","bible-study","bible-translations","bibledata","free-software","python3"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/neocl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-02-01T09:30:49.000Z","updated_at":"2024-11-06T19:10:48.000Z","dependencies_parsed_at":"2022-09-19T08:01:55.247Z","dependency_job_id":null,"html_url":"https://github.com/neocl/freebible","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neocl%2Ffreebible","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neocl%2Ffreebible/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neocl%2Ffreebible/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/neocl%2Ffreebible/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/neocl","download_url":"https://codeload.github.com/neocl/freebible/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252968121,"owners_count":21833252,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bible","bible-api","bible-study","bible-translations","bibledata","free-software","python3"],"created_at":"2025-05-07T23:13:41.166Z","updated_at":"2025-05-07T23:13:41.724Z","avatar_url":"https://github.com/neocl.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# freebible library\n\nFree holy bibles data and toolkit for Python developers\n\n## Project Home Page\n\nhttps://github.com/neocl/freebible\n\n## Installation\n\nfreebible package is available on PyPI, so it can be installed via pip by using\n\n```bash\npip install freebible\n# or even better\npython3 -m pip install freebible\n```\n\nPlease note that freebible requires **Python 3**. It does not work on ~~Python 2~~ anymore. \n\n## Sample code\n\n### Easy access\n\n```python\n\u003e\u003e\u003e from freebible import bibles\n\n# Quote everything\n\u003e\u003e\u003e bibles.print(\"Gen\")\n[1] 創世記\n[1] Genesis\n\u003e\u003e\u003e bibles.print(\"Gen\", 1, 1)\n[Ge 1:1] 元始に神天地を創造たまへり \n[Gen 1:1] In the beginning God created the heavens and the earth.\n\n# Quote from a specific bible\n\u003e\u003e\u003e bibles.kougo.quote(\"John\")  # this returns a book object\nBook(ID='104', title='ヨハネ傳福音書', filename='John', title_eng='John', short_name='John')\n\u003e\u003e\u003e bibles.kougo.quote(\"John\", 1)  # this returns a chapter object\nChapter(ID='1')\n\u003e\u003e\u003e bibles.kougo.quote(\"John\", 1, 1)  # this returns a verse object\nJohn 1:1 太初に言あり、言は神と偕にあり、言は神なりき。 \n\n\u003e\u003e\u003e bibles.web.quote(\"John\")\nBook(ID='43', title='John', filename='', title_eng='John', short_name='John')\n\u003e\u003e\u003e bibles.web.quote(\"John\", 1)\nChapter(ID='1')\n\u003e\u003e\u003e bibles.web.quote(\"John\", 1, 1)\nJohn 1:1 In the beginning was the Word, and the Word was with God, and the Word was God.\n```\n\n### Accessing Kougo\n\n```python\n\u003e\u003e\u003e from freebible import read_kougo\n\u003e\u003e\u003e kougo = read_kougo()\n\u003e\u003e\u003e print(len(kougo))\n66\n\u003e\u003e\u003e print(kougo['John'])\n[104] ヨハネ傳福音書\n\u003e\u003e\u003e print(len(kougo['John']))\n21\n\u003e\u003e\u003e print(kougo['John'][1])\nChapter(ID='1')\n\u003e\u003e\u003e print(kougo['John'][1][1])\n[John 1:1] 太初に言あり、言は神と偕にあり、言は神なりき。\n```\n\n### Accessing World English Bible (WEB)\n\n```python\n\u003e\u003e\u003e from freebible import read_web\n\u003e\u003e\u003e web = read_web()\n\u003e\u003e\u003e print(len(web))\n66\n\u003e\u003e\u003e print(web['John'])\n[43] John\n\u003e\u003e\u003e print(len(web['John']))\n21\n\u003e\u003e\u003e print(web['John'][1])\nChapter(ID='1')\n\u003e\u003e\u003e print(len(web['John'][1]))\n51\n\u003e\u003e\u003e print(web['John'][1][1])\n[John 1:1] In the beginning was the Word, and the Word was with God, and the Word was God.\n```\n\n## Developer setup\n\nIf you want to contribute to the source code, you can setup the development environment like this\n```bash\n# Create a virtual environment to install packages\npython3 -venv ~/.envfreebible\n# Activate the virtual environment\n. ~/.envfreebible/bin/activate\n\n# Check out the source code to your machine\ngit clone https://github.com/freebible freebible-project\ncd freebible-project\n# Install required packages\npython3 -m pip install -r requirements.txt\n\n# Run the demo to make sure that this source code work\npython3 demo.py\n```\n\n## Bible sources:\n\nJapanese Colloquial 口語訳: http://jco.ibibles.net/\n\nWorld English Bible: https://github.com/scrollmapper/bible_databases\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneocl%2Ffreebible","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneocl%2Ffreebible","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneocl%2Ffreebible/lists"}