Loopt, TypeScript, Python, Go veya Rust ile yazılan GitHub Actions workflow'larını YAML'e derliyor

CI pipeline'ları için bir derleyici

GitHub'da preloopdev organizasyonu altında yayımlanan ve Hacker News'in ana sayfasında öne çıkan açık kaynak proje Loopt, GitHub Actions'ı bir yazım biçimi değil bir derleme hedefi olarak ele alıyor. Geliştiriciler workflow'ları TypeScript, Python, Go veya Rust ile yazıyor — dördü de birinci sınıf dil desteğiyle geliyor — ve araç geleneksel YAML dosyalarını .github/workflows/ altında üretiyor. Eklenti protokolü üzerinden ek diller eklenebiliyor.

Çıktı sıradan bir GitHub Actions YAML'i olduğundan, bir depo aracı benimsediğinde GitHub tarafında hiçbir şey değişmiyor. Üretilen dosyalar, Loopt tarafından oluşturulduklarını belirten ve düzenlemeleri bunun yerine .loopt/workflows/ altındaki kaynak dosyalara yönlendiren bir başlık yorumu taşıyor.

Mevcut workflow'larla çalışmak

Benimseme genellikle halihazırda var olan pipeline'larla başlar ve Loopt bunu loopt import ile çözüyor; bu komut mevcut workflow YAML'ini düzenlenebilir kaynak koda dönüştürürken özgün dosyalara dokunmuyor. .github/workflows/ dışında action.yml dosyalarında tanımlanan composite action'lar da aynı şekilde action meta verisi olarak içe aktarılıyor.

Eşitleme disiplini iki yönlü işliyor. loopt gen, YAML'i kaynaktan yeniden üretiyor ve --force geçirilmedikçe Loopt dışında elle düzenlenmiş bir workflow'un üzerine yazmayı reddediyor. loopt gen --check çalıştırıldığında, commit edilmiş YAML artık commit edilmiş kaynakla eşleşmiyorsa başarısız oluyor; bu da biçim sapmasını bir CI işinin otomatik olarak yakalayabileceği bir şeye dönüştürüyor.

İskelet oluşturma ve güvenli varsayılanlar

loopt init, seçilen dilde bir başlangıç workflow'u yazıyor, ilgili YAML'i üretiyor ve bulduğu projeye uyum sağlıyor. Projenin README'sine göre, algılanan bir package.json npm install ve test adımları üretiyor, Cargo.toml cargo test veriyor, go.mod go test ./... veriyor ve Python paketleme dosyaları pip ve pytest adımlarına yol açıyor. Bu işaretlerden hiçbirini içermeyen depolar, yerine konulacak bir yer tutucu adım alıyor.

Varsayılanlar kayda değer ölçüde güvenlik odaklı. Her başlangıç şablonu contents: read kapsamıyla sınırlı salt okunur bir token kullanıyor, actions/checkout eylemini belirli bir commit'e sabitliyor, kimlik bilgilerini kalıcı hale getirmekten kaçınıyor, geçersiz kılınan çalışmaları iptal ediyor ve aracın kendi lint denetimlerini geçiyor. README, başlangıç şablonunun yalnızca serbestçe düzenlenecek bir başlangıç noktası olduğunu vurguluyor.

Lint ve destekleyici komutlar

loopt review, üretilen workflow'lar üzerinde yerel doğruluk ve güvenlik denetimleri çalıştırıyor ve isteğe bağlı olarak run: betiklerini shellcheck'ten geçiriyor. loopt gen aynı review'u otomatik olarak çağırıyor, böylece denetimler ayrı bir tercih adımı olarak değil her üretimde çalışıyor. Review; --persona, --context ve --shellcheck gibi bayrakları, belgelenmiş bir önem düzeyi eşlemesiyle destekliyor.

Çekirdek derleme adımının çevresinde bir dizi destekleyici komut bulunuyor: loopt actions tipli ve commit'e sabitlenmiş action import'ları üretiyor; loopt secrets sync yalnızca isimlerden oluşan bir secret envanterini koruyor; loopt lock ise bir workflow lockfile aracılığıyla uses: referanslarının sabitlenmesini zorunlu kılıyor. Yazım SDK'ları npm'de @preloopdev/sdk ve crates.io'da loopt-sdk olarak yayımlanıyor.

Erişilebilirlik

Önceden derlenmiş binary'ler arm64 üzerinde macOS'u ve x86_64 üzerinde Linux'u kapsıyor; bir yayın checksum'ı yayımlandığında bunu doğrulayan bir shell betiğiyle kuruluyorlar. Ortam değişkenleri yükleme dizinini değiştirebilir veya v0.1.1 gibi belirli bir yayına sabitleyebilir. Hangi dilde yazarsanız yazın — Node.js 26 veya üzeri, Python 3, Go ya da Cargo/Rust — ilgili runtime, üretim zamanında kurulu olmalı. Proje MIT lisanslı.

Neden önemli

CI YAML'i meşhur biçimde hataya açıktır: tipleri yoktur, string enterpolasyonlu ifadelere dayanır ve işler arasında kopyala-yapıştır'ı teşvik eder. Workflow'ları genel amaçlı bir dille yazmak, pipeline koduna tip denetimi, soyutlama ve test araçları getirir; YAML'e derleme tasarımı ise platform kilidi oluşturmaz — üretilen dosyalar, Loopt ortadan kalksa bile çalışmaya devam eden düz GitHub Actions dosyalarıdır. Sapma denetimi ve elle düzenlenmiş workflow'ların sessizce ezip yok etmeyi reddetmesi, üretilen dosyalara yönelik temel pratik itirazı yanıtlar: aynı pipeline'ın iki gösteriminin kaçınılmaz olarak birbirinden sapması. En az ayrıcalıklı token'ların ve commit'e sabitlenmiş action'ların varsayılan başlangıç şablonuna gömülmesi ise güvenli CI yapılandırmasını, belgelenmiş bir en iyi uygulamadan en az direnç gösterilen yola taşıyor.