zaxy 0.1.0

Lightweight Python utility for efficient code writing.

🛠 Xa-Framework (v0.1.0)

Xa is a powerful Python utility library that simplifies standard boilerplate code into clean, one-line commands. Xa — это производительная библиотека для Python, превращающая громоздкий стандартный код в чистые однострочные команды.

[EN] Developed by maks39P. Created on February 8, 2026, by a 14-year-old developer with minimal use of AI. [RU] Разработчик: maks39P. Создано 8 февраля 2026 г. 14-летним разработчиком с минимальным использованием ИИ.

---

EN | Installation

pip install xa

EN | Core Documentation

1. Console Output & Control

• tx(*args): Shortcut for print().
• clr() / clear(): Clears terminal screen (supports Windows/Linux).
• pau(text) / pause(text): Execution pause (replaces input() for waiting).

2. Smart Input & Global Variables Important: These functions inject variables directly into the global scope (globals).

• ir("var_name", "prompt"): Replaces [ var_name = input("prompt") ]
• irn("var_name", "prompt"): Replaces [ var_name = int(input("prompt")) ] (includes protection against non-integer input).
• irf("var_name", "prompt"): Replaces [ var_name = float(input("prompt")) ] (supports both dots and commas).

3. File System (OS wrappers)

• ls(path): Returns list of files in directory.
• gwd(): Returns current working directory path.
• md(name): Creates a new directory.
• rm(path): Removes a FILE (does not remove directories). Includes Xa-System-Error protection.
• ren(old, new): Renames a file or directory.

4. Randomization

• rn(a, b): Returns random integer (randint).
• rc(list): Returns random element from list (choice).
• sh(list): Shuffles list and returns it.

---

RU | Инструкция по использованию

pip install xa

RU | Техническая документация

1. Вывод и управление консолью

• tx(*args): Сокращение для print().
• clr() / clear(): Полная очистка консоли (Windows/Linux).
• pau(text) / pause(text): Пауза выполнения кода (ожидание нажатия Enter).

2. Умный ввод и глобальные переменные Важно: Эти функции создают переменные сразу в глобальной области видимости (globals).

• ir("имя", "текст"): Заменяет [ имя = input("текст") ]
• irn("имя", "текст"): Заменяет [ имя = int(input("текст")) ] (с защитой от ввода букв вместо чисел).
• irf("имя", "текст"): Заменяет [ имя = float(input("текст")) ] (автоматически меняет запятую на точку).

3. Работа с системой (OS модули)

• ls(путь): Список содержимого папки.
• gwd(): Получение пути текущей рабочей директории.
• md(имя): Создание новой папки.
• rm(путь): Удаление ФАЙЛА (не папки). Включает обработку Xa-System-Error.
• ren(старое, новое): Переименование файла или папки.

4. Рандомизация и списки

• rn(a, b): Случайное целое число от a до b.
• rc(список): Случайный выбор элемента из списка.
• sh(список): Перемешивание элементов списка (shuffle).

---

Contacts / Контакты: Email: [e-mail] Telegram: @maks39P