notLang — VS Code kengaytmasi

.ntl fayllar uchun sintaksis yoritish, kod bo'laklari (snippets) va asosiy IntelliSense.

Imkoniyatlari

Sintaksis yoritish — barcha 153 ta notLang buyrug'i (load, buffer, get_sentinel, moran, get_worldclim_future va h.k.) va 80+ parametr kalit so'zi (bbox, scale, reducer, cloud_mask va h.k.) alohida ranglarda ko'rsatiladi. Qatorlar (#), satrlar, sonlar, -> operatori va $O'ZGARUVCHI interpolyatsiyasi ham to'g'ri tanib olinadi.
26 ta kod bo'lagi (snippet) — eng ko'p ishlatiladigan naqshlar uchun: load, buffer-area, filter, show-scheme, zonal_stats, GEE (get-gee, get-gee-ndvi, export_gee, ikkala connect-gee-*), Copernicus (connect-copernicus, get_sentinel), fazoviy statistika (moran, lisa, classify_dbscan), osmnx (get_osmnx, route_osmnx), WorldClim (get_worldclim, get_worldclim_future), vaqt seriyasi va boshqalar. Yozishni boshlang (masalan get-gee), Tab bosing — to'liq shablon avtomatik to'ldiriladi.
"Joriy faylni ishga tushirish" buyrug'i — Ctrl+Shift+Enter (Mac: Cmd+Shift+Enter) yoki muharrir tepasidagi ▶ tugmasi orqali joriy .ntl faylni ishga tushiradi, chiqishni "notLang" Output panelida ko'rsatadi.
Colab-ga o'xshash avtomatik vizual natija — agar skript webmap (interaktiv xarita), show3d (3D ko'rinish), show (statik xarita), yoki chart (diagramma) buyrug'ini ishlatsa, natija fayli avtomatik ravishda VS Code'ning o'zida ochiladi:
- .html (webmap/show3d) — Webview panelida, to'liq interaktiv
- .png/.jpg/.gif/.svg (show/chart) — VS Code'ning o'zining standart rasm ko'ruvchisida (zoom bilan)
Faylni qo'lda topish yoki brauzerga chiqish shart emas — xuddi Jupyter/Colab'da katakni ishga tushirganda natija darhol ko'rinishiga o'xshash tajriba.
"REPL ochish" buyrug'i — Buyruqlar palitrasidan (Ctrl+Shift+P) interaktiv notLang REPL'ni ochadi.
IntelliSense (avtomatik taklif) — harf yozib borishning o'zidayoq mos keladigan buyruq/parametrlar ro'yxati chiqadi (masalan "get" yozilsa get_sentinel, get_stac, get_worldclim va h.k. barchasi taklif qilinadi; "lo" yozilsa load taklif qilinadi) — barcha 154 buyruq va 82 parametr uchun.
Rang tanlash (Color Picker) — color "red" yoki color "#ff0000" kabi qatorlarda rang qiymati yonida kichik rangli kvadratcha chiqadi. Bosilganda VS Code'ning o'zining standart rang tanlash oynasi ochiladi (HEX/RGB/HSL formatlarida tahrirlash mumkin, 148 ta nomli rang — "red", "steelblue" va h.k. — ham qo'llab- quvvatlanadi).
"Muallif/loyiha haqida" buyrug'i — Buyruqlar palitrasidan o'rnatilgan notlang --about ma'lumotini (muallif, sayt, email) ko'rsatadi — bu ma'lumot notLang'ning o'zida markazlashtirilgan bo'lgani uchun terminal, .ntl skript (about buyrug'i) va VS Code hammasi doim bir xil, sinxron ma'lumotni ko'rsatadi.
Qavslarni avtomatik yopish, izoh (#) qo'llab-quvvatlash.

O'rnatish

VS Code'da

.vsix faylni yuklab oling
Buyruqlar palitrasi (Ctrl+Shift+P) -> "Extensions: Install from VSIX..." -> faylni tanlang

Yoki terminal orqali:

code --install-extension notlang-0.4.24.vsix

Cursor'da

Cursor — VS Code'ning "fork"i bo'lib, xuddi shu kengaytma arxitekturasini ishlatadi. Bu kengaytma faqat til-darajasidagi (sintaksis yoritish, snippets, oddiy terminal buyruqlari) bo'lgani va hech qanday Microsoft-proprietar (masalan Copilot-maxsus) xususiyatga bog'liq bo'lmagani uchun Cursor'da ham xuddi shunday ishlaydi:

Buyruqlar palitrasi (Ctrl+Shift+P) -> "Extensions: Install from VSIX..." -> faylni tanlang

Yoki terminal orqali (agar cursor CLI o'rnatilgan bo'lsa):

cursor --install-extension notlang-0.4.24.vsix

Talablar

Bu kengaytma faqat muharrir-darajasidagi yordam beradi (rang, avtomatik to'ldirish). Skriptlarni haqiqatda ISHGA TUSHIRISH uchun notlang paketi alohida o'rnatilgan bo'lishi kerak:

pip install notlang[full]

Agar notlang buyrug'i PATH'da topilmasa (masalan alohida virtual muhitda), Sozlamalar (Ctrl+,) -> "notlang" qidiring va notlang.usePythonModuleni yoqib, notlang.pythonPathni venv Python yo'liga o'rnating.

Bilinган cheklovlar

IntelliSense buyruq/parametr nomlarini to'liq taklif qiladi, lekin hozircha ularning argument tuzilishini (masalan get_sentinel keyin qanday parametrlar kelishi kerakligini) tekshirmaydi — bu uchun to'liq til-serveri (LSP, real vaqtda grammatik xato tekshirish) hali qo'shilmagan. Bu — kelajakdagi versiya uchun rejalashtirilgan.
webmap ... draw (interaktiv chizish vositalari) VS Code'da ISHLAMAYDI — bu faqat jonli Jupyter/Colab kernelida ishlaydi, chunki chizilgan geometriyani qaytarib olish uchun doimiy (real-vaqt) aloqa kerak. drawsiz webmap/show3d esa VS Code'da to'liq ishlaydi (standalone HTML fayl + avtomatik Webview orqali).
Vizual natijalarni avtomatik ochish uchun webmap/show3d buyruqlarida folium/plotly kutubxonalari o'rnatilgan bo'lishi kerak (pip install folium plotly).
Kengaytma versiyasi notLang'ning o'zi bilan mos ravishda yangilanadi (hozir v0.4.24).

Litsenziya

notLang loyihasi bilan bir xil litsenziya.

Muallif

Xushnudbek Rahimberganov Sayt: https://notgis.top Email: notgis@proton.me