CLI Referansi

Forge CLI: tüm komutlar ve önemli davranışlar

English · Türkçe · Languages / Diller

Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe

Paket iki eşdeğer giriş noktası sağlar: forge ve json-api-forge. Kaynak ağacında python forge.py da kullanılabilir. Genel --root parametresi alt komuttan önce yazılır:

forge --root /srv/forge validate

Komut tablosu

Komut	Seçenekler	Etki
new NAME / new-app NAME	--slug, --preset	app/NAME oluşturur; var olan hedefi reddeder
init	--production, --editor, --force	.env ve rastgele sırlar üretir
validate	—	Tüm projelerin model ve semantik kontrolleri
doctor	--production, --json	Güvenlik, routing ve dağıtım teşhisleri
routes	—	HTTP ve WebSocket yollarını yazdırır
openapi	--output / -o	Oluşturulan OpenAPI'yi dosyaya yazar
schema	—	JSON şemalarını modelden yeniden üretir
migrate	—	Forge destek tablolarını ve auto-create kaynak tablolarını oluşturur
secrets	--count	Güçlü sırları stdout'a üretir; dosya değiştirmez
dev	--host, --port, --reload, --no-reload, --log-level	Geliştirme ASGI sunucusu

--help hem genel hem komuta özeldir. doctor hata seviyesinde teşhis varsa çıkış kodu 2 döndürür. --json CI veya otomatik raporlama için kullanılabilir.

Preset'ler

Preset	Başlangıç içeriği
minimal	Veritabanı, bootstrap, performans ve boş resources
postgres-api	Yukarıdakiler + items SQL kaynağı
discord-bot	Items ve bot rolü
game-backend	Items ve gaming feature pack

Preset isimleri tam bir ürün kurulduğu anlamına gelmez. postgres-api PostgreSQL sunucusu kurmaz; discord-bot bir Discord botunu kendiliğinden başlatmaz.

init ve mevcut .env

Yeni dosyada --production, APP_ENV=production ve OPERATOR_TOKEN; --editor, yönetim API anahtarı ve etkinlik ayarı üretir. Proje JSON'larında varsayılanı olmayan ve adı SECRET/TOKEN/KEY/PASSWORD içeren env başvuruları da yönetilen sırlar olarak bulunur.

Mevcut dosyada:

• forge init üzerine yazmayı reddeder.
• forge init --force bulunan tüm yönetilen sırları döndürür. Sadece yeni projenin eksik anahtarını ekleyen bir komut değildir.
• Dosyanın diğer satırları korunur. Bu nedenle mevcut .env üzerinde --production veya --editor kullanmak tüm çalışma modu satırlarını otomatik dönüştürmez; APP_ENV ve EDITOR_API_ENABLED değerlerini ayrıca inceleyin.

Yalnız yeni bir sır gerektiğinde forge secrets ile üretip ilgili değişkeni sır yönetiminize ekleyebilirsiniz. Gerçek değeri log, issue veya Wiki'ye yazmayın.

migrate sınırı

forge migrate sürümlü iş verisi migration aracı değildir. Mevcut sütunları yeniden tasarlayan bir Alembic zinciri, otomatik veri taşıma veya geri alma planı oluşturmaz. Üretim şema değişiklikleri migration sayfasındaki süreçle yönetilir.

dev sınırı

Varsayılan host 127.0.0.1, port 8000, Python reload truedur. --no-reload, Python reloader'ını kapatır; JSON watcher için APPS_AUTO_RELOAD=false gerekir. Global proxy yeniden yazımı kapalıdır; Forge kendi proxy güven politikalarını uygular.

Kaynak ve doğrulama

Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.

• main/framework/cli.py
• main/pyproject.toml

---

Wiki ana sayfa · Tüm sayfalar · Sürüm ve bakım