Ir para o conteúdo

CLI Reference

Todos os comandos disponíveis via CLI core.

Projeto

# Criar novo projeto
stride init my-api
stride init my-api --python 3.13
stride init my-api --minimal  # Projeto mínimo

# Criar nova app
core createapp posts

Servidor

# Servidor de desenvolvimento (hot reload)
stride run

# Produção
stride run --no-reload --workers 4 --host 0.0.0.0 --port 8000

Banco de Dados

# Criar migration
stride makemigrations --name add_posts

# Aplicar migrations
stride migrate

# Mostrar status das migrations
core showmigrations

# Rollback última migration
core rollback

# Rollback para migration específica
core rollback 0002

# Info do banco
core dbinfo

# Reset do banco (DESTRUTIVO)
core reset_db --yes

Auth

# Criar superusuário
core createsuperuser

# Coletar permissões dos models
core collectpermissions

Debug

# Listar todas as rotas
core routes

# Verificar configuração
core check

# Shell interativo
stride shell

Deployment

# Gerar Dockerfile
core docker generate

# Gerar docker-compose.yml
core docker compose

# Gerar manifests Kubernetes
core deploy kubernetes

# Gerar config PM2
core deploy pm2

Kafka / Messaging

# Listar topics
core kafka topics

# Criar topic
core kafka create-topic my-topic --partitions 3

# Deletar topic
core kafka delete-topic my-topic

# Consumir mensagens
core kafka consume my-topic --group my-service

# Stream worker (Kafka @worker) — ver também: strider runworker
# (comandos kafka legacy podem variar; prefira strider runworker)

Workers / Tasks

Dois fluxos distintos: Tarefas vs stream workers.

# Jobs @task (strider.tasks) — consome filas tasks.<queue>
strider worker -q default -c 4
strider tasks

# Stream workers @worker (mensageria)
strider runworker MyWorkerClassName
strider runworker all
strider workers

# Agendamento @periodic_task
strider scheduler

Testing

# Executar testes
stride test

# Com coverage
stride test --cov

# Arquivo específico
stride test tests/test_posts.py

Versão

core version
core --version

Ajuda

core --help
core <command> --help

Opções Comuns

A maioria dos comandos suporta:

Opção Descrição
--help Mostrar ajuda
--dry-run Preview sem executar
--yes Pular confirmações

Configuração via Settings

O CLI usa configurações do Settings:

class AppSettings(Settings):
    # CLI / Discovery
    migrations_dir: str = "./migrations"
    app_label: str = "main"
    models_module: str = "app.models"
    workers_module: str | None = None  # Auto-discovery
    tasks_module: str | None = None    # Auto-discovery
    app_module: str = "src.main"
Setting Descrição
migrations_dir Diretório de migrations
app_label Label da aplicação
models_module Módulo dos models
workers_module Módulo dos workers (auto-discovery se None)
tasks_module Módulo das tasks (auto-discovery se None)
app_module Módulo da aplicação principal

Próximos Passos