<h1>organizador_planilha</h1>
<h2>Introdução</h2>
<p>O <strong>organizador_planilha</strong> é uma ferramenta prática para realizar consultas em bancos de dados MySQL e exportar os resultados para uma planilha Excel. Além disso, ele oferece funcionalidades para sanitizar nomes de colunas e dados, e organizar planilhas com base em uma coluna especÃfica.</p>
<h2>Instalação</h2>
<p>Para instalar o <strong>organizador_planilha</strong>, execute:</p>
<pre><code>pip install organizador_planilha</code></pre>
<h2>Uso Básico</h2>
<h3>Importando o Pacote</h3>
<pre><code>from organizador_planilha import buscar_planilha, organizar_planilha</code></pre>
<h3>1. buscar_planilha(query, banco, servidor, senha, usuario, nome_planilha)</h3>
<p>Executa uma consulta SQL no banco de dados especificado e exporta os resultados para uma planilha Excel.</p>
<h4>Parâmetros:</h4>
<ul>
<li><code>query</code> (str): A consulta SQL a ser executada.</li>
<li><code>banco</code> (str): O nome do banco de dados.</li>
<li><code>servidor</code> (str): O endereço do servidor MySQL.</li>
<li><code>senha</code> (str): A senha para acessar o banco de dados.</li>
<li><code>usuario</code> (str): O nome do usuário do banco de dados.</li>
<li><code>nome_planilha</code> (str): O nome do arquivo Excel a ser gerado (sem extensão).</li>
</ul>
<h4>Exemplo de Uso:</h4>
<pre><code>buscar_planilha(
query="SELECT * FROM minha_tabela",
banco="meu_banco",
servidor="localhost",
senha="minha_senha",
usuario="meu_usuario",
nome_planilha="resultado_consulta"
)
</code></pre>
<h3>2. organizar_planilha(input_path, output_path, coluna_ordenar)</h3>
<p>Organiza uma planilha (em formato .csv ou .xlsx) com base em uma coluna especÃfica e salva o resultado em um novo arquivo.</p>
<h4>Parâmetros:</h4>
<ul>
<li><code>input_path</code> (str): Caminho para a planilha de entrada.</li>
<li><code>output_path</code> (str): Caminho para salvar a planilha organizada.</li>
<li><code>coluna_ordenar</code> (str): Nome da coluna pela qual a planilha deve ser organizada.</li>
</ul>
<h4>Exemplo de Uso:</h4>
<pre><code>organizar_planilha(
input_path="dados.csv",
output_path="dados_organizados.xlsx",
coluna_ordenar="nome"
)
</code></pre>
<h2>Interface Gráfica</h2>
<p>O pacote também fornece uma interface gráfica para facilitar a interação com o usuário. Esta interface permite inserir os parâmetros da consulta SQL e executar o processo de forma interativa.</p>
<h3>Iniciando a Interface Gráfica</h3>
<p>Para iniciar a interface gráfica, use:</p>
<pre><code>from organizador_planilha import gui
gui.run()
</code></pre>
<h2>Exemplo de Uso</h2>
<h3>Script Completo</h3>
<pre><code>from organizador_planilha import buscar_planilha, organizar_planilha
# Executando uma consulta e gerando uma planilha Excel
buscar_planilha(
query="SELECT * FROM minha_tabela",
banco="meu_banco",
servidor="localhost",
senha="minha_senha",
usuario="meu_usuario",
nome_planilha="resultado_consulta"
)
# Organizando a planilha gerada com base na coluna 'nome'
organizar_planilha(
input_path="resultado_consulta.xlsx",
output_path="resultado_organizado.xlsx",
coluna_ordenar="nome"
)
</code></pre>
<h2>Contribuição</h2>
<p>Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests no repositório do GitHub. Ao contribuir, siga as melhores práticas de codificação e inclua testes para suas mudanças.</p>
Raw data
{
"_id": null,
"home_page": "https://github.com/MoisesAlves2023/organizador_planilha",
"name": "organizador-planilha",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "Mois\u00e9s Alves",
"author_email": "moisesalvespc@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/66/09/cba2b7b4730e4dcb117c67e93839e74ed23d5e2b40263d91bbc5c0ff7a01/organizador_planilha-1.tar.gz",
"platform": null,
"description": "<h1>organizador_planilha</h1>\r\n\r\n<h2>Introdu\u00c3\u00a7\u00c3\u00a3o</h2>\r\n\r\n<p>O <strong>organizador_planilha</strong> \u00c3\u00a9 uma ferramenta pr\u00c3\u00a1tica para realizar consultas em bancos de dados MySQL e exportar os resultados para uma planilha Excel. Al\u00c3\u00a9m disso, ele oferece funcionalidades para sanitizar nomes de colunas e dados, e organizar planilhas com base em uma coluna espec\u00c3\u00adfica.</p>\r\n\r\n<h2>Instala\u00c3\u00a7\u00c3\u00a3o</h2>\r\n\r\n<p>Para instalar o <strong>organizador_planilha</strong>, execute:</p>\r\n\r\n<pre><code>pip install organizador_planilha</code></pre>\r\n\r\n<h2>Uso B\u00c3\u00a1sico</h2>\r\n<h3>Importando o Pacote</h3>\r\n\r\n<pre><code>from organizador_planilha import buscar_planilha, organizar_planilha</code></pre>\r\n\r\n<h3>1. buscar_planilha(query, banco, servidor, senha, usuario, nome_planilha)</h3>\r\n\r\n<p>Executa uma consulta SQL no banco de dados especificado e exporta os resultados para uma planilha Excel.</p>\r\n\r\n<h4>Par\u00c3\u00a2metros:</h4>\r\n<ul>\r\n <li><code>query</code> (str): A consulta SQL a ser executada.</li>\r\n <li><code>banco</code> (str): O nome do banco de dados.</li>\r\n <li><code>servidor</code> (str): O endere\u00c3\u00a7o do servidor MySQL.</li>\r\n <li><code>senha</code> (str): A senha para acessar o banco de dados.</li>\r\n <li><code>usuario</code> (str): O nome do usu\u00c3\u00a1rio do banco de dados.</li>\r\n <li><code>nome_planilha</code> (str): O nome do arquivo Excel a ser gerado (sem extens\u00c3\u00a3o).</li>\r\n</ul>\r\n\r\n<h4>Exemplo de Uso:</h4>\r\n\r\n<pre><code>buscar_planilha(\r\n query=\"SELECT * FROM minha_tabela\",\r\n banco=\"meu_banco\",\r\n servidor=\"localhost\",\r\n senha=\"minha_senha\",\r\n usuario=\"meu_usuario\",\r\n nome_planilha=\"resultado_consulta\"\r\n)\r\n</code></pre>\r\n\r\n<h3>2. organizar_planilha(input_path, output_path, coluna_ordenar)</h3>\r\n\r\n<p>Organiza uma planilha (em formato .csv ou .xlsx) com base em uma coluna espec\u00c3\u00adfica e salva o resultado em um novo arquivo.</p>\r\n\r\n<h4>Par\u00c3\u00a2metros:</h4>\r\n<ul>\r\n <li><code>input_path</code> (str): Caminho para a planilha de entrada.</li>\r\n <li><code>output_path</code> (str): Caminho para salvar a planilha organizada.</li>\r\n <li><code>coluna_ordenar</code> (str): Nome da coluna pela qual a planilha deve ser organizada.</li>\r\n</ul>\r\n\r\n<h4>Exemplo de Uso:</h4>\r\n\r\n<pre><code>organizar_planilha(\r\n input_path=\"dados.csv\",\r\n output_path=\"dados_organizados.xlsx\",\r\n coluna_ordenar=\"nome\"\r\n)\r\n</code></pre>\r\n\r\n<h2>Interface Gr\u00c3\u00a1fica</h2>\r\n\r\n<p>O pacote tamb\u00c3\u00a9m fornece uma interface gr\u00c3\u00a1fica para facilitar a intera\u00c3\u00a7\u00c3\u00a3o com o usu\u00c3\u00a1rio. Esta interface permite inserir os par\u00c3\u00a2metros da consulta SQL e executar o processo de forma interativa.</p>\r\n\r\n<h3>Iniciando a Interface Gr\u00c3\u00a1fica</h3>\r\n\r\n<p>Para iniciar a interface gr\u00c3\u00a1fica, use:</p>\r\n\r\n<pre><code>from organizador_planilha import gui\r\n\r\ngui.run()\r\n</code></pre>\r\n\r\n<h2>Exemplo de Uso</h2>\r\n<h3>Script Completo</h3>\r\n\r\n<pre><code>from organizador_planilha import buscar_planilha, organizar_planilha\r\n\r\n# Executando uma consulta e gerando uma planilha Excel\r\nbuscar_planilha(\r\n query=\"SELECT * FROM minha_tabela\",\r\n banco=\"meu_banco\",\r\n servidor=\"localhost\",\r\n senha=\"minha_senha\",\r\n usuario=\"meu_usuario\",\r\n nome_planilha=\"resultado_consulta\"\r\n)\r\n\r\n# Organizando a planilha gerada com base na coluna 'nome'\r\norganizar_planilha(\r\n input_path=\"resultado_consulta.xlsx\",\r\n output_path=\"resultado_organizado.xlsx\",\r\n coluna_ordenar=\"nome\"\r\n)\r\n</code></pre>\r\n\r\n<h2>Contribui\u00c3\u00a7\u00c3\u00a3o</h2>\r\n\r\n<p>Contribui\u00c3\u00a7\u00c3\u00b5es s\u00c3\u00a3o bem-vindas! Sinta-se \u00c3\u00a0 vontade para abrir issues ou enviar pull requests no reposit\u00c3\u00b3rio do GitHub. Ao contribuir, siga as melhores pr\u00c3\u00a1ticas de codifica\u00c3\u00a7\u00c3\u00a3o e inclua testes para suas mudan\u00c3\u00a7as.</p>\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Um pacote simples para buscar e organizar planilhas em um banco MYSQL",
"version": "1",
"project_urls": {
"Homepage": "https://github.com/MoisesAlves2023/organizador_planilha"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9e999a650cdc182795041f109a6049e0669683153996f9f7b4fe8f22c4dee96d",
"md5": "47f2e3e723dd5223a2b1e3e501116bdc",
"sha256": "a26cde6f142054cc13cc5a0396b9166553bcb90a68884291d061100374010d15"
},
"downloads": -1,
"filename": "organizador_planilha-1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "47f2e3e723dd5223a2b1e3e501116bdc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 5310,
"upload_time": "2024-09-02T17:18:31",
"upload_time_iso_8601": "2024-09-02T17:18:31.635754Z",
"url": "https://files.pythonhosted.org/packages/9e/99/9a650cdc182795041f109a6049e0669683153996f9f7b4fe8f22c4dee96d/organizador_planilha-1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6609cba2b7b4730e4dcb117c67e93839e74ed23d5e2b40263d91bbc5c0ff7a01",
"md5": "9452a3d7648d11ccb1faa4923cd8aa52",
"sha256": "8eb230f70c039c01fc3298bf3073f3637858f3db2286b5063be536a137bebf03"
},
"downloads": -1,
"filename": "organizador_planilha-1.tar.gz",
"has_sig": false,
"md5_digest": "9452a3d7648d11ccb1faa4923cd8aa52",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 4077,
"upload_time": "2024-09-02T17:18:32",
"upload_time_iso_8601": "2024-09-02T17:18:32.828975Z",
"url": "https://files.pythonhosted.org/packages/66/09/cba2b7b4730e4dcb117c67e93839e74ed23d5e2b40263d91bbc5c0ff7a01/organizador_planilha-1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-02 17:18:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MoisesAlves2023",
"github_project": "organizador_planilha",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "organizador-planilha"
}
JSON
