#!/usr/bin/env python # -*- coding: utf-8 -*- """Create a web service for verb form derivation. See api.sanskritworld.in for documentation. Author - Dr. Dhaval Patel Date - 07 January 2018 email - drdhaval2785@gmail.com """ from flask import Flask, jsonify from flask_restplus import Api, Resource, reqparse from flask_cors import CORS try: from HTMLParser import HTMLParser except ImportError: from html.parser import HTMLParser from prakriya import Prakriya, Generate app = Flask(__name__) app.config['JSON_AS_ASCII'] = False CORS(app) apiversion = 'v0.0.2' api = Api(app, version=apiversion, title=u'Prakriyāpradarśinī API', description='Describes step by step verb form generation according to Paninian grammar. For more user friendly experience, please visit this page by Avinash Varna. Please report any issues here. For more details, please see the github projects for SanskritVerb and prakriya.') storagedirectory = '/var/www/html/sanskritworldflask/' def wholedata(verbform, inTran='slp1', outTran='slp1', argument=''): """Fetch the whole data from prakriya package.""" p = Prakriya() p.inputTranslit(inTran) p.outputTranslit(outTran) verbform = htmlunescape(verbform).encode('utf-8') result = p[verbform, argument] return result # https://stackoverflow.com/questions/2087370/decode-html-entities-in-python-string def htmlunescape(htmlencodedstring): h = HTMLParser() return h.unescape(htmlencodedstring) @api.route('/' + apiversion + '/verbforms//') @api.doc(params={'verbform': 'Verb form to be examined.', 'input_transliteration': 'devanagari/slp1/iast/hk/wx/itrans/kolkata/velthuis'}) class FullData(Resource): """Return the JSON data regarding verb information and derivation steps for given verb form.""" get_parser = reqparse.RequestParser() get_parser.add_argument('output_transliteration', location='args', default='devanagari', help='devanagari/slp1/iast/hk/wx/itrans/kolkata/velthuis') @api.expect(get_parser, validate=True) def get(self, input_transliteration, verbform): """Return the verb information and derivation steps for given verb form. This function reads the pregenerated JSON files. If the JSON file exists, it is loaded back. If the file is absent, an error is thrown. The JSON files are created by the script at SanskritVerb repository. See https://github.com/drdhaval2785/SanskritVerb/blob/master/jsongenerator.sh for details. """ output_transliteration = self.get_parser.parse_args()['output_transliteration'] return jsonify(wholedata(verbform, input_transliteration, output_transliteration)) @api.route('/' + apiversion + '/verbforms///prakriya') @api.doc(params={'verbform': 'Verb form to be examined.', 'input_transliteration': 'devanagari/slp1/iast/hk/wx/itrans/kolkata/velthuis'}) class GetPrakriya(Resource): """Return human readable derivation of a given verb form.""" get_parser = reqparse.RequestParser() get_parser.add_argument('output_transliteration', location='args', default='devanagari', help='devanagari/slp1/iast/hk/wx/itrans/kolkata/velthuis') @api.expect(get_parser, validate=True) def get(self, verbform, input_transliteration): """Return step by step derivation of a given verb form. Dependencies This function has a dependency on sutrainfo.json. sutrainfo.json has sutra number, sutra text key value pairs. The data stored in JSON does not have sutra text. it only has sutra number. sutra text is supplied from sutrainfo.json. See https://github.com/drdhaval2785/prakriya/blob/master/data/sutrainfo.json. """ output_transliteration = self.get_parser.parse_args()['output_transliteration'] return jsonify(wholedata(verbform, input_transliteration, output_transliteration, argument='prakriya')) @api.route('/' + apiversion + '/verbforms///') @api.doc(params={'verbform': 'Verb form to be examined.', 'argument': 'See Implementation notes / docstring of GET method.', 'input_transliteration': 'devanagari/slp1/iast/hk/wx/itrans/kolkata/velthuis'}) class SpecificInfo(Resource): """Return the specific sought for information of a given verb form.""" get_parser = reqparse.RequestParser() get_parser.add_argument('output_transliteration', location='args', default='devanagari', help='devanagari/slp1/iast/hk/wx/itrans/kolkata/velthuis') @api.expect(get_parser, validate=True) def get(self, verbform, argument, input_transliteration): """Return the specific sought for information of a given verb form. Valid arguments and expected output are as follows. "verb" - Return verb in Devanagari without accent marks. "verbaccent" - Return the verb with accent marks. This item is not changed irrespective of transliteration choices. "lakara" - Return the lakAra (tense / mood) in which this form is generated. "purusha" - Return the purusha in which this form is generated. "suffix" - Return the suffix by which this form is generated. "vachana" - Return the vachana in which this form is generated. "gana" - Return the gaNa (class) of the verb. "meaning" - Return meaning of the verb in SLP1 transliteration. "number" - Return number of the verb in dhAtupATha. "madhaviya" - Return link to mAdhaviyadhAtuvRtti. http://sanskrit.uohyd.ac.in/scl/dhaatupaatha is the home page. "kshiratarangini" - Return link to kSIrataraGgiNI. http://sanskrit.uohyd.ac.in/scl/dhaatupaatha is the home page. "dhatupradipa" - Return link to dhAtupradIpa. http://sanskrit.uohyd.ac.in/scl/dhaatupaatha is the home page. "jnu" - Return link to JNU site for this verb form. http://sanskrit.jnu.ac.in/tinanta/tinanta.jsp is the home page. "uohyd" - Return link to UoHyd site for this verb form. http://sanskrit.uohyd.ac.in/cgi-bin/scl/skt_gen/verb/verb_gen.cgi is the home page. "upasarga" - Return upasarga, if any. Currently we do not support verb forms with upasargas. "padadecider_id" - Return the rule number which decides whether the verb is parasmaipadI, AtmanepadI or ubhayapadI. "padadecider_sutra" - Return the rule text which decides whether the verb is parasmaipadI, AtmanepadI or ubhayapadI. "it_id" - Returns whether the verb is seT, aniT or veT, provided the form has iDAgama. "it_status" - Returns whether the verb form has iDAgama or not. seT, veT, aniT are the output. "it_sutra" - Returns rule number if iDAgama is caused by some special rule. """ output_transliteration = self.get_parser.parse_args()['output_transliteration'] validArgs = ['verb', 'verbaccent', 'lakara', 'purusha', 'vachana', 'suffix', 'gana', 'meaning', 'number', 'madhaviya', 'kshiratarangini', 'dhatupradipa', 'jnu', 'uohyd', 'upasarga', 'padadecider_id', 'padadecider_sutra', 'it_id', 'it_status', 'it_sutra'] if argument not in validArgs: return jsonify({'error': 'Not a valid argument.'}) else: return jsonify(wholedata(verbform, input_transliteration, output_transliteration, argument)) @api.route('/' + apiversion + '/generate/////') @api.doc(params={'verb': 'Verb to test.', 'lakara': 'law/liw/luw/lfw/low/laN/viDiliN/ASIrliN/luN/lfN', 'purusha': 'praTama/maDyama/uttama', 'vachana': 'eka/dvi/bahu', 'input_transliteration': 'devanagari/slp1/iast/hk/wx/itrans/kolkata/velthuis'}) class GenData(Resource): """Return the verb forms for given verb, lakAra, purusha and vachana.""" get_parser = reqparse.RequestParser() get_parser.add_argument('output_transliteration', location='args', default='devanagari', help='devanagari/slp1/iast/hk/wx/itrans/kolkata/velthuis') @api.expect(get_parser, validate=True) def get(self, input_transliteration, verb, lakara, purusha, vachana): """Return the verb forms for given verb, lakAra, purusha and vachana.""" output_transliteration = self.get_parser.parse_args()['output_transliteration'] g = Generate() g.inputTranslit(input_transliteration) g.outputTranslit(output_transliteration) return jsonify(g[verb, lakara, purusha, vachana]) @app.errorhandler(404) def not_found(error): """Give URIs if app hits 404.""" uris = giveuris() return jsonify({'uris': uris, 'error': 'Use any of the URIs given below.'}) def giveuris(verbform='', webserver='https://api.sanskritworld.in', version=apiversion): """Give the URIs list for RESTful service.""" uris = {'prakriya_human_readable': webserver + '/' + version + '/verbforms//' + verbform + '/prakriya?output_transliteration=', 'prakriya_machine_readable': webserver + '/' + version + '/verbforms//' + verbform + '/prakriya/machine?output_transliteration=', 'verb_devanagari': webserver + '/' + version + '/verbforms//' + verbform + '/verb?output_transliteration=', 'verb_meaning': webserver + '/' + version + '/verbforms//' + verbform + '/meaning?output_transliteration=', 'verb_number': webserver + '/' + version + '/verbforms//' + verbform + '/number?output_transliteration=', 'verb_gana': webserver + '/' + version + '/verbforms//' + verbform + '/gana?output_transliteration=', 'purusha': webserver + '/' + version + '/verbforms//' + verbform + '/purusha?output_transliteration=', 'vachana': webserver + '/' + version + '/verbforms//' + verbform + '/vachana?output_transliteration=', 'suffix': webserver + '/' + version + '/verbforms//' + verbform + '/suffix?output_transliteration=', 'madhaviyadhatuvritti_link': webserver + '/' + version + '/verbforms//' + verbform + '/madhaviya?output_transliteration=', 'kshiratarangini_link': webserver + '/' + version + '/verbforms//' + verbform + '/kshiratarangini?output_transliteration=', 'dhatupradipa_link': webserver + '/' + version + '/verbforms//' + verbform + '/dhatupradipa?output_transliteration=', 'UoHyd_link': webserver + '/' + version + '/verbforms//' + verbform + '/uohyd?output_transliteration=', 'JNU_link': webserver + '/' + version + '/verbforms//' + verbform + '/jnu?output_transliteration=', 'verb_slp': webserver + '/' + version + '/verbforms//' + verbform + '/verbslp?output_transliteration=', 'lakAra_or_tense': webserver + '/' + version + '/verbforms//' + verbform + '/lakara?output_transliteration=', 'upasarga': webserver + '/' + version + '/verbforms//' + verbform + '/upasarga?output_transliteration=', 'padadecider_id': webserver + '/' + version + '/verbforms//' + verbform + '/padadecider_id?output_transliteration=', 'padadecider_sutra': webserver + '/' + version + '/verbforms//' + verbform + '/padadecider_sutra?output_transliteration=', 'it_sutra': webserver + '/' + version + '/verbforms//' + verbform + '/it_sutra?output_transliteration=', 'it_id': webserver + '/' + version + '/verbforms//' + verbform + '/it_id?output_transliteration=', 'it_status': webserver + '/' + version + '/verbforms//' + verbform + '/it_status?output_transliteration=', 'all_details': webserver + '/' + version + '/verbforms//' + verbform + '?output_transliteration=', } return uris if __name__ == '__main__': # app.run(debug=True) app.run()