remote

Version: 1.2.0

Table of Contents

• Introduction
• Install
• Tests
• Roadmap
• Status Compatibility
• Useful Links

wexample-remote keeps track of everything a Python application talks to outside itself — an HTTP API, a model provider, a database — whatever the library it goes through. It holds what those have in common: a registry of the app's remotes and a status per remote (up, down, or unconfigured when its address or credentials are missing), with the time the check took.

It mirrors php-remote. For HTTP APIs built on wexample-api, GatewayRemote checks a gateway by requesting its ping path.

Installation

pip install wexample-remote

Requires Python >=3.10.

Tests

This project uses pytest for testing and pytest-cov for code coverage analysis.

Installation

First, install the required testing dependencies:

.venv/bin/python -m pip install pytest pytest-cov

Basic Usage

Run all tests with coverage:

.venv/bin/python -m pytest --cov --cov-report=html

Common Commands

# Run tests with coverage for a specific module
.venv/bin/python -m pytest --cov=your_module

# Show which lines are not covered
.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing

# Generate an HTML coverage report
.venv/bin/python -m pytest --cov=your_module --cov-report=html

# Combine terminal and HTML reports
.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html

# Run specific test file with coverage
.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing

Viewing HTML Reports

After generating an HTML report, open htmlcov/index.html in your browser to view detailed line-by-line coverage information.

Coverage Threshold

To enforce a minimum coverage percentage:

.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80

This will cause the test suite to fail if coverage drops below 80%.

Known Limitations & Roadmap

Current limitations and planned features are tracked in the GitHub issues.

See the project roadmap for upcoming features and improvements.

Status & Compatibility

Maturity: Production-ready

Python Support: >=3.10

OS Support: Linux, macOS, Windows

Status: Actively maintained

Useful Links

• Homepage: https://github.com/wexample/python-remote
• Issue Tracker: https://github.com/wexample/python-remote/issues
• Discussions: https://github.com/wexample/python-remote/discussions
• PyPI: pypi.org/project/wexample-remote