How mdarnob007/train-ticket works
This is a hands-on CLI bot for booking Bangladesh Railway e-tickets at release time. The principal workflow starts in bin/start.py: establish or reuse a browser session, search for the requested train, obtain its seat layout, choose seats, and use the browser to confirm the selection. Booking stops at the passenger form; payment remains a manual handoff. The graph preserves the API/browser split and the documented login, seat-preference, and OTP capabilities. Some internal links are based on imports and README statements; unsampled implementation details are not inferred.
Main entry points: start.py Booking CLI · api_client.py Rail API client · session.py Login and session · seat_picker.py Seat selection
Components 18
CLI orchestration
- Booking CLI
bin/start.py
Browser session
- Login and session
app/rpa/session.py - Browser driver
app/rpa/driver.py - OTP entry
app/rpa/otp.py
Trip and seats
- Rail API client
app/rpa/api_client.py - Train search
app/rpa/search.py - Seat layout
app/rpa/layout.py - Seat selection
app/rpa/seat_picker.py - Seat confirmation
app/rpa/reserve.py
Configuration and state
- Settings
app/config.py - Booking state
app/models/job.py - API definitions
app/models/apidefs.py - UI selectors
app/models/selectors.py
Other components
- Traveler
- Railway booking site
- Shohoz API
- Passenger form
- Manual payment
Connections 25
- Traveler → Booking CLI: runs
- Booking CLI → Settings: loads settings
bin/start.py - Booking CLI → Booking state: creates run
bin/start.py - Booking CLI → Login and session: establishes session
bin/start.py - Booking CLI → Train search: searches trains
bin/start.py - Booking CLI → Seat layout: loads layout
bin/start.py - Booking CLI → Seat selection: chooses seats
bin/start.py - Booking CLI → Seat confirmation: confirms seats
bin/start.py - Login and session → Browser driver: uses browser
app/rpa/session.py - Login and session → Rail API client: uses API
app/rpa/session.py - Train search → Rail API client: requests trips
app/rpa/search.py - Seat layout → Rail API client: requests layout
app/rpa/layout.py - Seat layout → Browser driver: reads seat modal
app/rpa/layout.py - Seat selection → Browser driver: resolves seats
app/rpa/seat_picker.py - Seat confirmation → Seat selection: uses selection
app/rpa/reserve.py - Browser driver → Railway booking site: drives browser
- Rail API client → Shohoz API: sends API requests
app/rpa/api_client.py - Rail API client → API definitions: uses endpoints
app/rpa/api_client.py - Login and session → UI selectors: uses locators
app/rpa/session.py - Train search → UI selectors: uses locators
app/rpa/search.py - Seat selection → UI selectors: uses locators
app/rpa/seat_picker.py - Seat confirmation → Passenger form: continues to form
- Traveler → OTP entry: enters code
- Traveler → Passenger form: fills details
- Traveler → Manual payment: completes manually