python-scs 0.1.0

Agendador de Scripts Python usando Crontab com Painel Streamlit

Python Scripts Cron Scheduler

Abstração com Painel em Streamlit para gestão do agendamento de scripts Python através de CronJobs.

📌 Instalação

Você pode instalar as bibliotecas necessárias manualmente ou utilizando um arquivo requirements.txt.

pip install python-crontab psutil streamlit

🚀 Configuração

1. Copie o arquivo python_scs.py para sua aplicação.
2. Certifique-se de ter a seguinte estrutura de diretórios:

└── sua_aplicação/
    ├── scripts/
    │   ├── logs/
    │   ├── script_teste.py
    │   ├── __init__.py
    ├── python_scs.py
    ├── streamlit_pannel.py
    ├── app.py

3. Configure o painel no arquivo streamlit_pannel.py:

import os
from python_scs import PythonScriptsCronManager
from python_scs.streamlit import PannelConfig, StreamlitPannel

scripts_manager = PythonScriptsCronManager(
    config=PythonScriptsCronManager.Config(
        app_path=os.path.abspath('.'),  # Raiz onde scripts_folder estará
        scripts_folder='scripts',       # Diretório com os códigos
        logs_folder='scripts/logs'      # Diretório de logs
    ),
    user=True
)

streamlit_pannel = StreamlitPannel(scripts_manager, config=PannelConfig(
    layout='wide',
    title='Crontab Interface',
    subheader='Interface para gerenciamento de agendamentos',
    allow_upload_script=True,
    allow_create_job=True,
    allow_execute_job=True,
    allow_toggle_job=True,
    allow_remove_job=True
))

4. Execute o painel:

streamlit run streamlit_pannel.py

🛠 Uso da API

Instanciando o gerenciador de scripts

import os
from python_scs import PythonScriptsCronManager

scripts_manager = PythonScriptsCronManager(
    config=PythonScriptsCronManager.Config(
        app_path=os.path.abspath("."),  # Raiz onde scripts_folder estará
        scripts_folder="scripts",       # Diretório com os códigos
        logs_folder="scripts/logs"      # Diretório de logs
    ),
    user=True
)

📌 Veja a documentação do python-crontab para entender o parâmetro user.

Listando os scripts disponíveis

scripts = scripts_manager.get_scripts()
print(scripts)  # ["script_teste.py"]

Criando um agendamento

job = scripts_manager.set_script_job(
    script_name="script_teste.py",
    schedule=["* * * * *"],
    comment="Agendamento teste",
    enable=True
)

# Criando um agendamento com comando customizado
job = scripts_manager.set_job(
    command='echo "Teste"',
    schedule=["* * * * *"],
    log_file_name="teste.txt",  # Necessário para armazenar a saída
    comment="Agendamento customizado",
    enable=True
)

📌 Para verificar se o agendamento foi criado, execute:

crontab -l

Listando os agendamentos configurados

jobs = scripts_manager.get_jobs()
for job in jobs:
    print(f"{job.comment} - {job.script_name} - {job.is_runing()}")

# Busca um agendamento por filtros
job_script_test = scripts_manager.get_job({
    "script_name": "script_teste.py",
    "comment": "Agendamento teste"
})

Habilitando, desabilitando, executando e removendo um agendamento

job = scripts_manager.get_job({
    "script_name": "script_teste.py",
    "comment": "Agendamento teste"
})

job.enable_job()     # Habilita o job
job.disable_job()    # Desabilita o job
job.toggle_job()     # Alterna entre ativado/desativado

# Executa o script manualmente
scripts_manager.execute(job)

# Executa como subprocesso
scripts_manager.execute(job, use_subprocess=True)

# Remove o agendamento
scripts_manager.remove_job(job)

📜 Licença

Este projeto é distribuído sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.