N/M komut satırı referansı
Tekrar üretilebilir N/M workspace'leri oluşturma, denetleme, test etme, çalıştırma, paketleme, dışa aktarma, transpile etme ve paylaşma komutları.
Herkese açık npm kurulumu
N/M komut satırını kurun
Depoyu indirmeden veya TypeScript derlemesi yapmadan yerel bir N/M programı oluşturun ve çalıştırın.
Node.js 20 veya üzeri gerekir. Yayın kontrollerinde Node.js 22.23.1 kullanılır.
npm paket sürümü 0.7.1, N/M dil sürümü 0.2.0'ı hedefler. Etiketsiz kurulum varsayılan latest kanalını seçer; aynı sürümü yeniden kurmak için @0.7.1 kullanın. Dağıtım kanalı, dilin preview olgunluk durumunu değiştirmez. VS Code eklentisinin dağıtım sürümü ayrıdır.
npm install --global @nm-lang/cliBu sürümü sabitlemek için:
npm install --global @nm-lang/cli@0.7.1Bir program oluşturup yerel simülatörde çalıştırın
nm --version
nm init main.nm
nm run main.nm --jsonÖrnekler yerel simülatörde çalışır. Kurulum fiziksel QPU erişimi sağlamaz veya bütün yetenekleri kararlı hâle getirmez.
Kişisel, eğitim ve ticari kullanım ücretsizdir. QuantumSoftware paket kodunun haklarını saklı tutar; değiştirme ve yeniden dağıtma için ayrıca izin gerekir. Kendi N/M programlarınız ve sonuçlarınız size aittir. Kurulan paketteki LICENSE.txt dosyasını okuyun.
0.6.0 ile gelen araçlar
0.6.0 ile gelen sayısal işlemler, çalışma alanında otomatik içe aktarma ve hazır proje şablonları güncel CLI 0.7.1 ve Core 0.7.0 ile kullanılabilir. N/M dil sözleşmesi 0.2.0 ve özelliklerin ön izleme/deneysel durumları korunur.
Bir dosya yerine tam proje oluşturun
Bell, parametrik eğitim veya sayısal hesaplama şablonunu seçin. Her proje src/main.nm, ortak src/helper.nm, tests/main.test.nm, nm-workspace.json ve seçtiğiniz dilde README.md içerir.
Terminal
npm install --global @nm-lang/cli@0.7.1nm init bell-project --template bell --name bell-project --locale trnm init parametric-training-project --template parametric-training --name parametric-training-project --locale trnm init numerics-project --template numerics --name numerics-project --locale trOluşturucu dolu klasörün üzerine yazmaz ve kodu kendiliğinden çalıştırmaz. Sayısal şablonun README komutları --experimental-classical-functions ve --experimental-typed-classical-values bayraklarını açıkça belirtir. Manifest veya şablon deneysel izin vermez; kayıtlı kapalı ayarlar korunur.
Bell projesini kontrol edin, çalıştırın ve test edin
Yukarıdaki oluşturma komutlarından Bell örneğini çalıştırdıktan sonra aynı terminalde proje klasörüne geçin. JSON sürüm çıktısında cliPackageVersion 0.7.1, corePackageVersion 0.7.0 ve dil 0.2.0 görünmelidir. Bu komutlar Bell şablonu içindir; diğer şablonlarda kendi README adımlarını izleyin.
Terminal
cd bell-projectnm --version --jsonnm check src/main.nmnm run src/main.nm --jsonnm test tests/main.test.nm --jsoncheck kaynak ve importları doğrular; run 256 ölçümlük yerel Bell simülasyonu üretir ve yalnız 00/11 sonuçları beklenir; test ortak yardımcı devreyi kullanarak iki durumun olasılığını doğrular. Başarılı komutlar 0 çıkış koduyla biter. Parametrik şablondaki DSL train bloğu normal nm run sırasında yürütülür; --train ile seçilen ayrı sonlu ölçüm eğitim host'u farklı bir akıştır.
Çalışma alanından otomatik içe aktarma
Aynı çalışma alanındaki public fonksiyon, record ve enum adlarını yazmaya başladığınızda önerilerden seçin. Editör gereken use workspace.… satırını ekler. Private semboller önerilmez; takma ad, görünürlük ve döngü kontrolleri korunur. İndeks hazırlanırken açık dosyalardaki öneriler kullanılabilir.
Eklenti veya bağımsız dil sunucusu 0.6.0 gerekir. Oluşturduğunuz projenin src klasörüne aşağıdaki iki dosyayı ekleyip ikisini de editörde açın. classicalFunctions ve typedClassicalValues açık olmalıdır; bu public bildirimi için moduleVisibility de gerekir. VS Code'daki varsayılan açık profil bu izinleri sağlar; daha önce kaydedilmiş false değerleri ayrıca değiştirmeniz gerekir.
src/math.nm
module guide_math;public fn double(value: Float) -> Float { return value * 2.0;}src/import-demo.nm
module import_demo;use workspace.guide_math;fn main() { let q = qreg[1]; let result: Float = double(0.5); return result;}main örneği, öneri kabul edildikten sonraki hâlidir. Denemek için use workspace.guide_math; satırını kaldırın ve double adını dou yapın. İmleç dou sonundayken Ctrl+Space ile workspace.guide_math kaynaklı double önerisini seçin; tamamlama hem adı düzeltir hem import satırını ekler. Aynı adlı sembollerde önerinin kaynak modülünü kontrol edin.
Bu örnekte result değişkeninin değeri 1.0'dır. Öneri yoksa klasörü çalışma alanı olarak açtığınızı, dosyaların manifestteki src kaynak kökünde olduğunu ve ilgili özelliklerin açık olduğunu kontrol edin. Otomatik içe aktarma editör işlemidir. Rehberdeki CLI örneği aynı izinleri açıkça gösterir; kayıtlı veya aktarılan kapalı özellik seçimleri kendiliğinden açılmaz.
Terminal
nm check src/import-demo.nm --experimental-classical-functions --experimental-typed-classical-values --experimental-module-visibilityYeni sayısal işlemler
- eigvecsh
- Float/Complex Hermitsel matrisin özvektörlerini sütunlar halinde verir; sıralama eigvalsh ile aynıdır. Faz ve dejenere özuzayın baz seçimi tek değildir. Parametreye bağlı analitik özvektör türevi desteklenmez.
- solve
- Gerçel A*x=b çözümünün birinci analitik türevini A*dx=db-dA*x ile hesaplar. Aynı çağrıda primal ve türev sağ tarafları pivotlu ayrıştırmayı paylaşır; Complex ve ikinci türev bu kapsamda değildir.
- lstsq
- Kare veya uzun, tam sütun ranklı Float sistemlerde sütun pivotlu QR ile en küçük kareler çözümünü bulur. Geniş/rank eksik matrisler ve parametreye bağlı analitik türevler desteklenmez.
Mevcut 1–16 matris boyutu, 256 eleman ve ortak işlem bütçesi sınırları değişmez. Eklentinin test ve kayıtlı debugger akışı ayrı sonlu ölçüm eğitim host'unu başlatmaz; bu host CLI'de --train ile seçilir.
Matris ve türev rehberini aç →Python ve Jupyter'den yerel CLI'yi kullanın
CLI 0.7.1, python/ dizininde standart kütüphane köprüsünü ve isteğe bağlı nm_jupyter uzantısını içerir. Aşağıdaki örnek için npm paketini notebook veya Python projenize yerel kurun; kodu aynı proje dizininden çalıştırın. Python 3.10+ ve güvenilir PATH üzerinde Node.js gerekir.
Terminal
npm install @nm-lang/cli@0.7.1Python
from pathlib import Pathimport sys adapter_dir = Path.cwd() / "node_modules/@nm-lang/cli/python"sys.path.insert(0, str(adapter_dir.resolve()))from nm_bridge import NMClient client = NMClient(locale="tr", timeout=30)source = "module notebook_check;\nfn main() {\n let q = qreg[1];\n H(q[0]);\n return q;\n}"result = client.check(source)print(result.success)Bu örnek yalnız kaynak kontrolü yapar. Kaynak kontrolü, normal yürütme ve ayrı eğitim host'u farklı açık çağrılardır; notebook'u açmak veya modülü import etmek kod çalıştırmaz. Kayıtlar izin vermez; ölçüm bütçeleri ve güven aralıkları korunur. Ayrı PyPI yayını yoktur; yerel wheel kimliği 0.0.0.dev0'dır. Python adaptörü VSIX içine dahil değildir.
İsteğe bağlı hücreler için Python 3.11+ ortamınıza IPython 9.17.1 kurun. Yukarıdaki client hazırken ayrı bir hücrede %load_ext nm_jupyter çalıştırın; ardından aşağıdaki hücreyle açık kontrol başlatın. Global kernel veya otomatik başlangıç kurulmaz.
Jupyter
%%nm --client client --checkmodule notebook_check;fn main() { let q = qreg[1]; H(q[0]); return q;}Seçili testler, izleme ve CI raporları
Test seçimi, izleme ve CI raporları için @nm-lang/cli 0.3.0 veya üzerini kullanın. --name tam adla, --id aynı girdi yolu ve kaynak satırları için JSON raporundaki kimlikle seçer. İki seçenek de tekrarlanabilir; birleşimleri yürütülür. Seçilmeyen test blokları çalıştırılmaz, ortak kurulum ve özgün satırlar korunur. Kaynağın tamamında sözdizimi ve özellik doğrulaması devam eder.
CLI
1nm test main.nm --name "balanced qubit" --json2nm test main.nm --report-format junit --output results.xml3nm test main.nm --report-format sarif --output results.sarif4nm test main.nm --watch --jsonBilinmeyen/eski seçim NM-TEST-SELECT-001 hatasıdır. İç içe kontroller doğrudan seçilemez; üst düzey kontrolünü seçin. Boş suite veya başarısız yürütme çıkış kodu 1 döndürür. --report-format json|junit|sarif stdout biçimini seçer; --output mevcut üst klasörde belirtilen .json/.xml/.sarif raporunu her çalıştırmada yeniler. --json ile JSON dışı rapor biçimi birlikte kullanılamaz.
Node CLI host --watch ile ilk çalıştırmadan sonra bağımlı .nm dosyalarını ve çalışma alanı manifestlerini izler, değişiklikleri birleştirir ve çakışmayan yürütmeler yapar. --json çıktısı NDJSON olaylarıdır: run, sıra numarası, exitCode, report ve diagnostics alanları. JUnit/SARIF izlemede --output zorunludur. Ctrl+C veya SIGTERM izleyicileri kapatır.
@nm-lang/cli 0.3.0 ve üzerinde nm doctor --json veya nm doctor --locale tr ile yüklenen CLI/Core ve yerel LSP/MCP paketlerini kontrol edin. Paket, dil ve protokol sürümleri ayrı karşılaştırılır. VS Code kurulumu ve çalışan sunucular sorgulanmaz; gözlenmeyen araçlar doğrulanmış sayılmaz.
CLI 0.1 komut sözleşmesi
Help çıktısı, dokümantasyon, spec API, paketlenmiş CLI export'ları, çıktı türü, dosya sistemi değişikliği, determinizm ve exit code'lar tek registry'den üretilir. Başarılı komutlar 0; invocation, doğrulama, provider veya yürütme hataları 1 döndürür.
nm bridge --allow-feature hamiltonianEvolution --allow-feature measurementGroupingÖzgün kaynak, bağımsız çağıran izinleri ve tam eğitim/belirsizlik kanıtı içeren yerel ve sınırlı bir JSON isteğini çalıştırır.
nm doctor --jsonGözlenen CLI/Core ve yerel LSP/MCP metadata'sını yüklü sürüm ve yetenek manifestiyle karşılaştırır; gözlenmeyen editör/sunucu kurulumlarını açıkça belirtir.
nm run main.nm --sweep sweep.json --experimental-parameter-groups --jsonAçık zip/kartezyen eksenleri ortak işlem bütçesi ve tekrar çalıştırılabilir kaynak kanıtıyla yürütür.
nm check main.nm --jsonBir programı isteğe bağlı ve açıkça uzlaşılan deneysel dil desteğiyle parse eder ve doğrular.
nm run main.nm --shots 1024 --jsonAçık shot, çıktı ve bağımsız uzlaşılan deneysel dil yetenekleriyle çalıştırır.
nm debug main.nm --breakpoint 6 --jsonDoğrulanmış breakpoint'lerle sınırlı source-mapped debug oturumu kaydeder.
nm fmt main.nm --checkKaynak-koruyan çıktıyı biçimlendirir veya doğrular.
nm lint main.nm --strictTanıları raporlar ve strict uyarı politikasını uygular.
nm test main.nm --experimental-property-assertions --jsonTest, property ve snapshot kontrollerini tam ad/kimlik seçimi, JSON/JUnit/SARIF raporları ve Node host bağımlılık izlemesiyle çalıştırır.
nm explain main.nm --jsonTanıları ve iyileştirme fırsatlarını açıklar.
nm transpile main.nm --target superconducting --calibration calibration.json --jsonİsteğe bağlı kalibre yerleşimle target-native gate basis'ine indirger.
nm estimate main.nm --ftqc --budget nm-budget.jsonMantıksal ve hata-toleranslı kaynak tahminlerini döndürür ve isteğe bağlı sürümlü bütçe artefaktına karşı fail-closed uygular.
nm export main.nm --to qasm3 --strict --jsonQASM, Quantikz, ham AST JSON (json), sürümlü JSON IR (ir) veya çalıştırılabilir PennyLane Python dışa aktarır; QASM JSON kaynak yan kayıtlarını korur; QASM3 ayrıca conformance kanıtını içerir; PennyLane JSON zorunlu kaynak yan kayıtlarını korur.
nm benchmark main.nm --optimizers gd,adam --steps 8 --csvSınırlı objective veya supervised workload'ları benchmark eder ve sürümlü JSON ya da CSV kanıtı üretir.
nm checkpoint create main.nm --steps 8Eski kesin GD kaydı veya isteğe bağlı, eniyileyici belleğini koruyan deterministik devam kaydı üretir.
nm checkpoint resume training.checkpoint.json --additional-steps 8Girdi kaydını değiştirmeden eski GD veya durumlu eğitim kaydını doğrular ve devam ettirir.
nm checkpoint model training.checkpoint.json --name resumed-modelDoğrulanmış checkpoint durumunu mevcut model-package sözleşmesine dönüştürür; createdAt çağrı zamanını yansıtır.
nm init main.nmKorumalı ve çalıştırılabilir başlangıç programı oluşturur.
nm init bell-project --template bell --name bell-projectMevcut dosyaları değiştirmeden ortak kaynak baytlarından eksiksiz bir proje oluşturur.
nm package build main.nmTaşınabilir learning-package artefaktı oluşturur.
nm package validate package.jsonLearning-package sözleşmesini doğrular.
nm package list --jsonExact registry paketlerini ve güven metadata'sını listeler.
nm package inspect std.bell@0.1 --jsonKaynak, bütünlük, lisans ve güven metadata'sını inceler.
nm package install std.bell@0.1 --output std_bell.nm --jsonBütünlüğü denetlenmiş exact paketi kurar.
nm package sign release.json --output release.signed.json --jsonEd25519 release attestation oluşturur.
nm package verify release.signed.json --jsonİmzalı paket sürümünü güvenilir anahtarlarla doğrular.
nm workspace snapshot main.nmDeterministik salt-okunur workspace snapshot'ı oluşturur.
nm workspace share main.nmSınırlı ve fragment-öncelikli snapshot URL'si üretir.
nm workspace validate workspace.snapshot.json --jsonSnapshot bütünlüğünü kararlı tanı kodlarıyla doğrular.
nm lock main.nmExperimental package importlarından canonical exact dependency lock üretir.
nm lock main.nm --lock nm-lock.json --jsonEksik, stale, değişmiş ve exact olmayan source dependency'lerini lock'a karşı doğrular.