Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
## [Unreleased]
## [0.1] - 2025-xx-xx
### Added
- Item1
- Item2
- Item3
- `get_events` function
- Jalali events
- Gregorian events
- Hijri events


[Unreleased]: https://github.com/openscilab/rokh/compare/v0.1...dev
Expand Down
11 changes: 8 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
<div align="center">
<img src="https://github.com/openscilab/rokh/raw/main/otherfiles/logo.png" alt="Rokh Logo" width="220">
<h1>Rokh: Iranian Calendar Events Collection</h1>
<br/>
<a href="https://badge.fury.io/py/rokh"><img src="https://badge.fury.io/py/rokh.svg" alt="PyPI version"></a>
Expand All @@ -16,7 +15,7 @@
Rokh provides a unified interface for accessing Iranian calendar events across Jalali, Gregorian, and Hijri date systems. It lets you easily retrieve national holidays, cultural events, and religious occasions by simply passing a date. It automatically converts between calendars and return event's description.
You can use it in your apps, bots, and research tools that rely on Iranian date conversions, holidays, and cultural event data.

In Farsi, Rokh is derived from Rokhdad, meaning "event." Rokh itself also means face and even refers to the "rook" piece in chess.
In Farsi, Rokh is derived from Rokhdad, meaning "event." Rokh itself also means "face" and even refers to the "rook" piece in chess.

</p>

Expand Down Expand Up @@ -51,7 +50,7 @@ In Farsi, Rokh is derived from Rokhdad, meaning "event." Rokh itself also means
</td>
<td align="center">
<img src="https://github.com/openscilab/rokh/actions/workflows/test.yml/badge.svg?branch=dev">
</td>
</td>
</tr>
</table>

Expand Down Expand Up @@ -105,6 +104,12 @@ Just fill an issue and describe it. We'll check it ASAP! or send an email to [ro
- Please complete the issue template


## References

<blockquote>1- <a href="https://www.time.ir/">ساعت و تقویم ایران | تاریخ امروز | Time.ir</a></blockquote>
<blockquote>2- <a href="https://holidayapi.ir/">Jalali Holiday API</a></blockquote>


## Show your support


Expand Down
7 changes: 5 additions & 2 deletions setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -33,14 +33,14 @@ def read_description() -> str:
name='rokh',
packages=['rokh', 'rokh.events'],
version='0.1',
description="Rokh provides a unified interface for accessing Iranian calendar events across Jalali, Gregorian, and Hijri date systems. It lets you easily retrieve national holidays, cultural events, and religious occasions by simply passing a date. It automatically converts between calendars and return event's description. You can use it in your apps, bots, and research tools that rely on Iranian date conversions, holidays, and cultural event data. In Farsi, Rokh is derived from Rokhdad, meaning \"event.\" Rokh itself also means “face” and even refers to the \"rook\" piece in chess.",
description="Rokh: Iranian Calendar Events Collection",
long_description=read_description(),
long_description_content_type='text/markdown',
author='Rokh Development Team',
author_email='rokh@openscilab.com',
url='https://github.com/openscilab/rokh',
download_url='https://github.com/openscilab/rokh/tarball/v0.1',
keywords="events date date-system",
keywords="events date date-system calendar gregorian hijri jalali",
project_urls={
'Source': 'https://github.com/openscilab/rokh',
},
Expand All @@ -49,6 +49,7 @@ def read_description() -> str:
classifiers=[
'Development Status :: 2 - Pre-Alpha',
'Natural Language :: English',
'Natural Language :: Persian',
'License :: OSI Approved :: MIT License',
'Operating System :: OS Independent',
'Programming Language :: Python :: 3.7',
Expand All @@ -64,6 +65,8 @@ def read_description() -> str:
'Intended Audience :: End Users/Desktop',
'Intended Audience :: Manufacturing',
'Topic :: Education',
'Topic :: Office/Business :: Scheduling',
'Topic :: Utilities',
],
license='MIT',
)