env-guard-checker

Lightweight pre-flight checks for Python projects.

Validate environment variables, services, endpoints and files before running your application.

Installation

pip install env-guard-checker

Requires Python 3.9+.

Quick example

envguard init
envguard check

Example output:

ENV VARS
✓ OPENAI_API_KEY present
✗ DATABASE_URL missing

TCP PORTS
✗ PostgreSQL connection refused

Configuration

Create an envguard.yaml file:

name: my-app

env_vars:
  - key: OPENAI_API_KEY
    required: true
    validate: starts_with:sk-

  - key: DATABASE_URL
    required: true
    validate: contains:postgresql

tcp_ports:
  - host: localhost
    port: 5432
    label: PostgreSQL

http_endpoints:
  - url: http://localhost:8000/health
    expect_status: 200

files:
  - path: .env
    type: file

CLI

envguard check
envguard check --hints
envguard check -c custom.yaml
envguard init

Exit codes:

0 → success
1 → failed checks

Use cases

Local development sanity checks
CI validation before deploy
Preventing common misconfiguration issues

Project

Source code: https://github.com/IvanYanishevskyi/env-guard

License

MIT

Metadata

Release files for env-guard-checker 0.1.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for env-guard-checker 0.1.8
File	Size	Uploaded
env_guard_checker-0.1.8.tar.gz	5.6 kB	Mar 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for env-guard-checker 0.1.8
File	Interpreter	ABI	Platform	Reset
env_guard_checker-0.1.8-py3-none-any.whl 5.7 kB Mar 29, 2026	Python 3	none	any	Details

Total release size: 11.3 kB

Release files / env_guard_checker-0.1.8.tar.gz

Download URL	env_guard_checker-0.1.8.tar.gz
Size	5.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`55fd967a9c21b1470b7a99ec304774440c30c4e057627b09d33f75ea4cb17404`
BLAKE2b-256 checksum How to use checksums	`2af59beb60bf2b27730bfb62629729006dd8b9803652e26673978a96ff69c642`
Upload date	Mar 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.6`

Release files / env_guard_checker-0.1.8-py3-none-any.whl

Download URL	env_guard_checker-0.1.8-py3-none-any.whl
Size	5.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7530825daac65d6e8e686883242964e2268341d49b35dac046ac0e5e2074e8e2`
BLAKE2b-256 checksum How to use checksums	`cf69c01ff83c2f293ff379d1f8f030e355284dd71f77cb3b791336e5c64219c8`
Upload date	Mar 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.6`