w1x-cli 3.5.0__tar.gz → 3.5.1__tar.gz

{w1x_cli-3.5.0/w1x_cli.egg-info → w1x_cli-3.5.1}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: w1x-cli
-Version: 3.5.0
-Summary: A fast, keyboard-first CLI terminal assistant for Ollama with Function Calling, Persistent Memory, and Python Sandbox.
+Version: 3.5.1
+Summary: A fast, keyboard-first CLI terminal assistant for Ollama with Function Calling, Persistent Memory, and Interactive Python Runner.
 Author: W1bbex
 License: MIT
 Project-URL: Homepage, https://github.com/w1bbex/w1x-cli
 Project-URL: Issues, https://github.com/w1bbex/w1x-cli/issues
-Keywords: ollama,cli,terminal,ai,llm,chat,tools,python-sandbox
+Keywords: ollama,cli,terminal,ai,llm,chat,tools,python-runner
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -30,15 +30,16 @@ Dynamic: license-file
 
 # 🚀 W1x CLI
 
-> **A fast, keyboard-first CLI terminal client for Ollama with Function Calling, Persistent Memory, and Interactive Python Sandbox.**
+> **A fast, keyboard-first CLI terminal client for Ollama with Function Calling, Persistent Memory, and Interactive Python Runner.**
 
 ![Python](https://img.shields.io/badge/Python-3.10%2B-blue?logo=python)
+[![PyPI](https://img.shields.io/pypi/v/w1x-cli?color=blue&logo=pypi)](https://pypi.org/project/w1x-cli/)
 ![Ollama](https://img.shields.io/badge/Ollama-Compatible-black?logo=ollama)
 ![License](https://img.shields.io/badge/License-MIT-green)
 ![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-brightgreen)
 
 W1x — это легковесный, отзывчивый терминальный ассистент для локальных нейросетей Ollama.  
-Он превращает обычные локальные модели (Qwen, Llama, Gemma, DeepSeek) в полноценного автономного помощника с доступом в интернет, точными вычислениями, памятью между сессиями и интерактивной песочницей кода.
+Он превращает обычные локальные модели (Qwen, Llama, Gemma, DeepSeek) в полноценного автономного помощника с доступом в интернет, точными вычислениями, памятью между сессиями и интерактивным запуском кода в отдельном терминале.
 
 ---
 
@@ -53,8 +54,8 @@ W1x — это легковесный, отзывчивый терминальн
   * **Точная дата и время:** вычисление дней недели, смещений и таймзон.
   * **Калькулятор:** точные математические формулы через безопасное синтаксическое дерево.
   * **Чтение файлов проекта:** безопасный доступ к рабочей папке через `/workspace`.
-* 🐍 **Интерактивная песочница кода (`/testpy`):**
-  * Модель пишет код ➔ вы вводите `/testpy` ➔ открывается отдельная консоль ➔ вы тестируете ввод/вывод вживую ➔ полный лог тестирования автоматически возвращается в контекст нейросети.
+* 🐍 **Интерактивный REPL-раннер кода (`/testpy`):**
+  * Модель пишет код ➔ вы вводите `/testpy` ➔ открывается отдельное окно локального терминала ➔ вы тестируете ввод/вывод вживую ➔ полный лог запуска автоматически возвращается в контекст нейросети (работает с локальным окружением пользователя, не является изолированным контейнером).
 * 🧠 **Долговременная память (`/memory`):**
   * Запоминание фактов пользователя навсегда (`"Запомни: у меня есть кот Барсик"`).
   * Автоматический стемминг падежей русского языка и умная подмешка в контекст.
@@ -74,7 +75,13 @@ W1x — это легковесный, отзывчивый терминальн
 1. Установленный **[Ollama](https://ollama.com/)** (модели можно выбрать прямо при первом запуске W1x).
 2. **Python 3.10+**
 
-### Установка (Windows)
+### Вариант 1. Установка через PyPI (Рекомендуется)
+
+`ash
+pip install --upgrade w1x-cli
+`
+
+### Вариант 2. Установка из исходников (Windows / Linux / macOS)
 
 Просто запустите **`install.bat`** или выполните в терминале:
 
@@ -163,6 +170,22 @@ w1x-cli/
 └── README.md           # Документация
 ```
 
+## 🧪 Тестирование
+
+Проект покрыт автоматическими тестами. Для запуска выполните:
+
+`ash
+pytest
+`
+
+Все **16 тестов** проверяют:
+* Точность вычислений и безопасность математического синтаксического дерева.
+* Изоляцию фоновых задач и корректное завершение воркеров загрузчика.
+* Атомарное сохранение конфигурации и обработку поврежденных файлов сессий.
+* Защиту от рассинхронизации документации и кодовой базы.
+
+---
+
 ---
 
 ## 🐛 Сообщить об ошибке и контакты

{w1x_cli-3.5.0 → w1x_cli-3.5.1}/README.md

@@ -1,14 +1,15 @@
 # 🚀 W1x CLI
 
-> **A fast, keyboard-first CLI terminal client for Ollama with Function Calling, Persistent Memory, and Interactive Python Sandbox.**
+> **A fast, keyboard-first CLI terminal client for Ollama with Function Calling, Persistent Memory, and Interactive Python Runner.**
 
 ![Python](https://img.shields.io/badge/Python-3.10%2B-blue?logo=python)
+[![PyPI](https://img.shields.io/pypi/v/w1x-cli?color=blue&logo=pypi)](https://pypi.org/project/w1x-cli/)
 ![Ollama](https://img.shields.io/badge/Ollama-Compatible-black?logo=ollama)
 ![License](https://img.shields.io/badge/License-MIT-green)
 ![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-brightgreen)
 
 W1x — это легковесный, отзывчивый терминальный ассистент для локальных нейросетей Ollama.  
-Он превращает обычные локальные модели (Qwen, Llama, Gemma, DeepSeek) в полноценного автономного помощника с доступом в интернет, точными вычислениями, памятью между сессиями и интерактивной песочницей кода.
+Он превращает обычные локальные модели (Qwen, Llama, Gemma, DeepSeek) в полноценного автономного помощника с доступом в интернет, точными вычислениями, памятью между сессиями и интерактивным запуском кода в отдельном терминале.
 
 ---
 
@@ -23,8 +24,8 @@ W1x — это легковесный, отзывчивый терминальн
   * **Точная дата и время:** вычисление дней недели, смещений и таймзон.
   * **Калькулятор:** точные математические формулы через безопасное синтаксическое дерево.
   * **Чтение файлов проекта:** безопасный доступ к рабочей папке через `/workspace`.
-* 🐍 **Интерактивная песочница кода (`/testpy`):**
-  * Модель пишет код ➔ вы вводите `/testpy` ➔ открывается отдельная консоль ➔ вы тестируете ввод/вывод вживую ➔ полный лог тестирования автоматически возвращается в контекст нейросети.
+* 🐍 **Интерактивный REPL-раннер кода (`/testpy`):**
+  * Модель пишет код ➔ вы вводите `/testpy` ➔ открывается отдельное окно локального терминала ➔ вы тестируете ввод/вывод вживую ➔ полный лог запуска автоматически возвращается в контекст нейросети (работает с локальным окружением пользователя, не является изолированным контейнером).
 * 🧠 **Долговременная память (`/memory`):**
   * Запоминание фактов пользователя навсегда (`"Запомни: у меня есть кот Барсик"`).
   * Автоматический стемминг падежей русского языка и умная подмешка в контекст.
@@ -44,7 +45,13 @@ W1x — это легковесный, отзывчивый терминальн
 1. Установленный **[Ollama](https://ollama.com/)** (модели можно выбрать прямо при первом запуске W1x).
 2. **Python 3.10+**
 
-### Установка (Windows)
+### Вариант 1. Установка через PyPI (Рекомендуется)
+
+`ash
+pip install --upgrade w1x-cli
+`
+
+### Вариант 2. Установка из исходников (Windows / Linux / macOS)
 
 Просто запустите **`install.bat`** или выполните в терминале:
 
@@ -133,6 +140,22 @@ w1x-cli/
 └── README.md           # Документация
 ```
 
+## 🧪 Тестирование
+
+Проект покрыт автоматическими тестами. Для запуска выполните:
+
+`ash
+pytest
+`
+
+Все **16 тестов** проверяют:
+* Точность вычислений и безопасность математического синтаксического дерева.
+* Изоляцию фоновых задач и корректное завершение воркеров загрузчика.
+* Атомарное сохранение конфигурации и обработку поврежденных файлов сессий.
+* Защиту от рассинхронизации документации и кодовой базы.
+
+---
+
 ---
 
 ## 🐛 Сообщить об ошибке и контакты

{w1x_cli-3.5.0 → w1x_cli-3.5.1}/pyproject.toml

@@ -1,42 +1,46 @@
-[build-system]
-requires = ["setuptools>=61.0"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "w1x-cli"
-version = "3.5.0"
-description = "A fast, keyboard-first CLI terminal assistant for Ollama with Function Calling, Persistent Memory, and Python Sandbox."
-readme = "README.md"
-requires-python = ">=3.10"
-license = { text = "MIT" }
-authors = [
-    { name = "W1bbex" }
-]
-keywords = ["ollama", "cli", "terminal", "ai", "llm", "chat", "tools", "python-sandbox"]
-classifiers = [
-    "Development Status :: 4 - Beta",
-    "Environment :: Console",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Topic :: Software Development :: User Interfaces",
-]
-dependencies = [
-    "ollama>=0.4.0",
-    "rich>=13.7.0",
-    "prompt_toolkit>=3.0.43",
-    "requests>=2.31.0",
-    "duckduckgo_search>=7.0.0",
-]
-
-[project.scripts]
-w1x = "w1x.app:main"
-
-[project.urls]
-Homepage = "https://github.com/w1bbex/w1x-cli"
-Issues = "https://github.com/w1bbex/w1x-cli/issues"
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "w1x-cli"
+version = "3.5.1"
+description = "A fast, keyboard-first CLI terminal assistant for Ollama with Function Calling, Persistent Memory, and Interactive Python Runner."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "W1bbex" }
+]
+keywords = ["ollama", "cli", "terminal", "ai", "llm", "chat", "tools", "python-runner"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: User Interfaces",
+]
+dependencies = [
+    "ollama>=0.4.0",
+    "rich>=13.7.0",
+    "prompt_toolkit>=3.0.43",
+    "requests>=2.31.0",
+    "duckduckgo_search>=7.0.0",
+]
+
+[project.scripts]
+w1x = "w1x.app:main"
+
+[project.urls]
+Homepage = "https://github.com/w1bbex/w1x-cli"
+Issues = "https://github.com/w1bbex/w1x-cli/issues"
+
+[tool.pytest.ini_options]
+addopts = "--basetemp=.pytest_temp"
+pythonpath = ["."]

w1x_cli-3.5.1/tests/test_datetime_and_math.py

@@ -0,0 +1,41 @@
+import json
+import pytest
+from w1x.tools import calculate_datetime, calculate_expression, _format_offset
+from datetime import timedelta
+
+
+def test_calculate_datetime_mixed_offsets():
+    # days=1, hours=-2 -> net offset should be +22 hours forward, NOT "1 день 2 часа вперёд"
+    res_raw = calculate_datetime(days=1, hours=-2, base_datetime="2026-01-01T12:00:00")
+    data = json.loads(res_raw)
+    answer = data["answer"]
+    assert "22 часа вперёд" in answer
+    assert "2026-01-02T10:00:00" in data["result"]
+
+
+def test_calculate_datetime_negative_offset():
+    # days=-1, hours=-2 -> net offset should be 1 day 2 hours backward
+    res_raw = calculate_datetime(days=-1, hours=-2, base_datetime="2026-01-05T12:00:00")
+    data = json.loads(res_raw)
+    answer = data["answer"]
+    assert "1 день 2 часа назад" in answer
+    assert "2026-01-04T10:00:00" in data["result"]
+
+
+def test_calculate_expression_exact_float_precision():
+    # 0.1 + 0.2 must be strictly "0.3" without IEEE 754 float drift
+    res = calculate_expression("0.1 + 0.2")
+    assert res == "0.3"
+
+    res = calculate_expression("100 - 0.01")
+    assert res == "99.99"
+
+    res = calculate_expression("0.1 * 3")
+    assert res == "0.3"
+
+
+def test_calculate_expression_integer_and_power():
+    assert calculate_expression("10 / 2") == "5"
+    assert calculate_expression("2 ** 10") == "1024"
+    assert calculate_expression("10 // 3") == "3"
+    assert calculate_expression("10 % 3") == "1"

w1x_cli-3.5.1/tests/test_regressions.py

@@ -0,0 +1,217 @@
+"""
+Regression and resilience test suite for w1x-cli.
+Covers:
+- Preload task isolation and error reset under concurrency
+- Worker queue termination atomicity
+- Memory facts sandbox and corrupted file recovery
+- Chat session recovery from invalid payloads
+- Arithmetic parsing without misinterpreting dates or phone numbers
+- Terminal runner and configuration atomic persistence
+"""
+import json
+import os
+import re
+import sys
+import tempfile
+import threading
+import time
+from pathlib import Path
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from w1x import config, memory, models, tools
+from w1x.app import load_current_chat
+import w1x.app as w1x_app
+from w1x.config import load_user_config, save_user_config
+import w1x.config as w1x_config
+from w1x.engine import calculate_expression
+from w1x.memory import load_facts
+from w1x.models import PreloadTask, wait_for_model_ready, _PRELOAD_LOCK
+import w1x.models as w1x_models
+from w1x.puller import AsyncPullManager, DownloadTask
+from w1x.tools import calculate_datetime
+
+
+def test_preload_task_isolation():
+    """Verify that multiple preload calls create isolated tasks and don't mix events."""
+    a_finished = threading.Event()
+    b_started = threading.Event()
+
+    def fake_generate_a(*args, **kwargs):
+        b_started.wait(timeout=2.0)
+        time.sleep(0.05)
+        a_finished.set()
+
+    with patch("w1x.models.generate", side_effect=fake_generate_a):
+        models.start_background_preload("model_a")
+        task_a = models._CURRENT_PRELOAD
+        assert task_a is not None
+        assert task_a.name == "model_a"
+        assert not task_a.event.is_set()
+
+        b_finished = threading.Event()
+        def fake_generate_b(*args, **kwargs):
+            b_finished.wait(timeout=2.0)
+
+        with patch("w1x.models.generate", side_effect=fake_generate_b):
+            b_started.set()
+            models.start_background_preload("model_b")
+            task_b = models._CURRENT_PRELOAD
+            assert task_b is not None
+            assert task_b.name == "model_b"
+            assert task_b is not task_a
+
+            a_finished.wait(timeout=2.0)
+            assert task_a.event.is_set()
+            assert not task_b.event.is_set()
+
+        b_finished.set()
+
+
+def test_puller_worker_termination_atomicity():
+    """Verify worker terminates safely when queue is empty."""
+    mgr = AsyncPullManager()
+    t = threading.Thread(target=mgr._worker_loop, daemon=True)
+    mgr._worker_thread = t
+    t.start()
+    t.join(timeout=1.0)
+    assert not t.is_alive()
+    assert mgr._worker_thread is None
+
+
+def test_models_preload_error_clears_task():
+    """Verify failed model preloads clear _CURRENT_PRELOAD so subsequent requests are not blocked."""
+    task = PreloadTask(name="broken_model")
+    task.error = RuntimeError("Ollama connection failed")
+    task.event.set()
+
+    with _PRELOAD_LOCK:
+        w1x_models._CURRENT_PRELOAD = task
+
+    with pytest.raises(RuntimeError, match="Ollama connection failed"):
+        wait_for_model_ready("broken_model")
+
+    with _PRELOAD_LOCK:
+        assert w1x_models._CURRENT_PRELOAD is None
+
+    wait_for_model_ready("broken_model")
+
+
+def test_memory_corrupted_file_moved(tmp_path, monkeypatch):
+    """Verify corrupted memory-facts.json is archived to .corrupted.<timestamp>.json and reset."""
+    facts_file = tmp_path / "memory-facts.json"
+    facts_file.write_text("{broken json syntax: missing quotes", encoding="utf-8")
+    monkeypatch.setattr("w1x.memory._get_facts_path", lambda: facts_file)
+
+    res1 = load_facts()
+    assert res1 == []
+    assert not facts_file.exists()
+
+    corrupted_files = list(tmp_path.glob("memory-facts.corrupted.*.json"))
+    assert len(corrupted_files) == 1
+
+    res2 = load_facts()
+    assert res2 == []
+    corrupted_files_after = list(tmp_path.glob("memory-facts.corrupted.*.json"))
+    assert len(corrupted_files_after) == 1
+
+
+def test_memory_sandbox_redirection(tmp_path, monkeypatch):
+    """Verify mutating config paths redirects facts storage without polluting user home."""
+    sandbox_facts = tmp_path / "test-facts.json"
+    sandbox_chat = tmp_path / "test-chat"
+
+    monkeypatch.setattr(config, "FACTS_PATH", sandbox_facts)
+    monkeypatch.setattr(config, "CHAT_DIR", sandbox_chat)
+
+    assert memory._get_facts_path() == sandbox_facts
+    assert memory._get_chat_dir() == sandbox_chat
+    assert memory.load_facts() == []
+
+    memory.save_facts([{"fact": "Test fact", "created_at": "2026-11-04"}])
+    assert sandbox_facts.exists()
+    assert len(memory.load_facts()) == 1
+
+
+def test_tools_datetime_offset_safe_types():
+    """Verify datetime offset parameters accept flexible string floats and None safely."""
+    res_str = calculate_datetime(days="1.5", hours=None, minutes="0", seconds=10)
+    data = json.loads(res_str)
+    assert "answer" in data or "datetime" in data or "error" not in data
+
+    res_err = calculate_datetime(days="invalid_days")
+    data_err = json.loads(res_err)
+    assert "error" in data_err
+
+
+def test_app_load_current_chat_corrupted_list(tmp_path, monkeypatch):
+    """Verify chat memory loader recovers gracefully from empty or list-typed JSON."""
+    chat_file = tmp_path / "current-chat.json"
+    chat_file.write_text("[]", encoding="utf-8")
+    monkeypatch.setattr(w1x_app, "CURRENT_CHAT_PATH", chat_file)
+
+    sys_prompt, messages = load_current_chat()
+    assert sys_prompt == w1x_app.DEFAULT_SYSTEM_PROMPT
+    assert len(messages) >= 1
+    assert messages[0]["role"] == "system"
+
+
+def test_engine_dates_and_phones_not_computed_as_math():
+    """Verify dates and phone numbers are excluded from automated arithmetic precomputation."""
+    text = "События 2026-11-08 и звонок на номер +7-999-123-45-67, но посчитай 25 * 4"
+    math_candidates = re.findall(r"[\d\s().,+\-*/%]{3,}", text.replace("×", "*").replace("÷", "/"))
+    precomputed = []
+    for cand in math_candidates:
+        cand_clean = cand.strip(" ,.")
+        if re.search(r"\b\d{4}-\d{2}-\d{2}\b", cand_clean) or re.search(r"\b\d{2}\.\d{2}\.\d{4}\b", cand_clean):
+            continue
+        if re.search(r"^\+?\d[\d\s-]{7,}\d$", cand_clean):
+            continue
+        if re.search(r"[+\-*/%]", cand_clean) and re.search(r"\d", cand_clean) and len(cand_clean) >= 3:
+            val = calculate_expression(cand_clean)
+            if not val.startswith("Ошибка"):
+                precomputed.append(f"{cand_clean} = {val}")
+
+    assert not any("2026-11-08" in item for item in precomputed)
+    assert not any("999-123" in item for item in precomputed)
+    assert any("25 * 4 = 100" in item for item in precomputed)
+
+
+def test_config_atomic_save(tmp_path, monkeypatch):
+    """Verify user configuration is saved atomically via temporary replacement."""
+    cfg_file = tmp_path / "config.json"
+    monkeypatch.setattr(w1x_config, "CONFIG_FILE_PATH", cfg_file)
+
+    save_user_config({"test_key": "test_val"})
+    assert cfg_file.exists()
+    saved = json.loads(cfg_file.read_text(encoding="utf-8"))
+    assert saved.get("test_key") == "test_val"
+
+
+def test_reset_all_models_accepts_show_message():
+    """Verify reset_all_models accepts show_message parameter without crash."""
+    res = models.reset_all_models(show_message=True)
+    assert isinstance(res, (list, bool, type(None)))
+
+
+def test_set_file_workspace_syncs_globals(tmp_path):
+    """Verify set_file_workspace updates both tools and config roots."""
+    orig = getattr(config, "ACTIVE_FILE_ROOT", None)
+    try:
+        tools.set_file_workspace(str(tmp_path))
+        assert tools.ACTIVE_FILE_ROOT == tmp_path.resolve()
+        assert config.ACTIVE_FILE_ROOT == tmp_path.resolve()
+    finally:
+        config.ACTIVE_FILE_ROOT = orig
+        tools.ACTIVE_FILE_ROOT = orig
+
+
+def test_testpy_runner_code_templates():
+    """Verify interactive test runner template handles dynamic streams and error codes."""
+    import inspect
+    from w1x import testpy
+    source = inspect.getsource(testpy.run_interactive_python_test)
+    assert "__getattr__" in source
+    assert "getattr(self.original, name)" in source
+    assert "exit_code = exc.code if isinstance(exc.code, int) else (1 if exc.code is not None else 0)" in source

{w1x_cli-3.5.0 → w1x_cli-3.5.1}/w1x/__init__.py

@@ -1,5 +1,5 @@
-"""W1x — Персональный локальный ИИ."""
-
-from .app import main
-__version__ = "3.5"
-__all__ = ["main"]
+"""W1x — Персональный локальный ИИ."""
+
+from .app import main
+__version__ = "3.5.1"
+__all__ = ["main"]