{"categories":[{"label":"Monitoring","url":"https://skillfed.io/packages/category/system-monitoring/3"}],"enrichment":{"capability":"Portend monitors TCP ports to check whether they are bound (occupied) or free, and can find available local ports for binding.","skillfed_tags":["port-monitoring","tcp-utilities","test-infrastructure"],"use_cases":["Wait for a service to start up in integration tests before running test suites that depend on it","Find an available local port to bind a test server without port conflicts","Verify port availability in deployment or orchestration scripts before starting a service","Monitor a remote port (e.g., a database or API server) to detect when it becomes available after a restart","Implement health checks in CI/CD pipelines that need to confirm a service is listening before proceeding"],"what_it_does":"Portend is a lightweight TCP port monitoring library that lets you wait for a port to become occupied (bound by a listener) or free (unbound), with configurable timeouts. It's commonly used in test setup, service orchestration, and deployment scripts where you need to verify that a service has started or that a port is available before binding to it.\n\nThe package provides a simple API with two main functions\u2014`occupied()` and `free()`\u2014plus utilities like `find_available_local_port()` to discover an unused port and a lower-level `Checker` class for more direct control. It can also be invoked as a command-line tool via `python -m portend`, making it useful in shell scripts and CI/CD pipelines. The only runtime dependency is tempora, keeping the installation footprint minimal.","worth_installing":"Yes. Portend solves a common, specific problem (TCP port state checking) with a minimal dependency footprint, active maintenance, no known vulnerabilities, and a permissive license. It's well-suited for test automation, service orchestration, and deployment workflows. Install it if you need to wait for ports or discover available ones in Python or shell scripts."},"id":"portend","links":{"html":"https://skillfed.io/packages/portend","md":"https://skillfed.io/packages/portend.md","pypi":"https://pypi.org/project/portend/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2025-05-29","license_spdx":"MIT","license_treatment":"permissive","name":"portend","python_support":"supports_current","summary":"TCP port monitoring and discovery"},"popularity":{"monthly_downloads":889978,"position":4806,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"3.2.1"}