Coder Social home page Coder Social logo

nikhilkumarsingh / pyinrail Goto Github PK

View Code? Open in Web Editor NEW
43.0 5.0 23.0 151 KB

A python wrapper for Indian Railways Enquiry API!

License: MIT License

Python 100.00%
python3 indian-railways enquiry python-api captcha-breaker trains requests tesseract-ocr

pyinrail's Introduction

PyPI license

pyinrail

A python wrapper for Indian Railways Enquiry API!

  • Get trains between stations
  • Get seat availability
  • Get train fare
  • Get train schedule
  • Get train live running status
  • Get PNR status

...and much more!

Note: This is not an official package and using it for commercial purposes is not recommended.

Installation

To install pyinrail, simply,

$ pip install pyinrail

You will also need to install tesseract-ocr. Find instructions to install tesseract-ocr here.

Usage

  • Importing pyinrail
from pyinrail import pyinrail
  • Create RailwayEnquiry object
enq = pyinrail.RailwayEnquiry(src='new delhi', dest='ahmedabad', date='12-05-2018')
  • Get trains between stations
df = enq.get_trains_between_stations(as_df=True)
print(df)
         trainName trainNumber fromStnCode toStnCode departureTime arrivalTime duration  distance        avlClasses
0  ADI SJ RAJDHANI       12958        NDLS       ADI         19:55       09:40    13:45       935      [1A, 2A, 3A]
1  GUJRAT S KRANTI       12918         NZM       ADI         13:55       06:10    16:15      1085      [2A, 3A, SL]
2   ASHRAM EXPRESS       12916         DLI       ADI         15:20       07:40    16:20       934  [1A, 2A, 3A, SL]
3   ALA HAZRAT EXP       14311         DLI       ADI         11:45       06:15    18:30       933      [2A, 3A, SL]
4     YOGA EXPRESS       19032         DSA       ADI         21:26       17:10    19:44       963  [1A, 2A, 3A, SL]
5  DEE BDTS G RATH       12215         DEE       ADI         09:20       01:10    15:50       951              [3A]
  • Get seat availability
df = enq.get_seat_availability(12958, classc='2A', as_df=True)
print(df)
  availablityDate availablityStatus  availablityType currentBkgFlag reason reasonType  waitListType
0       12-5-2018    TRAIN DEPARTED             8224              Y                 W          8224
1       13-5-2018       GNWL68/WL24             8224              N                 S             9
2       14-5-2018        GNWL41/WL8             8224              N                 S             9
3       15-5-2018        GNWL25/WL6             8224              N                 S             9
4       16-5-2018       GNWL33/WL14             8224              N                 S             9
5       17-5-2018        GNWL20/WL9             8224              N                 S             9
  • Get train schedule
df = enq.get_train_schedule(12958, as_df=True)
print(df)
   stationCode   stationName departureTime arrivalTime routeNumber haltTime distance dayCount stnSerialNumber
0         NDLS     NEW DELHI         19:55          --           1       --        0        1               1
1          DEC   DELHI CANTT         20:25       20:23           1    02:00       16        1               2
2          GGN       GURGAON         20:43       20:41           1    02:00       32        1               3
3           JP        JAIPUR         00:30       00:20           1    10:00      309        2               4
4          AII      AJMER JN         02:29       02:25           1    04:00      443        2               5
5           FA         FALNA         04:53       04:52           1    01:00      650        2               6
6          ABR      ABU ROAD         06:05       06:01           1    04:00      748        2               7
7          PNU   PALANPUR JN         07:12       07:10           1    02:00      801        2               8
8          MSH   MAHESANA JN         08:05       08:03           1    02:00      866        2               9
9         SBIB  SABARMATI BG         09:02       09:00           1    02:00      929        2              10
10         ADI  AHMEDABAD JN            --       09:40           1       --      935        2              11
  • Get train fare
fare_data = enq.get_train_fare(12958, classc='2A')
print(fare_data)
{'baseFare': 1841,
 'cateringCharge': 225,
 'dynamicFare': 921,
 'fuelAmount': 0.0,
 'goodsServiceTax': 143.0,
 'otherCharge': 0,
 'reservationCharge': 50,
 'superfastCharge': 45,
 'tatkalFare': 0,
 'totalCollectibleAmount': 3225.0,
 'totalConcession': 0,
 'totalFare': 3225,
 'travelInsuranceCharge': 0.0,
 'travelInsuranceServiceTax': 0.0,
 'wpServiceCharge': 0.0,
 'wpServiceTax': 0.0}
  • Get train's live running status
train_detail, instances, detailed_instances = enq.get_train_status(12958, as_df=True)
print(train_detail)
print(instances)
print(detailed_instances[0])
{'dayCnt': '1',
 'from': 'NDLS',
 'runsOn': '1111111',
 'schArrTime': '09:40',
 'schDepTime': '19:55',
 'to': 'ADI',
 'trainName': 'ADI SJ RAJDHANI',
 'trainNo': '12958'}


     startDate  departed curStn  terminated        lastUpdated  totalLateMins
0  12 May 2018      True     RE       False  12 May 2018 21:43              6
1  11 May 2018      True    ADI        True   12 May 2018 9:27            -14


   stnCode    arr schArrTime actArr  delayArr    dep schDepTime actDep  delayDep  dayCnt  schDayCnt  distance
0     NDLS  False      00:00  00:00         0   True      19:55  19:55         0       0          0         0
1      DEC   True      20:23  20:27         4   True      20:25  20:29         4       0          0        15
2      GGN   True      20:41  20:47         6   True      20:43  20:49         6       0          0        32
3       RE   True      21:30  21:41        11   True      21:30  21:41        11       0          0        83
4       JP  False      00:20  00:20         0  False      00:30  00:30         0       1          1       308
5      AII  False      02:25  02:25         0  False      02:29  02:29         0       1          1       442
6       FA  False      04:52  04:52         0  False      04:53  04:53         0       1          1       649
7      ABR  False      06:01  06:01         0  False      06:05  06:05         0       1          1       747
8      PNU  False      07:10  07:10         0  False      07:12  07:12         0       1          1       800
9      MSH  False      08:03  08:03         0  False      08:05  08:05         0       1          1       865
10    SBIB  False      09:00  09:00         0  False      09:02  09:02         0       1          1       927
11     ADI  False      09:40  09:40         0  False      00:00  00:00         0       1          1       934

TODOs

  • A command line client
  • A GUI interface

Want to contribute?

  • Clone the repository

     $ git clone http://github.com/nikhilkumarsingh/pyinrail
    
  • Install dependencies

     $ pip install -r requirements.txt
    
  • To test local version of pyinrail:

     $ pip install -U .
    

    OR :

     $ pip install -e <project dir.> .
    

pyinrail's People

Contributors

nikhilkumarsingh avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

pyinrail's Issues

FileNotFoundError

FileNotFoundError: [Errno 2] No such file or directory: 'tesseract': 'tesseract'

ReCaptcha bypass

This is a very nice wrapper, especially the fuzzy match.
Recently irctc and Indian rail started using recaptcha which puts all such apis at halt. Any thougths on how we can get around recaptcha ?

Invalid request pyinrail

whenever using this package it shows Invalid request, even for the example given in the document of package pyinrail, is there a bug or am i missing something.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.