codespector 0.1.0__tar.gz

codespector-0.1.0/.github/workflows/build-publish.yml

@@ -0,0 +1,54 @@
+name: Build and publish package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build release distributions
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install uv
+          uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/codespector
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

codespector-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,36 @@
+name: tests
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "*" ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12"]
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v3
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install uv
+        uv venv
+        source .venv/bin/activate
+        uv sync --all-extras
+    - name: Lint with ruff
+      run: |
+        uvx ruff check . --fix
+        uvx ruff format . --check
+    - name: Test with pytest
+      run: |
+        uv run pytest -vv

codespector-0.1.0/.gitignore

@@ -0,0 +1,114 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+venv_pp
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+#VS code
+.vscode
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.idea
+tmp/
+
+# linters
+.flakeheaven_cache
+pip.ini

codespector-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vladimir-Titov
+
+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.

codespector-0.1.0/Makefile

@@ -0,0 +1,13 @@
+lint:
+	@ruff check . --fix
+	@ruff format --check .
+
+format:
+	@ruff format .
+
+fix:
+	@ruff check . --fix
+	@ruff format .
+
+test:
+	@pytest tests -vv

codespector-0.1.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: codespector
+Version: 0.1.0
+Summary: Assistant for reviewing your code
+Project-URL: Repository, https://github.com/Vladimir-Titov/codespector
+Project-URL: Issues, https://github.com/Vladimir-Titov/codespector/issues
+Author-email: vtitov <v.v.titov94@gmail.com>
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.8
+Requires-Dist: environs>=14.1.1
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: requests>=2.32.3
+Requires-Dist: ujson>=5.10.0
+Description-Content-Type: text/markdown
+
+# CodeSpector
+
+CodeSpector is a Python package designed to review code changes for quality and security issues using AI chat agents. It supports different chat agents like Codestral and ChatGPT.
+
+## Features
+
+- Automated code review using AI chat agents.
+- Supports multiple chat agents and models.
+- Generates detailed review reports in markdown format.
+- Configurable via environment variables and command-line options.
+
+## Installation
+
+To install the package, use the following command:
+
+```sh
+pip install codespector
+```
+
+```sh
+uv add codespector
+```
+
+## Usage
+
+### Command-Line Interface
+
+You can use the `codespector` command to start a code review. Below are the available options:
+
+```sh
+Usage: codespector [OPTIONS]
+
+Options:
+  --system-content TEXT       Content which used in system field for agent
+                              [default: Ты код ревьювер. Отвечай на русском языке.]
+  --output-dir TEXT           Select the output directory [default: codespector]
+  -b, --compare-branch TEXT   Select the branch to compare the current one with
+                              [default: develop]
+  --chat-agent [codestral|chatgpt]
+                              Choose the chat agent to use [default: codestral]
+  --chat-model TEXT           Choose the chat model to use
+  --chat-token TEXT           Chat agent token
+  --mode [local]              Choose the mode of the application [default: local]
+  --version                   Show the version and exit.
+  --help                      Show this message and exit.
+```
+
+### Example
+
+To run a code review, use the following command:
+
+```sh
+codespector --chat-token YOUR_CHAT_TOKEN --chat-agent codestral --compare-branch develop
+```
+
+## Configuration
+
+You can also configure CodeSpector using environment variables. Create a `.env` file in the root directory of your project with the following content:
+
+```
+CODESPECTOR_SYSTEM_CONTENT=Ты код ревьювер. Отвечай на русском языке.
+CODESPECTOR_OUTPUT_DIR=codespector
+CODESPECTOR_CHAT_AGENT=codestral
+CODESPECTOR_CHAT_MODEL=codestral-latest
+CODESPECTOR_CHAT_TOKEN=YOUR_CHAT_TOKEN
+```
+
+## Makefile Commands
+
+- `lint`: Run linting and formatting checks.
+- `format`: Format the code.
+- `fix`: Fix linting issues and format the code.
+- `test`: Run the tests.
+
+## License
+
+This project is licensed under the MIT License. See the `LICENSE` file for more details.

codespector-0.1.0/README.md

@@ -0,0 +1,77 @@
+# CodeSpector
+
+CodeSpector is a Python package designed to review code changes for quality and security issues using AI chat agents. It supports different chat agents like Codestral and ChatGPT.
+
+## Features
+
+- Automated code review using AI chat agents.
+- Supports multiple chat agents and models.
+- Generates detailed review reports in markdown format.
+- Configurable via environment variables and command-line options.
+
+## Installation
+
+To install the package, use the following command:
+
+```sh
+pip install codespector
+```
+
+```sh
+uv add codespector
+```
+
+## Usage
+
+### Command-Line Interface
+
+You can use the `codespector` command to start a code review. Below are the available options:
+
+```sh
+Usage: codespector [OPTIONS]
+
+Options:
+  --system-content TEXT       Content which used in system field for agent
+                              [default: Ты код ревьювер. Отвечай на русском языке.]
+  --output-dir TEXT           Select the output directory [default: codespector]
+  -b, --compare-branch TEXT   Select the branch to compare the current one with
+                              [default: develop]
+  --chat-agent [codestral|chatgpt]
+                              Choose the chat agent to use [default: codestral]
+  --chat-model TEXT           Choose the chat model to use
+  --chat-token TEXT           Chat agent token
+  --mode [local]              Choose the mode of the application [default: local]
+  --version                   Show the version and exit.
+  --help                      Show this message and exit.
+```
+
+### Example
+
+To run a code review, use the following command:
+
+```sh
+codespector --chat-token YOUR_CHAT_TOKEN --chat-agent codestral --compare-branch develop
+```
+
+## Configuration
+
+You can also configure CodeSpector using environment variables. Create a `.env` file in the root directory of your project with the following content:
+
+```
+CODESPECTOR_SYSTEM_CONTENT=Ты код ревьювер. Отвечай на русском языке.
+CODESPECTOR_OUTPUT_DIR=codespector
+CODESPECTOR_CHAT_AGENT=codestral
+CODESPECTOR_CHAT_MODEL=codestral-latest
+CODESPECTOR_CHAT_TOKEN=YOUR_CHAT_TOKEN
+```
+
+## Makefile Commands
+
+- `lint`: Run linting and formatting checks.
+- `format`: Format the code.
+- `fix`: Fix linting issues and format the code.
+- `test`: Run the tests.
+
+## License
+
+This project is licensed under the MIT License. See the `LICENSE` file for more details.

codespector-0.1.0/codespector/clients/codestral.py

@@ -0,0 +1,5 @@
+import ujson
+
+
+def chat_completion(diff: str):
+    pass

codespector-0.1.0/codespector/controller.py

@@ -0,0 +1,44 @@
+from codespector import local
+from loguru import logger
+
+
+class CodeSpectorController:
+    __slots__ = (
+        'mode',
+        'chat_token',
+        'chat_agent',
+        'compare_branch',
+        'output_dir',
+        'system_content',
+        'chat_model',
+    )
+
+    def __init__(
+        self,
+        mode: str,
+        chat_token: str,
+        chat_agent: str,
+        compare_branch: str,
+        output_dir: str,
+        system_content: str,
+        chat_model: str,
+    ):
+        self.mode = mode
+        self.chat_token = chat_token
+        self.chat_agent = chat_agent
+        self.compare_branch = compare_branch
+        self.output_dir = output_dir
+        self.system_content = system_content
+        self.chat_model = chat_model
+
+    def start(self):
+        codespector = local.LocalCodespector(
+            chat_token=self.chat_token,
+            chat_agent=self.chat_agent,
+            compare_branch=self.compare_branch,
+            output_dir=self.output_dir,
+            system_content=self.system_content,
+            chat_model=self.chat_model,
+        )
+        codespector.review()
+        logger.info('Review completed successfully.See result.txt in {} directory', self.output_dir)

codespector-0.1.0/codespector/local/__init__.py

@@ -0,0 +1 @@
+from .main import LocalCodespector

codespector-0.1.0/codespector/local/main.py

@@ -0,0 +1,35 @@
+from .prepare import CodeSpectorDataPreparer
+from .reviewer import CodeSpectorReviewer
+
+
+class LocalCodespector:
+    def __init__(
+        self,
+        chat_token: str,
+        chat_agent: str,
+        compare_branch: str,
+        output_dir: str,
+        system_content: str,
+        chat_model: str,
+    ):
+        self.chat_token = chat_token
+        self.chat_agent = chat_agent
+        self.compare_branch = compare_branch
+        self.output_dir = output_dir
+        self.system_content = system_content
+        self.chat_model = chat_model
+
+        self.data_preparer = CodeSpectorDataPreparer(output_dir=self.output_dir, compare_branch=self.compare_branch)
+        self.reviewer = CodeSpectorReviewer(
+            diff_file=self.data_preparer.combined_file,
+            chat_token=self.chat_token,
+            chat_agent=self.chat_agent,
+            system_content=self.system_content,
+            output_dir=self.output_dir,
+            chat_model=self.chat_model,
+        )
+        self.processes = [self.data_preparer, self.reviewer]
+
+    def review(self):
+        for process in self.processes:
+            process.start()

codespector-0.1.0/codespector/local/prepare.py

@@ -0,0 +1,81 @@
+import ujson
+import subprocess
+import os
+
+
+class CodeSpectorDataPreparer:
+    def __init__(
+        self,
+        output_dir: str,
+        compare_branch: str,
+    ):
+        self.output_dir = output_dir
+        self.compare_branch = compare_branch
+
+        self.original_files_tmp = 'original_files_tmp.json'
+        self.code_changes_only = 'code_changes_only.txt'
+        self.diff_file = 'diff.json'
+        self.combined_file = 'combined.json'
+
+    def _prepare_dir(self):
+        if not os.path.exists(self.output_dir):
+            os.makedirs(self.output_dir)
+
+    def _prepare_diff_file(self):
+        diff_output = subprocess.run(['git', 'diff', self.compare_branch], stdout=subprocess.PIPE, text=True).stdout
+
+        filtered_diff = [
+            line
+            for line in diff_output.splitlines()
+            if (line.startswith('+') or line.startswith('-'))
+            and not line.startswith('+++')
+            and not line.startswith('---')
+        ]
+
+        with open(os.path.join(self.output_dir, self.code_changes_only), 'w', encoding='utf-8') as f:
+            f.write('\n'.join(filtered_diff))
+
+        diff_json = {'diff': '\n'.join(filtered_diff)}
+        diff_filepath = os.path.join(self.output_dir, self.diff_file)
+        with open(diff_filepath, 'w', encoding='utf-8') as f:
+            ujson.dump(diff_json, f, indent=4, ensure_ascii=False)
+
+        with open(os.path.join(self.output_dir, self.original_files_tmp), 'r', encoding='utf-8') as f:
+            original_files_data = ujson.load(f)
+
+        with open(diff_filepath, 'r', encoding='utf-8') as f:
+            diff_data = ujson.load(f)
+
+        combined_data = {**original_files_data, **diff_data}
+
+        with open(os.path.join(self.output_dir, self.combined_file), 'w', encoding='utf-8') as f:
+            ujson.dump(combined_data, f, indent=4, ensure_ascii=False)
+
+    def _prepare_name_only_file(self):
+        changed_files = subprocess.run(
+            ['git', 'diff', '--name-only', self.compare_branch], stdout=subprocess.PIPE, text=True
+        ).stdout.splitlines()
+
+        result = {'original files': []}
+
+        for file in changed_files:
+            if not file.endswith('.py'):
+                continue
+
+            if os.path.isfile(file):
+                with open(file, 'r', encoding='utf-8') as f:
+                    content = f.read()
+                result['original files'].append({'filename': file, 'content': content})
+
+        filepath = os.path.join(self.output_dir, self.original_files_tmp)
+
+        with open(filepath, 'w', encoding='utf-8') as f:
+            ujson.dump(result, f, indent=4, ensure_ascii=False)
+
+    def prepare_data(self) -> str:
+        self._prepare_dir()
+        self._prepare_name_only_file()
+        self._prepare_diff_file()
+
+    def start(self):
+        self.prepare_data()

codespector-0.1.0/codespector/local/reviewer.py

@@ -0,0 +1,109 @@
+import os.path
+from dataclasses import dataclass
+from typing import Self
+
+import ujson
+import requests
+
+from loguru import logger
+
+AGENT_URL_MAPPING = {
+    'codestral': 'https://api.mistral.ai/v1/chat/completions',
+    'chatgpt': 'https://api.openai.com/v1/chat/completions',
+}
+
+DEFAULT_AGENT_MODEL = {'codestral': 'codestral-latest', 'chatgpt': 'gpt-4o'}
+
+
+@dataclass
+class AgentInfo:
+    model: str
+    url: str
+    headers: dict
+
+    @classmethod
+    def create(cls, chat_agent: str, chat_token: str, chat_model: str | None = None) -> Self:
+        url = AGENT_URL_MAPPING[chat_agent]
+        model = chat_model if chat_model else DEFAULT_AGENT_MODEL[chat_agent]
+        headers = {'Authorization': f'Bearer {chat_token}'}
+        return cls(
+            url=url,
+            model=model,
+            headers=headers,
+        )
+
+
+class CodeSpectorReviewer:
+    def __init__(
+        self,
+        diff_file: str,
+        chat_token: str,
+        chat_agent: str,
+        chat_model: str | None,
+        system_content: str,
+        output_dir: str,
+    ):
+        self.diff_file = diff_file
+        self.chat_token = chat_token
+        self.chat_agent = chat_agent
+        self.chat_model = chat_model
+        self.system_content = system_content
+        self.output_dir = output_dir
+
+        self.request_file = 'request.json'
+        self.response_file = 'response.json'
+        self.result_file = 'result.txt'
+
+    def _request_to_chat_agent(self, prompt: str):
+        agent_info = AgentInfo.create(self.chat_agent, self.chat_token, self.chat_model)
+        request_data = {
+            'model': agent_info.model,
+            'messages': [{'role': 'system', 'content': self.system_content}, {'role': 'user', 'content': prompt}],
+        }
+
+        with open(os.path.join(self.output_dir, self.request_file), 'w', encoding='utf-8') as f:
+            ujson.dump(request_data, f, indent=4, ensure_ascii=False)
+
+        response = requests.post(
+            agent_info.url,
+            json=request_data,
+            headers=agent_info.headers,
+            timeout=100,
+        )
+        response.raise_for_status()
+        return response
+
+    def send_to_review(self):
+        with open(os.path.join(self.output_dir, self.diff_file), 'r', encoding='utf-8') as f:
+            diff_data = ujson.load(f)
+
+        diff_content = diff_data.get('diff', '')
+        original_files = diff_data.get('original files', [])
+
+        original_files_str = ujson.dumps(original_files, indent=4, ensure_ascii=False)
+
+        prompt = (
+            'Пожалуйста, проверь следующие изменения в коде на наличие очевидных проблем с качеством или безопасностью. '
+            'Предоставь краткий отчет в формате markdown:\n\n'
+            'DIFF:\n'
+            f'{diff_content}\n\n'
+            'ORIGINAL FILES:\n'
+            f'{original_files_str}'
+        )
+        try:
+            response = self._request_to_chat_agent(prompt=prompt)
+        except Exception as e:
+            logger.error('Error while send request: {}', e)
+            raise e
+
+        with open(os.path.join(self.output_dir, self.response_file), 'w', encoding='utf-8') as f:
+            ujson.dump(response.json(), f, indent=4, ensure_ascii=False)
+
+        resp = response.json()
+        clear_response = resp['choices'][0]['message']['content']
+
+        with open(os.path.join(self.output_dir, self.result_file), 'w', encoding='utf-8') as f:
+            f.write(clear_response)
+
+    def start(self):
+        self.send_to_review()

codespector-0.1.0/codespector/main.py

@@ -0,0 +1,81 @@
+from pathlib import Path
+
+import click
+from environs import Env
+
+from .controller import CodeSpectorController
+from loguru import logger
+
+BASE_PATH = Path(__file__).parent.parent
+
+env = Env()
+env.read_env(path=str(BASE_PATH / '.env'))
+
+
+@click.option(
+    '--system-content',
+    type=str,
+    default='Ты код ревьювер. Отвечай на русском языке.',
+    envvar='CODESPECTOR_SYSTEM_CONTENT',
+    show_envvar=True,
+    help='Content which used in system field for agent',
+)
+@click.option(
+    '--output-dir',
+    type=str,
+    default='codespector',
+    envvar='CODESPECTOR_OUTPUT_DIR',
+    show_envvar=True,
+    help='Select the output directory',
+)
+@click.option(
+    '-b',
+    '--compare-branch',
+    type=str,
+    default='develop',
+    help='Select the branch to compare the current one with',
+)
+@click.option(
+    '--chat-agent',
+    type=click.Choice(['codestral', 'chatgpt'], case_sensitive=False),
+    envvar='CODESPECTOR_CHAT_AGENT',
+    show_envvar=True,
+    default='codestral',
+    help='Choose the chat agent to use',
+)
+@click.option(
+    '--chat-model',
+    type=str,
+    envvar='CODESPECTOR_CHAT_MODEL',
+    show_envvar=True,
+    help='Choose the chat model to use',
+)
+@click.option(
+    '--chat-token',
+    type=str,
+    envvar='CODESPECTOR_CHAT_TOKEN',
+    show_envvar=True,
+)
+@click.option(
+    '--mode',
+    type=click.Choice(['local'], case_sensitive=False),
+    default='local',
+    help='Choose the mode of the application',
+)
+@click.version_option(message='%(version)s')
+@click.command()
+def main(*args, **kwargs):
+    return start(*args, **kwargs)
+
+
+def start(*args, **kwargs):
+    codespector = CodeSpectorController(*args, **kwargs)
+    try:
+        codespector.start()
+        logger.info('Review completed successfully.See result.txt in {} directory', kwargs['output_dir'])
+    except Exception as e:
+        logger.error('Error while review: {}', e)
+
+
+if __name__ == '__main__':
+    main()

codespector-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[project]
+name = "codespector"
+version = "0.1.0"
+authors = [
+    { name = "vtitov", email = "v.v.titov94@gmail.com" }
+]
+description = "Assistant for reviewing your code"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "click>=8.1.8",
+    "environs>=14.1.1",
+    "loguru>=0.7.3",
+    "requests>=2.32.3",
+    "ujson>=5.10.0",
+]
+
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project.urls]
+Repository = "https://github.com/Vladimir-Titov/codespector"
+Issues = "https://github.com/Vladimir-Titov/codespector/issues"
+
+
+[project.scripts]
+codespector = "codespector.main:main"
+
+
+[tool.ruff]
+line-length = 120
+indent-width = 4
+
+[tool.ruff.lint]
+ignore = ["F401"]
+
+[tool.ruff.format]
+quote-style = "single"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3.5",
+    "ruff>=0.11.0",
+]
+

codespector-0.1.0/tests/unit/test_prepare.py

@@ -0,0 +1,26 @@
+import pytest
+from unittest.mock import patch
+from codespector.local.prepare import CodeSpectorDataPreparer
+
+
+@pytest.fixture
+def preparer():
+    return CodeSpectorDataPreparer(output_dir='test_output', compare_branch='develop')
+
+
+def test_prepare_dir(preparer):
+    with patch('os.makedirs') as mock_makedirs, patch('os.path.exists', return_value=False):
+        preparer._prepare_dir()
+        mock_makedirs.assert_called_once_with('test_output')
+
+
+def test_prepare_data(preparer):
+    with (
+        patch.object(preparer, '_prepare_dir') as mock_prepare_dir,
+        patch.object(preparer, '_prepare_name_only_file') as mock_prepare_name_only_file,
+        patch.object(preparer, '_prepare_diff_file') as mock_prepare_diff_file,
+    ):
+        preparer.prepare_data()
+        mock_prepare_dir.assert_called_once()
+        mock_prepare_name_only_file.assert_called_once()
+        mock_prepare_diff_file.assert_called_once()

codespector-0.1.0/tests/unit/test_reviewer.py

@@ -0,0 +1,74 @@
+import pytest
+from unittest.mock import patch, mock_open
+from codespector.local.reviewer import CodeSpectorReviewer
+import os
+import ujson
+from unittest.mock import MagicMock
+
+
+@pytest.fixture
+def reviewer():
+    return CodeSpectorReviewer(
+        diff_file='diff.json',
+        chat_token='test_token',
+        chat_agent='codestral',
+        chat_model=None,
+        system_content='Test system content',
+        output_dir='test_output',
+    )
+
+
+def test_request_to_chat_agent(reviewer):
+    prompt = 'Test prompt'
+    mock_response = MagicMock()
+    mock_response.json.return_value = {'choices': [{'message': {'content': 'Test response'}}]}
+
+    with (
+        patch('requests.post', return_value=mock_response) as mock_post,
+        patch('builtins.open', mock_open()) as mock_file,
+    ):
+        response = reviewer._request_to_chat_agent(prompt)
+
+        mock_post.assert_called_once_with(
+            'https://api.mistral.ai/v1/chat/completions',
+            json={
+                'model': 'codestral-latest',
+                'messages': [{'role': 'system', 'content': 'Test system content'}, {'role': 'user', 'content': prompt}],
+            },
+            headers={'Authorization': 'Bearer test_token'},
+            timeout=100,
+        )
+        mock_file.assert_called_with(os.path.join('test_output', 'request.json'), 'w', encoding='utf-8')
+        assert response == mock_response
+
+
+# tests/unit/test_reviewer.py
+def test_send_to_review(reviewer):
+    diff_data = {'diff': 'Test diff', 'original files': ['file1.py', 'file2.py']}
+    mock_response = MagicMock()
+    mock_response.json.return_value = {'choices': [{'message': {'content': 'Test response'}}]}
+
+    with (
+        patch('builtins.open', mock_open(read_data=ujson.dumps(diff_data))) as mock_file,
+        patch.object(reviewer, '_request_to_chat_agent', return_value=mock_response) as mock_request,
+        patch('ujson.dump') as _,
+    ):
+        reviewer.send_to_review()
+
+        mock_file.assert_any_call(os.path.join('test_output', 'diff.json'), 'r', encoding='utf-8')
+        mock_request.assert_called_once_with(
+            prompt='Пожалуйста, проверь следующие изменения в коде на наличие очевидных проблем с качеством или безопасностью. '
+            'Предоставь краткий отчет в формате markdown:\n\n'
+            'DIFF:\n'
+            'Test diff\n\n'
+            'ORIGINAL FILES:\n'
+            '[\n    "file1.py",\n    "file2.py"\n]'
+        )
+        mock_file.assert_any_call(os.path.join('test_output', 'response.json'), 'w', encoding='utf-8')
+        mock_file.assert_any_call(os.path.join('test_output', 'result.txt'), 'w', encoding='utf-8')
+
+
+def test_start(reviewer):
+    with patch.object(reviewer, 'send_to_review') as mock_send_to_review:
+        reviewer.start()
+        mock_send_to_review.assert_called_once()

codespector-0.1.0/uv.lock

@@ -0,0 +1,284 @@
+version = 1
+requires-python = ">=3.12"
+
+[[package]]
+name = "certifi"
+version = "2025.1.31"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1c/ab/c9f1e32b7b1bf505bf26f0ef697775960db7932abeb7b516de930ba2705f/certifi-2025.1.31.tar.gz", hash = "sha256:3d5da6925056f6f18f119200434a4780a94263f10d1c21d032a6f6b2baa20651", size = 167577 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/38/fc/bce832fd4fd99766c04d1ee0eead6b0ec6486fb100ae5e74c1d91292b982/certifi-2025.1.31-py3-none-any.whl", hash = "sha256:ca78db4565a652026a4db2bcdf68f2fb589ea80d0be70e03929ed730746b84fe", size = 166393 },
+]
+
+[[package]]
+name = "charset-normalizer"
+version = "3.4.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/16/b0/572805e227f01586461c80e0fd25d65a2115599cc9dad142fee4b747c357/charset_normalizer-3.4.1.tar.gz", hash = "sha256:44251f18cd68a75b56585dd00dae26183e102cd5e0f9f1466e6df5da2ed64ea3", size = 123188 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0a/9a/dd1e1cdceb841925b7798369a09279bd1cf183cef0f9ddf15a3a6502ee45/charset_normalizer-3.4.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:73d94b58ec7fecbc7366247d3b0b10a21681004153238750bb67bd9012414545", size = 196105 },
+    { url = "https://files.pythonhosted.org/packages/d3/8c/90bfabf8c4809ecb648f39794cf2a84ff2e7d2a6cf159fe68d9a26160467/charset_normalizer-3.4.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:dad3e487649f498dd991eeb901125411559b22e8d7ab25d3aeb1af367df5efd7", size = 140404 },
+    { url = "https://files.pythonhosted.org/packages/ad/8f/e410d57c721945ea3b4f1a04b74f70ce8fa800d393d72899f0a40526401f/charset_normalizer-3.4.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:c30197aa96e8eed02200a83fba2657b4c3acd0f0aa4bdc9f6c1af8e8962e0757", size = 150423 },
+    { url = "https://files.pythonhosted.org/packages/f0/b8/e6825e25deb691ff98cf5c9072ee0605dc2acfca98af70c2d1b1bc75190d/charset_normalizer-3.4.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2369eea1ee4a7610a860d88f268eb39b95cb588acd7235e02fd5a5601773d4fa", size = 143184 },
+    { url = "https://files.pythonhosted.org/packages/3e/a2/513f6cbe752421f16d969e32f3583762bfd583848b763913ddab8d9bfd4f/charset_normalizer-3.4.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bc2722592d8998c870fa4e290c2eec2c1569b87fe58618e67d38b4665dfa680d", size = 145268 },
+    { url = "https://files.pythonhosted.org/packages/74/94/8a5277664f27c3c438546f3eb53b33f5b19568eb7424736bdc440a88a31f/charset_normalizer-3.4.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:ffc9202a29ab3920fa812879e95a9e78b2465fd10be7fcbd042899695d75e616", size = 147601 },
+    { url = "https://files.pythonhosted.org/packages/7c/5f/6d352c51ee763623a98e31194823518e09bfa48be2a7e8383cf691bbb3d0/charset_normalizer-3.4.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:804a4d582ba6e5b747c625bf1255e6b1507465494a40a2130978bda7b932c90b", size = 141098 },
+    { url = "https://files.pythonhosted.org/packages/78/d4/f5704cb629ba5ab16d1d3d741396aec6dc3ca2b67757c45b0599bb010478/charset_normalizer-3.4.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:0f55e69f030f7163dffe9fd0752b32f070566451afe180f99dbeeb81f511ad8d", size = 149520 },
+    { url = "https://files.pythonhosted.org/packages/c5/96/64120b1d02b81785f222b976c0fb79a35875457fa9bb40827678e54d1bc8/charset_normalizer-3.4.1-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:c4c3e6da02df6fa1410a7680bd3f63d4f710232d3139089536310d027950696a", size = 152852 },
+    { url = "https://files.pythonhosted.org/packages/84/c9/98e3732278a99f47d487fd3468bc60b882920cef29d1fa6ca460a1fdf4e6/charset_normalizer-3.4.1-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:5df196eb874dae23dcfb968c83d4f8fdccb333330fe1fc278ac5ceeb101003a9", size = 150488 },
+    { url = "https://files.pythonhosted.org/packages/13/0e/9c8d4cb99c98c1007cc11eda969ebfe837bbbd0acdb4736d228ccaabcd22/charset_normalizer-3.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:e358e64305fe12299a08e08978f51fc21fac060dcfcddd95453eabe5b93ed0e1", size = 146192 },
+    { url = "https://files.pythonhosted.org/packages/b2/21/2b6b5b860781a0b49427309cb8670785aa543fb2178de875b87b9cc97746/charset_normalizer-3.4.1-cp312-cp312-win32.whl", hash = "sha256:9b23ca7ef998bc739bf6ffc077c2116917eabcc901f88da1b9856b210ef63f35", size = 95550 },
+    { url = "https://files.pythonhosted.org/packages/21/5b/1b390b03b1d16c7e382b561c5329f83cc06623916aab983e8ab9239c7d5c/charset_normalizer-3.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:6ff8a4a60c227ad87030d76e99cd1698345d4491638dfa6673027c48b3cd395f", size = 102785 },
+    { url = "https://files.pythonhosted.org/packages/38/94/ce8e6f63d18049672c76d07d119304e1e2d7c6098f0841b51c666e9f44a0/charset_normalizer-3.4.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:aabfa34badd18f1da5ec1bc2715cadc8dca465868a4e73a0173466b688f29dda", size = 195698 },
+    { url = "https://files.pythonhosted.org/packages/24/2e/dfdd9770664aae179a96561cc6952ff08f9a8cd09a908f259a9dfa063568/charset_normalizer-3.4.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:22e14b5d70560b8dd51ec22863f370d1e595ac3d024cb8ad7d308b4cd95f8313", size = 140162 },
+    { url = "https://files.pythonhosted.org/packages/24/4e/f646b9093cff8fc86f2d60af2de4dc17c759de9d554f130b140ea4738ca6/charset_normalizer-3.4.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8436c508b408b82d87dc5f62496973a1805cd46727c34440b0d29d8a2f50a6c9", size = 150263 },
+    { url = "https://files.pythonhosted.org/packages/5e/67/2937f8d548c3ef6e2f9aab0f6e21001056f692d43282b165e7c56023e6dd/charset_normalizer-3.4.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2d074908e1aecee37a7635990b2c6d504cd4766c7bc9fc86d63f9c09af3fa11b", size = 142966 },
+    { url = "https://files.pythonhosted.org/packages/52/ed/b7f4f07de100bdb95c1756d3a4d17b90c1a3c53715c1a476f8738058e0fa/charset_normalizer-3.4.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:955f8851919303c92343d2f66165294848d57e9bba6cf6e3625485a70a038d11", size = 144992 },
+    { url = "https://files.pythonhosted.org/packages/96/2c/d49710a6dbcd3776265f4c923bb73ebe83933dfbaa841c5da850fe0fd20b/charset_normalizer-3.4.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:44ecbf16649486d4aebafeaa7ec4c9fed8b88101f4dd612dcaf65d5e815f837f", size = 147162 },
+    { url = "https://files.pythonhosted.org/packages/b4/41/35ff1f9a6bd380303dea55e44c4933b4cc3c4850988927d4082ada230273/charset_normalizer-3.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:0924e81d3d5e70f8126529951dac65c1010cdf117bb75eb02dd12339b57749dd", size = 140972 },
+    { url = "https://files.pythonhosted.org/packages/fb/43/c6a0b685fe6910d08ba971f62cd9c3e862a85770395ba5d9cad4fede33ab/charset_normalizer-3.4.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:2967f74ad52c3b98de4c3b32e1a44e32975e008a9cd2a8cc8966d6a5218c5cb2", size = 149095 },
+    { url = "https://files.pythonhosted.org/packages/4c/ff/a9a504662452e2d2878512115638966e75633519ec11f25fca3d2049a94a/charset_normalizer-3.4.1-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:c75cb2a3e389853835e84a2d8fb2b81a10645b503eca9bcb98df6b5a43eb8886", size = 152668 },
+    { url = "https://files.pythonhosted.org/packages/6c/71/189996b6d9a4b932564701628af5cee6716733e9165af1d5e1b285c530ed/charset_normalizer-3.4.1-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:09b26ae6b1abf0d27570633b2b078a2a20419c99d66fb2823173d73f188ce601", size = 150073 },
+    { url = "https://files.pythonhosted.org/packages/e4/93/946a86ce20790e11312c87c75ba68d5f6ad2208cfb52b2d6a2c32840d922/charset_normalizer-3.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:fa88b843d6e211393a37219e6a1c1df99d35e8fd90446f1118f4216e307e48cd", size = 145732 },
+    { url = "https://files.pythonhosted.org/packages/cd/e5/131d2fb1b0dddafc37be4f3a2fa79aa4c037368be9423061dccadfd90091/charset_normalizer-3.4.1-cp313-cp313-win32.whl", hash = "sha256:eb8178fe3dba6450a3e024e95ac49ed3400e506fd4e9e5c32d30adda88cbd407", size = 95391 },
+    { url = "https://files.pythonhosted.org/packages/27/f2/4f9a69cc7712b9b5ad8fdb87039fd89abba997ad5cbe690d1835d40405b0/charset_normalizer-3.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:b1ac5992a838106edb89654e0aebfc24f5848ae2547d22c2c3f66454daa11971", size = 102702 },
+    { url = "https://files.pythonhosted.org/packages/0e/f6/65ecc6878a89bb1c23a086ea335ad4bf21a588990c3f535a227b9eea9108/charset_normalizer-3.4.1-py3-none-any.whl", hash = "sha256:d98b1668f06378c6dbefec3b92299716b931cd4e6061f3c875a71ced1780ab85", size = 49767 },
+]
+
+[[package]]
+name = "click"
+version = "8.1.8"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b9/2e/0090cbf739cee7d23781ad4b89a9894a41538e4fcf4c31dcdd705b78eb8b/click-8.1.8.tar.gz", hash = "sha256:ed53c9d8990d83c2a27deae68e4ee337473f6330c040a31d4225c9574d16096a", size = 226593 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/d4/7ebdbd03970677812aac39c869717059dbb71a4cfc033ca6e5221787892c/click-8.1.8-py3-none-any.whl", hash = "sha256:63c132bbbed01578a06712a2d1f497bb62d9c1c0d329b7903a866228027263b2", size = 98188 },
+]
+
+[[package]]
+name = "codespector"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "click" },
+    { name = "environs" },
+    { name = "loguru" },
+    { name = "requests" },
+    { name = "ujson" },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "ruff" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "click", specifier = ">=8.1.8" },
+    { name = "environs", specifier = ">=14.1.1" },
+    { name = "loguru", specifier = ">=0.7.3" },
+    { name = "requests", specifier = ">=2.32.3" },
+    { name = "ujson", specifier = ">=5.10.0" },
+]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pytest", specifier = ">=8.3.5" },
+    { name = "ruff", specifier = ">=0.11.0" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335 },
+]
+
+[[package]]
+name = "environs"
+version = "14.1.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "marshmallow" },
+    { name = "python-dotenv" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/31/d3/e82bdbb8cc332e751f67a3f668c5d134d57f983497d9f3a59a375b6e8fd8/environs-14.1.1.tar.gz", hash = "sha256:03db7ee2d50ec697b68814cd175a3a05a7c7954804e4e419ca8b570dc5a835cf", size = 32050 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/1c/ab9752f02d32d981d647c05822be9ff93809be8953dacea2da2bec9a9de9/environs-14.1.1-py3-none-any.whl", hash = "sha256:45bc56f1d53bbc59d8dd69bba97377dd88ec28b8229d81cedbd455b21789445b", size = 15566 },
+]
+
+[[package]]
+name = "idna"
+version = "3.10"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f1/70/7703c29685631f5a7590aa73f1f1d3fa9a380e654b86af429e0934a32f7d/idna-3.10.tar.gz", hash = "sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9", size = 190490 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/76/c6/c88e154df9c4e1a2a66ccf0005a88dfb2650c1dffb6f5ce603dfbd452ce3/idna-3.10-py3-none-any.whl", hash = "sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3", size = 70442 },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f2/97/ebf4da567aa6827c909642694d71c9fcf53e5b504f2d96afea02718862f3/iniconfig-2.1.0.tar.gz", hash = "sha256:3abbd2e30b36733fee78f9c7f7308f2d0050e88f0087fd25c2645f63c773e1c7", size = 4793 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/e1/e6716421ea10d38022b952c159d5161ca1193197fb744506875fbb87ea7b/iniconfig-2.1.0-py3-none-any.whl", hash = "sha256:9deba5723312380e77435581c6bf4935c94cbfab9b1ed33ef8d238ea168eb760", size = 6050 },
+]
+
+[[package]]
+name = "loguru"
+version = "0.7.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "win32-setctime", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3a/05/a1dae3dffd1116099471c643b8924f5aa6524411dc6c63fdae648c4f1aca/loguru-0.7.3.tar.gz", hash = "sha256:19480589e77d47b8d85b2c827ad95d49bf31b0dcde16593892eb51dd18706eb6", size = 63559 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0c/29/0348de65b8cc732daa3e33e67806420b2ae89bdce2b04af740289c5c6c8c/loguru-0.7.3-py3-none-any.whl", hash = "sha256:31a33c10c8e1e10422bfd431aeb5d351c7cf7fa671e3c4df004162264b28220c", size = 61595 },
+]
+
+[[package]]
+name = "marshmallow"
+version = "3.26.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "packaging" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ab/5e/5e53d26b42ab75491cda89b871dab9e97c840bf12c63ec58a1919710cd06/marshmallow-3.26.1.tar.gz", hash = "sha256:e6d8affb6cb61d39d26402096dc0aee12d5a26d490a121f118d2e81dc0719dc6", size = 221825 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/34/75/51952c7b2d3873b44a0028b1bd26a25078c18f92f256608e8d1dc61b39fd/marshmallow-3.26.1-py3-none-any.whl", hash = "sha256:3350409f20a70a7e4e11a27661187b77cdcaeb20abca41c1454fe33636bea09c", size = 50878 },
+]
+
+[[package]]
+name = "packaging"
+version = "24.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d0/63/68dbb6eb2de9cb10ee4c9c14a0148804425e13c4fb20d61cce69f53106da/packaging-24.2.tar.gz", hash = "sha256:c228a6dc5e932d346bc5739379109d49e8853dd8223571c7c5b55260edc0b97f", size = 163950 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/88/ef/eb23f262cca3c0c4eb7ab1933c3b1f03d021f2c48f54763065b6f0e321be/packaging-24.2-py3-none-any.whl", hash = "sha256:09abb1bccd265c01f4a3aa3f7a7db064b36514d2cba19a2f694fe6150451a759", size = 65451 },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/96/2d/02d4312c973c6050a18b314a5ad0b3210edb65a906f868e31c111dede4a6/pluggy-1.5.0.tar.gz", hash = "sha256:2cffa88e94fdc978c4c574f15f9e59b7f4201d439195c3715ca9e2486f1d0cf1", size = 67955 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/88/5f/e351af9a41f866ac3f1fac4ca0613908d9a41741cfcf2228f4ad853b697d/pluggy-1.5.0-py3-none-any.whl", hash = "sha256:44e1ad92c8ca002de6377e165f3e0f1be63266ab4d554740532335b9d75ea669", size = 20556 },
+]
+
+[[package]]
+name = "pytest"
+version = "8.3.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ae/3c/c9d525a414d506893f0cd8a8d0de7706446213181570cdbd766691164e40/pytest-8.3.5.tar.gz", hash = "sha256:f4efe70cc14e511565ac476b57c279e12a855b11f48f212af1080ef2263d3845", size = 1450891 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/30/3d/64ad57c803f1fa1e963a7946b6e0fea4a70df53c1a7fed304586539c2bac/pytest-8.3.5-py3-none-any.whl", hash = "sha256:c69214aa47deac29fad6c2a4f590b9c4a9fdb16a403176fe154b79c0b4d4d820", size = 343634 },
+]
+
+[[package]]
+name = "python-dotenv"
+version = "1.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/bc/57/e84d88dfe0aec03b7a2d4327012c1627ab5f03652216c63d49846d7a6c58/python-dotenv-1.0.1.tar.gz", hash = "sha256:e324ee90a023d808f1959c46bcbc04446a10ced277783dc6ee09987c37ec10ca", size = 39115 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6a/3e/b68c118422ec867fa7ab88444e1274aa40681c606d59ac27de5a5588f082/python_dotenv-1.0.1-py3-none-any.whl", hash = "sha256:f7b63ef50f1b690dddf550d03497b66d609393b40b564ed0d674909a68ebf16a", size = 19863 },
+]
+
+[[package]]
+name = "requests"
+version = "2.32.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "charset-normalizer" },
+    { name = "idna" },
+    { name = "urllib3" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/63/70/2bf7780ad2d390a8d301ad0b550f1581eadbd9a20f896afe06353c2a2913/requests-2.32.3.tar.gz", hash = "sha256:55365417734eb18255590a9ff9eb97e9e1da868d4ccd6402399eaf68af20a760", size = 131218 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f9/9b/335f9764261e915ed497fcdeb11df5dfd6f7bf257d4a6a2a686d80da4d54/requests-2.32.3-py3-none-any.whl", hash = "sha256:70761cfe03c773ceb22aa2f671b4757976145175cdfca038c02654d061d6dcc6", size = 64928 },
+]
+
+[[package]]
+name = "ruff"
+version = "0.11.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/77/2b/7ca27e854d92df5e681e6527dc0f9254c9dc06c8408317893cf96c851cdd/ruff-0.11.0.tar.gz", hash = "sha256:e55c620690a4a7ee6f1cccb256ec2157dc597d109400ae75bbf944fc9d6462e2", size = 3799407 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/48/40/3d0340a9e5edc77d37852c0cd98c5985a5a8081fc3befaeb2ae90aaafd2b/ruff-0.11.0-py3-none-linux_armv6l.whl", hash = "sha256:dc67e32bc3b29557513eb7eeabb23efdb25753684b913bebb8a0c62495095acb", size = 10098158 },
+    { url = "https://files.pythonhosted.org/packages/ec/a9/d8f5abb3b87b973b007649ac7bf63665a05b2ae2b2af39217b09f52abbbf/ruff-0.11.0-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:38c23fd9bdec4eb437b4c1e3595905a0a8edfccd63a790f818b28c78fe345639", size = 10879071 },
+    { url = "https://files.pythonhosted.org/packages/ab/62/aaa198614c6211677913ec480415c5e6509586d7b796356cec73a2f8a3e6/ruff-0.11.0-py3-none-macosx_11_0_arm64.whl", hash = "sha256:7c8661b0be91a38bd56db593e9331beaf9064a79028adee2d5f392674bbc5e88", size = 10247944 },
+    { url = "https://files.pythonhosted.org/packages/9f/52/59e0a9f2cf1ce5e6cbe336b6dd0144725c8ea3b97cac60688f4e7880bf13/ruff-0.11.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b6c0e8d3d2db7e9f6efd884f44b8dc542d5b6b590fc4bb334fdbc624d93a29a2", size = 10421725 },
+    { url = "https://files.pythonhosted.org/packages/a6/c3/dcd71acc6dff72ce66d13f4be5bca1dbed4db678dff2f0f6f307b04e5c02/ruff-0.11.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3c3156d3f4b42e57247275a0a7e15a851c165a4fc89c5e8fa30ea6da4f7407b8", size = 9954435 },
+    { url = "https://files.pythonhosted.org/packages/a6/9a/342d336c7c52dbd136dee97d4c7797e66c3f92df804f8f3b30da59b92e9c/ruff-0.11.0-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:490b1e147c1260545f6d041c4092483e3f6d8eba81dc2875eaebcf9140b53905", size = 11492664 },
+    { url = "https://files.pythonhosted.org/packages/84/35/6e7defd2d7ca95cc385ac1bd9f7f2e4a61b9cc35d60a263aebc8e590c462/ruff-0.11.0-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:1bc09a7419e09662983b1312f6fa5dab829d6ab5d11f18c3760be7ca521c9329", size = 12207856 },
+    { url = "https://files.pythonhosted.org/packages/22/78/da669c8731bacf40001c880ada6d31bcfb81f89cc996230c3b80d319993e/ruff-0.11.0-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bcfa478daf61ac8002214eb2ca5f3e9365048506a9d52b11bea3ecea822bb844", size = 11645156 },
+    { url = "https://files.pythonhosted.org/packages/ee/47/e27d17d83530a208f4a9ab2e94f758574a04c51e492aa58f91a3ed7cbbcb/ruff-0.11.0-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:6fbb2aed66fe742a6a3a0075ed467a459b7cedc5ae01008340075909d819df1e", size = 13884167 },
+    { url = "https://files.pythonhosted.org/packages/9f/5e/42ffbb0a5d4b07bbc642b7d58357b4e19a0f4774275ca6ca7d1f7b5452cd/ruff-0.11.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:92c0c1ff014351c0b0cdfdb1e35fa83b780f1e065667167bb9502d47ca41e6db", size = 11348311 },
+    { url = "https://files.pythonhosted.org/packages/c8/51/dc3ce0c5ce1a586727a3444a32f98b83ba99599bb1ebca29d9302886e87f/ruff-0.11.0-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:e4fd5ff5de5f83e0458a138e8a869c7c5e907541aec32b707f57cf9a5e124445", size = 10305039 },
+    { url = "https://files.pythonhosted.org/packages/60/e0/475f0c2f26280f46f2d6d1df1ba96b3399e0234cf368cc4c88e6ad10dcd9/ruff-0.11.0-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:96bc89a5c5fd21a04939773f9e0e276308be0935de06845110f43fd5c2e4ead7", size = 9937939 },
+    { url = "https://files.pythonhosted.org/packages/e2/d3/3e61b7fd3e9cdd1e5b8c7ac188bec12975c824e51c5cd3d64caf81b0331e/ruff-0.11.0-py3-none-musllinux_1_2_i686.whl", hash = "sha256:a9352b9d767889ec5df1483f94870564e8102d4d7e99da52ebf564b882cdc2c7", size = 10923259 },
+    { url = "https://files.pythonhosted.org/packages/30/32/cd74149ebb40b62ddd14bd2d1842149aeb7f74191fb0f49bd45c76909ff2/ruff-0.11.0-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:049a191969a10897fe052ef9cc7491b3ef6de79acd7790af7d7897b7a9bfbcb6", size = 11406212 },
+    { url = "https://files.pythonhosted.org/packages/00/ef/033022a6b104be32e899b00de704d7c6d1723a54d4c9e09d147368f14b62/ruff-0.11.0-py3-none-win32.whl", hash = "sha256:3191e9116b6b5bbe187447656f0c8526f0d36b6fd89ad78ccaad6bdc2fad7df2", size = 10310905 },
+    { url = "https://files.pythonhosted.org/packages/ed/8a/163f2e78c37757d035bd56cd60c8d96312904ca4a6deeab8442d7b3cbf89/ruff-0.11.0-py3-none-win_amd64.whl", hash = "sha256:c58bfa00e740ca0a6c43d41fb004cd22d165302f360aaa56f7126d544db31a21", size = 11411730 },
+    { url = "https://files.pythonhosted.org/packages/4e/f7/096f6efabe69b49d7ca61052fc70289c05d8d35735c137ef5ba5ef423662/ruff-0.11.0-py3-none-win_arm64.whl", hash = "sha256:868364fc23f5aa122b00c6f794211e85f7e78f5dffdf7c590ab90b8c4e69b657", size = 10538956 },
+]
+
+[[package]]
+name = "ujson"
+version = "5.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f0/00/3110fd566786bfa542adb7932d62035e0c0ef662a8ff6544b6643b3d6fd7/ujson-5.10.0.tar.gz", hash = "sha256:b3cd8f3c5d8c7738257f1018880444f7b7d9b66232c64649f562d7ba86ad4bc1", size = 7154885 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e8/a6/fd3f8bbd80842267e2d06c3583279555e8354c5986c952385199d57a5b6c/ujson-5.10.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:98ba15d8cbc481ce55695beee9f063189dce91a4b08bc1d03e7f0152cd4bbdd5", size = 55642 },
+    { url = "https://files.pythonhosted.org/packages/a8/47/dd03fd2b5ae727e16d5d18919b383959c6d269c7b948a380fdd879518640/ujson-5.10.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:a9d2edbf1556e4f56e50fab7d8ff993dbad7f54bac68eacdd27a8f55f433578e", size = 51807 },
+    { url = "https://files.pythonhosted.org/packages/25/23/079a4cc6fd7e2655a473ed9e776ddbb7144e27f04e8fc484a0fb45fe6f71/ujson-5.10.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6627029ae4f52d0e1a2451768c2c37c0c814ffc04f796eb36244cf16b8e57043", size = 51972 },
+    { url = "https://files.pythonhosted.org/packages/04/81/668707e5f2177791869b624be4c06fb2473bf97ee33296b18d1cf3092af7/ujson-5.10.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f8ccb77b3e40b151e20519c6ae6d89bfe3f4c14e8e210d910287f778368bb3d1", size = 53686 },
+    { url = "https://files.pythonhosted.org/packages/bd/50/056d518a386d80aaf4505ccf3cee1c40d312a46901ed494d5711dd939bc3/ujson-5.10.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f3caf9cd64abfeb11a3b661329085c5e167abbe15256b3b68cb5d914ba7396f3", size = 58591 },
+    { url = "https://files.pythonhosted.org/packages/fc/d6/aeaf3e2d6fb1f4cfb6bf25f454d60490ed8146ddc0600fae44bfe7eb5a72/ujson-5.10.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:6e32abdce572e3a8c3d02c886c704a38a1b015a1fb858004e03d20ca7cecbb21", size = 997853 },
+    { url = "https://files.pythonhosted.org/packages/f8/d5/1f2a5d2699f447f7d990334ca96e90065ea7f99b142ce96e85f26d7e78e2/ujson-5.10.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:a65b6af4d903103ee7b6f4f5b85f1bfd0c90ba4eeac6421aae436c9988aa64a2", size = 1140689 },
+    { url = "https://files.pythonhosted.org/packages/f2/2c/6990f4ccb41ed93744aaaa3786394bca0875503f97690622f3cafc0adfde/ujson-5.10.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:604a046d966457b6cdcacc5aa2ec5314f0e8c42bae52842c1e6fa02ea4bda42e", size = 1043576 },
+    { url = "https://files.pythonhosted.org/packages/14/f5/a2368463dbb09fbdbf6a696062d0c0f62e4ae6fa65f38f829611da2e8fdd/ujson-5.10.0-cp312-cp312-win32.whl", hash = "sha256:6dea1c8b4fc921bf78a8ff00bbd2bfe166345f5536c510671bccececb187c80e", size = 38764 },
+    { url = "https://files.pythonhosted.org/packages/59/2d/691f741ffd72b6c84438a93749ac57bf1a3f217ac4b0ea4fd0e96119e118/ujson-5.10.0-cp312-cp312-win_amd64.whl", hash = "sha256:38665e7d8290188b1e0d57d584eb8110951a9591363316dd41cf8686ab1d0abc", size = 42211 },
+    { url = "https://files.pythonhosted.org/packages/0d/69/b3e3f924bb0e8820bb46671979770c5be6a7d51c77a66324cdb09f1acddb/ujson-5.10.0-cp313-cp313-macosx_10_9_x86_64.whl", hash = "sha256:618efd84dc1acbd6bff8eaa736bb6c074bfa8b8a98f55b61c38d4ca2c1f7f287", size = 55646 },
+    { url = "https://files.pythonhosted.org/packages/32/8a/9b748eb543c6cabc54ebeaa1f28035b1bd09c0800235b08e85990734c41e/ujson-5.10.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:38d5d36b4aedfe81dfe251f76c0467399d575d1395a1755de391e58985ab1c2e", size = 51806 },
+    { url = "https://files.pythonhosted.org/packages/39/50/4b53ea234413b710a18b305f465b328e306ba9592e13a791a6a6b378869b/ujson-5.10.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:67079b1f9fb29ed9a2914acf4ef6c02844b3153913eb735d4bf287ee1db6e557", size = 51975 },
+    { url = "https://files.pythonhosted.org/packages/b4/9d/8061934f960cdb6dd55f0b3ceeff207fcc48c64f58b43403777ad5623d9e/ujson-5.10.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d7d0e0ceeb8fe2468c70ec0c37b439dd554e2aa539a8a56365fd761edb418988", size = 53693 },
+    { url = "https://files.pythonhosted.org/packages/f5/be/7bfa84b28519ddbb67efc8410765ca7da55e6b93aba84d97764cd5794dbc/ujson-5.10.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:59e02cd37bc7c44d587a0ba45347cc815fb7a5fe48de16bf05caa5f7d0d2e816", size = 58594 },
+    { url = "https://files.pythonhosted.org/packages/48/eb/85d465abafb2c69d9699cfa5520e6e96561db787d36c677370e066c7e2e7/ujson-5.10.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:2a890b706b64e0065f02577bf6d8ca3b66c11a5e81fb75d757233a38c07a1f20", size = 997853 },
+    { url = "https://files.pythonhosted.org/packages/9f/76/2a63409fc05d34dd7d929357b7a45e3a2c96f22b4225cd74becd2ba6c4cb/ujson-5.10.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:621e34b4632c740ecb491efc7f1fcb4f74b48ddb55e65221995e74e2d00bbff0", size = 1140694 },
+    { url = "https://files.pythonhosted.org/packages/45/ed/582c4daba0f3e1688d923b5cb914ada1f9defa702df38a1916c899f7c4d1/ujson-5.10.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:b9500e61fce0cfc86168b248104e954fead61f9be213087153d272e817ec7b4f", size = 1043580 },
+    { url = "https://files.pythonhosted.org/packages/d7/0c/9837fece153051e19c7bade9f88f9b409e026b9525927824cdf16293b43b/ujson-5.10.0-cp313-cp313-win32.whl", hash = "sha256:4c4fc16f11ac1612f05b6f5781b384716719547e142cfd67b65d035bd85af165", size = 38766 },
+    { url = "https://files.pythonhosted.org/packages/d7/72/6cb6728e2738c05bbe9bd522d6fc79f86b9a28402f38663e85a28fddd4a0/ujson-5.10.0-cp313-cp313-win_amd64.whl", hash = "sha256:4573fd1695932d4f619928fd09d5d03d917274381649ade4328091ceca175539", size = 42212 },
+]
+
+[[package]]
+name = "urllib3"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/aa/63/e53da845320b757bf29ef6a9062f5c669fe997973f966045cb019c3f4b66/urllib3-2.3.0.tar.gz", hash = "sha256:f8c5449b3cf0861679ce7e0503c7b44b5ec981bec0d1d3795a07f1ba96f0204d", size = 307268 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c8/19/4ec628951a74043532ca2cf5d97b7b14863931476d117c471e8e2b1eb39f/urllib3-2.3.0-py3-none-any.whl", hash = "sha256:1cee9ad369867bfdbbb48b7dd50374c0967a0bb7710050facf0dd6911440e3df", size = 128369 },
+]
+
+[[package]]
+name = "win32-setctime"
+version = "1.2.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b3/8f/705086c9d734d3b663af0e9bb3d4de6578d08f46b1b101c2442fd9aecaa2/win32_setctime-1.2.0.tar.gz", hash = "sha256:ae1fdf948f5640aae05c511ade119313fb6a30d7eabe25fef9764dca5873c4c0", size = 4867 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e1/07/c6fe3ad3e685340704d314d765b7912993bcb8dc198f0e7a89382d37974b/win32_setctime-1.2.0-py3-none-any.whl", hash = "sha256:95d644c4e708aba81dc3704a116d8cbc974d70b3bdb8be1d150e36be6e9d1390", size = 4083 },
+]