CLI

CLI Komutları

Dokuz public CLI komutu.

Public komut us (us.exe) altındadır. Aşağıdaki özet tablodan tarayın; her komutun doğrulanmış davranışı maddelerde anlatılır.

Komut	Amaç	Tipik kullanım
`us yeni`	Proje iskeleti	`us yeni konsol Merhaba`
`us çalıştır`	Yorumlayıcıda çalıştır	`us çalıştır` / `us çalıştır ana.us`
`us derle`	.NET emit (`cikti/`)	`us derle`
`us test`	`test` bildirimlerini koş	`us test`
`us yayınla`	Yerel `yayin/` klasörü	`us yayınla`
`us paket ekle`	Manifest paket satırı	`us paket ekle US.Json`
`us veritabanı senkronize`	Şema farkı / `.us-schema.json`	`us veritabanı senkronize [onay]`
`us biçimlendir`	Kaynağı yerinde biçimle	`us biçimlendir ana.us`
`us dil-sunucusu`	Stdio LSP sunucusu	Editör/LSP istemcisi başlatır

Proje komutları us.proje aramasını yalnız geçerli dizinde yapar; üst dizin taranmaz.

Terminal

$ us yeni konsol|kütüphane|web <ad>
$ us çalıştır [dosya|klasör]
$ us derle
$ us test
$ us yayınla
$ us paket ekle <ad>
$ us veritabanı senkronize [onay]
$ us biçimlendir [dosya]
$ us dil-sunucusu

İlgili konular

CLI · Proje Sistemi · VS Code ve Tooling

Referans

Bu sayfa 9 katalog öğesini kapsar. Aşağıdaki maddeler language-spec, örnekler ve katalog alanlarından üretilmiştir.

`yeni`

Nedir?

us yeni geçerli çalışma dizininde konsol, kütüphane veya web iskeleti oluşturur: us.proje yazar; konsol/web için ana.us ekler, kütüphane için giriş dosyası üretmez.

Biçim: us yeni \<tür\> \<ad\>. Türler: konsol → hedef uygulama + syaz örnek girişi; web → hedef web + örnek kontrolcü/rota; kütüphane → hedef kütüphane, başlangıç satırı yok. Manifest sürümü 1.0.0. Dolu dizin veya var olan us.proje üzerine yazılmaz (çıkış 1).

Örnek

Terminal

$ us yeni konsol Merhaba

Dikkat edilmesi gerekenler

Yalnızca konsol, kütüphane ve web kabul edilir; başka şablon yoktur.
Proje üst dizinlerde aranmaz; komut geçerli dizinde alt klasör açar.

Argümanlar: konsol|kütüphane|web <ad>

İlgili konular

Proje Sistemi

`çalıştır`

Nedir?

us çalıştır kaynağı yorumlayıcı ile yürütür. Argümansız çağrıda yalnız geçerli dizindeki us.proje yüklenir; üst dizin taranmaz. İsteğe bağlı .us dosyası veya proje klasörü yolu verilebilir.

Ne zaman kullanılır?

Geliştirme sırasında programı derlemeden çalıştırmak için kullanın.

Nasıl çalışır?

us çalıştır → cwd us.proje. us çalıştır ana.us → tek dosya. us çalıştır \<klasör\> → o klasördeki proje. kütüphane hedefinde giriş çalıştırılmaz; bağlama/derleme doğrulanır ve "Kütüphane derlemesi hazır" yazılır. test bildirimleri bu komutta otomatik koşmaz. Başarı çıkış 0; tanı/hata çıkış 1.

Örnek

Terminal

$ us çalıştır

Dikkat edilmesi gerekenler

us.proje yoksa ve yol verilmediyse US1701 ile başarısız olur.
Üst dizinlerde proje aranmaz.

Argümanlar: [dosya|klasör]

İlgili konular

Proje Sistemi · Derleyici

`derle`

Nedir?

us derle geçerli dizindeki us.proje projesini DotNetEmitBackend ile derler; çıktı proje kökündeki cikti/ altındadır (tipik artefakt UsProgram.dll). Yorumlayıcıya düşmez.

Ne zaman kullanılır?

Dağıtılabilir .NET derlemesi üretmek veya derleyici uyumluluğunu doğrulamak için kullanın.

Nasıl çalışır?

Argüman yoktur. yayin/bin/obj/.git dışındaki *.us kaynakları derlenir. Yalnızca SUPPORTED yüzey production-supported kabul edilir; desteklenmeyen özellikler tanı üretir. Başarı mesajı artefakt yolunu yazar; hata çıkış 1.

Sözdizimi

us derle

Örnek

Terminal

$ us derle

Dikkat edilmesi gerekenler

us.proje cwd içinde olmalıdır (üst dizin taranmaz).
us yayınla ile karıştırmayın: derle emit eder, yayınla yerel yayin/ paket klasörü üretir.

Argümanlar: —

İlgili konular

Derleyici Uyumluluğu · Derleyici

`test`

Nedir?

us test bağlı test "…" bildirimlerini bulur ve her birini ayrı değerlendirme oturumunda çalıştırır. Argüman veya isim süzgeci yoktur. Başarı çıkış 0; derleme/test hatasında çıkış 1.

Ne zaman kullanılır?

Birim testlerini komut satırından koşturmak için kullanın.

Nasıl çalışır?

Kaynak seçimi: cwd'de us.proje varsa projedeki *.us dosyaları; yoksa yalnız ana.us; ikisi de yoksa US1701. Binder test üyelerini toplar; her testte üst düzey üyeler yeniden çalışır, ardından test gövdesi. Konsola ✓/✗ satırları ve özet (N test, geçen/başarısız sayıları) yazılır. CLI bayrağı yoktur.

Sözdizimi

us test

Geçerli örnek

usana.us

fonksiyon topla(a: tamsayı, b: tamsayı): tamsayı{    => a + b} test "iki sayı doğru toplanır"{    sonuç: tamsayı = topla(2, 3)    beklenen sonuç == 5}

Örnek

Terminal

$ us test

Geçersiz örnek

US1701 — geçerli dizinde us.proje ve ana.us yoksa CLI çıkış 1. Başarısız beklenen veya derleme tanıları da çıkış 1 üretir; test dili tanıları için Test sayfasına bakın.

Dikkat edilmesi gerekenler

us çalıştır testleri otomatik koşmaz; ayrı us test gerekir.
İsim süzgeci veya ek CLI bayrağı yoktur.

Argümanlar: —

İlgili konular

Test · Proje Sistemi

`yayınla`

Nedir?

us yayınla proje kökünde yerel yayin/ klasörü üretir: us.proje kopyası ve kaynak listeli ozet.txt. Uzak registry'ye yükleme yapmaz. Önce bağlama/doğrulama derlemesi çalışır; DotNetEmitBackend emit etmez.

Ne zaman kullanılır?

Dağıtıma hazır yerel yayın klasörü almak için kullanın.

Nasıl çalışır?

cwd'de us.proje gerekir. yayin/ zaten varsa US1704 ile durur (üzerine yazmaz). Başarıda Yayın hazır: …/yayin yazar. Bu komut us derle çıktısı (cikti/) üretmez ve paket registry'sine göndermez.

Örnek

Terminal

$ us yayınla

Geçersiz örnek

US1704 — yayin/ klasörü zaten varsa üzerine yazılmaz (CLI çıkış 1). Manifest yoksa US1701.

Dikkat edilmesi gerekenler

Uzak paket registry yoktur; yayınla yükleme yapmaz.
us derle ile karıştırmayın: yayınlama yerel paket klasörüdür, DLL emit değildir.

Argümanlar: —

İlgili konular

Proje Sistemi · Derleyici

`paket ekle`

Nedir?

us paket ekle \<ad\> [sürüm] geçerli projenin us.proje dosyasına paket "…" sürüm "…" satırı ekler (exact sürüm; varsayılan 1.0.0). Uzak registry indirmez. Yerel kurulum için us paket kur kullanılır.

Ne zaman kullanılır?

Manifestte yerel paket bağımlılığı bildirmek için kullanın.

Nasıl çalışır?

cwd'de us.proje gerekir. Komut manifest satırı ekler. Uzak registry DEFERRED (US1555). SemVer aralığı / lockfile yoktur.

Sözdizimi

us paket ekle US.Json

Örnek

Terminal

$ us paket ekle US.Json

Dikkat edilmesi gerekenler

Uzak paket registry yoktur; ağdan paket indirmez (US1555).
Yerel çözümleme: us paket kur + paketler/\{ad\}/\{sürüm\}.
Exact sürüm; SemVer aralığı yok.

Argümanlar: <ad>

İlgili konular

Proje Sistemi

`veritabanı senkronize`

Nedir?

us veritabanı senkronize üst düzey *.us içindeki veritabanı/tablo şemasını karşılaştırır ve güvenli/ekleyici farkları uygular. MemoryDatabase şema dosyası ve SQL Server şema incelemesi/support vardır. Satır verisi taşımaz.

Ne zaman kullanılır?

Bellek veya SQL Server şemasını model bildirimiyle hizalamak için kullanın.

Nasıl çalışır?

Proje varsa kök oradan, yoksa cwd. Yıkıcı işlemler (DropTable, DropColumn, NarrowColumn vb.) için tam onay jetonu gerekir; yoksa US1550 ve uygulama yapılmaz. Başarı/"değişiklik yok" çıkış 0; Error tanılarında çıkış 1.

Örnek

Terminal

$ us veritabanı senkronize onay

Geçersiz örnek

US1550 — yıkıcı şema farkı varken onay yoksa senkron uygulanmaz.

Dikkat edilmesi gerekenler

Yıkıcı işlemler için onay gerekir (US1550); otomatik yıkım yoktur.
Yalnızca proje kökündeki üst düzey *.us dosyaları taranır (alt klasör yok).

Argümanlar: [onay]

İlgili konular

Veritabanı · Proje Sistemi

`biçimlendir`

Nedir?

us biçimlendir AST tabanlı biçimlendiriciyi çalıştırır ve hedef .us dosyasını yerinde yeniden yazar. Dosya verilmezse cwd projesinin giriş dosyası (ana.us) kullanılır.

Ne zaman kullanılır?

Kaynak düzenini standartlaştırmak için kullanın.

Nasıl çalışır?

us biçimlendir [dosya]. Başarıda Biçimlendirildi: … yazar. Dosya/giriş yoksa veya biçimlendirme hata verirse çıkış 1. Ek CLI bayrağı yoktur.

Örnek

Terminal

$ us biçimlendir ana.us

Dikkat edilmesi gerekenler

Dosya yerinde değiştirilir; ayrı çıktı yolu yoktur.

Argümanlar: [dosya]

İlgili konular

VS Code ve Tooling · Proje Sistemi

`dil-sunucusu`

Nedir?

us dil-sunucusu US dil sunucusunu stdio üzerinde Content-Length çerçeveli JSON-RPC (LSP) ile başlatır. Normal kullanıcılar bunu elle çağırmaz; VS Code eklentisi veya LSP istemcisi süreci yönetir.

Ne zaman kullanılır?

Editör/LSP istemcisi yapılandırmasında sunucu komutu olarak gösterilirken kullanın.

Nasıl çalışır?

Argüman yoktur. stdin EOF veya exit ile süreç 0 döner; yakalanmayan hata 1. İstemci bağlıyken engelleyici döngüde kalır. Yetenek ayrıntıları Tooling sayfasındadır; bu komut yalnızca sunucuyu başlatır.

Sözdizimi

us dil-sunucusu

Örnek

Terminal

$ us dil-sunucusu

Dikkat edilmesi gerekenler

Manuel etkileşimli kullanım için tasarlanmamıştır; çıktı LSP çerçevesidir.
Kurulum ve istemci ayarları için VS Code / Tooling belgesine bakın.

Argümanlar: —

İlgili konular

VS Code ve Tooling · CLI

CLI

CLI Komutları

Dokuz public CLI komutu.

Public komut us (us.exe) altındadır. Aşağıdaki özet tablodan tarayın; her komutun doğrulanmış davranışı maddelerde anlatılır.

Komut	Amaç	Tipik kullanım
`us yeni`	Proje iskeleti	`us yeni konsol Merhaba`
`us çalıştır`	Yorumlayıcıda çalıştır	`us çalıştır` / `us çalıştır ana.us`
`us derle`	.NET emit (`cikti/`)	`us derle`
`us test`	`test` bildirimlerini koş	`us test`
`us yayınla`	Yerel `yayin/` klasörü	`us yayınla`
`us paket ekle`	Manifest paket satırı	`us paket ekle US.Json`
`us veritabanı senkronize`	Şema farkı / `.us-schema.json`	`us veritabanı senkronize [onay]`
`us biçimlendir`	Kaynağı yerinde biçimle	`us biçimlendir ana.us`
`us dil-sunucusu`	Stdio LSP sunucusu	Editör/LSP istemcisi başlatır

Proje komutları us.proje aramasını yalnız geçerli dizinde yapar; üst dizin taranmaz.

Terminal

$ us yeni konsol|kütüphane|web <ad>
$ us çalıştır [dosya|klasör]
$ us derle
$ us test
$ us yayınla
$ us paket ekle <ad>
$ us veritabanı senkronize [onay]
$ us biçimlendir [dosya]
$ us dil-sunucusu

İlgili konular

CLI · Proje Sistemi · VS Code ve Tooling

Referans

Bu sayfa 9 katalog öğesini kapsar. Aşağıdaki maddeler language-spec, örnekler ve katalog alanlarından üretilmiştir.

`yeni`

Nedir?

us yeni geçerli çalışma dizininde konsol, kütüphane veya web iskeleti oluşturur: us.proje yazar; konsol/web için ana.us ekler, kütüphane için giriş dosyası üretmez.

Ne zaman kullanılır?

Yeni US projesi başlatırken kullanın.

Nasıl çalışır?

Örnek

Terminal

$ us yeni konsol Merhaba

Dikkat edilmesi gerekenler

Yalnızca konsol, kütüphane ve web kabul edilir; başka şablon yoktur.
Proje üst dizinlerde aranmaz; komut geçerli dizinde alt klasör açar.

Argümanlar: konsol|kütüphane|web <ad>

İlgili konular

Proje Sistemi

`çalıştır`

Nedir?

Ne zaman kullanılır?

Geliştirme sırasında programı derlemeden çalıştırmak için kullanın.

Nasıl çalışır?

Örnek

Terminal

$ us çalıştır

Dikkat edilmesi gerekenler

us.proje yoksa ve yol verilmediyse US1701 ile başarısız olur.
Üst dizinlerde proje aranmaz.

Argümanlar: [dosya|klasör]

İlgili konular

Proje Sistemi · Derleyici

`derle`

Nedir?

us derle geçerli dizindeki us.proje projesini DotNetEmitBackend ile derler; çıktı proje kökündeki cikti/ altındadır (tipik artefakt UsProgram.dll). Yorumlayıcıya düşmez.

Ne zaman kullanılır?

Dağıtılabilir .NET derlemesi üretmek veya derleyici uyumluluğunu doğrulamak için kullanın.

Nasıl çalışır?

Sözdizimi

us derle

Örnek

Terminal

$ us derle

Dikkat edilmesi gerekenler

us.proje cwd içinde olmalıdır (üst dizin taranmaz).
us yayınla ile karıştırmayın: derle emit eder, yayınla yerel yayin/ paket klasörü üretir.

Argümanlar: —

İlgili konular

Derleyici Uyumluluğu · Derleyici

`test`

Nedir?

Ne zaman kullanılır?

Birim testlerini komut satırından koşturmak için kullanın.

Nasıl çalışır?

Sözdizimi

us test

Geçerli örnek

usana.us

fonksiyon topla(a: tamsayı, b: tamsayı): tamsayı{    => a + b} test "iki sayı doğru toplanır"{    sonuç: tamsayı = topla(2, 3)    beklenen sonuç == 5}

Örnek

Terminal

$ us test

Geçersiz örnek

US1701 — geçerli dizinde us.proje ve ana.us yoksa CLI çıkış 1. Başarısız beklenen veya derleme tanıları da çıkış 1 üretir; test dili tanıları için Test sayfasına bakın.