Типы данных

Числа (Number): целые и с плавающей точкой. Например: 42, 3.14.

Строки (String): текст в двойных, одинарных или обратных кавычках (бэктиках): "some text", 'some text', `some text`. Строки поддерживают доступ к символам по индексу, как и списки.

Строки в обратных кавычках — особые: внутри {выражение} подставляется результат вычисления, а не печатается как текст. Двойных и одинарных кавычек это не касается — там {} остаётся обычным текстом.

name = "Dark"
age = 16

println(`Привет, {name}! Тебе {age} лет.`)
# Выведет: Привет, Dark! Тебе 16 лет.

println("Привет, {name}!") # Выведет буквально: Привет, {name}!

Внутри {} можно писать любое выражение — не только имя переменной: арифметику, обращение к атрибуту объекта, индексацию, вызов метода.

items = ["a", "b", "c"]
println(`Первый элемент: {items[0]}, всего: {items.len()}, сумма: {2 + 2 * 10}`)

Чтобы вывести буквальную фигурную скобку внутри бэктик-строки, а не подстановку, удвойте её: {{ и }}.

println(`Так пишут подстановку: {{name}}`)
# Выведет: Так пишут подстановку: {name}

Булевы (Boolean): true или false.

Списки (List): упорядоченная коллекция элементов в квадратных скобках. Доступ к элементам — по индексу (нумерация с 0):

my_list = ["a", "b", "c"]
println(my_list[1]) # Выведет "b"

my_list[1] = "B" # Изменение элемента по индексу
println(my_list) # Выведет ["a", "B", "c"]

Словари (Dictionary): коллекция пар ключ-значение в фигурных скобках. Доступ к значениям — двумя способами:

person = {"name": "Alex", "age": 30}

# Через квадратные скобки
println(person["name"]) # Выведет "Alex"

# Через точку (если ключ - валидный идентификатор)
println(person.age) # Выведет 30

Операторы

Dark поддерживает стандартные арифметические (+, -, *, /), сравнительные (==, !=, <, >, <=, >=) и логические операторы.

Логические операторы (and / or / not)

Для сложных условий используются and, or и not.

# Пример с 'and'
if age > 18 and has_license == true then
    println("Можно водить машину")
end

# Пример с 'or'
if is_weekend or is_holiday then
    println("Время отдыхать!")
end

# Пример с 'not'
is_ready = false
if not is_ready then
    println("Ещё не готово.")
end

# Пример not с операторами сравнения
if not (a > b) then
    println("a не больше b")
end

Операторы поддерживают «короткое замыкание» (short-circuiting): в выражении A and B, если A ложно, то B не вычисляется.

Управляющие конструкции

if · then · else

Условный оператор. Блок else не обязателен.

if x > 10 then
    println("x is greater than 10")
else
    println("x is not greater than 10")
end

while

Цикл, который выполняется, пока условие истинно.

i = 0
while i < 5 do
    println(i)
    i = i + 1
end

for

Цикл для итерации по элементам списка, строки или ключам словаря.

my_list = [1, 2, 3]
for item in my_list do
    println(item)
end

Функции

Определение пользовательских функций:

function add(a, b) do
    return a + b
end

result = add(5, 3)
println(result) # Выведет 8

Функция может не возвращать значение — тогда return используется для досрочного выхода:

function check_age(age) do
    if age < 18 then
        println("Доступ запрещен.")
        return # Досрочный выход из функции
    end
    println("Доступ разрешен.")
end

Обработка ошибок (try…except)

Конструкция try…except перехватывает ошибки времени выполнения, предотвращая аварийное завершение программы.

try do
    # Код, который может вызвать ошибку
except e do
    # Код, который выполнится в случае ошибки.
    # 'e' - это словарь с информацией об ошибке.
end

С версии 0.3.1 сообщения об ошибках стали более понятными: Dark показывает не только описание ошибки, но и строку кода с указателем на проблемное место, а также полную трассировку стека вызовов, если ошибка произошла внутри функции.

function inner_function() do
    c = 10 / 0 # Ошибка здесь
end

function middle_function() do
    inner_function() # Вызов, ведущий к ошибке
end

middle_function()

Вывод в консоли будет выглядеть так:

Трассировка вызовов (от последнего к первому):
  Файл "D:\...\script.dark", строка 8, в функция 'middle_function'
  Файл "D:\...\script.dark", строка 2, в функция 'inner_function'

Ошибка выполнения: деление на ноль
  [Файл: "D:\...\script.dark", строка 2, позиция 12]

  2 |     c = 10 / 0 # Ошибка здесь
    |            ^
--------------------------------------------------------------------

Пример

try do
    result = 10 / 0
except e do
    println("Произошла ошибка: " + e["message"])
end

assert

assert(условие, сообщение) проверяет условие. Если оно ложно — выводит сообщение в консоль. Оба аргумента обязательны и передаются в скобках через запятую.

age = -5
assert(age >= 0, "Возраст не может быть отрицательным")

Импорт модулей

Для использования кода из других файлов (модулей) используется ключевое слово import. Путь указывается в двойных кавычках, расширение .dark или .py указывать не нужно. Синонимом import служит use.

# Импортируем стандартный модуль os
import "os"
# или так:
use "os"

# Импортируем пользовательский модуль из файла my_module.dark
import "my_module"

os.system("cls")
my_module.my_function()

Можно импортировать конкретные имена из модуля конструкцией from … use …:

# В файле my_math.dark есть PI = 3.14 и функция square(x)
from "my_math" use PI, square

println(PI)        # Выведет 3.14
println(square(5)) # Выведет 25

С версии 1.2.0 Dark поддерживает импорт модулей напрямую из интернета:

from "https://raw.githubusercontent.com/Dark-Tehno/Dark-Lang-Source-Code/refs/heads/main/example/script.dark" use PI

println(PI)

Комментарии

Однострочные комментарии начинаются с символа #.

# Это комментарий. Он будет проигнорирован.
variable = 1 # Это тоже комментарий.

Директивы

Строка в начале файла, начинающаяся с #!, объявляет директиву.

#!nocache
# Это директива, которая отключает кеширование для этого файла.
# Полезно при разработке, чтобы изменения в файле сразу применялись.

#!USE_WITH_PYTHON
# Эта директива включает интеграцию с Python, позволяя использовать модуль `python`.
# Требуется для выполнения Python-кода внутри Dark-скрипта.
python.exec('print("Hello from Python!")')

# или версия с созданием переменных:
python_code = """
a = input("Enter something: ")
print(f"You entered: {a}")
def greet(name):
    return f"Hello, {name}!"
b = greet("World")
"""
vars = python.exec(python_code)
println(vars['a'])
println(vars['b'])

"my string".len()

Возвращает количество символов в строке.

"my string".upper()

Возвращает новую строку в верхнем регистре.

"my string".lower()

Возвращает новую строку в нижнем регистре.

" str ".strip()

Удаляет пробельные символы в начале и в конце строки.

"string".startswith(prefix)

Возвращает true, если строка начинается с prefix.

"string".endswith(suffix)

Возвращает true, если строка заканчивается на suffix.

"string".find(substring)

Ищет подстроку, возвращает индекс первого вхождения или -1.

"string".replace(old, new)

Заменяет все вхождения old на new.

"string".split(separator)

Разбивает строку на список строк по разделителю.

"string".join(list)

Объединяет список строк в одну строку с указанным разделителем.

my_list.len()

Возвращает количество элементов в списке.

my_list.append(item)

Добавляет элемент в конец списка.

my_list.pop()

Удаляет и возвращает последний элемент списка.

my_list.insert(index, item)

Вставляет элемент item на позицию index.

my_list.remove(item)

Удаляет первое вхождение элемента item.

my_list.index(item)

Возвращает индекс первого вхождения элемента item.

my_list.count(item)

Возвращает количество вхождений элемента item.

my_list.reverse()

Обращает порядок элементов в списке.

my_list.sort()

Сортирует элементы списка на месте.

my_list.clear()

Удаляет все элементы из списка.

my_dict.len()

Возвращает количество пар ключ-значение в словаре.

my_dict.keys()

Возвращает список всех ключей.

my_dict.values()

Возвращает список всех значений.

my_dict.items()

Возвращает список пар ключ-значение (в виде списков из двух элементов).

my_dict.get(key, default)

Возвращает значение по ключу или default, если ключ не найден.

my_dict.pop(key, default)

Удаляет ключ и возвращает его значение; если не найден — default или ошибка.

my_dict.popitem()

Удаляет и возвращает последнюю пару ключ-значение как список из двух элементов.

my_dict.clear()

Удаляет все элементы из словаря.

my_dict.update(other_dict)

Добавляет пары ключ-значение из other_dict.

my_dict.setdefault(key, default)

Возвращает значение ключа; если отсутствует — вставляет default и возвращает его.

Модуль http

http.get(url)

Выполняет HTTP GET-запрос и возвращает словарь с status_code, headers и body (сырой объект ответа — передайте его в http.json() или http.text()).

http.post(url, data, headers?)

Выполняет HTTP POST-запрос с телом data (словарь) и необязательным словарём заголовков headers. Возвращает словарь с status_code, headers и response (сырой объект ответа).

http.json(response)

Парсит объект ответа как JSON и возвращает словарь или список Dark. Если тело не валидный JSON — вызывается ошибка.

http.text(response)

Возвращает текст тела ответа.

import "http"

result = http.get("https://api.example.com/data")
if result["status_code"] == 200 then
    data = http.json(result["body"])
    println(data)
end

Модуль math

math.sqrt(number)

Вычисляет квадратный корень числа.

math.pow(base, exp)

Вычисляет base в степени exp.

math.floor(number)

Возвращает наибольшее целое, меньшее или равное number.

math.ceil(number)

Возвращает наименьшее целое, большее или равное number.

math.pi()

Возвращает значение числа PI.

math.random(min, max)

Возвращает случайное целое число от min до max включительно.

math.randint(min, max)

То же самое, что math.random(min, max) — случайное целое число от min до max включительно.

Модуль os

os.getcwd()

Возвращает текущую рабочую директорию.

os.path_exists(path)

Проверяет, существует ли путь. Возвращает true или false.

os.mkdir(path)

Создаёт директорию.

os.rmdir(path)

Удаляет директорию.

os.remove(path)

Удаляет файл.

os.rename(old, new)

Переименовывает файл или директорию.

os.listdir(path)

Возвращает список содержимого директории.

os.getsize(path)

Возвращает размер файла.

os.isdir(path)

Проверяет, является ли путь директорией.

os.system(command)

Выполняет системную команду (например, "cls" или "clear").

os.exit(code)

Завершает выполнение программы. Сейчас переданный code не влияет на реальный код завершения процесса — можно вызывать и как os.exit().

Модуль stdlib

stdlib.range(start, stop)

Возвращает список чисел от start (включительно) до stop (не включительно).

stdlib.list_contains(list, item)

Проверяет, содержится ли item в list.

stdlib.list_join(list, separator)

Объединяет элементы списка в строку с указанным разделителем.

stdlib.dict_get(dict, key, default)

Получает значение из словаря по ключу, с возможностью указать значение по умолчанию.

stdlib.clamp(value, min, max)

Ограничивает значение value между min и max.

stdlib.json_decode(json_string)

Преобразует строку в формате JSON в словарь или список.

stdlib.str_split(string, separator)

Разделяет строку по указанному разделителю и возвращает список.

stdlib.str_upper(string)

Преобразует строку в верхний регистр.

stdlib.str_lower(string)

Преобразует строку в нижний регистр.

stdlib.str_replace(string, old, new)

Заменяет все вхождения подстроки old на new.

Модуль time

time.time()

Возвращает текущее время в виде Unix timestamp (число секунд с 1 января 1970 года).

time.sleep(seconds)

Приостанавливает выполнение программы на указанное количество секунд.

Модуль file

Модуль для работы с файлами. file.open() возвращает файловый объект — его нужно передавать первым аргументом во все остальные функции модуля. Файлов можно держать открытыми одновременно сколько угодно, каждый со своим объектом.

file.open(path, mode, encoding?)

Открывает файл и возвращает файловый объект. mode — строка: "r" (чтение), "w" (запись), "a" (дозапись), "r+" (чтение и запись). Необязательный третий аргумент — кодировка (например, "utf-8").

file.read(file_object)

Читает всё содержимое открытого файла и возвращает его как строку.

file.readline(file_object)

Читает одну строку из файла.

file.readlines(file_object)

Читает все строки из файла и возвращает их в виде списка.

file.write(file_object, content)

Записывает строку content в открытый файл.

file.seek(file_object, offset)

Перемещает позицию чтения/записи в файле на offset байт от начала.

file.close(file_object)

Закрывает ранее открытый файл.

Пример

f = file.open("notes.txt", "w")
file.write(f, "Привет из Dark!")
file.close(f)

f = file.open("notes.txt", "r")
println(file.read(f))
file.close(f)

Модуль color

Модуль для вывода цветного текста в консоль. Поддерживает именованные цвета, а также форматы RGB, HEX и HSL.

Функции с приставкой dark_ — дополнительные варианты для нескольких базовых цветов; сейчас часть из них (white, black, orange, purple, brown) визуально совпадает со своей базовой версией, кроме dark_pink — у него отдельный, более глубокий оттенок.

Каждая функция принимает один аргумент — текст, который нужно раскрасить, и возвращает строку с ANSI-кодами: color.red(text), color.orange(text) и т.д.

color.rgb(r, g, b, text)

Окрашивает текст в указанный RGB-цвет (компоненты от 0 до 255).

color.rgba(r, g, b, a, text)

Окрашивает текст в RGBA-цвет. Альфа-канал a в большинстве терминалов не поддерживается и игнорируется.

color.hex(hex_string, text)

Окрашивает текст в HEX-цвет (например, "#ff6496").

color.hsl(h, s, l, text)

Окрашивает текст в HSL-цвет (h: 0–360, s: 0–100, l: 0–100).

Модуль weather

Получение текущей погоды через WeatherAPI. Требует собственный API-ключ WeatherAPI.

weather.initialization(api_key)

Проверяет ключ и возвращает объект сессии — передавайте его в weather.get_weather(). Если ключ неверный, вызывается ошибка.

weather.get_weather(session, city)

Выполняет запрос погоды для города city и возвращает сырой объект HTTP-ответа — как и в модуле http, используйте http.json() или http.text(), чтобы получить данные из него.

import "weather"
import "http"

session = weather.initialization("ВАШ_API_KEY")
response = weather.get_weather(session, "Moscow")
data = http.json(response)
println(data)

Модуль python

Модуль для прямой интеграции с Python. Требует директиву #!USE_WITH_PYTHON в начале файла.

python.exec(code_string)

Выполняет код Python (переданный строкой) в текущем окружении Dark. Позволяет обмениваться переменными между Dark и Python — см. пример во вкладке «Синтаксис → Директивы».

Файл requirements.txt позволяет установить все зависимости проекта одной командой — это делает проект переносимым и легко воспроизводимым на других машинах.

Создайте файл requirements.txt в корне проекта:

# requirements.txt
utils
requests_wrapper

Чтобы установить все пакеты из этого файла, выполните install без аргументов:

dark --dpm install

Вы можете легко поделиться своим расширением с сообществом.

1. Создайте публичный репозиторий на GitHub. Его имя должно начинаться с префикса Dark_, например Dark_my_super_package.
2. Структура репозитория. Внутри должна быть папка с именем, совпадающим с именем пакета (часть после Dark_), и в ней — файл __init__.py.

Dark_my_super_package/  (корень репозитория)
├── my_super_package/     (папка с кодом пакета)
│   ├── __init__.py
│   └── helpers.py
└── README.md

Содержимое __init__.py. Этот файл должен содержать функцию get_module(**kwargs), возвращающую словарь с экспортируемыми именами.

# Dark_my_super_package/my_super_package/__init__.py

def my_func(args):
    return "Hello from my package!"

def get_module(**kwargs):
    return {
        "hello": my_func
    }

После публикации репозитория любой пользователь сможет установить пакет командой: dark --dpm install my_super_package.