Skip to main content

this is a command line tool to get tracking information about your parcels from tracking.post.ir

Project description

PyPI - Version PyPI - Python Version Downloads

Issues Stargazers MIT License


Post Tracker

A command-line tool to get information about parcel's tracking from https://tracking.post.ir

Report Bug · Request Feature


Screenshot

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:

Repository . Robot


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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

post_tracker-0.3.1.tar.gz (313.8 kB view details)

Uploaded Source

Built Distribution

post_tracker-0.3.1-py3-none-any.whl (10.8 kB view details)

Uploaded Python 3

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

Hashes for post_tracker-0.3.1.tar.gz
Algorithm Hash digest
SHA256 cb31eb74885fdff5a783402d4f049ca459800f6e024568459c605845296a5f81
MD5 8713e1ba5e2def010a63325886f3b830
BLAKE2b-256 7bb97ffd7fb9e249c9f880f7f4504ddfb46b9831c7ddda3300af8fe337818e6f

See more details on using hashes here.

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

Hashes for post_tracker-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b0098bd03fbb31c484c79d450f2b65d3606df30d6498b709ee964748e6b93980
MD5 8a599b379926d9792bbf7d4b428e7995
BLAKE2b-256 ecc0c56bc8b4eb8b7b65408480ff63f55cbf5ae1967fafd21d6ae3c73cadd21c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page