hqdZddlZddlZejdZejdZejdZejdZddZ dZ d Z d Z d Z dd Zd Zy)an Miscellaneous utility functions for working with tor. .. versionadded:: 1.2.0 **Module Overview:** :: is_valid_fingerprint - checks if a string is a valid tor relay fingerprint is_valid_nickname - checks if a string is a valid tor relay nickname is_valid_circuit_id - checks if a string is a valid tor circuit id is_valid_stream_id - checks if a string is a valid tor stream id is_valid_connection_id - checks if a string is a valid tor connection id is_valid_hidden_service_address - checks if a string is a valid hidden service address is_hex_digits - checks if a string is only made up of hex digits Nz^[a-zA-Z0-9]{1,19}$z^[a-zA-Z0-9]{1,16}$z^[a-z2-7]{16}$z^[a-z2-7]{56}$ct|tr)tjjj |} |r|r|ddk7ry|dd}t |dS#t$rYywxYw)a_ Checks if a string is a properly formatted relay fingerprint. This checks for a '$' prefix if check_prefix is true, otherwise this only validates the hex digits. :param str entry: string to be checked :param bool check_prefix: checks for a '$' prefix :returns: **True** if the string could be a relay fingerprint, **False** otherwise r$FN() isinstancebytesstemutil str_tools _to_unicode is_hex_digits TypeError)entry check_prefixs ]/var/www/betterdocs.net/sherlock_api/venv/lib/python3.12/site-packages/stem/util/tor_tools.pyis_valid_fingerprintr0sju II   + +E 2E  eAh#oABie  ##  s AA A%$A%ct|tr)tjjj |} t tj|S#t$rYywxYw)z Checks if a string is a valid format for being a nickname. :param str entry: string to be checked :returns: **True** if the string could be a nickname, **False** otherwise F) rrr r r r boolNICKNAME_PATTERNmatchrrs ris_valid_nicknamerKsVu II   + +E 2E  &&u- ..  A A%$A%ct|tr)tjjj |} t tj|S#t$rYywxYw)z Checks if a string is a valid format for being a circuit identifier. :returns: **True** if the string could be a circuit id, **False** otherwise F) rrr r r r rCIRC_ID_PATTERNrrrs ris_valid_circuit_idr]sUu II   + +E 2E %%e, --  rct|S)z Checks if a string is a valid format for being a stream identifier. Currently, this is just an alias to :func:`~stem.util.tor_tools.is_valid_circuit_id`. :returns: **True** if the string could be a stream id, **False** otherwise rrs ris_valid_stream_idrm U ##ct|S)z Checks if a string is a valid format for being a connection identifier. Currently, this is just an alias to :func:`~stem.util.tor_tools.is_valid_circuit_id`. :returns: **True** if the string could be a connection id, **False** otherwise rrs ris_valid_connection_idr#xr r!ct|tr)tjjj |}|d}nKt|t r|g}n7t|ttfs!tdt|jz d|vrttj|ryd|vrttj|ryy#t $rYywxYw)a Checks if a string is a valid format for being a hidden service address (not including the '.onion' suffix). .. versionchanged:: 1.8.0 Added the **version** argument, and responds with **True** if a version 3 hidden service address rather than just version 2 addresses. :param int,list version: versions to check for, if unspecified either v2 or v3 hidden service address will provide **True** :returns: **True** if the string could be a hidden service address, **False** otherwise )z;Hidden service version must be an integer or list, not a %sr%Tr&F)rrr r r r intlisttuple ValueErrortype__name__rHS_V2_ADDRESS_PATTERNrHS_V3_ADDRESS_PATTERNr)rversions ris_valid_hidden_service_addressr0s u II   + +E 2E _G'3iG ge} - RUYZaUbUkUkk ll G|288?@ G|288?@    s "C."C CCcf t||k7ryt|dy#ttf$rYywxYw)a# Checks if a string is the given number of hex digits. Digits represented by letters are case insensitive. :param str entry: string to be checked :param int count: number of hex digits to be checked for :returns: **True** if the given number of hex digits, **False** otherwise FT)lenr'r*r)rcounts rr r s9 5zU rN  i  s 00)F)N)__doc__restem.util.str_toolsr compilerrr-r.rrrrr#r0r r!rr:s$ 2::34"**23# #34" #346$  $$#Lr!