A Python package for tracking parcels from various Bangladeshi courier services including Redx, Steadfast, Pathao, Rokomari, and Sundarban.
- 🚚 Support for major Bangladeshi courier services
- 📦 Unified tracking interface across all providers
- ⏱️ Detailed timeline of parcel journey
- 🎯 Easy-to-use delivery status checking
- 🔄 Real-time tracking with live API integration
- 📊 Comprehensive tracking event data
- 🐍 Python 3.8+ support
- 🛠️ Command-line interface included
- Redx - Leading courier service in Bangladesh
- Steadfast - Reliable delivery solutions
- Pathao - Fast and efficient courier service
- Rokomari - Book and product delivery specialist
- Sundarban - Comprehensive logistics and courier solutions
The package is available on PyPI. Install it using pip:
pip install bangladeshi-parcel-trackerFor development installation:
git clone https://github.com/yourusername/bangladeshi-parcel-tracker.git
cd bangladeshi-parcel-tracker
pip install -e .from bangladeshi_parcel_tracker import RedxTracker, SteadfastTracker
# Track a Redx parcel
tracker = RedxTracker("RDX123456789")
events = tracker.track()
# Check if delivered
if tracker.is_delivered():
print("Package has been delivered!")
else:
print(f"Current status: {tracker.get_current_status().value}")
# Print timeline
for event in events:
print(event)from bangladeshi_parcel_tracker import (
RedxTracker, SteadfastTracker,
PathaoTracker, RokomariTracker, SundarbanTracker
)
tracking_number = "YOUR_TRACKING_NUMBER"
# For Pathao and Rokomari, you may need phone number
phone_number = "01700000000" # Required for some providers
# Choose your provider
trackers = {
'redx': RedxTracker(tracking_number),
'steadfast': SteadfastTracker(tracking_number),
'pathao': PathaoTracker(tracking_number, phone=phone_number),
'rokomari': RokomariTracker(tracking_number, phone=phone_number),
'sundarban': SundarbanTracker(tracking_number)
}
for name, tracker in trackers.items():
try:
events = tracker.track()
print(f"\\n{tracker.provider_name} Tracking:")
print(f"Status: {tracker.get_current_status().value}")
print(f"Delivered: {tracker.is_delivered()}")
print(f"Last Update: {tracker.get_last_update()}")
for event in events:
print(f" {event}")
except Exception as e:
print(f"Error tracking with {name}: {e}")The package includes a powerful CLI for tracking parcels from the terminal:
After installing the package from pip, you can use the bangladeshi-parcel-tracker command:
# Basic usage
bangladeshi-parcel-tracker <provider> <tracking_number>
# Show help
bangladeshi-parcel-tracker --help
# Show version
bangladeshi-parcel-tracker --version# Track with Redx (detailed timeline)
bangladeshi-parcel-tracker redx RDX123456789
# Track with Steadfast (status only)
bangladeshi-parcel-tracker steadfast SF987654321 --status-only
# Track with Pathao (JSON output) - requires phone number
bangladeshi-parcel-tracker pathao PA456789123 --phone 01700000000 --json
# Track with Rokomari (detailed timeline) - requires phone number
bangladeshi-parcel-tracker rokomari RK789123456 --phone 01700000000 --detailed
# Track with Sundarban (detailed timeline)
bangladeshi-parcel-tracker sundarban 70003000778899 --detailed--status-only,-s: Show only the current delivery status--detailed,-d: Show detailed timeline with all events (default)--json,-j: Output results in JSON format--phone,-p: Phone number (required for Pathao and Rokomari)--version,-v: Show version information--help,-h: Show help message
Status Only Output:
📊 Tracking Status for RDX123456789
==================================================
Provider: Redx
Status: 🚛 Out For Delivery
Delivered: ❌ No
Last Update: 2025-01-15 15:45:00
Detailed Timeline:
📦 Detailed Tracking for SF987654321
============================================================
Provider: Steadfast
Current Status: ✅ Delivered
Delivered: ✅ Yes
Total Events: 4
📅 Timeline:
------------------------------------------------------------
1. ⏳ [2025-01-15 08:00:00] Pending
📍 Location: Steadfast Hub
📝 Order received and processing
2. 📦 [2025-01-15 10:30:00] Picked Up
📍 Location: Pickup Point
📝 Package collected from merchant
3. 🚚 [2025-01-15 14:15:00] In Transit
📍 Location: Transit Hub
📝 Package in transit to destination
4. ✅ [2025-01-15 16:00:00] Delivered
📍 Location: Customer Address
📝 Package delivered successfully
JSON Output:
{
"tracking_number": "PA456789123",
"provider": "Pathao",
"current_status": "in_transit",
"is_delivered": false,
"last_update": "2025-01-15T13:20:00",
"total_events": 3,
"events": [
{
"timestamp": "2025-01-15T09:15:00",
"status": "pending",
"location": "Pathao Warehouse",
"description": "Parcel received at warehouse",
"details": null
}
]
}All provider classes inherit from BaseTracker and implement these methods:
provider_name: str- Name of the courier servicetracking_number: str- The tracking/consignment number
track() -> List[TrackingEvent]- Fetch tracking eventsis_delivered() -> bool- Check if parcel is deliveredget_current_status() -> TrackingStatus- Get current tracking statusget_last_update() -> Optional[datetime]- Get timestamp of last updaterefresh() -> List[TrackingEvent]- Force refresh tracking data
Represents a single tracking event:
@dataclass
class TrackingEvent:
timestamp: datetime
status: TrackingStatus
location: Optional[str] = None
description: Optional[str] = None
details: Optional[str] = NoneEnumeration of possible tracking statuses:
PENDING- Order received/processingPICKED_UP- Package picked upIN_TRANSIT- Package in transitOUT_FOR_DELIVERY- Out for deliveryDELIVERED- Successfully deliveredRETURNED- Returned to senderCANCELLED- Order cancelledFAILED_DELIVERY- Delivery attempt failedUNKNOWN- Status unknown
The package provides a custom TrackingError exception:
from bangladeshi_parcel_tracker import TrackingError
try:
tracker = RedxTracker("INVALID123")
events = tracker.track()
except TrackingError as e:
print(f"Tracking failed: {e}")
print(f"Provider: {e.provider}")
print(f"Tracking Number: {e.tracking_number}")# Clone the repository
git clone https://github.com/yourusername/bangladeshi-parcel-tracker.git
cd bangladeshi-parcel-tracker
# Install in development mode
pip install -e .
# Format code
black src/Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Follow the existing code style (Black formatting)
- Update documentation as needed
- Ensure your changes work with the existing API structure
To add a new courier service provider:
- Create a new file in
src/bangladeshi_parcel_tracker/providers/ - Inherit from
BaseTracker - Implement the
track()method - Add provider to
__init__.py
Example:
from ..base import BaseTracker, TrackingEvent, TrackingStatus
class NewProviderTracker(BaseTracker):
@property
def provider_name(self) -> str:
return "New Provider"
def track(self) -> List[TrackingEvent]:
# Implementation here
passThis project is licensed under the MIT License - see the LICENSE file for details.
- Available on PyPI as
bangladeshi-parcel-tracker - Thanks to all Bangladeshi courier services for their tracking systems
- Built with ❤️ for the Bangladeshi developer community
This package is not officially affiliated with any of the courier services. It's an independent tool created to help developers integrate parcel tracking functionality into their applications.
The package uses publicly available tracking APIs and websites to fetch parcel information. Please use responsibly and respect the terms of service of each courier provider.
