Язык программирования Dark

Добро пожаловать в официальную документацию по языку программирования Dark.

Dark — это современный, динамический язык программирования, созданный для простоты и эффективности. Его синтаксис интуитивно понятен, что делает его отличным выбором как для начинающих, так и для опытных разработчиков. Эта документация поможет вам изучить основы языка, его синтаксис и стандартную библиотеку, чтобы вы могли начать создавать свои собственные программы.

Для удобной разработки на языке Dark рекомендуется использовать официальное расширение для Visual Studio Code, которое предоставляет подсветку синтаксиса, автодополнение и другие полезные функции.

Основы синтаксиса

Переменные

Переменные объявляются с помощью оператора присваивания =. Имена переменных могут содержать буквы, цифры и знак подчеркивания, но не могут начинаться с цифры.

my_variable = 10
another_var = "Hello, Dark!"
is_active = true

Типы данных

• Числа (Number): Целые и с плавающей точкой. Например: 42, 3.14.
• Строки (String): Текст в двойных или одинарных кавычках. Например: "some text".

  Строки поддерживают доступ к символам по индексу, как и списки.

• Булевы (Boolean): true или false.
• Списки (List): Упорядоченная коллекция элементов в квадратных скобках. Например: [1, "two", 3.0].

  Доступ к элементам осуществляется по индексу (нумерация с 0):

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

• Словари (Dictionary): Коллекция пар ключ-значение в фигурных скобках. Например: {"key": "value", "age": 30}.

  Доступ к значениям осуществляется по ключу, двумя способами:

  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

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

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

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

Пример:

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

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

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

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

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

# Используем функцию из импортированного модуля
os.system("cls")
my_module.my_function()

Функции

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

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

Комментарии

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

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

Директивы

Если в начале фаила будет строка начинающаяся с символа #! - это даст информацию о объявлении директивы.

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

Встроенные функции

Встроенные методы

Некоторые типы данных имеют встроенные методы, которые можно вызывать через точку. Методы — это функции, связанные с конкретным объектом.

Стандартная библиотека

Язык Dark поставляется с набором встроенных модулей для выполнения общих задач. Для использования функций модуля, импортируйте его: import "os", а затем вызывайте функции через точку: os.getcwd().

Python-расширения

Одной из самых мощных возможностей Dark является способность подключать модули, написанные на Python. Это открывает доступ ко всей экосистеме библиотек Python.

Структура проекта

Для использования расширений создайте папку dark_extensions в корне вашего проекта. В эту папку помещайте ваши .py файлы-модули.

my_project/
├── dark_extensions/
│   └── math_ext.py
├── my_script.dark
└── ...

Создание модуля-расширения

Каждый Python-файл расширения должен содержать функцию get_module(). Эта функция должна возвращать словарь, где ключи — это имена, которые будут доступны в Dark, а значения — это соответствующие функции или переменные из Python.

Все функции, предназначенные для вызова из Dark, должны принимать один аргумент — список (list) переданных параметров.

Пример: dark_extensions/math_ext.py

import math

# Функция принимает список аргументов от Dark
def power(args):
    if len(args) != 2:
        raise TypeError("pow() expects 2 arguments")
    return math.pow(args[0], args[1])

# Эта функция будет вызвана интерпретатором Dark
def get_module():
    return {
        "pi": math.pi,      # Экспорт переменной
        "pow": power        # Экспорт функции
    }

Использование в Dark

Импортируйте ваше расширение как обычный модуль и используйте его содержимое.

import "math_ext"

println("Число PI из Python: " + math_ext.pi)

# Вызываем функцию из Python, передавая аргументы
# В Python они придут как список [2, 8]
result = math_ext.pow(2, 8) 
println("2 в степени 8 = " + result) # Выведет 256.0