py-connect-test 2.2.0__py3-none-any.whl

py_connect_test/main.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+import sys
+
+import typer
+
+from py_connect_test.services.http import HttpTest
+from py_connect_test.setup_logger import setup_logger
+
+app = typer.Typer(help="Http Connection Test")
+
+logger = setup_logger()
+
+
+@app.callback(invoke_without_command=True)
+def callback(ctx: typer.Context) -> None:
+    if ctx.invoked_subcommand is None:
+        typer.echo(ctx.get_help())
+        sys.exit(0)
+
+
+@app.command()
+def test(
+    insecure: bool = typer.Option(
+        False,
+        "-i",
+        "--insecure",
+        help="Bypass Certificate Checking",
+    ),
+    alerts: bool = typer.Option(
+        False,
+        "-a",
+        "--alerts",
+        help="Send Alert to Webhook (WEBHOOK_URL env variable)",
+    ),
+):
+    http_test = HttpTest(insecure=insecure)
+    status_code = http_test.get_status_code()
+    logger.success("Connected: {}", status_code)
+
+    if alerts:
+        alert = http_test.post_alerts()
+        logger.success("Alert response: {}", alert.status_code)
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()

py_connect_test/services/http.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+import json
+
+import httpx
+
+from py_connect_test.settings import AlertSettings, HttpSettings
+from py_connect_test.setup_logger import setup_logger
+
+logger = setup_logger()
+
+
+class HttpTest:
+    def __init__(self, insecure: bool) -> None:
+        self.http_settings = HttpSettings()
+        self.alert_settings = AlertSettings()
+        self.insecure = insecure
+
+    def get(self) -> httpx.Response | None:
+        with httpx.Client(
+            base_url=self.http_settings.url,
+            verify=not self.insecure,
+            follow_redirects=True,
+        ) as client:
+            logger.info("Connecting to {}", self.http_settings.url)
+            try:
+                response = client.get("/")
+                response.raise_for_status()
+                return response
+            except httpx.RequestError as e:
+                logger.error("Error connecting to {}: {}", self.http_settings.url, e)
+                return None
+
+    def get_status_code(self) -> int | None:
+        response = self.get()
+        if not response:
+            return None
+        return response.status_code
+
+    def post_alerts(self) -> httpx.Response:
+        with open(self.alert_settings.payload_file_path) as f:
+            payload = json.load(f)
+
+        with httpx.Client(
+            base_url=self.alert_settings.webhook_url,
+            verify=not self.insecure,
+        ) as client:
+            response = client.post("/", json=payload)
+            response.raise_for_status()
+            logger.success(
+                "Alert posted successfully to {}",
+                self.alert_settings.webhook_url,
+            )
+            return response

py_connect_test/settings.py

@@ -0,0 +1,12 @@
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class HttpSettings(BaseSettings):
+    model_config = SettingsConfigDict(env_prefix="PY_CONNECT_TEST_")
+
+    url: str = "https://ifconfig.me"
+
+
+class AlertSettings(BaseSettings):
+    webhook_url: str = "http://prometheus.local"
+    payload_file_path: str = "payload.json"

py_connect_test/setup_logger.py

@@ -0,0 +1,14 @@
+import sys
+
+import loguru
+from loguru import logger
+
+
+def setup_logger() -> loguru.Logger:
+    logger.remove()
+    logger.add(
+        sink=sys.stdout,
+        format="{time:YYYY-MM-DD HH:mm:ss} - {level} - {message}",
+        level="INFO",
+    )
+    return logger

py_connect_test-2.2.0.dist-info/METADATA

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: py_connect_test
+Version: 2.2.0
+Summary: A simple Python package for testing connectivity.
+License: MIT
+Keywords: python3
+Author: Victor Bajada
+Author-email: bajada.victor@gmail.com
+Maintainer: Victor Bajada
+Maintainer-email: bajada.victor@gmail.com
+Requires-Python: >=3.14,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Typing :: Typed
+Requires-Dist: httpx (>=0.28.1,<0.29.0)
+Requires-Dist: loguru (>=0.7.0,<0.8.0)
+Requires-Dist: pydantic-settings (>=2.14.1,<3.0.0)
+Requires-Dist: rich (>=14.0.0,<15.0.0)
+Requires-Dist: typer (>=0.25.0,<0.26.0)
+Project-URL: Changelog, https://github.com/Diapolo10/project-name/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/tech1ndex/py-connect-test/tree/main/docs
+Project-URL: Homepage, https://pypi.org/project/py-connect-test/
+Project-URL: Repository, https://github.com/tech1ndex/py-connect-test
+Project-URL: Tracker, https://github.com/Diapolo10/project-name/issues
+Description-Content-Type: text/markdown
+
+# py-connect-test
+
+A simple Python package to test HTTP connectivity to URLs and retrieve status codes. Built with Typer CLI framework and httpx.
+
+## Prerequisites
+
+- Python 3.14 or higher
+- Poetry (for dependency management)
+
+## Installation
+
+### From Source
+
+```bash
+git clone https://github.com/tech1ndex/py-connect-test.git
+cd py-connect-test
+poetry install
+```
+
+## Usage
+
+### Basic Usage
+
+Test connectivity to the default URL (https://ifconfig.me):
+
+```bash
+poetry run py-connect-test test
+```
+
+Or directly:
+
+```bash
+python -m py_connect_test.main test
+```
+
+### Options
+
+#### Bypass SSL Certificate Validation
+
+```bash
+poetry run py-connect-test test --insecure
+# or
+poetry run py-connect-test test -i
+```
+
+#### Send Alerts to Webhook
+
+```bash
+poetry run py-connect-test test --alerts
+# or
+poetry run py-connect-test test -a
+```
+
+#### Combined Options
+
+```bash
+poetry run py-connect-test test --insecure --alerts
+```
+
+### View Help
+
+```bash
+poetry run py-connect-test test --help
+```
+
+## Docker Usage
+
+### Build Image
+
+```bash
+docker build -t py-connect-test:latest .
+```
+
+### Run Container
+
+```bash
+docker run -d \
+  -e HTTP_URL=https://example.com \
+  -e WEBHOOK_URL=http://prometheus.local \
+  ghcr.io/tech1ndex/py-connect-test:latest
+```
+
+### Bypass SSL Validation
+
+```bash
+docker run -d \
+  -e PY_CONNECT_TEST_URL=https://example.com \
+  ghcr.io/tech1ndex/py-connect-test:latest \
+  py-connect-test test --insecure
+```
+
+### Multi-Architecture Support
+
+Available architectures:
+- `amd64`
+- `arm64`
+
+Pull specific architecture:
+
+```bash
+docker pull ghcr.io/tech1ndex/py-connect-test:latest-amd64
+docker pull ghcr.io/tech1ndex/py-connect-test:latest-arm64
+```
+
+## Environment Variables
+
+| Variable              | Description | Default | Required |
+|-----------------------|-------------|---------|----------|
+| `PY_CONNECT_TEST_URL` | URL to test connectivity to | `https://ifconfig.me` | No |
+| `WEBHOOK_URL`         | Webhook URL for alerts | `http://prometheus.local` | No |
+| `PAYLOAD_FILE_PATH`   | Path to JSON payload file for webhooks | `/tmp/payload.json` | No |
+
+
+## Project Structure
+
+```
+py-connect-test/
+├── src/py_connect_test/
+│   ├── main.py                 # CLI entry point
+│   ├── settings.py             # Configuration management
+│   ├── setup_logger.py         # Logger setup
+│   ├── py.typed                # Type hints marker
+│   └── services/
+│       └── http.py             # HTTP service
+├── tests/
+│   ├── conftest.py            # Pytest fixtures
+│   └── services/
+│       └── test_http_service.py # HTTP service tests
+├── pyproject.toml             # Project configuration
+├── Dockerfile                 # Docker configuration
+└── README.md
+```
+

py_connect_test-2.2.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+py_connect_test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+py_connect_test/main.py,sha256=gY3WdeDj_9azk9_uyQruM8vKtPrGK1eqqvf1Qc7XKbU,1073
+py_connect_test/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+py_connect_test/services/http.py,sha256=y5DHG9R6RixJBr_FiXjBQEieE5dy9t8Km-zVFqimtgk,1679
+py_connect_test/settings.py,sha256=mBQ3Pu2LlOJ9oHOiUGoS0gJGt81LTjRLabBMk9ldbOM,336
+py_connect_test/setup_logger.py,sha256=LRfw2ghm1-k2eBMqOpKJpcdm3AZIOCfgc8KikEHVhUc,265
+py_connect_test-2.2.0.dist-info/METADATA,sha256=N6FdpZyJfw2ooZ5n6sKstUxCphLfO9Uj6Um1CX0SaxA,4386
+py_connect_test-2.2.0.dist-info/WHEEL,sha256=EGEvSphFYqXKs23-kQBeyNoJP1nrT8ZJKQoi5p5DYL8,88
+py_connect_test-2.2.0.dist-info/entry_points.txt,sha256=zwYyTMK5baBWaYJfoQCCO2x6fIA0b3e09Rc2X7026kA,60
+py_connect_test-2.2.0.dist-info/RECORD,,

py_connect_test-2.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.4.0
+Root-Is-Purelib: true
+Tag: py3-none-any

py_connect_test-2.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+py_connect_test=py_connect_test.main:app
+