# Exemplos de utilizacao da bilioteca value-to-text
```python
# linha1: update pip
# linha2: install lib value_to_text via pip
python -m pip install --upgrade pip
pip install value-to-text
```
```python
# Escreve por extenso valores monetarios ate 999 Bilhoes
# Escreve por extenso valores nao monetarios ate 999 Bilhoes
# Escreve por extenso percentual de taxas de juros
# Possui parametros para troca de moeda e ou separadores
# Python puro, nao exige demais dependencias de libs externas
```
## import a biblioteca value_to_text
```python
from value_to_text.write_value import Value_to_text
value_to_text = Value_to_text()
```
## metodo num_to_text
# Escreve por extenso valores monetarios ate 999 Bilhoes
```python
text = value_to_text.num_to_text( 100025545465.45 )
print(text)
'''result...
cem bilhoes e vinte e cinco milhoes e quinhentos e quarenta e
cinco mil e quatrocentos e sessenta e cinco reais e quarenta e cinco centavos
'''
text = value_to_text.num_to_text('9.534,85', moeda_unit='dolar', moeda_plural='dolares')
print(text)
'''result...
nove mil e quinhentos e trinta e quatro dolares e oitenta e cinco centavos
'''
text = value_to_text.num_to_text('9.534,85', monetario=False)
print(text)
'''result...
nove mil e quinhentos e trinta e quatro virgula oitenta e cinco
'''
```
## metodo perc_to_text
# Escreve por extenso percentual de taxas de juros
```python
text = value_to_text.perc_to_text( 0.38 )
print(text)
'''result...
zero virgula trinta e oito por cento
'''
text = value_to_text.perc_to_text( 25.10, nome_separador='ponto')
print(text)
'''result...
vinte e cinco ponto dez por cento
'''
```
Raw data
{
"_id": null,
"home_page": "https://github.com/edenilsonsantos/value_to_text",
"name": "value-to-text",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "value_to_text write_value numero para texto valor para texto num_to_text num2text",
"author": "Edenilson Fernandes dos Santos",
"author_email": "santoeen@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/1b/5e/1874dfb2b5b265d40cc4eea4677581ebd39148519a1fb94620ad747d4923/value-to-text-1.0.2.tar.gz",
"platform": null,
"description": "# Exemplos de utilizacao da bilioteca value-to-text\r\n\r\n```python\r\n# linha1: update pip \r\n# linha2: install lib value_to_text via pip\r\npython -m pip install --upgrade pip\r\npip install value-to-text\r\n```\r\n\r\n```python\r\n# Escreve por extenso valores monetarios ate 999 Bilhoes\r\n# Escreve por extenso valores nao monetarios ate 999 Bilhoes\r\n# Escreve por extenso percentual de taxas de juros\r\n# Possui parametros para troca de moeda e ou separadores\r\n# Python puro, nao exige demais dependencias de libs externas\r\n```\r\n## import a biblioteca value_to_text\r\n```python\r\nfrom value_to_text.write_value import Value_to_text\r\nvalue_to_text = Value_to_text()\r\n```\r\n\r\n## metodo num_to_text\r\n# Escreve por extenso valores monetarios ate 999 Bilhoes\r\n```python\r\ntext = value_to_text.num_to_text( 100025545465.45 )\r\nprint(text)\r\n'''result...\r\ncem bilhoes e vinte e cinco milhoes e quinhentos e quarenta e \r\ncinco mil e quatrocentos e sessenta e cinco reais e quarenta e cinco centavos\r\n'''\r\n\r\ntext = value_to_text.num_to_text('9.534,85', moeda_unit='dolar', moeda_plural='dolares')\r\nprint(text)\r\n'''result...\r\nnove mil e quinhentos e trinta e quatro dolares e oitenta e cinco centavos\r\n'''\r\n\r\ntext = value_to_text.num_to_text('9.534,85', monetario=False)\r\nprint(text)\r\n'''result...\r\nnove mil e quinhentos e trinta e quatro virgula oitenta e cinco\r\n'''\r\n```\r\n\r\n## metodo perc_to_text\r\n# Escreve por extenso percentual de taxas de juros\r\n```python\r\ntext = value_to_text.perc_to_text( 0.38 )\r\nprint(text)\r\n'''result...\r\nzero virgula trinta e oito por cento\r\n'''\r\n\r\ntext = value_to_text.perc_to_text( 25.10, nome_separador='ponto')\r\nprint(text)\r\n'''result...\r\nvinte e cinco ponto dez por cento\r\n'''\r\n```\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "classe para converter valor monetario para texto por extenso... e percentual por extenso",
"version": "1.0.2",
"project_urls": {
"Homepage": "https://github.com/edenilsonsantos/value_to_text",
"repository": "https://github.com/edenilsonsantos/value_to_text"
},
"split_keywords": [
"value_to_text",
"write_value",
"numero",
"para",
"texto",
"valor",
"para",
"texto",
"num_to_text",
"num2text"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1b5e1874dfb2b5b265d40cc4eea4677581ebd39148519a1fb94620ad747d4923",
"md5": "174e40fdcdcc6d8faa92b6c2018db205",
"sha256": "ccc30e63c4b87ef18bd64bed88b794dbf3e1c872d2d94efb5b454e5c238712f0"
},
"downloads": -1,
"filename": "value-to-text-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "174e40fdcdcc6d8faa92b6c2018db205",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4828,
"upload_time": "2023-08-31T02:13:53",
"upload_time_iso_8601": "2023-08-31T02:13:53.942328Z",
"url": "https://files.pythonhosted.org/packages/1b/5e/1874dfb2b5b265d40cc4eea4677581ebd39148519a1fb94620ad747d4923/value-to-text-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-31 02:13:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "edenilsonsantos",
"github_project": "value_to_text",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "value-to-text"
}