Reverting the script commit/merge which erased everything

Author: Chris Park

.gitignore

@@ -0,0 +1,73 @@
+# General
+*~
+.DS_Store
+.DS_Store?
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Jetbrains
+**/.idea/*
+!**/.idea/runConfigurations/
+*.iml
+target/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/

CHANGES.txt

@@ -0,0 +1,3 @@
+0.5.1: first published version.
+0.5.2: refactored code and tests.
+0.5.3: change github repo for beta

LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright (c) 2014-2015 Basis Technology Corporation.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

MANIFEST.in

@@ -0,0 +1,2 @@
+include README.txt CHANGES.txt LICENSE.txt
+exclude MANIFEST.in

README.md

@@ -0,0 +1,70 @@
+# This is the Python client binding for Rosette API.
+
+The Python binding requires Python 2.6 or greater and is available through pip:
+
+`pip install rosette_api`
+
+```python
+# 1. Set utf-8 encoding.
+# -*- coding: utf-8 -*-
+
+# 2. Imports from rosette.api.
+from rosette.api import API, DocumentParameters, MorphologyOutput
+
+# 3. Create API object.
+api = API("[your_api-key]")
+
+# 4. Create parameters object
+params = DocumentParameters()
+
+# 5. Set parameters.
+params["content"] = u"Was ist so böse an der Europäischen Zentralbank?"
+
+# 6. Make a call.
+result = api.morphology(params)
+
+# result is a Python dictionary that contains
+
+{u'lemmas': [{u'text': u'Was', u'lemma': u'was'}, {u'text': u'ist', u'lemma': u'sein'}, {u'text': u'so', u'lemma': u'so'}, {u'text': u'böse', u'lemma': u'böse'}, {u'text': u'an', u'lemma': u'an'}, {u'text': u'der', u'lemma': u'der'}, {u'text': u'Europäischen', u'lemma': u'europäisch'}, {u'text': u'Zentralbank', u'lemma': u'Zentralbank'}, {u'text': u'?', u'lemma': u'?'}]}
+```
+
+The samples use the following procedure:
+
+1. If the application reads text in, set encoding to utf-8 in the first line of the script.
+
+2. Import the `rosette.api` packages that your application needs. The `rosette.api` packages include
+    * `API`
+    * `DocumentParameters`
+    * `NameMatchingParameters`
+    * `NameTranslationParameters`
+    * `MorphologyOutput`
+    * `DataFormat`
+    * `InputUnit`
+
+3. Create an `API` object with the `user_key` parameter.
+
+4. Create a parameters object for your request input:
+
+   | Parameter | Endpoint |
+   | ----|----|
+   | `NameMatchingParameters` | for `/matched-name` |
+   | `NameTranslationParameters` | for `/translated-name` |
+   | `DocumentParameters` | for all other endpoints |
+
+
+5. Set the parameters required for your operation: "`content`" or "`contentUri`" for `DocumentParameters`;
+"`name`" and "`targetLanguage`" for `NameTranslationParameters`; "`name1.text`" and "`name2.text`" for
+ `NameMatchingParameters`; Other parameters are optional.
+
+6. Create an `API` method for the endpoint you are calling. The methods are
+    * `entities(linked)` where `linked` is `False` for entity extraction and `True` for entity linking.
+    * `categories()`
+    * `sentiment()`
+    * `language()`
+    * `morphology(tag)` where tag is a member of `MorphologyOutput`: `LEMMAS`, `PARTS_OF_SPEECH`, `COMPOUND_COMPONENTS`, `HAN_READINGS`, or `COMPLETE`. An empty tag is equivalent to `COMPLETE`.
+    * `sentences()`
+    * `tokens()`
+    * `matched_name()`
+    * `translated_name()`
+
+7. The API will return a dictionary with the results.