# PyTester

**Repository Path**: jungle/py-tester

## Basic Information

- **Project Name**: PyTester
- **Description**: A small test framework for network device.
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-01
- **Last Updated**: 2026-03-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Testing

## README

Py-Tester
=========

Small test framework that discovers `TestSuite` objects from `testcases/`.

Quick start

- Configure device connection in `config.json` (repo root) or use CLI args to override.
- Add test modules in `testcases/` — each module should expose `TestSuite` objects at module level.
- Run:

  ```powershell
  python main.py
  ```

CLI precedence and config

- The framework loads device info from `config.json` by default.
- Command-line options override `config.json` values. Supported flags:
  - `--config` / `-c`: path to config file
  - `--host`, `--port`, `--username`, `--password`
  - `--prompt`, `--login-prompt`, `--passwd-prompt`
  - `--dry-run`: do not open real network connections (uses DummyDevice)

Test module authoring (summary)

- Define `TestCase` and `TestSuite` objects at module scope; the framework auto-discovers them.
- Use module-level hook functions if needed:
  - `suite_setup(dev)` / `suite_teardown(dev)` — run once per suite
  - `setup(dev)` / `teardown(dev)` — run for each case in the module
- Ensure `suite_id` is unique.

Examples and more details: see `testcases/README.md`.