\"S?54PS@\"SA54PSB\"SA54PSC\"SD54PSE\"S$54PSF\"SG54PSH\"S$54PSI\"S$54PSJ\"SK54PSL\"SM54PSN\"S(54PSO\"SP54PSQ\"SR54PSS\"S54PST\"SU54PSV\"SW54PSX\"S,54PSY\"SZ54PS[\"S\54PS]\"S^54P76rg)`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*\))*)$cpU[;aSU-n[RRR U5nUHKnURS5(dMURS5(dM3USS n[U5[U' O U[;a"[S U<S S RU5<35e[U$![ aNnS[ U5;a/[RRU5(aSU-nOSU-n[U5eSnAff=f![an[U5eSnAff=f) 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 F/home/james-whalen/.local/lib/python3.13/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#CkQ# CL *   s0)C0D D A DD D5% D00D5c[U5$N)rrs r _get_versionr%s  cH\rSrSrSrSrSrSrSrSr Sr S r S r S r g ) 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 cXl[RU5nU(Ga$UR5up4pVpxn U(a[ USS5nU(aUSSn[ U5Ul[ U5Ul[ U5UlX`lXpl U(a1UR5R5V s/sHoSSPM sn O/Ul UR(aURSOSUl SUlURH4n U (dM [R"SU 5(dM*U SSUl g g[!SU-5es sn f)Nrrz^git-[0-9a-f]{16}$z+'%s' isn't a properly formatted tor version)rVERSION_PATTERNmatchgroupsintmajorminormicropatchstatusstripsplit all_extraextra git_commitrer) selfr version_partsr0r1r2r3r4 extra_str_entryr8s r __init__Version.__init__s"#))+6M9F9M9M9O6eE&Q E!"I u:dju:dju:djjkOX1B1H1H1JK1Ja 1JK^`dn(,4>>!$Ddjdo>>% 5RXX2E::!!"I$/ " D{R SSLs=EcUR$)z4 Provides the string used to construct the version. r$r;s r __str__Version.__str__s   r&c*[U[5(dgSH2n[X5n[X5nUcSnUcSnXE:wdM*U"XE5s $ UR(a UROSnUR(a UROSnU"Xg5$)z2 Compares version ordering according to the spec. F)r0r1r2r3r) isinstancergetattrr4)r;othermethodattr my_version other_version my_status other_statuss r _compareVersion._compares eW % % 44&je*m      $j005$ ${{ I#(<<5< Version.__eq__..QVr&)rQr;rJs r __eq__Version.__eq__s == 3 44r&c X:X+$r#rZras r __ne__Version.__ne__s  r&c[U[5(a#URHnU"U5(dM g gURUS5$)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 X:$r#rZr[s r r^ Version.__gt__..sQUr&rH_VersionRequirementsrulesrQr;rJrules r __gt__Version.__gt__sC%-..++$ :: == 2 33r&c[U[5(a#URHnU"U5(dM g gURUS5$)NTFc X:$r#rZr[s r r^ Version.__ge__..r`r&rjrms r __ge__Version.__ge__sA%-..++$ :: == 3 44r&) r7r8r9r0r2r1r3r4rN)__name__ __module__ __qualname____firstlineno____doc__r@rDrQrVrbrerort__static_attributes__rZr&r rrs20T@+>b54 5r&rc<\rSrSrSrSrS SjrS SjrS SjrSr g) rki"z 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. c/Ulgr#rlrCs r r@_VersionRequirements.__init__+s DJr&c^U(a URRU4Sj5 gURRU4Sj5 g)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>TU:*$r#rZvversions r r^3_VersionRequirements.greater_than..7 'Q,r&c>TU:$r#rZrs r r^r9 'A+r&Nrlappendr;r inclusives ` r greater_than!_VersionRequirements.greater_than.. jj./ jj-.r&c^U(a URRU4Sj5 gURRU4Sj5 g)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>TU:$r#rZrs r r^0_VersionRequirements.less_than..Drr&c>TU:$r#rZrs r r^rFrr&Nrrs ` r less_than_VersionRequirements.less_than;rr&cT^^^^UUUU4SjnURRU5 g)ay 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 c>T(aT(aTUs=:*=(a T:*$s $T(aTUs=:*=(a T:$s $TUs=:=(a T:$s $r#rZ)rfrom_inclusive from_version to_inclusive to_versions r new_rule/_VersionRequirements.in_range..new_ruleRsV Lq..J.... q--:----a,,*,,,,r&Nr)r;rrrrrs ```` r in_range_VersionRequirements.in_rangeHs!-- JJhr&r~N)T)TF) rvrwrxryrzr@rrrr{rZr&r rkrk"s / / r&rkz0.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)rzrr: stem.prereqr stem.utilstem.util.enumstem.util.systemprereq_is_lru_cache_available functoolsrstem.util.lru_cacher compiler,r!r%objectrrksafecookie_reqrrr enumEnum RequirementrZr&r rsRh ;;&&((!+ **]^, ^  @5f@5F8 68 v&' +WY-?@GJ/0iinn!!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&