AIUnitTest 0.0.4__tar.gz → 0.0.7__tar.gz

aiunittest-0.0.7/.flake8

@@ -0,0 +1,34 @@
+[flake8]
+statistics=true
+count=True
+max-line-length = 120
+extend-select = B, ANN, D, C4, E, PT
+max-complexity = 10
+# E203: whitespace before ':' (Black's conflict)
+# W503: line break before binary operator (Black's conflict)
+# ANN101: missing-type-self - Modern type checkers, such as MyPy, are capable of inferring the type of self automatically. This makes explicit annotation of self redundant in most cases.
+extend-ignore = E203,W503,ANN101
+exclude =
+    env,
+    .venv,
+    venv,
+    build,
+    dist,
+    __pycache__,
+    assets,
+    tests/fake_project,
+    src/ai_unit_test/_version.py,
+    .pytest_cache,
+    htmlcov,
+    .ai_unit_test_cache,
+    .git
+
+# F401: imported but unused (comum em __init__.py para re-exports)
+per-file-ignores =
+    __init__.py:F401
+    tests/fake_project/**: D100,D103
+
+[flake8-annotations]
+suppress-none-returning = true
+suppress-dummy-args = true
+allow-untyped-defs = true

{aiunittest-0.0.4 → aiunittest-0.0.7}/.github/dependabot.yml

@@ -3,7 +3,7 @@ updates:
   - package-ecosystem: "pip"
     directory: "/"
     schedule:
-      interval: "weekly"  # frequência de update (daily/weekly/monthly)
+      interval: "weekly" # update frequency (daily/weekly/monthly)
     commit-message:
       prefix: "chore"
       include: "scope"
@@ -11,7 +11,7 @@ updates:
     groups:
       python-deps:
         patterns:
-          - "*"  # agrupar todas as dependências em um PR
+          - "*" # group all dependencies into a single PR
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:

aiunittest-0.0.7/.github/instructions/general.instructions.md

@@ -0,0 +1,112 @@
+---
+applyTo: "**"
+---
+
+# AIUnitTest – Copilot & Developer Instructions
+
+## Running Tests
+
+1. **Activate the virtual environment:**
+
+   ```bash
+   source env/bin/activate
+   ```
+
+2. **Install dependencies (if needed):**
+
+   ```bash
+   make install-dev
+   ```
+
+3. **Run tests:**
+
+   - All unit tests (default):
+
+     ```bash
+     make test
+     ```
+
+   - Only unit tests:
+
+     ```bash
+     make test-unit
+     ```
+
+   - Unit tests with coverage report:
+
+     ```bash
+     make test-unit-cov
+     ```
+
+     - Coverage HTML report: `htmlcov/index.html`
+
+   - Integration tests:
+
+     ```bash
+     make test-integration
+     ```
+
+   - All tests (including slow):
+
+     ```bash
+     make test-all
+     ```
+
+   - Fast tests (excluding slow):
+
+     ```bash
+     make test-fast
+     ```
+
+   - Watch mode (auto re-run on file change):
+
+     ```bash
+     make test-watch
+     ```
+
+   - Using global pytest (not recommended):
+
+     ```bash
+     make test-simple
+     ```
+
+> **Note:** All test commands require the virtual environment to be active and dependencies installed.
+
+## Project Structure
+
+- **Source code:** `src/ai_unit_test/`
+- **Tests:** `tests/`
+- **Configs:** `pyproject.toml`, `requirements.txt`
+- **Docs:** `README.md`, `docs/`
+
+## Coding Conventions
+
+- Use descriptive names for functions and variables.
+- Cover normal and edge cases in tests.
+- Follow mypy standards (see: mypy-lang.org/) and configured `flake8`/`bandit` rules.
+- Never skip pre-commit hooks.
+- Always run commands inside the project environment (`source env/bin/activate`).
+- Follow clean code best practices.
+
+## Quick Onboarding
+
+- Clone the repo and enter the project folder.
+
+- Create and activate the virtual environment:
+
+  ```bash
+  python3 -m venv env
+  source env/bin/activate
+  ```
+
+- Install all dependencies:
+
+  ```bash
+  make install-dev
+  ```
+
+- Run tests and check code quality before committing.
+
+---
+
+If you have questions, check the documentation or ask your team!

{aiunittest-0.0.4 → aiunittest-0.0.7}/.github/workflows/ci.yml

@@ -8,12 +8,14 @@ jobs:
   setup:
     name: Setup & Lint
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
 
     steps:
       - uses: actions/checkout@v5
 
       - name: Setup Python 3.13 (with pip cache)
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.13"
           cache: pip # ativa cache de dependencies pip :contentReference[oaicite:1]{index=1}
@@ -27,11 +29,8 @@ jobs:
           restore-keys: |
             precommit-${{ runner.os }}-
 
-      - name: Install dependencies
-        run: pip install -r requirements.txt
-
       - name: Install project
-        run: pip install -e .
+        run: pip install -e .[all,dev]
 
       - name: Run pre-commit hooks
         run: pre-commit run --show-diff-on-failure --all-files
@@ -46,20 +45,21 @@ jobs:
     steps:
       - uses: actions/checkout@v5
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: "3.13"
           cache: pip
 
-      - name: Install dependencies
-        run: pip install -r requirements.txt
-
       - name: Install project
-        run: pip install -e .
+        run: pip install -e .[all,dev]
 
-      - name: Run pytest with coverage
+      - name: Run all tests (without coverage)
         run: |
-          pytest --cov=src --cov-report=xml --cov-fail-under=80
+          pytest tests --tb=short --no-cov
+
+      - name: Run unit tests with coverage
+        run: |
+          pytest tests/unit --cov=src --cov-report=xml --cov-fail-under=70
 
       - name: Upload coverage report
         uses: actions/upload-artifact@v4
@@ -82,7 +82,7 @@ jobs:
       pull-requests: write
     steps:
       - uses: actions/checkout@v5
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: "3.13"
           cache: pip
@@ -90,10 +90,12 @@ jobs:
         run: pip install -r requirements.txt
 
       - name: Install project
-        run: pip install -e .
+        run: pip install -e .[all,dev]
 
       - name: Run tests
-        run: pytest
+        run: |
+          pytest tests --tb=short --no-cov
+          pytest tests/unit --cov=src --cov-report=term-missing --cov-fail-under=70
 
       - name: Add label for dependencies
         id: fetch-metadata

{aiunittest-0.0.4 → aiunittest-0.0.7}/.github/workflows/release.yml

@@ -44,16 +44,8 @@ jobs:
           git tag -a ${{ steps.get_next_version.outputs.NEXT_VERSION }} -m "Release ${{ steps.get_next_version.outputs.NEXT_VERSION }}"
           git push origin ${{ steps.get_next_version.outputs.NEXT_VERSION }}
 
-      - name: Create GitHub Release
-        uses: ncipollo/release-action@v1
-        with:
-          tag: ${{ steps.get_next_version.outputs.NEXT_VERSION }}
-          name: Release ${{ steps.get_next_version.outputs.NEXT_VERSION }}
-          generateReleaseNotes: true
-          artifacts: "dist/*"
-
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.9"
 
@@ -65,21 +57,30 @@ jobs:
       - name: Build package
         run: python -m build
 
+      - name: Create GitHub Release
+        uses: ncipollo/release-action@v1
+        with:
+          tag: ${{ steps.get_next_version.outputs.NEXT_VERSION }}
+          name: Release ${{ steps.get_next_version.outputs.NEXT_VERSION }}
+          generateReleaseNotes: true
+          artifacts: "dist/*"
+
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@v1.13.0
 
-      - name: Set up Conda
-        uses: conda-incubator/setup-miniconda@v3
-        with:
-          python-version: 3.9
-          auto-update-conda: true
-          auto-activate-base: false
+      # - name: Set up Conda
+      #   uses: conda-incubator/setup-miniconda@v3
+      #   with:
+      #     python-version: 3.9
+      #     auto-update-conda: true
+      #     auto-activate-base: false
 
-      - name: Build and upload Conda package
-        shell: bash -l {0}
-        run: |
-          conda install -c conda-forge conda-build anaconda-client -y
-          export GIT_TAG=${{ steps.get_next_version.outputs.NEXT_VERSION }}
-          conda build conda --output-folder conda-dist
-          anaconda login --with-token ${{ secrets.CONDA_TOKEN }}
-          anaconda upload conda-dist/**/*.tar.bz2 --label main --skip-existing
+      # - name: Build and upload Conda package
+      #   shell: bash -l {0}
+      #   run: |
+      #     conda install -c conda-forge conda-build anaconda-client -y
+      #     conda install -c conda-forge --file conda/meta.yaml --yes
+      #     export GIT_TAG=${{ steps.get_next_version.outputs.NEXT_VERSION }}
+      #     conda build conda --output-folder conda-dist
+      #     anaconda login --with-token ${{ secrets.CONDA_TOKEN }}
+      #     anaconda upload conda-dist/**/*.tar.bz2 --label main --skip-existing

{aiunittest-0.0.4 → aiunittest-0.0.7}/.gitignore

@@ -208,3 +208,6 @@ __marimo__/
 tasks.md
 .vscode/settings.json
 src/ai_unit_test/_version.py
+need_to_do/
+valid_index_dir/*
+data/faiss_index/*

{aiunittest-0.0.4 → aiunittest-0.0.7}/.pre-commit-config.yaml

@@ -3,7 +3,7 @@ default_install_hook_types:
   - commit-msg
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: check-yaml
         args: ["--unsafe"]
@@ -17,36 +17,36 @@ repos:
         args: ["--maxkb=500"] # por ex. limites de 500 KB
 
   - repo: https://github.com/compilerla/conventional-pre-commit
-    rev: v4.2.0
+    rev: v4.3.0
     hooks:
       - id: conventional-pre-commit
         stages:
           - commit-msg
 
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.21.0
+    hooks:
+      - id: pyupgrade
+        args: ["--py313-plus"]
+
   - repo: https://github.com/pycqa/isort
-    rev: 6.0.1
+    rev: 7.0.0
     hooks:
       - id: isort
 
   - repo: https://github.com/psf/black
-    rev: 25.1.0
+    rev: 25.9.0
     hooks:
       - id: black
         args: ["--config", "pyproject.toml"]
 
-  - repo: https://github.com/asottile/pyupgrade
-    rev: v3.20.0
-    hooks:
-      - id: pyupgrade
-        args: ["--py3-plus", "--py313-plus"]
-
   - repo: https://github.com/DavidAnson/markdownlint-cli2
     rev: v0.18.1
     hooks:
-    - id: markdownlint-cli2
+      - id: markdownlint-cli2
 
   - repo: https://github.com/adamchainz/blacken-docs
-    rev: 1.19.1
+    rev: 1.20.0
     hooks:
       - id: blacken-docs
         additional_dependencies:
@@ -56,7 +56,15 @@ repos:
     rev: 7.3.0
     hooks:
       - id: flake8
-        additional_dependencies: [flake8-bugbear, flake8-annotations]
+        additional_dependencies:
+          [
+            flake8-bugbear,
+            flake8-annotations,
+            flake8-docstrings,
+            flake8-comprehensions,
+            flake8-eradicate,
+            flake8-pytest-style,
+          ]
         args: ["--config", ".flake8"]
 
   - repo: https://github.com/PyCQA/bandit
@@ -69,12 +77,11 @@ repos:
           - "pre-commit"
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.17.1
+    rev: v1.18.2
     hooks:
       - id: mypy
         entry: mypy --config-file pyproject.toml
         language: python
         require_serial: true
-        additional_dependencies: ["typer", "openai", "coverage", "pytest"]
-        env:
-          PYTHONPATH: src
+        additional_dependencies:
+          ["typer", "openai", "coverage", "pytest", "faiss-cpu", "scikit-learn"]

aiunittest-0.0.7/GEMINI.md

@@ -0,0 +1,86 @@
+
+# Gemini CLI Instructions
+
+## How to run the tests
+
+- **Always activate the project virtual environment first:**
+
+    ```bash
+    source env/bin/activate
+    ```
+
+- **To run all unit tests (default):**
+
+    ```bash
+    make test
+    ```
+
+- **To run only unit tests:**
+
+    ```bash
+    make test-unit
+    ```
+
+- **To run unit tests with coverage report:**
+
+    ```bash
+    make test-unit-cov
+    ```
+
+- The HTML coverage report will be generated at `htmlcov/index.html`.
+
+- **To run integration tests:**
+
+    ```bash
+    make test-integration
+    ```
+
+- **To run all tests (including slow ones):**
+
+    ```bash
+    make test-all
+    ```
+
+- **To run only fast tests (excluding slow ones):**
+
+    ```bash
+    make test-fast
+    ```
+
+- **To run tests in watch mode (auto re-run on file change):**
+
+    ```bash
+    make test-watch
+    ```
+
+- **If you want to run tests using the global pytest (not recommended):**
+
+    ```bash
+    make test-simple
+    ```
+
+- **Tip:** All test commands require the virtual environment to be active and dependencies installed.
+    If you see errors about missing dependencies, run:
+
+    ```bash
+    make install-dev
+    ```
+
+- **Test files are located in the `tests/` folder.**
+
+## Project Structure
+
+- Source code: `src/ai_unit_test/`
+- Tests: `tests/`
+- Configurations: `pyproject.toml`, `requirements.txt`
+- Documentation: `README.md`, `docs/`
+
+## Conventions
+
+- Follow mypy standards for Python according to the configured flake8 and bandit rules.
+- Use descriptive names for functions and variables.
+- Tests must cover normal and edge cases.
+- Never skip pre-commit.
+- Always run commands inside the project env (`source env/bin/activate`).
+- Follow clean code best practices.
+- Always think as much as necessary.

aiunittest-0.0.7/Makefile

@@ -0,0 +1,207 @@
+# Makefile for AIUnitTest
+# ======================
+
+# Variables
+PYTHON := python3
+PIP := pip
+VENV_BIN := env/bin
+PYTEST := $(VENV_BIN)/pytest
+BLACK := $(VENV_BIN)/black
+ISORT := $(VENV_BIN)/isort
+FLAKE8 := $(VENV_BIN)/flake8
+MYPY := $(VENV_BIN)/mypy
+COVERAGE := $(VENV_BIN)/coverage
+PRE_COMMIT := $(VENV_BIN)/pre-commit
+
+# Directories
+SRC_DIR := src
+TEST_DIR := tests
+VENV_DIR := env
+
+# Configurations
+.PHONY: help install install-dev test test-unit test-integration lint format type-check \
+        coverage clean build publish pre-commit setup-dev run-app activate-env \
+        test-fast test-all check-all docs reset-fake-project
+
+# Default target
+.DEFAULT_GOAL := help
+
+# Check if virtual environment exists
+check-venv:
+	@if [ ! -f $(VENV_BIN)/python ]; then \
+		echo "❌ Virtual environment not found at $(VENV_DIR)"; \
+		echo "Run 'make create-venv' to create or activate existing virtual environment"; \
+		exit 1; \
+	fi
+
+help: ## Show this help message
+	@echo "Available commands:"
+	@echo
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+# Installation and setup
+install: ## Install the project in development mode
+	$(PIP) install -e .
+
+install-dev: ## Install development dependencies
+	$(PIP) install -e ".[dev]"
+	$(PIP) install -r requirements.txt
+
+install-prod: ## Install production dependencies only
+	$(PIP) install -e .
+
+setup-dev: install-dev ## Configure complete development environment
+	@if [ -f $(VENV_BIN)/pre-commit ]; then \
+		$(PRE_COMMIT) install; \
+	else \
+		echo "⚠️  pre-commit not found in virtual environment, trying global version"; \
+		pre-commit install || echo "❌ Error configuring pre-commit"; \
+	fi
+	@echo "✅ Development environment configured!"
+
+# Virtual environment
+create-venv: ## Create a new virtual environment
+	$(PYTHON) -m venv $(VENV_DIR)
+	@echo "✅ Virtual environment created at $(VENV_DIR)"
+	@echo "To activate: source $(VENV_DIR)/bin/activate"
+
+activate-env: ## Show how to activate virtual environment
+	@echo "To activate the virtual environment, run:"
+	@echo "source $(VENV_DIR)/bin/activate"
+
+# Tests
+test: check-venv ## Run unit tests with coverage (default)
+	$(PYTEST) $(TEST_DIR)/unit -v
+
+test-unit: check-venv ## Run unit tests only
+	$(PYTEST) $(TEST_DIR)/unit -v
+
+test-unit-cov: check-venv ## Run unit tests with coverage
+	$(PYTEST) $(TEST_DIR)/unit --cov=$(SRC_DIR) --cov-report=html --cov-report=term-missing
+
+test-integration: check-venv ## Run integration tests
+	$(PYTEST) $(TEST_DIR) -v -m "integration"
+
+test-fast: check-venv ## Run fast tests (exclude slow tests)
+	$(PYTEST) $(TEST_DIR) -v -m "not slow"
+
+test-all: check-venv ## Run all tests including slow ones
+	$(PYTEST) $(TEST_DIR) -v --tb=short
+
+test-watch: check-venv ## Run tests in watch mode (re-run when files change)
+	$(PYTEST) $(TEST_DIR) -f
+
+test-simple: ## Run tests using global pytest (fallback)
+	@if command -v pytest >/dev/null 2>&1; then \
+		pytest $(TEST_DIR) -v; \
+	else \
+		echo "❌ pytest not found. Run 'make install-dev' first"; \
+		exit 1; \
+	fi
+
+# Code coverage
+coverage: check-venv ## Generate coverage report
+	$(PYTEST) $(TEST_DIR)/unit --cov=$(SRC_DIR) --cov-report=html --cov-report=term-missing
+	@echo "📊 HTML coverage report generated at htmlcov/index.html"
+
+coverage-xml: check-venv ## Generate XML coverage report
+	$(PYTEST) $(TEST_DIR)/unit --cov=$(SRC_DIR) --cov-report=xml
+
+# Code quality
+lint: check-venv ## Run linting with flake8
+	$(FLAKE8) $(SRC_DIR) $(TEST_DIR)
+
+format: check-venv ## Format code with black and isort
+	$(BLACK) $(SRC_DIR) $(TEST_DIR)
+	$(ISORT) $(SRC_DIR) $(TEST_DIR)
+
+format-check: check-venv ## Check formatting without modifying files
+	$(BLACK) --check $(SRC_DIR) $(TEST_DIR)
+	$(ISORT) --check-only $(SRC_DIR) $(TEST_DIR)
+
+type-check: check-venv ## Run type checking with mypy
+	$(MYPY) $(SRC_DIR)
+
+# Combined checks
+check-all: format-check lint type-check test ## Run all quality checks
+	@echo "✅ All checks passed!"
+
+pre-commit-run: ## Run pre-commit on all files
+	$(PRE_COMMIT) run --all-files
+
+pre-commit-install: ## Install pre-commit hooks
+	$(PRE_COMMIT) install
+
+# Build and publishing
+build: clean ## Build the package
+	$(PYTHON) -m build
+
+clean: ## Remove temporary and build files
+	rm -rf build/
+	rm -rf dist/
+	rm -rf *.egg-info/
+	rm -rf .pytest_cache/
+	rm -rf .coverage
+	rm -rf htmlcov/
+	rm -rf .mypy_cache/
+	find . -type d -name __pycache__ -exec rm -rf {} +
+	find . -type f -name "*.pyc" -delete
+
+publish-test: build ## Publish to TestPyPI
+	twine upload --repository testpypi dist/*
+
+publish: build ## Publish to PyPI
+	twine upload dist/*
+
+# Application execution
+run-app: check-venv ## Run the main application
+	$(VENV_BIN)/ai-unit-test --help
+
+run-cli: check-venv ## Run the CLI with example arguments
+	$(VENV_BIN)/ai-unit-test --help
+
+# Project utilities
+reset-fake-project: ## Reset fake project for testing
+	$(PYTHON) reset_fake_project.py
+
+docs: ## Generate documentation (placeholder)
+	@echo "📚 Documentation will be implemented soon"
+
+# Quick development commands
+dev-install: create-venv activate-env install-dev setup-dev ## Complete setup for new developers
+	@echo "🚀 Development environment ready!"
+	@echo "Don't forget to activate the virtual environment: source $(VENV_DIR)/bin/activate"
+
+quick-test: format lint test-fast ## Quick check before commit
+	@echo "✅ Quick check completed!"
+
+full-check: format lint type-check coverage ## Complete verification
+	@echo "✅ Full check completed!"
+
+# Debug and logs
+show-logs: ## Show recent logs
+	@echo "📋 Available logs:"
+	@ls -la logs/ 2>/dev/null || echo "No logs found"
+
+tail-logs: ## Follow logs in real time
+	tail -f logs/*.log 2>/dev/null || echo "No logs to follow"
+
+# Project information
+info: ## Show project information
+	@echo "📦 AIUnitTest - Project Information"
+	@echo "=================================="
+	@echo "Python: $(shell $(PYTHON) --version)"
+	@echo "Pip: $(shell $(PIP) --version)"
+	@echo "Current directory: $(shell pwd)"
+	@echo "Current branch: $(shell git branch --show-current 2>/dev/null || echo 'N/A')"
+	@echo "Last commit: $(shell git log -1 --format=%cd --date=short 2>/dev/null || echo 'N/A')"
+
+# Special commands for CI/CD
+ci-install: ## Installation for CI/CD
+	$(PIP) install -e ".[dev]"
+
+ci-test: ## Tests for CI/CD
+	$(PYTEST) $(TEST_DIR) --cov=$(SRC_DIR) --cov-report=xml --cov-report=term
+
+ci-check: ci-install format-check lint type-check ci-test ## Complete CI/CD verification
+	@echo "✅ CI/CD verification completed!"