pythomate 0.6
Automatiza acionamento de fluxos Power Automate.
Keywords: python, power automate, automate, automação

# Pythomate

Pacote [pythomate](https://pypi.org/project/pythomate/) inicia fluxo(s) e rotina(s) de ferramentas Microsoft (como Power Automate e Power Bi)[^1] via linha de comando.
Aliado ao agendador de tarefas Windows cria-se gatilho(s)[^2].

[![Watch the video](https://img.youtube.com/vi/09ceWwO6Xx0/maxresdefault.jpg)](https://youtu.be/09ceWwO6Xx0)

## Instalação

O `pythomate` está disponível no Python Package Index - [PyPI](https://pypi.org/project/pythomate/), sendo **compatível apenas com sistema operacional Windows**.
Ele pode ser instalado utilizando-se o comando[^3]:

```bash
# Sugerimos a instalação em ambiente virtual
$ pip install pythomate
```

- Necessário adicionar ao `PATH` do Windows caminho de instalação das ferramentas Microsoft desejadas (Power Automate e/ou Power Bi)[^4].
- Para o Power Automate é necessário **desmarcar** a opção de configuração "Ao fechar, manter aplicativo em execução". Isso evita conflito entre instâncias abertas e a execução que será gerada com auxílio do pacote.

## Uso

Diretamente na linha de comando:

```bash
# Substitua <ferramenta> pela ferramenta que se deseja acionar (automate ou bi).
# Substitua <nome> pelo nome do fluxo/processo que deseja iniciar.
$ pythomate run <ferramenta> <nome>
```

Para maiores informações, consulte documentação disponível no próprio CLI, via `pythomate --help`.

## Contribuições

Veja o arquivo [`CONTRIBUTING.md`](CONTRIBUTING.md) para mais detalhes.

## Licença

O **pythomete** é licenciado sob a licença MIT.
Veja o arquivo [`LICENSE.txt`](LICENSE.txt) para mais detalhes.

Teste push.

[^1]: Atualmente encontra-se implantado apenas processos para Power Automate.
[^2]: Gatilhos que, em geral, não são permitidos em versões gratúitas destas ferramentas.
[^3]: Sugerimos a utilização da Git Bash disponível na instalação do programa [Git for Windows](https://gitforwindows.org/).
[^4]: Como exemplo, sabemos que a ferramenta Power Automate, em geral, encontra-se instalada em `C:/Program Files (x86)/Power Automate Desktop/`. Em algumas situações a pasta de instalação do Power Automate pode não aparecer listada em nenhum lugar (como em `C:/Program Files (x86)`). Caso tenha algum problema ao tentar localizar este caminho, [este Issue](https://github.com/automatiza-mg/pythomate/issues/18) poderá te auxiliar ao explicar como utilizar o gerenciador de tarefas para descobrir onde o programa está instalado.


# CHANGELOG - Controle de alterações

Documentação das principais alterações deste repositório.
Baseado na filosofia [Mantenha um Changelog](https://keepachangelog.com/pt-BR/1.0.0/).

### [0.5] - 2024-07-10

- Melhora timeout de carregamento inicial da página See[#14](https://github.com/automatiza-mg/pythomate/issues/14) (retira wait(active)).

### [0.5] - 2024-07-10

- Fecha automate após execução do fluxo See [#15](https://github.com/automatiza-mg/pythomate/issues/15).
- Melhora timeout de carregamento inicial da página See[#14](https://github.com/automatiza-mg/pythomate/issues/14).
- Melhora fluxo click ok para fluxos com variáveis de entrada See [#12](https://github.com/automatiza-mg/pythomate/issues/12).

### [0.4] - 2024-05-22

- Aumenta timoute para execução Power Automate - See [#11](https://github.com/automatiza-mg/pythomate/issues/11#issuecomment-2125428514).
- Melhora documentação - See [#11](https://github.com/automatiza-mg/pythomate/issues/11#issuecomment-2125428514).

### [0.3] - 2024-05-22

- Corrige erro de não clicar em Meus fluxos no menu inicial - See [#11](https://github.com/automatiza-mg/pythomate/issues/11).

### [0.2] - 2023-11-10

- Publicação primeiro comando `pythomate run automate <nome-fluxo>`.

### [0.1] - 2023-10-16

- Publicação estrutura inicial necessária para funcionamento do pacote. Sem nenhuma função implementada.