# Python SDK for GroupDocs.Rewriter Cloud
     [](https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-python/blob/master/LICENSE)
[Product Page](https://products.groupdocs.cloud/rewriter/python/) | [Documentation](https://docs.groupdocs.cloud/rewriter/) | [Demos](https://products.groupdocs.app/rewriter/family) | [Swagger UI](https://reference.groupdocs.cloud/rewriter/) | [Examples](https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-python) | [Blog](https://blog.groupdocs.cloud/category/rewriter/) | [Search](https://search.groupdocs.cloud/) | [Free Support](https://forum.groupdocs.cloud/c/rewriter) | [Free Trial](https://purchase.groupdocs.cloud/trial)
GroupDocs.Rewriter Cloud SDK for Python is a simple Python SDK that enables your cloud Apps to perform paraphrasing, simplification, summarization and paraphrasing detection of Microsoft Word®, OpenOffice, Markdown, HTML and Adobe Acrobat® PDF documents as well as plain text by adding just a few lines of code.
In other words, it's a SDK for document and plain text rewriting, summarization, etc. in our Cloud, that supports paraphrasing of .doc, .docx, .docm, .pdf, .rtf, .odt, .md, .html, .txt files. Just pass a specific file or text to the GroupDocs.Rewriter Cloud API, and it will process and save result in our Cloud or will return resulting text.
It is easy to get started with GroupDocs.Rewriter Cloud and there is nothing to install. Create an account at GroupDocs Cloud and get your application information, then you are ready to use SDKs.
## Cloud Features
- Paraphrasing / summarization / simplification / paraphrase detection of documents
- Paraphrasing / summarization / simplification / paraphrase detection / comparison of plain text
- Words and idioms synonyms finder
- Return resulting text in response
- Save processed file in cloud
- No need to install any 3rd party software
## Supported Document Formats
You can specify format of document to process putting in the request’s body:
- **Microsoft Word®:** DOC, DOCX, DOCM
- **Adobe®:** PDF
- **Markdown:** MD
- **HTML:** HTML
- **Other:** RTF, ODT, TXT
Additionally, user could obtain processed file in any other format available for conversion. Just specify output format of paraphrased document by putting file extension in the request’s body:
- **doc, docx** — docx, rtf, html, odt, txt, md, pdf, tiff, svg, xps
- **pdf** — docx, pptx, html, svg, xps
- **html** — md, pdf, docx, tiff, xps
Please visit [Supported Formats](https://docs.groupdocs.cloud/rewriter/supported-formats/) for details.
## Supported Languages
- **ar** — to process Arabic text or document
- **de** — to process German text or document
- **en** — to process English text or document
- **es** — to process Spanish text or document
- **fr** — to process French text or document
- **id** — to process Indonesian text or document
- **ru** — to process Russian text or document
- **uk** — to process Ukrainian text or document
- **sk** — to process Slovak text or document
- **pt** — to process Portuguese text or document
- **it** — to process Italian text or document
## JSON Request Details
To paraphrase plain text the following information should be put in the requests body:
- **language** — language of text (e.g. en)
- **text** — text to paraphrase (e.g. hello world)
- **diversityDegree** — diversity of paraphrasing, "medium" or "high", default is "off"
- **suggestions** — to receive several suggested variants of paraphrasing (from 1 to 3)
To suummarize plain text:
- **language** — language of text
- **text** — text to paraphrase
- **summarizationDegree** — degree of summarization, "off", "medium" or "high"
To simplify plain text:
- **language** — language of text
- **text** — text to paraphrase
To find synonyms:
- **language** — language of text
- **text** — word or phrase to find synonyms
- **synonyms** — number of synonyms to return
SDK also provides a tool for summarizing texts and documents in English. To do this, put the same parameters as for paraphrasing (except for "diversity" and "suggestions") in the requests body.
## How to use the SDK?
Our API is completely independent of your operating system, database system, or development language. You can use any language and platform that supports HTTP to interact with our API. However, manually writing client code can be difficult, error-prone, and time-consuming. Therefore, we provide and support [SDKs](https://github.com/groupdocs-rewriter-cloud) in many development languages to make it easier for your Cloud Apps to integrate with us.
## Quickstart
#### 1. Get Started
It is easy to get started with GroupDocs.Rewriter Cloud. Simply, create an account at [GroupDocs Cloud](https://dashboard.groupdocs.cloud/#/apps) and get your application information, then you are ready to use the [SDKs](https://github.com/groupdocs-rewriter-cloud).
#### 2. Run Demo
* Checkout the SDK
* Open .NET core demo project
* Set Your ClientId & ClientSecret
* Run
## Rewrite plain text
```python
import time
import groupdocs_rewriter_cloud
from groupdocs_rewriter_cloud.api.paraphrase_api import ParaphraseApi
from groupdocs_rewriter_cloud.rest import ApiException
from groupdocs_rewriter_cloud.models import HttpStatusCode, ParaphraseTextRequest
api = ParaphraseApi()
file_api = FileApi()
api.api_client.configuration.client_id = "CLIENT_ID"
api.api_client.configuration.client_secret = "CLIENT_SECRET"
language = "en"
src_text = "YOUR_TEXT"
request = ParaphraseTextRequest(language=language, text=src_text)
status = api.paraphrase_text_post(request)
if status.status == groupdocs_rewriter_cloud.models.HttpStatusCode.ACCEPTED:
while True:
text_response = api.paraphrase_text_request_id_get(status.id)
if text_response.status == groupdocs_rewriter_cloud.models.HttpStatusCode.OK:
print(text_response.paraphrase_result)
break
time.sleep(2)
```
## GroupDocs.Rewriter Cloud SDKs in Popular Languages
| .NET | Python |
|---|---|
| [GitHub](https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-dotnet) | [GitHub](https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-dotnet) |
| [NuGet](https://www.nuget.org/packages/GroupDocs.Rewriter-Cloud/) | [PyPi](https://pypi.org/project/groupdocs-rewriter-cloud/) |
---
[Product Page](https://products.groupdocs.cloud/rewriter/python/) | [Docs](https://docs.groupdocs.cloud/rewriter/) | [Demos](https://products.groupdocs.app/rewriter/family) | [Swagger UI](https://apireference.groupdocs.cloud/rewriter/) | [Examples](https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-python) | [Blog](https://blog.groupdocs.cloud/category/rewriter/) | [Search](https://search.groupdocs.cloud/) | [Free Support](https://forum.groupdocs.cloud/c/rewriter) | [Free Trial](https://purchase.groupdocs.cloud/trial)
Raw data
{
"_id": null,
"home_page": "https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-python",
"name": "groupdocs-rewriter-cloud",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "GroupDocs.Rewriter Cloud API Reference, Aspose, GroupDocs, RewriterRewriter Cloud, GroupDocs.Rewriter API",
"author": "GroupDocs",
"author_email": "anton.perhunov@aspose.com",
"download_url": null,
"platform": null,
"description": "# Python SDK for GroupDocs.Rewriter Cloud\r\n\r\n     [](https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-python/blob/master/LICENSE)\r\n\r\n[Product Page](https://products.groupdocs.cloud/rewriter/python/) | [Documentation](https://docs.groupdocs.cloud/rewriter/) | [Demos](https://products.groupdocs.app/rewriter/family) | [Swagger UI](https://reference.groupdocs.cloud/rewriter/) | [Examples](https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-python) | [Blog](https://blog.groupdocs.cloud/category/rewriter/) | [Search](https://search.groupdocs.cloud/) | [Free Support](https://forum.groupdocs.cloud/c/rewriter) | [Free Trial](https://purchase.groupdocs.cloud/trial)\r\n\r\nGroupDocs.Rewriter Cloud SDK for Python is a simple Python SDK that enables your cloud Apps to perform paraphrasing, simplification, summarization and paraphrasing detection of Microsoft Word\u00ae, OpenOffice, Markdown, HTML and Adobe Acrobat\u00ae PDF documents as well as plain text by adding just a few lines of code.\r\n\r\nIn other words, it's a SDK for document and plain text rewriting, summarization, etc. in our Cloud, that supports paraphrasing of .doc, .docx, .docm, .pdf, .rtf, .odt, .md, .html, .txt files. Just pass a specific file or text to the GroupDocs.Rewriter Cloud API, and it will process and save result in our Cloud or will return resulting text.\r\n\r\nIt is easy to get started with GroupDocs.Rewriter Cloud and there is nothing to install. Create an account at GroupDocs Cloud and get your application information, then you are ready to use SDKs.\r\n\r\n## Cloud Features\r\n\r\n- Paraphrasing / summarization / simplification / paraphrase detection of documents\r\n- Paraphrasing / summarization / simplification / paraphrase detection / comparison of plain text\r\n- Words and idioms synonyms finder\r\n- Return resulting text in response\r\n- Save processed file in cloud\r\n- No need to install any 3rd party software\r\n\r\n## Supported Document Formats\r\n\r\nYou can specify format of document to process putting in the request\u2019s body:\r\n\r\n- **Microsoft Word\u00ae:** DOC, DOCX, DOCM\r\n- **Adobe\u00ae:** PDF\r\n- **Markdown:** MD\r\n- **HTML:** HTML\r\n- **Other:** RTF, ODT, TXT\r\n\r\nAdditionally, user could obtain processed file in any other format available for conversion. Just specify output format of paraphrased document by putting file extension in the request\u2019s body:\r\n\r\n- **doc, docx** \u2014 docx, rtf, html, odt, txt, md, pdf, tiff, svg, xps\r\n- **pdf** \u2014 docx, pptx, html, svg, xps\r\n- **html** \u2014 md, pdf, docx, tiff, xps\r\n\r\nPlease visit [Supported Formats](https://docs.groupdocs.cloud/rewriter/supported-formats/) for details.\r\n\r\n## Supported Languages\r\n\r\n- **ar** \u2014 to process Arabic text or document\r\n- **de** \u2014 to process German text or document\r\n- **en** \u2014 to process English text or document\r\n- **es** \u2014 to process Spanish text or document\r\n- **fr** \u2014 to process French text or document\r\n- **id** \u2014 to process Indonesian text or document\r\n- **ru** \u2014 to process Russian text or document\r\n- **uk** \u2014 to process Ukrainian text or document\r\n- **sk** \u2014 to process Slovak text or document\r\n- **pt** \u2014 to process Portuguese text or document\r\n- **it** \u2014 to process Italian text or document\r\n\r\n## JSON Request Details\r\n\r\nTo paraphrase plain text the following information should be put in the requests body:\r\n\r\n- **language** \u2014 language of text (e.g. en)\r\n- **text** \u2014 text to paraphrase (e.g. hello world)\r\n- **diversityDegree** \u2014 diversity of paraphrasing, \"medium\" or \"high\", default is \"off\"\r\n- **suggestions** \u2014 to receive several suggested variants of paraphrasing (from 1 to 3)\r\n\r\nTo suummarize plain text:\r\n\r\n- **language** \u2014 language of text\r\n- **text** \u2014 text to paraphrase\r\n- **summarizationDegree** \u2014 degree of summarization, \"off\", \"medium\" or \"high\"\r\n\r\nTo simplify plain text:\r\n\r\n- **language** \u2014 language of text\r\n- **text** \u2014 text to paraphrase\r\n\r\nTo find synonyms:\r\n\r\n- **language** \u2014 language of text\r\n- **text** \u2014 word or phrase to find synonyms\r\n- **synonyms** \u2014 number of synonyms to return\r\n\r\n\r\n\r\nSDK also provides a tool for summarizing texts and documents in English. To do this, put the same parameters as for paraphrasing (except for \"diversity\" and \"suggestions\") in the requests body.\r\n\r\n## How to use the SDK?\r\n\r\nOur API is completely independent of your operating system, database system, or development language. You can use any language and platform that supports HTTP to interact with our API. However, manually writing client code can be difficult, error-prone, and time-consuming. Therefore, we provide and support [SDKs](https://github.com/groupdocs-rewriter-cloud) in many development languages to make it easier for your Cloud Apps to integrate with us.\r\n\r\n\r\n## Quickstart\r\n\r\n#### 1. Get Started\r\n\r\nIt is easy to get started with GroupDocs.Rewriter Cloud. Simply, create an account at [GroupDocs Cloud](https://dashboard.groupdocs.cloud/#/apps) and get your application information, then you are ready to use the [SDKs](https://github.com/groupdocs-rewriter-cloud).\r\n\r\n#### 2. Run Demo\r\n * Checkout the SDK\r\n * Open .NET core demo project\r\n * Set Your ClientId & ClientSecret\r\n * Run\r\n\r\n\r\n## Rewrite plain text\r\n\r\n```python\r\nimport time\r\nimport groupdocs_rewriter_cloud\r\nfrom groupdocs_rewriter_cloud.api.paraphrase_api import ParaphraseApi \r\nfrom groupdocs_rewriter_cloud.rest import ApiException\r\nfrom groupdocs_rewriter_cloud.models import HttpStatusCode, ParaphraseTextRequest\r\n\r\napi = ParaphraseApi()\r\nfile_api = FileApi()\r\napi.api_client.configuration.client_id = \"CLIENT_ID\"\r\napi.api_client.configuration.client_secret = \"CLIENT_SECRET\"\r\nlanguage = \"en\"\r\nsrc_text = \"YOUR_TEXT\"\r\nrequest = ParaphraseTextRequest(language=language, text=src_text)\r\nstatus = api.paraphrase_text_post(request)\r\nif status.status == groupdocs_rewriter_cloud.models.HttpStatusCode.ACCEPTED:\r\n while True:\r\n text_response = api.paraphrase_text_request_id_get(status.id)\r\n if text_response.status == groupdocs_rewriter_cloud.models.HttpStatusCode.OK:\r\n print(text_response.paraphrase_result)\r\n break\r\n time.sleep(2)\r\n```\r\n\r\n## GroupDocs.Rewriter Cloud SDKs in Popular Languages\r\n\r\n| .NET | Python |\r\n|---|---|\r\n| [GitHub](https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-dotnet) | [GitHub](https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-dotnet) |\r\n| [NuGet](https://www.nuget.org/packages/GroupDocs.Rewriter-Cloud/) | [PyPi](https://pypi.org/project/groupdocs-rewriter-cloud/) |\r\n\r\n---\r\n\r\n[Product Page](https://products.groupdocs.cloud/rewriter/python/) | [Docs](https://docs.groupdocs.cloud/rewriter/) | [Demos](https://products.groupdocs.app/rewriter/family) | [Swagger UI](https://apireference.groupdocs.cloud/rewriter/) | [Examples](https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-python) | [Blog](https://blog.groupdocs.cloud/category/rewriter/) | [Search](https://search.groupdocs.cloud/) | [Free Support](https://forum.groupdocs.cloud/c/rewriter) | [Free Trial](https://purchase.groupdocs.cloud/trial)\r\n",
"bugtrack_url": null,
"license": "Aspose EULA",
"summary": "GroupDocs.Rewriter API",
"version": "24.4.0",
"project_urls": {
"Homepage": "https://github.com/groupdocs-rewriter-cloud/groupdocs-rewriter-cloud-python"
},
"split_keywords": [
"groupdocs.rewriter cloud api reference",
" aspose",
" groupdocs",
" rewriterrewriter cloud",
" groupdocs.rewriter api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "157ef2c87ce670a5701110c5ee34704eb4de7458885c90b80eceea4771151bd9",
"md5": "fd4139e74d55eeca02ea13b1168f986f",
"sha256": "349988bb11c67325237024b9427353b1d8c92da7637b13ac4b7e6a903a937aad"
},
"downloads": -1,
"filename": "groupdocs_rewriter_cloud-24.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fd4139e74d55eeca02ea13b1168f986f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 91009,
"upload_time": "2024-04-24T18:46:42",
"upload_time_iso_8601": "2024-04-24T18:46:42.014012Z",
"url": "https://files.pythonhosted.org/packages/15/7e/f2c87ce670a5701110c5ee34704eb4de7458885c90b80eceea4771151bd9/groupdocs_rewriter_cloud-24.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-24 18:46:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "groupdocs-rewriter-cloud",
"github_project": "groupdocs-rewriter-cloud-python",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "six",
"specs": [
[
"~=",
"1.15.0"
]
]
},
{
"name": "certifi",
"specs": [
[
"~=",
"2020.6.20"
]
]
},
{
"name": "urllib3",
"specs": [
[
"~=",
"1.25.10"
]
]
}
],
"lcname": "groupdocs-rewriter-cloud"
}
JSON
