testgenie-py 0.2.2__py3-none-any.whl → 0.2.3__py3-none-any.whl

testgenie_py-0.2.3.dist-info/METADATA

@@ -0,0 +1,139 @@
+Metadata-Version: 2.3
+Name: testgenie-py
+Version: 0.2.3
+Summary: Automated unit test generation tool for Python.
+Author: cjseitz
+Author-email: charlesjseitz@gmail.com
+Requires-Python: >=3.10,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: ConfigArgParse (==1.7)
+Requires-Dist: astor (==0.8.1)
+Requires-Dist: atheris (==2.3.0)
+Requires-Dist: coverage (==7.6.4)
+Requires-Dist: docker (>=7.1.0,<8.0.0)
+Requires-Dist: klara (==0.6.3)
+Requires-Dist: pygraphviz (>=1.14,<2.0)
+Requires-Dist: pytest (>=8.3.5,<9.0.0)
+Requires-Dist: staticfg (>=0.9.5,<0.10.0)
+Requires-Dist: tabulate (>=0.9.0,<0.10.0)
+Requires-Dist: typed-ast (==1.5.5)
+Requires-Dist: z3-solver (==4.13.3.0)
+Description-Content-Type: text/markdown
+
+# TestGenie
+
+**TestGenie** is an automated unit test generation tool for Python that supports multiple test generation strategies, including static AST analysis, fuzz testing, feedback-directed random testing, and reinforcement learning.  
+Built with a modular Pipe and Filter architecture, it analyzes Python source code to extract function metadata, generates meaningful test cases, and outputs executable test suites in formats like Unittest, PyTest, or Doctest.  
+The system can also measure and report code coverage and safely execute tests in Docker containers.  
+TestGenie aims to reduce manual testing effort, improve coverage, and explore the potential of learning-based approaches for optimizing test generation.
+
+---
+
+## Installation
+
+Make sure you have **Python 3.10+** and **Poetry** installed.
+
+Install dependencies:
+
+```bash
+poetry install
+```
+
+Activate the virtual environment:
+
+```bash
+poetry shell
+```
+
+---
+
+## Running the CLI
+
+To invoke the test generator, run:
+
+```bash
+poetry run python -m testgen.main <file_path> [options]
+```
+
+**Required Argument:**
+- `<file_path>`: Path to the Python module you want to analyze.
+
+---
+
+## Command-Line Options
+
+| Command/Flag | Description |
+|:---|:---|
+| `--output, -o <path>` | Path to output directory for generated test files (default: `./tests`) |
+| `--generate-only, -g` | Only generate test code, skip running tests and measuring coverage |
+| `--test-mode <mode>` | Set the test analysis strategy: `ast` (default), `random`, `fuzz`, or `reinforce` |
+| `--test-format <format>` | Set the test output format: `unittest` (default), `pytest`, or `doctest` |
+| `--safe` | Run test generation inside a Docker container for isolation and safety |
+| `--query, -q` | Query the database for test cases, coverage data, and test results for a specific file |
+| `--db <db_path>` | Path to SQLite database file (default: `testgen.db`) |
+| `--reinforce-mode <mode>` | Set mode for reinforcement learning: `train` (default) or `collect` |
+| `--visualize, -viz` | Visualize generated test coverage graphs using Graphviz |
+| `--debug` | Enable debug logging output |
+| `--log-file <path>` | Save logs to the specified file instead of only printing to the console |
+
+---
+
+## Examples
+
+Generate and run unit tests for a Python module:
+
+```bash
+poetry run python -m testgen.main mymodule.py
+```
+
+Generate tests using fuzzing strategy and output to a custom directory:
+
+```bash
+poetry run python -m testgen.main mymodule.py --test-mode fuzz --output generated_tests/
+```
+
+Run reinforcement learning-based test generation:
+
+```bash
+poetry run python -m testgen.main mymodule.py --test-mode reinforce
+```
+
+Query previously generated test results from the database:
+
+```bash
+poetry run python -m testgen.main mymodule.py --query
+```
+
+Safely generate tests inside a Docker container:
+
+```bash
+poetry run python -m testgen.main mymodule.py --safe
+```
+
+---
+
+## Features
+- Static analysis using Python AST
+- Fuzz testing using randomized input generation
+- Feedback-directed random testing
+- Reinforcement learning-based test case optimization
+- Supports Unittest, PyTest, and Doctest formats
+- Code coverage measurement and reporting
+- Docker sandboxing for safe test execution
+- SQLite database integration for tracking tests and results
+- CLI visualization of test coverage graphs
+
+---
+
+## Requirements
+
+- Python 3.10+
+- Poetry
+- (Optional) Docker (for safe mode execution)
+
+---
+

{testgenie_py-0.2.2.dist-info → testgenie_py-0.2.3.dist-info}/RECORD

@@ -61,7 +61,7 @@ testgen/util/z3_utils/branch_condition.py,sha256=N9FNR-iJmxIC62NpDQNVZ1OP14rXXqY
 testgen/util/z3_utils/constraint_extractor.py,sha256=RXJLpmk6dAvHZ27839VXKXNtdy9St1F-17-pSEFu4bM,1285
 testgen/util/z3_utils/variable_finder.py,sha256=dUh3F9_L_BDMz1ybiGss09LLcM_egbitgj0FT5Nh9u4,245
 testgen/util/z3_utils/z3_test_case.py,sha256=yF4oJOrXMLzOwDUqXdoeg83MOTl3pvc_lYaZcS01CuQ,4983
-testgenie_py-0.2.2.dist-info/METADATA,sha256=gqB_l7Y9ELHsTmydKcJDaTeVKbEmgNltEhL7Si0Ll18,885
-testgenie_py-0.2.2.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-testgenie_py-0.2.2.dist-info/entry_points.txt,sha256=OUN4GqB4zHlHWwWGjwIPbur4E_ZqQgkeeqaCLhzRZgg,47
-testgenie_py-0.2.2.dist-info/RECORD,,
+testgenie_py-0.2.3.dist-info/METADATA,sha256=2-QroI89cQjovRoy2sgGDE1KiNVX4na87b-9K-35jck,4350
+testgenie_py-0.2.3.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+testgenie_py-0.2.3.dist-info/entry_points.txt,sha256=OUN4GqB4zHlHWwWGjwIPbur4E_ZqQgkeeqaCLhzRZgg,47
+testgenie_py-0.2.3.dist-info/RECORD,,

testgenie_py-0.2.2.dist-info/METADATA

@@ -1,27 +0,0 @@
-Metadata-Version: 2.3
-Name: testgenie-py
-Version: 0.2.2
-Summary: 
-Author: cjseitz
-Author-email: charlesjseitz@gmail.com
-Requires-Python: >=3.10,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: ConfigArgParse (==1.7)
-Requires-Dist: astor (==0.8.1)
-Requires-Dist: atheris (==2.3.0)
-Requires-Dist: coverage (==7.6.4)
-Requires-Dist: docker (>=7.1.0,<8.0.0)
-Requires-Dist: klara (==0.6.3)
-Requires-Dist: pygraphviz (>=1.14,<2.0)
-Requires-Dist: pytest (>=8.3.5,<9.0.0)
-Requires-Dist: staticfg (>=0.9.5,<0.10.0)
-Requires-Dist: tabulate (>=0.9.0,<0.10.0)
-Requires-Dist: typed-ast (==1.5.5)
-Requires-Dist: z3-solver (==4.13.3.0)
-Description-Content-Type: text/markdown
-
-