o yK™]qã@s|dZddlZddlZe d¡Ze d¡Ze d¡Ze d¡Zddd „Z d d „Z d d „Z dd„Z dd„Z ddd„Zdd„ZdS)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}$FcCs`t|tƒr tjj |¡}z|r |r|ddkrWdS|dd…}t|dƒWSty/YdSw)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ú$FéNé()Ú isinstanceÚbytesÚstemÚutilÚ str_toolsÚ _to_unicodeÚ is_hex_digitsÚ TypeError)ÚentryZ check_prefix©rú5/usr/lib/python3/dist-packages/stem/util/tor_tools.pyÚis_valid_fingerprint0s    ÿrcCó>t|tƒr tjj |¡}ztt |¡ƒWSt yYdSw)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) rrrrr r ÚboolÚNICKNAME_PATTERNÚmatchr ©r rrrÚis_valid_nicknameKs  ÿrcCr)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) rrrrr r rÚCIRC_ID_PATTERNrr rrrrÚis_valid_circuit_id]s  ÿrcCót|ƒ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 ©rrrrrÚis_valid_stream_idmórcCr)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 rrrrrÚis_valid_connection_idxrrcCs¬t|tƒr tjj |¡}|durd}nt|tƒr|g}nt|ttfƒs,t dt |ƒj ƒ‚zd|vr;t t  |¡ƒr;WdSd|vrIt t |¡ƒrIWdSWdStyUYdSw)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 N)ééz;Hidden service version must be an integer or list, not a %srTrF)rrrrr r ÚintÚlistÚtupleÚ ValueErrorÚtypeÚ__name__rÚHS_V2_ADDRESS_PATTERNrÚHS_V3_ADDRESS_PATTERNr )r ÚversionrrrÚis_valid_hidden_service_addressƒs"   ÿr)c Cs<zt|ƒ|kr WdSt|dƒWdSttfyYdSw)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 FéT)Úlenr r#r )r Úcountrrrr ©s  ÿr )F)N)Ú__doc__ÚreZstem.util.str_toolsrÚcompilerrr&r'rrrrrr)r rrrrÚs      &