h:pdZddlZddlZddlZddlZddlZddlZejjrddl m Z nddl m Z iZ ejdZd_dZe dZGddeZGd d eZeZej-ed ed ej/ed ej0j2j4gdefdedfdedfdedfdedfdedfdedfdedfdedfded fd!ed"fd#ed$fd%ed&fd'ed(fd)ed*fd+ed,fd-ed&fd.ed/fd0ed1fd2ed3fd4ed3fd5ed3fd6ed3fd7ed3fd8ed9fd:ed;fd<ed;fd=edfd>ed?fd@edAfdBedAfdCedDfdEed$fdFedGfdHed$fdIed$fdJedKfdLedMfdNed(fdOedPfdQedRfdSedfdTedUfdVedWfdXed,fdYedZfd[ed\fd]ed^fZy)`ah Tor versioning information and requirements for its features. These can be easily parsed and compared, for instance... :: >>> from stem.version import get_system_tor_version, Requirement >>> my_version = get_system_tor_version() >>> print(my_version) 0.2.1.30 >>> my_version >= Requirement.TORRC_CONTROL_SOCKET True **Module Overview:** :: get_system_tor_version - gets the version of our system's tor installation Version - Tor versioning information .. data:: Requirement (enum) Enumerations for the version requirements of features. .. deprecated:: 1.6.0 Requirement entries belonging to tor versions which have been obsolete for at least six months will be removed when we break backward compatibility in the 2.x stem release. ===================================== =========== Requirement Description ===================================== =========== **AUTH_SAFECOOKIE** SAFECOOKIE authentication method **DESCRIPTOR_COMPRESSION** `Expanded compression support for ZSTD and LZMA `_ **DORMANT_MODE** **DORMANT** and **ACTIVE** :data:`~stem.Signal` **DROPGUARDS** DROPGUARDS requests **EVENT_AUTHDIR_NEWDESCS** AUTHDIR_NEWDESC events **EVENT_BUILDTIMEOUT_SET** BUILDTIMEOUT_SET events **EVENT_CIRC_MINOR** CIRC_MINOR events **EVENT_CLIENTS_SEEN** CLIENTS_SEEN events **EVENT_CONF_CHANGED** CONF_CHANGED events **EVENT_DESCCHANGED** DESCCHANGED events **EVENT_GUARD** GUARD events **EVENT_HS_DESC_CONTENT** HS_DESC_CONTENT events **EVENT_NETWORK_LIVENESS** NETWORK_LIVENESS events **EVENT_NEWCONSENSUS** NEWCONSENSUS events **EVENT_NS** NS events **EVENT_SIGNAL** SIGNAL events **EVENT_STATUS** STATUS_GENERAL, STATUS_CLIENT, and STATUS_SERVER events **EVENT_STREAM_BW** STREAM_BW events **EVENT_TRANSPORT_LAUNCHED** TRANSPORT_LAUNCHED events **EVENT_CONN_BW** CONN_BW events **EVENT_CIRC_BW** CIRC_BW events **EVENT_CELL_STATS** CELL_STATS events **EVENT_TB_EMPTY** TB_EMPTY events **EVENT_HS_DESC** HS_DESC events **EXTENDCIRCUIT_PATH_OPTIONAL** EXTENDCIRCUIT queries can omit the path if the circuit is zero **FEATURE_EXTENDED_EVENTS** 'EXTENDED_EVENTS' optional feature **FEATURE_VERBOSE_NAMES** 'VERBOSE_NAMES' optional feature **GETINFO_CONFIG_TEXT** 'GETINFO config-text' query **GETINFO_GEOIP_AVAILABLE** 'GETINFO ip-to-country/ipv4-available' query and its ipv6 counterpart **GETINFO_MICRODESCRIPTORS** 'GETINFO md/all' query **GETINFO_UPTIME** 'GETINFO uptime' query **HIDDEN_SERVICE_V3** Support for v3 hidden services **HSFETCH** HSFETCH requests **HSFETCH_V3** HSFETCH for version 3 hidden services **HSPOST** HSPOST requests **ADD_ONION** ADD_ONION and DEL_ONION requests **ADD_ONION_BASIC_AUTH** ADD_ONION supports basic authentication **ADD_ONION_NON_ANONYMOUS** ADD_ONION supports non-anonymous mode **ADD_ONION_MAX_STREAMS** ADD_ONION support for MaxStreamsCloseCircuit **LOADCONF** LOADCONF requests **MICRODESCRIPTOR_IS_DEFAULT** Tor gets microdescriptors by default rather than server descriptors **SAVECONF_FORCE** Added the 'FORCE' flag to SAVECONF **TAKEOWNERSHIP** TAKEOWNERSHIP requests **TORRC_CONTROL_SOCKET** 'ControlSocket ' config option **TORRC_PORT_FORWARDING** 'PortForwarding' config option **TORRC_DISABLE_DEBUGGER_ATTACHMENT** 'DisableDebuggerAttachment' config option **TORRC_VIA_STDIN** Allow torrc options via 'tor -f -' (:trac:`13865`) **ONION_SERVICE_AUTH_ADD** For adding ClientAuthV3 to a v3 onion service via ADD_ONION ===================================== =========== N) lru_cachez=^([0-9]+)\.([0-9]+)\.([0-9]+)(\.[0-9]+)?(-\S*)?(( \(\S*\))*)$cL|tvrd|z} tjjj |}|D]?}|jds|jds' |dd }t|t|<n|tvr td |d d j|t|S#t $rQ}dt |vr4tjj|rd|z}t|d|z}t|d}~wwxYw#t$r}t|d}~wwxYw) a Queries tor for its version. This is os dependent, only working on linux, osx, and bsd. :param str tor_cmd: command used to run tor :returns: :class:`~stem.version.Version` provided by the tor command :raises: **IOError** if unable to query or parse the version z %s --versionzNo such file or directoryz2Unable to check tor's version. '%s' doesn't exist.z1Unable to run '%s'. Maybe tor isn't in your PATH?Nz Tor version . 'z'' didn't provide a parseable version:  ) VERSION_CACHEstemutilsystemcallOSErrorstrospathisabsIOError startswithendswithVersion ValueErrorjoin)tor_cmd version_cmdversion_outputexcline version_strs V/var/www/betterdocs.net/sherlock_api/venv/lib/python3.12/site-packages/stem/version.pyget_system_tor_versionr!ks+ M! 7*K yy'',,[9n   (T]]3-? R +#*;#7-  m#  UYU^U^_mUno pp w 7   %C 0 77== !DwN# CLDkQ# CL *   s0)B-"D - D6A DD D# DD#ct|SN)rrs r _get_versionr%s  c@eZdZdZdZdZdZdZdZdZ dZ d Z y ) ra Comparable tor version. These are constructed from strings that conform to the 'new' style in the `tor version-spec `_, such as "0.1.4" or "0.2.2.23-alpha (git-7dcd105be34a4f44)". .. versionchanged:: 1.6.0 Added all_extra parameter. :var int major: major version :var int minor: minor version :var int micro: micro version :var int patch: patch level (**None** if undefined) :var str status: status tag such as 'alpha' or 'beta-dev' (**None** if undefined) :var str extra: first extra information without its parentheses such as 'git-8be6058d8f31e578' (**None** if undefined) :var list all_extra: all extra information entries, without their parentheses :var str git_commit: git commit id (**None** if it wasn't provided) :param str version_str: version to be parsed :raises: **ValueError** if input isn't a valid tor version cp||_tj|}|r|j\}}}}}}} |rt |dd}|r|dd}t ||_t ||_t ||_||_||_ |r/|jjD cgc]} | dd c} ng|_ |jr|jdnd|_ d|_|jD]'} | stjd| s| dd|_yyt!d|zcc} w)Nrrz^git-[0-9a-f]{16}$z+'%s' isn't a properly formatted tor version)rVERSION_PATTERNmatchgroupsintmajorminormicropatchstatusstripsplit all_extraextra git_commitrer) selfr version_partsr/r0r1r2r3 extra_str_entryr7s r __init__zVersion.__init__s$"D#))+6M9F9M9M9O6eUE5&)Q E!"I u:dju:dju:djdjdkOX1B1H1H1JKa K^`dn(,4>>!$Ddjdo>>% RXX2E:!!"I$/  D{R SSLs/ D3c|jS)z< Provides the string used to construct the version. r$r:s r __str__zVersion.__str__s   r&c t|tsydD]2}t||}t||}|d}|d}||k7s)|||cS|jr |jnd}|jr |jnd}|||S)z: Compares version ordering according to the spec. F)r/r0r1r2r) isinstancergetattrr3)r:othermethodattr my_version other_version my_status other_statuss r _comparezVersion._compares eW % 4 14&jeT*m     } $j-00 1$ ${{ I#(<<5<z Version.__eq__.. Q!Vr&)rNr:rGs r __eq__zVersion.__eq__s == 3 44r&c||k( Sr#rUr[s r __ne__zVersion.__ne__su} r&ct|tr|jD] }||s yy|j|dS)z Checks if this version meets the requirements for a given feature. We can be compared to either a :class:`~stem.version.Version` or :class:`~stem.version._VersionRequirements`. TFc ||kDSr#rUrVs r rYz Version.__gt__..s QUr&rE_VersionRequirementsrulesrNr:rGrules r __gt__zVersion.__gt__sC%-.++$ : == 2 33r&ct|tr|jD] }||s yy|j|dS)NTFc ||k\Sr#rUrVs r rYz Version.__ge__..rZr&rards r __ge__zVersion.__ge__sA%-.++$ : == 3 44r&N) __name__ __module__ __qualname____doc__r?rBrNrRr\r^rfrirUr&r rrs20T@+>b54 5r&rc.eZdZdZdZddZddZddZy) rba Series of version constraints that can be compared to. For instance, this allows for comparisons like 'if I'm greater than version X in the 0.2.2 series, or greater than version Y in the 0.2.3 series'. This is a logical 'or' of the series of rules. cg|_yr#)rcrAs r r?z_VersionRequirements.__init__+s DJr&c|r|jjfdy|jjfdy)z Adds a constraint that we're greater than the given version. :param stem.version.Version version: version we're checking against :param bool inclusive: if comparison is inclusive or not c|kSr#rUvversions r rYz3_VersionRequirements.greater_than..7 'Q,r&c|kSr#rUrrs r rYz3_VersionRequirements.greater_than..9 'A+r&Nrcappendr:rt inclusives ` r greater_thanz!_VersionRequirements.greater_than.. jj./ jj-.r&c|r|jjfdy|jjfdy)z Adds a constraint that we're less than the given version. :param stem.version.Version version: version we're checking against :param bool inclusive: if comparison is inclusive or not c|k\Sr#rUrrs r rYz0_VersionRequirements.less_than..Drur&c|kDSr#rUrrs r rYz0_VersionRequirements.less_than..Frwr&Nrxrzs ` r less_thanz_VersionRequirements.less_than;r}r&cRfd}|jj|y)a Adds constraint that we're within the range from one version to another. :param stem.version.Version from_version: beginning of the comparison range :param stem.version.Version to_version: end of the comparison range :param bool from_inclusive: if comparison is inclusive with the starting version :param bool to_inclusive: if comparison is inclusive with the ending version cprr|cxkxrkScSr|cxkxrkScS|cxkxrkScSr#rU)rsfrom_inclusive from_version to_inclusive to_versions r new_rulez/_VersionRequirements.in_range..new_ruleRsM Lq.J.... q-:----a,*,,,,r&Nrx)r:rrrrrs ```` r in_rangez_VersionRequirements.in_rangeHs- JJhr&N)T)TF)rjrkrlrmr?r|rrrUr&r rbrb"s / / r&rbz0.2.2.36z0.2.3.0z0.2.3.13AUTH_SAFECOOKIEDESCRIPTOR_COMPRESSIONz 0.3.1.1-alpha DORMANT_MODEz 0.4.0.1-alpha DROPGUARDSz 0.2.5.1-alphaEVENT_AUTHDIR_NEWDESCSz0.1.1.10-alphaEVENT_BUILDTIMEOUT_SETz 0.2.2.7-alphaEVENT_CIRC_MINORz0.2.3.11-alphaEVENT_CLIENTS_SEENz0.2.1.10-alphaEVENT_CONF_CHANGEDz 0.2.3.3-alphaEVENT_DESCCHANGEDz 0.1.2.2-alpha EVENT_GUARDz 0.1.2.5-alphaEVENT_HS_DESC_CONTENTz 0.2.7.1-alphaEVENT_NSz 0.1.2.3-alphaEVENT_NETWORK_LIVENESSz 0.2.7.2-alphaEVENT_NEWCONSENSUSz0.2.1.13-alpha EVENT_SIGNALz 0.2.3.1-alpha EVENT_STATUSEVENT_STREAM_BWz 0.1.2.8-betaEVENT_TRANSPORT_LAUNCHEDz 0.2.5.0-alpha EVENT_CONN_BWz 0.2.5.2-alpha EVENT_CIRC_BWEVENT_CELL_STATSEVENT_TB_EMPTY EVENT_HS_DESCEXTENDCIRCUIT_PATH_OPTIONALz0.2.2.9FEATURE_EXTENDED_EVENTSz 0.2.2.1-alphaFEATURE_VERBOSE_NAMESGETINFO_CONFIG_TEXTGETINFO_GEOIP_AVAILABLEz 0.3.2.1-alphaGETINFO_MICRODESCRIPTORSz 0.3.5.1-alphaGETINFO_UPTIMEHIDDEN_SERVICE_V3z 0.3.3.1-alphaHSFETCH HSFETCH_V3z 0.4.1.1-alphaHSPOST ADD_ONIONADD_ONION_BASIC_AUTHz 0.2.9.1-alphaADD_ONION_NON_ANONYMOUSz 0.2.9.3-alphaADD_ONION_MAX_STREAMSLOADCONFz0.2.1.1MICRODESCRIPTOR_IS_DEFAULTz0.2.3.3SAVECONF_FORCE TAKEOWNERSHIPz 0.2.2.28-betaTORRC_CONTROL_SOCKETz0.2.0.30TORRC_PORT_FORWARDING!TORRC_DISABLE_DEBUGGER_ATTACHMENTz0.2.3.9TORRC_VIA_STDINz 0.2.6.3-alphaONION_SERVICE_AUTH_ADDz 0.4.6.1-alpha)tor)rmrr9 stem.prereqr stem.utilstem.util.enumstem.util.systemprereq_is_lru_cache_available functoolsrstem.util.lru_cacher compiler+r!r%objectrrbsafecookie_reqrr|r enumEnum RequirementrUr&r rsRh ;;&&(!+ "**]^, ^  @5f@5F8 68 v&' +WY-?@GJ/0!diinn!!1n%1W_5617?+,1)* 1 W%567 1 W_56 1w/011!1231121011'/*+1GO451w'(1W_561!1231 7?+,!1"7?+,#1$gn-.%1&w78'1(GO,-)1*GO,-+1,w/0-1.W_-./10GO,-112!')"45314go67516GO45718'/2391:go67;1<w78=1>W_-.?1@01A1B go&'C1D)*E1F W_ %&G1H()I1J7?34K1Lgo67M1NGO45O1Pwy!"Q1R !34S1TW_-.U1VGO,-W1X7:./Y1ZGO45[1\' (:;]1^go./_1`W_56a1 r&