rooms 1.0.0__tar.gz

rooms-1.0.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## [1.0.0] - 2026-09-05
+
+### Added
+- Создание, удаление, переименование, клонирование виртуальных окружений (venv)
+- Интерактивное меню с поддержкой русского и английского языков
+- Автодетект окружений: Termux, WSL, Docker, Alpine, NixOS, ChromeOS/Crostini, Gitpod, Codespaces, macOS, Linux
+- Адаптация venv для "хрупких" окружений (Termux, Alpine, Docker, NixOS) через --system-site-packages
+- Спиннер при создании комнаты
+- Прогресс-бар при клонировании с отображением объема (MiB/GiB)
+- Прогресс-бар при удалении с отображением процента
+- Два режима клонирования: полное и легкое (через requirements.txt)
+- Автоматическое сохранение/генерация requirements.txt
+- Экспорт комнаты в tar.gz
+- Импорт комнаты из tar.gz
+- Проверка свободного места на диске перед клонированием
+- Выбор Python-интерпретатора при создании комнаты
+- Программный API (rooms.core) с type hints
+- Логирование через logging
+- 27 встроенных тестов pytest
+- Лицензия MIT

rooms-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rooms contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rooms-1.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include pyproject.toml
+include README.md
+include LICENSE
+include CHANGELOG.md

rooms-1.0.0/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: rooms
+Version: 1.0.0
+Summary: Менеджер виртуальных Python-окружений (комнат)
+Author-email: Kaneki Ken <jgxwuvducrycdjfwugrjvbv61@gmail.com>
+License-Expression: MIT
+Keywords: venv,virtualenv,environment,termux,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Dynamic: license-file
+
+# rooms
+
+> Менеджер виртуальных Python-окружений ("комнат")
+
+Создавайте изолированные Python-окружения для каждого проекта, не засоряя системный Python. Работает на Linux, macOS, Termux (Android), WSL, Docker, Alpine, NixOS, ChromeOS и других системах.
+
+---
+
+## Установка
+
+```bash
+pip install rooms
+```
+
+С тестами:
+
+```bash
+pip install "rooms[test]"
+```
+
+---
+
+## Быстрый старт
+
+```bash
+rooms              # интерактивное меню
+python -m rooms    # альтернативный запуск
+```
+
+---
+
+## Команды меню
+
+| Команда | Действие |
+|---------|----------|
+| `1`, `2`, `3`... | Войти в комнату по номеру |
+| `n` / `new` / `новая` | Создать новую комнату |
+| `d` / `delete` / `удалить` | Удалить комнату |
+| `r` / `rename` / `переименовать` | Переименовать комнату |
+| `c` / `clone` / `клонировать` | Клонировать комнату |
+| `p` / `peek` / `список` | Показать pip-пакеты без входа |
+| `e` / `export` / `экспорт` | Экспортировать в tar.gz |
+| `i` / `import` / `импорт` | Импортировать из tar.gz |
+| `q` / `Enter` | Выход |
+
+---
+
+## Режимы клонирования
+
+При выборе `c` (клонировать) доступно два режима:
+
+### 1. Полное клонирование
+
+Копирует всю комнату со всеми файлами. Быстро, но занимает столько же места, сколько оригинал.
+
+```
+[*] [##########----------]  52%  71.2 MiB / 134.5 MiB
+```
+
+### 2. Легкое клонирование (через requirements.txt)
+
+Создает пустую комнату и устанавливает пакеты из `requirements.txt`. Экономит место на диске — идеально для тяжелых комнат с PyTorch, TensorFlow и т.д.
+
+```
+Сохраняю список пакетов из 'big_project'...
+Создаю пустую комнату 'big_project_copy'...
+Устанавливаю пакеты из requirements.txt...
+```
+
+---
+
+## Индикаторы прогресса
+
+| Операция | Индикатор |
+|----------|-----------|
+| **Создание** (`n`) | `◐ Создание окружения...` (спиннер) |
+| **Клонирование** (`c`) | `[*] [##########----------] 52%  71.2 MiB / 134.5 MiB` |
+| **Удаление** (`d`) | `[*] [##########----------] 52%  Удаление...` |
+
+---
+
+## Автодетект окружения
+
+Библиотека автоматически определяет систему и адаптирует поведение:
+
+| Окружение | Признак | Особенность |
+|-----------|---------|-------------|
+| **Termux** | Android-терминал | `--system-site-packages` для venv |
+| **WSL** | Windows Subsystem for Linux | Работает как обычный Linux |
+| **Docker** | Контейнер | `--system-site-packages` fallback |
+| **Alpine** | Минимальный Linux | `--system-site-packages` fallback |
+| **NixOS** | Функциональный Linux | `--system-site-packages` fallback |
+| **ChromeOS / Crostini** | Linux на Chromebook | Стандартный режим |
+| **Gitpod / Codespaces** | Облачные IDE | Стандартный режим |
+| **macOS** | Darwin | Стандартный режим |
+| **Linux** | Остальные дистрибутивы | Стандартный режим |
+
+При создании комнаты в скобках показывается обнаруженное окружение:
+
+```bash
+Создаю комнату 'mybot' (docker)...
+  ◐ Создание окружения...
+```
+
+---
+
+## Программный API
+
+```python
+from rooms.core import (
+    list_rooms,           # список комнат
+    create_room,          # создать (с опциональным python=)
+    enter_room,           # войти в bash
+    delete_room,          # удалить
+    rename_room,          # переименовать
+    clone_room,           # полное клонирование
+    clone_room_fast,      # легкое клонирование
+    peek_packages,        # pip list без входа
+    get_pip_freeze,       # pip freeze
+    save_requirements,    # сохранить requirements.txt
+    export_room,          # экспорт в tar.gz
+    import_room,          # импорт из tar.gz
+    detect_env,           # определить окружение
+    is_fragile_env,       # хрупкое ли окружение
+)
+
+# Создать комнату с конкретным Python
+path = create_room("myenv", python="/usr/bin/python3.11")
+
+# Экспорт/импорт
+export_room("myenv")
+import_room(Path("myenv.tar.gz"), "restored")
+
+# Легкое клонирование
+clone_room_fast("myenv", "myenv_copy")
+```
+
+---
+
+## Тестирование
+
+Встроенные тесты доступны после установки:
+
+```bash
+python -m rooms.tests
+```
+
+С подробным выводом:
+
+```bash
+python -m rooms.tests -v
+```
+
+Через pytest:
+
+```bash
+pytest --pyargs rooms.tests -v
+```
+
+---
+
+## Перенос комнаты на другую машину
+
+```bash
+# На исходной машине
+rooms
+# -> e -> выбрать комнату -> получить ~/.rooms/myenv.tar.gz
+
+# Перенести файл (scp, облако, флешка)
+# На новой машине
+rooms
+# -> i -> указать путь к myenv.tar.gz -> готово
+```
+
+---
+
+## Переменные окружения
+
+| Переменная | Описание | По умолчанию |
+|------------|----------|--------------|
+| `ROOMS_DIR` | Путь к каталогу с комнатами | `~/.rooms` |
+
+Пример:
+
+```bash
+ROOMS_DIR=/opt/rooms rooms
+```
+
+---
+
+## Платформы
+
+| Платформа | Поддержка |
+|-----------|-----------|
+| Linux (Ubuntu, Debian, Arch, Fedora...) | Полная |
+| macOS | Полная |
+| Termux (Android) | Полная |
+| WSL (Windows) | Полная |
+| Docker / контейнеры | Полная |
+| Alpine Linux | Полная |
+| NixOS | Полная |
+| ChromeOS / Crostini | Полная |
+| Gitpod / Codespaces | Полная |
+| Нативная Windows | Не поддерживается (используйте WSL) |
+
+---
+
+---
+
+## Лицензия
+
+MIT License. См. LICENSE.
+
+---
+
+## Changelog
+
+См. CHANGELOG.md.

rooms-1.0.0/README.md

@@ -0,0 +1,218 @@
+# rooms
+
+> Менеджер виртуальных Python-окружений ("комнат")
+
+Создавайте изолированные Python-окружения для каждого проекта, не засоряя системный Python. Работает на Linux, macOS, Termux (Android), WSL, Docker, Alpine, NixOS, ChromeOS и других системах.
+
+---
+
+## Установка
+
+```bash
+pip install rooms
+```
+
+С тестами:
+
+```bash
+pip install "rooms[test]"
+```
+
+---
+
+## Быстрый старт
+
+```bash
+rooms              # интерактивное меню
+python -m rooms    # альтернативный запуск
+```
+
+---
+
+## Команды меню
+
+| Команда | Действие |
+|---------|----------|
+| `1`, `2`, `3`... | Войти в комнату по номеру |
+| `n` / `new` / `новая` | Создать новую комнату |
+| `d` / `delete` / `удалить` | Удалить комнату |
+| `r` / `rename` / `переименовать` | Переименовать комнату |
+| `c` / `clone` / `клонировать` | Клонировать комнату |
+| `p` / `peek` / `список` | Показать pip-пакеты без входа |
+| `e` / `export` / `экспорт` | Экспортировать в tar.gz |
+| `i` / `import` / `импорт` | Импортировать из tar.gz |
+| `q` / `Enter` | Выход |
+
+---
+
+## Режимы клонирования
+
+При выборе `c` (клонировать) доступно два режима:
+
+### 1. Полное клонирование
+
+Копирует всю комнату со всеми файлами. Быстро, но занимает столько же места, сколько оригинал.
+
+```
+[*] [##########----------]  52%  71.2 MiB / 134.5 MiB
+```
+
+### 2. Легкое клонирование (через requirements.txt)
+
+Создает пустую комнату и устанавливает пакеты из `requirements.txt`. Экономит место на диске — идеально для тяжелых комнат с PyTorch, TensorFlow и т.д.
+
+```
+Сохраняю список пакетов из 'big_project'...
+Создаю пустую комнату 'big_project_copy'...
+Устанавливаю пакеты из requirements.txt...
+```
+
+---
+
+## Индикаторы прогресса
+
+| Операция | Индикатор |
+|----------|-----------|
+| **Создание** (`n`) | `◐ Создание окружения...` (спиннер) |
+| **Клонирование** (`c`) | `[*] [##########----------] 52%  71.2 MiB / 134.5 MiB` |
+| **Удаление** (`d`) | `[*] [##########----------] 52%  Удаление...` |
+
+---
+
+## Автодетект окружения
+
+Библиотека автоматически определяет систему и адаптирует поведение:
+
+| Окружение | Признак | Особенность |
+|-----------|---------|-------------|
+| **Termux** | Android-терминал | `--system-site-packages` для venv |
+| **WSL** | Windows Subsystem for Linux | Работает как обычный Linux |
+| **Docker** | Контейнер | `--system-site-packages` fallback |
+| **Alpine** | Минимальный Linux | `--system-site-packages` fallback |
+| **NixOS** | Функциональный Linux | `--system-site-packages` fallback |
+| **ChromeOS / Crostini** | Linux на Chromebook | Стандартный режим |
+| **Gitpod / Codespaces** | Облачные IDE | Стандартный режим |
+| **macOS** | Darwin | Стандартный режим |
+| **Linux** | Остальные дистрибутивы | Стандартный режим |
+
+При создании комнаты в скобках показывается обнаруженное окружение:
+
+```bash
+Создаю комнату 'mybot' (docker)...
+  ◐ Создание окружения...
+```
+
+---
+
+## Программный API
+
+```python
+from rooms.core import (
+    list_rooms,           # список комнат
+    create_room,          # создать (с опциональным python=)
+    enter_room,           # войти в bash
+    delete_room,          # удалить
+    rename_room,          # переименовать
+    clone_room,           # полное клонирование
+    clone_room_fast,      # легкое клонирование
+    peek_packages,        # pip list без входа
+    get_pip_freeze,       # pip freeze
+    save_requirements,    # сохранить requirements.txt
+    export_room,          # экспорт в tar.gz
+    import_room,          # импорт из tar.gz
+    detect_env,           # определить окружение
+    is_fragile_env,       # хрупкое ли окружение
+)
+
+# Создать комнату с конкретным Python
+path = create_room("myenv", python="/usr/bin/python3.11")
+
+# Экспорт/импорт
+export_room("myenv")
+import_room(Path("myenv.tar.gz"), "restored")
+
+# Легкое клонирование
+clone_room_fast("myenv", "myenv_copy")
+```
+
+---
+
+## Тестирование
+
+Встроенные тесты доступны после установки:
+
+```bash
+python -m rooms.tests
+```
+
+С подробным выводом:
+
+```bash
+python -m rooms.tests -v
+```
+
+Через pytest:
+
+```bash
+pytest --pyargs rooms.tests -v
+```
+
+---
+
+## Перенос комнаты на другую машину
+
+```bash
+# На исходной машине
+rooms
+# -> e -> выбрать комнату -> получить ~/.rooms/myenv.tar.gz
+
+# Перенести файл (scp, облако, флешка)
+# На новой машине
+rooms
+# -> i -> указать путь к myenv.tar.gz -> готово
+```
+
+---
+
+## Переменные окружения
+
+| Переменная | Описание | По умолчанию |
+|------------|----------|--------------|
+| `ROOMS_DIR` | Путь к каталогу с комнатами | `~/.rooms` |
+
+Пример:
+
+```bash
+ROOMS_DIR=/opt/rooms rooms
+```
+
+---
+
+## Платформы
+
+| Платформа | Поддержка |
+|-----------|-----------|
+| Linux (Ubuntu, Debian, Arch, Fedora...) | Полная |
+| macOS | Полная |
+| Termux (Android) | Полная |
+| WSL (Windows) | Полная |
+| Docker / контейнеры | Полная |
+| Alpine Linux | Полная |
+| NixOS | Полная |
+| ChromeOS / Crostini | Полная |
+| Gitpod / Codespaces | Полная |
+| Нативная Windows | Не поддерживается (используйте WSL) |
+
+---
+
+---
+
+## Лицензия
+
+MIT License. См. LICENSE.
+
+---
+
+## Changelog
+
+См. CHANGELOG.md.

rooms-1.0.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rooms"
+version = "1.0.0"
+description = "Менеджер виртуальных Python-окружений (комнат)"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [
+    {name = "Kaneki Ken", email = "jgxwuvducrycdjfwugrjvbv61@gmail.com"}
+]
+keywords = ["venv", "virtualenv", "environment", "termux", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+dependencies = []
+
+[project.optional-dependencies]
+test = ["pytest>=7.0"]
+
+[project.scripts]
+rooms = "rooms.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

rooms-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

rooms-1.0.0/src/rooms/__init__.py

@@ -0,0 +1,3 @@
+"""rooms - менеджер виртуальных Python-окружений."""
+
+__version__ = "1.0.0"

rooms-1.0.0/src/rooms/__main__.py

@@ -0,0 +1,4 @@
+from rooms.cli import main
+
+if __name__ == "__main__":
+    main()