Metadata-Version: 2.4
Name: mellstroy-lang
Version: 0.1.0
Summary: Питон, которым его задумывали. Транспилятор языка mellstroy-lang.
Author: Bogdan Lazarev
License: MIT
Keywords: transpiler,python,language,mellstroy
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

<div align="center">

# 🐗 Mellstroy Lang

### Питон которым его задумывали

[![PyPI version](https://img.shields.io/pypi/v/mellstroy-lang?color=ff6b6b&style=for-the-badge)](https://pypi.org/project/mellstroy-lang/)
[![Python](https://img.shields.io/badge/Python-3.8+-4B8BBE?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](LICENSE)
[![Downloads](https://img.shields.io/pypi/dm/mellstroy-lang?color=green&style=for-the-badge)](https://pypi.org/project/mellstroy-lang/)

```
боровыу привет():
    ам_ам("боровы, даровы!")

друн вкусность:
    привет()
жмурино:
    ам_ам("бурмалда...")
```

[Установка](#-установка) · [Синтаксис](#-синтаксис) · [Примеры](#-примеры) · [Контрибьют](#-контрибьют)

</div>

---

## Что это такое

**Mellstroy Lang** (`.мелл`) — это транспилируемый язык программирования, построенный поверх Python.  
Синтаксически полностью совместим с Python 3, но использует бурмалду

Язык разработан для тех, кто шарит за бурмалду

> *"Что за бизнес, с*ка?"* — Меллстрой, о необходимости нового языка программирования

---

## Установка

```bash
pip install mellstroy-lang
```

Проверить установку:

```bash
мелл --version
# Mellstroy Lang 0.1.0 | THE FOG IS COMING
```

---

## Синтаксис

Mellstroy Lang — это Python, но каким он должен быть

### Ключевые слова

| Mellstroy Lang | Python | Описание |
|---|---|---|
| `боровыу` | `def` | Объявление функции |
| `чекушность` | `return` | Вернуть значение |
| `выкрасть` | `import` | Импортировать модуль |
| `из_мурино` | `from` | Откуда импортировать |
| `меллстройность` | `class` | Объявление класса |
| `ч` | `self` | Ссылка на себя |
| `нормалдаки` | `pass` | Ничего не делать |
| `фог` | `raise` | Выбросить исключение |
| `бурмалдить` | `yield` | Генератор |

### Управление потоком

| Mellstroy Lang | Python | Описание |
|---|---|---|
| `друн` | `if` | Условие |
| `а_если_брал` | `elif` | Иначе если |
| `жмурино` | `else` | Иначе |
| `самосбор` | `for` | Цикл for |
| `фог_идёт` | `while` | Цикл while |
| `ливт` | `break` | Выйти из цикла |
| `быстрее` | `continue` | Следующая итерация |
| `в_мурино` | `in` | Принадлежность |

### Значения и типы

| Mellstroy Lang | Python | Описание |
|---|---|---|
| `вкусность` | `True` | Истина |
| `бурмалда` | `False` | Ложь |
| `туман` | `None` | Пустота (туман ФОГа) |
| `жирность` | `int` | Целое число |
| `мелстройность` | `str` | Строка |
| `боровы` | `list` | Список |
| `хамам` | `dict` | Словарь |
| `самосборность` | `set` | Множество |

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

| Mellstroy Lang | Python | Описание |
|---|---|---|
| `ам_ам()` | `print()` | Вывод в консоль |
| `привет_артур()` | `input()` | Ввод (поздоровайся, или он сотрёт тебя из реальности) |
| `омайгад()` | `type()` | Тип объекта |
| `сколько_боровых()` | `len()` | Длина |
| `от_до_мурино()` | `range()` | Диапазон |
| `гермодверь()` | `open()` | Открыть файл |

### Обработка ошибок

| Mellstroy Lang | Python | Описание |
|---|---|---|
| `бурмалдим` | `try` | Попытка |
| `а_вдруг_фог` | `except` | Поймать ошибку |
| `всё_равно_друн` | `finally` | Выполнить в любом случае |
| `вместе_с_друном` | `with` | Контекстный менеджер |

---

## Примеры

### Hello, World

```python
боровыу главная():
    ам_ам("боровы, даровы!")

главная()
```

### Числа Фибоначчи

```python
боровыу фибоначчи(n):
    друн n <= 1:
        чекушность n
    чекушность фибоначчи(n - 1) + фибоначчи(n - 2)

самосбор i в_мурино от_до_мурино(10):
    ам_ам(фибоначчи(i))
```

### Классы

```python
меллстройность Боров:
    боровыу __init__(ч, имя):
        ч.имя = имя

    боровыу представиться(ч):
        ам_ам(f"Боровы, я {ч.имя}!")

главборов = Боров("Андрей")
главборов.представиться()
# → Боровы, я Андрей!
```

### Обработка ошибок

```python
бурмалдим:
    результат = 10 / 0
а_вдруг_фог ZeroDivisionError:
    ам_ам("бурмалда, делить на ноль нельзя")
всё_равно_друн:
    ам_ам("фог не дремлет")
```

### Генератор (Туман наступает)

```python
боровыу туман_наступает():
    фог_идёт вкусность:
        бурмалдить "THE FOG IS COMING"

самосбор сообщение в_мурино туман_наступает():
    ам_ам(сообщение)
    ливт
```

---

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

### Запустить `.мелл` файл

```bash
мелл программа.мелл
```

### Транспилировать в Python (без запуска)

```bash
мелл --transpile программа.мелл -o программа.py
```

### Интерактивный режим (REPL)

```bash
мелл --repl
# Mellstroy Lang REPL v0.1.0
# Боровы, даровы! Введи код:
# >>> 
```

---

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

```
mellstroy-lang/
├── mellstroy/
│   ├── __init__.py
│   ├── transpiler.py    # Логика транспиляции
│   ├── keywords.py      # Словарь замен
│   └── cli.py           # CLI интерфейс
├── examples/
│   ├── hello_world.мелл
│   ├── fibonacci.мелл
│   └── calculator.мелл
├── tests/
├── README.md
└── pyproject.toml
```

---

## 🤝 Контрибьют

Хочешь добавить новые слова в язык? Открывай PR!

1. Форкни репозиторий
2. Добавь новые замены в `mellstroy/keywords.py`
3. Напиши тест
4. Открывай PR с заголовком в формате: `feat: добавил бурмалдафон как asyncio`

### Как добавить новое ключевое слово

```python
# mellstroy/keywords.py
KEYWORDS = {
    ...
    "твоё_слово": "python_keyword",
}
```

## 📄 Лицензия

MIT — делай что хочешь, но если разбогатеешь — не забудь про Мурино.

---

<div align="center">

**Сделано с 🐗 и любовью к бурмалде**

*THE FOG IS COMING · 26 июня 2026 г., 16:23*

</div>
