D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
proc
/
self
/
root
/
opt
/
saltstack
/
salt
/
lib
/
python3.10
/
site-packages
/
portend-2.4.dist-info
/
Filename :
METADATA
back
Copy
Metadata-Version: 2.1 Name: portend Version: 2.4 Summary: TCP port monitoring and discovery Home-page: https://github.com/jaraco/portend Author: Jason R. Coombs Author-email: jaraco@jaraco.com Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: License :: OSI Approved :: MIT License Classifier: Programming Language :: Python :: 2.7 Classifier: Programming Language :: Python :: 3 Requires-Python: >=2.7 License-File: LICENSE Requires-Dist: tempora >=1.8 Provides-Extra: docs Requires-Dist: sphinx ; extra == 'docs' Requires-Dist: jaraco.packaging >=3.2 ; extra == 'docs' Requires-Dist: rst.linker >=1.9 ; extra == 'docs' Provides-Extra: testing Requires-Dist: pytest !=3.7.3,>=3.5 ; extra == 'testing' Requires-Dist: pytest-checkdocs ; extra == 'testing' Requires-Dist: pytest-flake8 ; extra == 'testing' .. image:: https://img.shields.io/pypi/v/portend.svg :target: https://pypi.org/project/portend .. image:: https://img.shields.io/pypi/pyversions/portend.svg .. image:: https://img.shields.io/travis/jaraco/portend/master.svg :target: https://travis-ci.org/jaraco/portend .. image:: https://img.shields.io/appveyor/ci/jaraco/portend/master.svg :target: https://ci.appveyor.com/project/jaraco/portend/branch/master .. image:: https://readthedocs.org/projects/portend/badge/?version=latest :target: https://portend.readthedocs.io/en/latest/?badge=latest por·tend pôrˈtend/ verb be a sign or warning that (something, especially something momentous or calamitous) is likely to happen. Usage ===== Use portend to monitor TCP ports for bound or unbound states. For example, to wait for a port to be occupied, timing out after 3 seconds:: portend.occupied('www.google.com', 80, timeout=3) Or to wait for a port to be free, timing out after 5 seconds:: portend.free('::1', 80, timeout=5) The portend may also be executed directly. If the function succeeds, it returns nothing and exits with a status of 0. If it fails, it prints a message and exits with a status of 1. For example:: python -m portend localhost:31923 free (exits immediately) python -m portend -t 1 localhost:31923 occupied (one second passes) Port 31923 not bound on localhost. Portend also exposes a ``find_available_local_port`` for identifying a suitable port for binding locally:: port = portend.find_available_local_port() print(port, "is available for binding") Portend additionally exposes the lower-level port checking functionality in the ``Checker`` class, which currently exposes only one public method, ``assert_free``:: portend.Checker().assert_free('localhost', 31923) If assert_free is passed a host/port combination that is occupied by a bound listener (i.e. a TCP connection is established to that host/port), assert_free will raise a ``PortNotFree`` exception.