Ana içeriğe geç
Dil v0.2.0 · Ön izleme

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/cli

Bu sürümü sabitlemek için:

npm install --global @nm-lang/cli@0.7.1

Bir 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 tr

Oluş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 --json

check 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-visibility

Yeni 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.1

Python

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

nm test main.nm --name "balanced qubit" --jsonnm test main.nm --report-format junit --output results.xmlnm test main.nm --report-format sarif --output results.sarifnm test main.nm --watch --json

Bilinmeyen/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.

başarılı: 0hata: 1
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.

çıktı: jsondeterminizm: runtime-timingdosya sistemi: neverJSON
01
nm doctor --json

Gö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.

çıktı: human-or-jsondeterminizm: filesystem-dependentdosya sistemi: neverJSON
02
nm run main.nm --sweep sweep.json --experimental-parameter-groups --json

Açık zip/kartezyen eksenleri ortak işlem bütçesi ve tekrar çalıştırılabilir kaynak kanıtıyla yürütür.

çıktı: human-or-jsondeterminizm: runtime-timingdosya sistemi: neverJSON
03
nm check main.nm --json

Bir programı isteğe bağlı ve açıkça uzlaşılan deneysel dil desteğiyle parse eder ve doğrular.

çıktı: human-or-jsondeterminizm: byte-stabledosya sistemi: neverJSON
04
nm run main.nm --shots 1024 --json

Açık shot, çıktı ve bağımsız uzlaşılan deneysel dil yetenekleriyle çalıştırır.

çıktı: human-or-jsondeterminizm: runtime-timingdosya sistemi: neverJSON
05
nm debug main.nm --breakpoint 6 --json

Doğrulanmış breakpoint'lerle sınırlı source-mapped debug oturumu kaydeder.

çıktı: human-or-jsondeterminizm: byte-stabledosya sistemi: neverJSON
06
nm fmt main.nm --check

Kaynak-koruyan çıktıyı biçimlendirir veya doğrular.

çıktı: human-or-sourcedeterminizm: byte-stabledosya sistemi: optional
07
nm lint main.nm --strict

Tanıları raporlar ve strict uyarı politikasını uygular.

çıktı: humandeterminizm: byte-stabledosya sistemi: never
08
nm test main.nm --experimental-property-assertions --json

Test, 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.

çıktı: human-or-jsondeterminizm: byte-stabledosya sistemi: optionalJSON
09
nm explain main.nm --json

Tanıları ve iyileştirme fırsatlarını açıklar.

çıktı: human-or-jsondeterminizm: byte-stabledosya sistemi: neverJSON
10
nm transpile main.nm --target superconducting --calibration calibration.json --json

İsteğe bağlı kalibre yerleşimle target-native gate basis'ine indirger.

çıktı: source-or-jsondeterminizm: byte-stabledosya sistemi: neverJSON
11
nm estimate main.nm --ftqc --budget nm-budget.json

Mantı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.

çıktı: jsondeterminizm: byte-stabledosya sistemi: neverJSON
12
nm export main.nm --to qasm3 --strict --json

QASM, 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.

çıktı: source-or-jsondeterminizm: byte-stabledosya sistemi: neverJSON
13
nm benchmark main.nm --optimizers gd,adam --steps 8 --csv

Sınırlı objective veya supervised workload'ları benchmark eder ve sürümlü JSON ya da CSV kanıtı üretir.

çıktı: source-or-jsondeterminizm: runtime-timingdosya sistemi: neverJSON
14
nm checkpoint create main.nm --steps 8

Eski kesin GD kaydı veya isteğe bağlı, eniyileyici belleğini koruyan deterministik devam kaydı üretir.

çıktı: jsondeterminizm: byte-stabledosya sistemi: neverJSON
15
nm checkpoint resume training.checkpoint.json --additional-steps 8

Girdi kaydını değiştirmeden eski GD veya durumlu eğitim kaydını doğrular ve devam ettirir.

çıktı: jsondeterminizm: byte-stabledosya sistemi: neverJSON
16
nm checkpoint model training.checkpoint.json --name resumed-model

Doğrulanmış checkpoint durumunu mevcut model-package sözleşmesine dönüştürür; createdAt çağrı zamanını yansıtır.

çıktı: jsondeterminizm: runtime-timingdosya sistemi: neverJSON
17
nm init main.nm

Korumalı ve çalıştırılabilir başlangıç programı oluşturur.

çıktı: humandeterminizm: filesystem-dependentdosya sistemi: always
18
nm init bell-project --template bell --name bell-project

Mevcut dosyaları değiştirmeden ortak kaynak baytlarından eksiksiz bir proje oluşturur.

çıktı: human-or-jsondeterminizm: filesystem-dependentdosya sistemi: alwaysJSON
19
nm package build main.nm

Taşınabilir learning-package artefaktı oluşturur.

çıktı: jsondeterminizm: byte-stabledosya sistemi: neverJSON
20
nm package validate package.json

Learning-package sözleşmesini doğrular.

çıktı: humandeterminizm: byte-stabledosya sistemi: never
21
nm package list --json

Exact registry paketlerini ve güven metadata'sını listeler.

çıktı: human-or-jsondeterminizm: byte-stabledosya sistemi: neverJSON
22
nm package inspect std.bell@0.1 --json

Kaynak, bütünlük, lisans ve güven metadata'sını inceler.

çıktı: human-or-jsondeterminizm: byte-stabledosya sistemi: neverJSON
23
nm package install std.bell@0.1 --output std_bell.nm --json

Bütünlüğü denetlenmiş exact paketi kurar.

çıktı: human-or-jsondeterminizm: filesystem-dependentdosya sistemi: alwaysJSON
24
nm package sign release.json --output release.signed.json --json

Ed25519 release attestation oluşturur.

çıktı: human-or-jsondeterminizm: filesystem-dependentdosya sistemi: alwaysJSON
25
nm package verify release.signed.json --json

İmzalı paket sürümünü güvenilir anahtarlarla doğrular.

çıktı: human-or-jsondeterminizm: byte-stabledosya sistemi: neverJSON
26
nm workspace snapshot main.nm

Deterministik salt-okunur workspace snapshot'ı oluşturur.

çıktı: jsondeterminizm: byte-stabledosya sistemi: neverJSON
27
nm workspace share main.nm

Sınırlı ve fragment-öncelikli snapshot URL'si üretir.

çıktı: urldeterminizm: byte-stabledosya sistemi: never
28
nm workspace validate workspace.snapshot.json --json

Snapshot bütünlüğünü kararlı tanı kodlarıyla doğrular.

çıktı: human-or-jsondeterminizm: byte-stabledosya sistemi: neverJSON
29
nm lock main.nm

Experimental package importlarından canonical exact dependency lock üretir.

çıktı: jsondeterminizm: byte-stabledosya sistemi: neverJSON
30
nm lock main.nm --lock nm-lock.json --json

Eksik, stale, değişmiş ve exact olmayan source dependency'lerini lock'a karşı doğrular.

çıktı: human-or-jsondeterminizm: byte-stabledosya sistemi: neverJSON
31
Playground'u aç