hafez 0.1.3

Hafez Poems

Divan Hafez Poems & Omen

This library gives you access to the Hafez Poems. To get more information about this poet, you can check https://en.wikipedia.org/wiki/Hafez.

Poems can be accessed as following:

• By the number of poem,
• By searching a query,
• Random poem (known as Omen or Fal in Persian)

Installation

This package can be installed:

• using pip:

pip install hafez

• using Makefile on a cloned/forked repo:

make install

• using pip on a cloned/forked repo:

pip install -e . --upgrade --upgrade-strategy only-if-needed

Methods

• hafez.total_poems() -> int

It returns int, the total number of poems available in the package.

• hafez.get_poem(poem_id: int) -> dict

poem_id is a number between 1 and hafez.total_poems(). It returns the poem in a dictionary format (see Poem Data Structure)

• hafez.omen() or hafez.fal() -> dict

It returns a random poem in a dictionary format (see Poem Data Structure)

• hafez.search(qeury: str) -> list

query is a string to search within the verses of the Divan Hafez It returns a list of poems in a dictionary format (see Poem Data Structure)

Poem's Data Structure

{"id": 1,
"poem": [],
"interpretation": "",
"mp3": "https://..."}

Example

# it returns the total number of poems
# returns: int
total_number_of_poems = hafez.total_poems()

# get a poem by ID
# returns: dict
poem_5 = hafez.get_poem(5)

# get a random poem - omen (fal)
# returns: dict
omen = hafez.omen()  # same as: hafez.fal()

# search within the verses of poems
# returns: list[dict]
search_result = hafez.search("حافظ")

Database

The poems of Divan Hafez are extracted from an open-source database as below:

Source: https://github.com/mahmoud-eskandari/HafezFaalDatabase

Vocal Audios

The vocal audio files are done by Ms. Modares Zadeh, and it is available below:

Source: https://avayemastan.deklame.net/hafez/

Demo

You can access the demo version deployed on Streamlit server at:

https://divan-hafez.streamlit.app/

Developer(s)

Kaveh Bakhtiyari - Website | Medium | LinkedIn | Github

Contribution

Feel free to join the open-source community and contribute to this repository.