autoAmbient 0.4.1

No project description provided

auto-enviroment

auto-enviroment é uma biblioteca Python que fornece modelos automatizados para facilitar o desenvolvimento de automações que interagem com interfaces de usuário em desktops, clicando, procurando e esperando quando solicitado

Instalação

Para realisar a instalação basta executar o seguinte comando via pip:

pip install autoAmbient

Modo de usar

Para começar a usar o auto-enviroment basta executar o comando no seu terminal :

createAmbient

A partir daí seram criados todos os arquivos base para que você comece a produzir e automatizar o que quiser. Escolha um local que você queira clicar, tire uma print, e coloque a imagem na pasta resouces com um bom nome, logo após isso execute:

createTagsFile

Após a criação da referencia à imagem no arquivo de tags você deve escrever o seu fluxo em run.py como no exemplo a seguir:

from botcity.core import DesktopBot
import tags as tg  # noqa: E261, F401
import blocks as bls
from ambient.tolls.utils import Nf


def run():
    class Bot(DesktopBot):
        def action(self, execution=None):
            nf = Nf(self)
            click(tg.btn_name) #o lugar que você que clicar

    Bot.main()

Depois disso é só executar o main.py e ver a mágica acontecer

Funções

As quatro funções disponíveis no arquivo automations-enviroment/src/run.py que são fornecidas pela classe Nf do módulo ambient.tolls.utils têm as seguintes funcionalidades:

• click(imgName, waiting_time): essa função faz um clique esquerdo do mouse na imagem com o nome fornecido.

• clickIfPossible(imgName, waiting_time): realiza a mesma operação do click, mas apenas se for possível, caso contrário, ele será ignorado e não emitira mensagem de erro.

• awaitItGoOut(imgName, waiting_time): essa função aguarda até que a imagem passada como parâmetro desapareça da tela.

• find(imgName, waiting_time, afterAction, notFoundAction): essa função busca pela imagem passada como parâmetro ,caso seja encontrado, executa o afterAction e, caso não, o notFoundAction.

Mensagens de erro

O auto-enviroment conta com diversas maneiras de corrigir erros como as GUIs para quando a respectiva imagem não for encontrada.

Mais algumas dessas interfaces podem ser usadas importando from ambient.tolls.gui import gui como no exemplo a seguir.

Contribuindo

Se você quiser contribuir com a biblioteca AutoAmbient, você deve seguir as seguintes etapas:

1. Fork o repositório
2. Crie sua branch de features (git checkout -b feature/fooBar)
3. Realize o commit de suas alterações (git commit -am 'Add some fooBar')
4. Faça o push das alterações (git push origin feature/fooBar)
5. Crie um novo Pull Request

Licença

Este projeto está sob a licença MIT. Para mais informações acesse o arquivo LICENSE.