rosette-api/python

Rosette API Client Library for Python

Rosette by Babel Street

Rosette uses natural language processing, statistical modeling, and machine learning to analyze unstructured and semi-structured text across hundreds of language-script combinations, revealing valuable information and actionable data. Rosette provides endpoints for extracting entities and relationships, translating and comparing the similarity of names, categorizing and adding linguistic tags to text and more. Rosette Server is the on-premises installation of Rosette, with access to Rosette's functions as RESTful web service endpoints. This solves cloud security worries and allows customization (models/indexes) as needed for your business.

Rosette API Access

• Rosette Cloud Sign Up

Quick Start

Installation

pip install rosette_api

Examples

View small example programs for each Rosette endpoint in the examples directory.

Documentation & Support

• Binding API
• Rosette Platform API
• Binding Release Notes
• Rosette Platform Release Notes
• Support
• Binding License: Apache 2.0

Binding Developer Information

If you are modifying the binding code, please refer to the developer README file.

python's Issues

Error when Debug is True

python/rosette/api.py

Line 499 in 0ab6df0

headers[_CUSTOM_HEADER_PREFIX + 'Devel'] = True

When you set "debug=True" in API(service_url="http://localhost:8181/rest/v1/", debug=True) you get Error:
Exception has occurred: InvalidHeader Header part (True) from {'X-RosetteAPI-Devel': True} must be of type str or bytes, not <class 'bool'>

Han readings example fails to transliterate 生物

morphology_han-readings.py passes "北京大学生物系主任办公室内部会议" and prints out

{'hanReadings': [['Bei3-jing1-Da4-xue2'], null, ['zhu3-ren4'], ['ban4-gong1-shi4'], ['nei4-bu4'], ['hui4-yi4']]}

The element of the list, null, should be ['Sheng1-wu4'], i.e., "Biology."

Bindings should allow specifying get parameters

Use Case

The REST API allows specifying REST paramaters. Notably, the entities endpoint supports ?output=rosette which returns sentences, tokens and analysis along with entities. I want to use that with the bindings.

Problem

The bindings don't seem to support specifying parameters.
The EndpointCaller creates a payload which references any set url paramaters but there doesn't seem to be a way to set them from the entities method

Cannot set "options" parameter in Python client

The Python wrapper prevent adding the "options" parameter while it is a valid param. The API does not complain when I send the request with an "options" parameter with curl, but the wrapper raise an exception when I try to set it to the request's params. I saw that using the serialize method you can add options, but the comment in source says it's for internal use.

https://github.com/rosette-api/python/blob/develop/rosette/api.py#L181

Temporary file Warnings

When i try to run the sentiment file on the process of obtaining sentiment scores of the data set I have got,I repeatedly get the warning shown below for every request sent.It would be great if someone can help me fix this issue.Appreciate your time and effort.Cheers

/usr/local/lib/python3.5/dist-packages/rosette/api.py:229: ResourceWarning: unclosed file <_io.BufferedReader name='/tmp/tmp06za34ck.html'>
self.load_document_string(open(path, "rb").read())

Two examples hit dead endpoints

root@c1f18c11022f:/rosette/python/examples# python transliteration.py --key REDACTED
u'notFound': requested resource not found:
  https://api.rosette.com/rest/v1/transliteration
null
root@c1f18c11022f:/rosette/python/examples# 
root@c1f18c11022f:/rosette/python/examples# python name_deduplication.py --key REDACTED
u'notFound': requested resource not found:
  https://api.rosette.com/rest/v1/name-deduplication
null

CMake fails when installing

Hello, I'm trying to install this lib in my project but it all end with a big red error and:

dist_wheel -d /tmp/pip-wheel-hqztqplb --python-tag cp34:
  running bdist_wheel
  running build
  running build_ext
  CMake Error: The source directory "/tmp/pip-install-_k0gefvs/rosette" does not appear to contain CMakeLists.txt.
  Specify --help for usage, or press the help button on the CMake GUI.
  setup.py exiting with returncode 1

I tried with python version 3.4, 3.5, 3.6 on the standard docker container (https://hub.docker.com/_/python/) but no luck :(

how to reproduce:

docker run -it --entrypoint /bin/sh python:<version>
apt update && apt install -y build-essential python3-dev cmake
pip install rosette

and just look at it fail.

I'm a python n00b but my google-fu found only similar errors on other libs while dealing with their source code, so kind of 100km form where I am 🤷‍♂️

What could I be doing wrong?