#!/usr/bin/env python3
# -*- coding:utf-8 -*-
__author__ = 'Mu Yang <http://muyang.pro>'
__copyright__ = '2018-2020 CKIP Lab'
__license__ = 'CC BY-NC-SA 4.0'
import os as _os
import warnings as _warnings
from ._parser import CkipParserSocket
################################################################################################################################
[docs]class CkipParserClient:
"""The CKIP sentence parsing client.
Parameters
----------
username : str
the username (default to the environment variable `$CKIPPARSER_USERNAME`).
password : str
the password (default to the environment variable `$CKIPPARSER_PASSWORD`).
Note
----
One may register an account at http://parser.iis.sinica.edu.tw/v1/reg.exe
"""
def __init__(self, *,
username=_os.getenv('CKIPPARSER_USERNAME'),
password=_os.getenv('CKIPPARSER_PASSWORD'),
):
if username is None:
_warnings.warn('Invalid username (%s)' % username)
if password is None:
_warnings.warn('Invalid password (%s)' % password)
self.socket = CkipParserSocket(username=username, password=password)
def __call__(self, text):
return self.apply(text)
[docs] def apply(self, text):
"""Parse a sentence.
Parameters
----------
text : str
the input sentence.
Returns
-------
str
the output sentence.
.. hint::
One may also call this method as :meth:`__call__`.
"""
return self.socket(text)[0]
[docs] def apply_list(self, ilist):
"""Parse a list of sentences.
Parameters
----------
ilist : List[str]
the list of input sentences.
Returns
-------
List[str]
the list of output sentences.
"""
res = []
for itext in ilist:
res += self.socket(itext)
return res