# telegram-text
**Python markup module for Telegram messenger.
This module provides a rich list of components to build any possible
markup fast and render it to specific _html_ and _MarkdownV2_ formats.**
[](https://github.com/SKY-ALIN/telegram-text)
[](https://codecov.io/gh/SKY-ALIN/telegram-text)
[](https://pypi.org/project/telegram-text/)
[](https://github.com/SKY-ALIN/telegram-text/blob/main/LICENSE)
---
### Installation
Install using `pip install telegram-text` or `poetry add telegram-text`
Also, `telegram-text` is integrated into following packages:
| Module | Installation | Import | Documentation |
| ------ | ------------ | ------ | ------------- |
| [python-telegram](https://github.com/alexander-akhmetov/python-telegram) | `pip install python-telegram` | `from telegram.text import ...` | [Readme](https://github.com/alexander-akhmetov/python-telegram/blob/master/README.md) |
| [OrigamiBot](https://github.com/cmd410/OrigamiBot) | `pip install origamibot[telegram-text]` | `from origamibot.text import ...` | [Release](https://github.com/cmd410/OrigamiBot/releases/tag/v2.3.0) |
| [TGramBot](https://github.com/KeralaBots/TGramBot) | `pip install tgrambot` | `from tgrambot.text import ...` | [Readme](https://github.com/KeralaBots/TGramBot/blob/alpha/README.md) |
### Basic Example
```python
from telegram_text import Bold, Italic, Underline
text = Underline(Bold("Bold") + "and" + Italic("italic") + "with underline.")
```
<p align="center">
<img
width="400"
src="https://raw.githubusercontent.com/SKY-ALIN/telegram-text/dev/docs/source/_static/basic_example_result.jpg"
/>
</p>
### Advanced Example
```python
from telegram_text import Bold, Chain, Italic, TOMLSection, Hashtag, Link, UnorderedList
description = "A Channel about software developing and distributing. Subscribe to follow new technologies."
tags: dict[str, str] = {...} # Tags description with following format `tag: tag_description`
links: dict[str, str] = {...} # Links with following format `text: url`
menu = Chain(
TOMLSection(
'Menu',
Italic(description),
),
TOMLSection(
'Tags',
*[Hashtag(tag, style=Bold) + f"- {about}" for tag, about in tags.items()],
),
TOMLSection(
'Links',
UnorderedList(*[Link(text, url) for text, url in links.items()]),
),
sep='\n\n'
)
```
---
Full documentation and reference are available at
[telegram-text.alinsky.tech](https://telegram-text.alinsky.tech)
Raw data
{
"_id": null,
"home_page": "https://telegram-text.alinsky.tech",
"name": "telegram-text",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7,<4.0",
"maintainer_email": "",
"keywords": "telegram,markup,markdown,formating",
"author": "Vladimir Alinsky",
"author_email": "Vladimir@Alinsky.tech",
"download_url": "https://files.pythonhosted.org/packages/3c/87/da98869571691e1b563cbc2ba51d5270a4e9ccc4f89d2070cefd4d6ca420/telegram_text-0.1.2.tar.gz",
"platform": null,
"description": "# telegram-text\n**Python markup module for Telegram messenger.\nThis module provides a rich list of components to build any possible\nmarkup fast and render it to specific _html_ and _MarkdownV2_ formats.**\n\n[](https://github.com/SKY-ALIN/telegram-text)\n\n\n[](https://codecov.io/gh/SKY-ALIN/telegram-text)\n[](https://pypi.org/project/telegram-text/)\n[](https://github.com/SKY-ALIN/telegram-text/blob/main/LICENSE)\n\n---\n\n### Installation\nInstall using `pip install telegram-text` or `poetry add telegram-text`\n\nAlso, `telegram-text` is integrated into following packages:\n\n| Module | Installation | Import | Documentation |\n| ------ | ------------ | ------ | ------------- |\n| [python-telegram](https://github.com/alexander-akhmetov/python-telegram) | `pip install python-telegram` | `from telegram.text import ...` | [Readme](https://github.com/alexander-akhmetov/python-telegram/blob/master/README.md) |\n| [OrigamiBot](https://github.com/cmd410/OrigamiBot) | `pip install origamibot[telegram-text]` | `from origamibot.text import ...` | [Release](https://github.com/cmd410/OrigamiBot/releases/tag/v2.3.0) |\n| [TGramBot](https://github.com/KeralaBots/TGramBot) | `pip install tgrambot` | `from tgrambot.text import ...` | [Readme](https://github.com/KeralaBots/TGramBot/blob/alpha/README.md) |\n\n### Basic Example\n\n```python\nfrom telegram_text import Bold, Italic, Underline\n\ntext = Underline(Bold(\"Bold\") + \"and\" + Italic(\"italic\") + \"with underline.\")\n```\n\n<p align=\"center\">\n <img \n width=\"400\"\n src=\"https://raw.githubusercontent.com/SKY-ALIN/telegram-text/dev/docs/source/_static/basic_example_result.jpg\"\n />\n</p>\n\n### Advanced Example\n\n```python\nfrom telegram_text import Bold, Chain, Italic, TOMLSection, Hashtag, Link, UnorderedList\n\ndescription = \"A Channel about software developing and distributing. Subscribe to follow new technologies.\"\ntags: dict[str, str] = {...} # Tags description with following format `tag: tag_description`\nlinks: dict[str, str] = {...} # Links with following format `text: url`\n\nmenu = Chain(\n TOMLSection(\n 'Menu',\n Italic(description),\n ),\n TOMLSection(\n 'Tags',\n *[Hashtag(tag, style=Bold) + f\"- {about}\" for tag, about in tags.items()],\n ),\n TOMLSection(\n 'Links',\n UnorderedList(*[Link(text, url) for text, url in links.items()]),\n ),\n sep='\\n\\n'\n)\n```\n\n\n\n---\n\nFull documentation and reference are available at \n[telegram-text.alinsky.tech](https://telegram-text.alinsky.tech)",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python markup module for Telegram messenger. This module provides a rich list of components to build any possible markup fast and render it to specific html or MarkdownV2 formats.",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://telegram-text.alinsky.tech",
"Repository": "https://github.com/SKY-ALIN/telegram-text"
},
"split_keywords": [
"telegram",
"markup",
"markdown",
"formating"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ae121d8d9ef80719af27d57732d2dffe934fe4fe84ca634be80265acc3e134f1",
"md5": "2feefc08451aae3720047d3c34f880c5",
"sha256": "4a2c46dae3792a8c8259455e8c93f304c9859f1e1a7196f74936e6d0f97b4006"
},
"downloads": -1,
"filename": "telegram_text-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2feefc08451aae3720047d3c34f880c5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<4.0",
"size": 8623,
"upload_time": "2023-05-30T21:30:13",
"upload_time_iso_8601": "2023-05-30T21:30:13.789470Z",
"url": "https://files.pythonhosted.org/packages/ae/12/1d8d9ef80719af27d57732d2dffe934fe4fe84ca634be80265acc3e134f1/telegram_text-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3c87da98869571691e1b563cbc2ba51d5270a4e9ccc4f89d2070cefd4d6ca420",
"md5": "ea6bbbee8cc16939b48c9c2278d27213",
"sha256": "ac67dc6774e422be37d66e58bd32e954af9a2854ca50dd2ee35fa62db263d9ab"
},
"downloads": -1,
"filename": "telegram_text-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "ea6bbbee8cc16939b48c9c2278d27213",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<4.0",
"size": 7539,
"upload_time": "2023-05-30T21:30:15",
"upload_time_iso_8601": "2023-05-30T21:30:15.154213Z",
"url": "https://files.pythonhosted.org/packages/3c/87/da98869571691e1b563cbc2ba51d5270a4e9ccc4f89d2070cefd4d6ca420/telegram_text-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-30 21:30:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SKY-ALIN",
"github_project": "telegram-text",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "telegram-text"
}
JSON
