this is a command line tool to get tracking information about your parcels from tracking.post.ir
Project description
Post Tracker
A command-line tool to get information about parcel's tracking from https://tracking.post.ir
Install the program :
install the post-tracker using pip :
pip install post-tracker
Using as a library
To use the post_tracker
as a library in your projects, do as following :
import asyncio
from post_tracker import PostTracker
from post_tracker.errors import TrackingNotFoundError
async def main():
code = "12345" # tracking code
async with PostTracker() as tracker_app:
try:
# get tracking data
result = await tracker_app.get_tracking_post(tracking_code=code)
print(result)
except TrackingNotFoundError as e:
# tracking data not found
return print(e)
asyncio.run(main())
Using as a CLI tool
After install, just write post-tracker
command to access to program :
# get help
post-tracker -h
# or, pass your tracking code
post-tracker -c 123456789101111213
Telegram Bot:
there is also a telegram robot developed based on this library to get parcel's tracking information in telegram:
Contributing
Contributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
Here is the Contributing Guidelines. Don't forget to give the project a star! Thanks again!
License
Distributed under the MIT License. See LICENSE
for more information.
TODO:
- create models to better parsing the data.
- create dmenu (or fzf menu) to save tracking codes in local cache and select in future program's runs.
- add installer script as a CLI tool in linux machines.
- create python telegram bot.
- make output result prettiy.
- make and test compatibily with windows os
- publish on pypi.org
- write README.md in persian
- re-write cli using click library
- write tests
- add CI/CD
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file post_tracker-0.3.1.tar.gz
.
File metadata
- Download URL: post_tracker-0.3.1.tar.gz
- Upload date:
- Size: 313.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cb31eb74885fdff5a783402d4f049ca459800f6e024568459c605845296a5f81 |
|
MD5 | 8713e1ba5e2def010a63325886f3b830 |
|
BLAKE2b-256 | 7bb97ffd7fb9e249c9f880f7f4504ddfb46b9831c7ddda3300af8fe337818e6f |
File details
Details for the file post_tracker-0.3.1-py3-none-any.whl
.
File metadata
- Download URL: post_tracker-0.3.1-py3-none-any.whl
- Upload date:
- Size: 10.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b0098bd03fbb31c484c79d450f2b65d3606df30d6498b709ee964748e6b93980 |
|
MD5 | 8a599b379926d9792bbf7d4b428e7995 |
|
BLAKE2b-256 | ecc0c56bc8b4eb8b7b65408480ff63f55cbf5ae1967fafd21d6ae3c73cadd21c |