https://github.com/Keda87/python-quran-odoa

:blue_book: Python library to get random ayah within quran surah for supporting "ODOA" (One Day One Ayah) campaign.
https://github.com/Keda87/python-quran-odoa

asyncio hacktoberfest library python python3 quran quran-api

Last synced: about 1 month ago
JSON representation

:blue_book: Python library to get random ayah within quran surah for supporting "ODOA" (One Day One Ayah) campaign.

• Host: GitHub
• URL: https://github.com/Keda87/python-quran-odoa
• Owner: Keda87
• License: mit
• Created: 2015-09-27T02:44:41.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2022-07-03T06:53:15.000Z (over 2 years ago)
• Last Synced: 2024-04-24T23:42:01.745Z (8 months ago)
• Topics: asyncio, hacktoberfest, library, python, python3, quran, quran-api
• Language: Python
• Homepage:
• Size: 20.5 KB
• Stars: 12
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-Islam - python-quran-odoa
• Awesome-Muslims - Python Quran ODOA

README

        
Python Quran ODOA 

=================

[![Build Status](https://travis-ci.org/Keda87/python-quran-odoa.svg?branch=master)](https://travis-ci.org/Keda87/python-quran-odoa) 

[![pypi](https://badge.fury.io/py/python-quran-odoa.svg)](https://badge.fury.io/py/python-quran-odoa) 

[![codecov](https://codecov.io/gh/Keda87/python-quran-odoa/branch/master/graph/badge.svg)](https://codecov.io/gh/Keda87/python-quran-odoa)

Python library to display random ayah within quran surah including the translation.

Currently supports only Bahasa Indonesia and English.

This library is part of supporting ODOA (One Day One Ayat) campaign and using datasource from [quranjson](https://github.com/semarketir/quranjson).

 

Prerequisite:

-------------

- Python v3.6.+

Installation:

-------------

**Pip:**

```bash

$ pip install python-quran-odoa

```

**Usage:**

```python

from odoa import ODOA

o = ODOA()

# by default the translation using bahasa indonesia,

# pass `lang='en'` if you want english translation.

surah = await o.get_random_surah()  # odoa.get_random_surah(lang='en')

surah.ayah

surah.desc

surah.translate

surah.sound

```