o ֬^9@s dZddlZddlZddlZddlZddlZddlZej r&ddl m Z nddl m Z iZ edZd`ddZe dd ZGd d d eZGd d d eZeZeededeedejjjgdefdedfdedfdedfdedfdedfdedfdedfd ed!fd"ed#fd$ed%fd&ed'fd(ed)fd*ed+fd,ed-fd.ed/fd0ed)fd1ed2fd3ed4fd5ed6fd7ed6fd8ed6fd9ed6fd:ed6fd;ed<fd=ed>fd?ed>fd@edfdAedBfdCedDfdEedDfdFedGfdHed'fdIedJfdKed'fdLed'fdMedNfdOedPfdQed+fdRedSfdTedUfdVedfdWedXfdYedZfd[ed/fd\ed]fd^ed_fRZdS)aa 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`) ===================================== =========== N) lru_cachez=^([0-9]+)\.([0-9]+)\.([0-9]+)(\.[0-9]+)?(-\S*)?(( \(\S*\))*)$torc Cs|tvrxd|}z tjj|}Wn(ty9}zdt|vr1tj |r-d|}t |d|}t |d}~ww|D],}| drh| drhz|dd }t |t|<Wntyg}zt |d}~wwq<|tvrxt d |d |ft|S) 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,'%s' didn't provide a parseable version: %s ) VERSION_CACHEstemutilsystemcallOSErrorstrospathisabsIOError startswithendswithVersion ValueErrorjoin)Ztor_cmdZ version_cmdZversion_outputexcline version_strr./usr/lib/python3/dist-packages/stem/version.pyget_system_tor_versionjs6      rcCst|SN)rrrrr _get_versionsr c@sPeZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ dS)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 c Cs||_t|}|rt|\}}}}}}} |rt|dd}|r'|dd}t||_t||_t||_||_||_ |rIdd| Dng|_ |j rT|j dnd|_ d|_|j D]} | rqtd| rq| dd|_dSq]dStd|)NcSsg|]}|ddqS)r!rr).0entryrrr sz$Version.__init__..rz^git-[0-9a-f]{16}$z+'%s' isn't a properly formatted tor version)rVERSION_PATTERNmatchgroupsintmajorminormicropatchstatusstripsplitZ all_extraextraZ git_commitrer) selfrZ version_partsr*r+r,r-r.Z extra_str_r1rrr__init__s.        zVersion.__init__cCs|jS)z< Provides the string used to construct the version. rr3rrr__str__szVersion.__str__cCst|tsdSdD]#}t||}t||}|durd}|dur!d}||kr,|||Sq |jr3|jnd}|jr;|jnd}|||S)z: Compares version ordering according to the spec. F)r*r+r,r-Nr) isinstancergetattrr.)r3othermethodattrZ my_versionZ other_versionZ my_statusZ other_statusrrr_compares    zVersion._comparec Cstjj|dddddddS)Nr*r+r,r-r.T)cache)r r Z _hash_attrr6rrr__hash__szVersion.__hash__cCs||ddS)NcSs||kSrrsorrrz Version.__eq__..)r>r3r;rrr__eq__szVersion.__eq__cCs ||k SrrrFrrr__ne__ zVersion.__ne__cC8t|tr|jD] }||rdSqdS||ddS)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`. TFcSs||kSrrrArrrrDrEz Version.__gt__..r9_VersionRequirementsrulesr>r3r;Zrulerrr__gt__s  zVersion.__gt__cCrJ)NTFcSs||kSrrrArrrrDrEz Version.__ge__..rKrNrrr__ge__s  zVersion.__ge__N) __name__ __module__ __qualname____doc__r5r7r>r@rGrHrOrPrrrrrs  rc@s6eZdZdZddZd ddZd ddZdd d Zd S)rLa 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. cCs g|_dSr)rMr6rrrr5*rIz_VersionRequirements.__init__Tc4|r|jfdddS|jfdddS)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 cs|kSrrvversionrrrD6rEz3_VersionRequirements.greater_than..cs|kSrrrVrXrrrD8rENrMappendr3rYZ inclusiverrXr greater_than-z!_VersionRequirements.greater_thancrU)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 cs|kSrrrVrXrrrDCrEz0_VersionRequirements.less_than..cs|kSrrrVrXrrrDErENrZr\rrXr less_than:r^z_VersionRequirements.less_thanFcs"fdd}|j|dS)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 csTrr|ko kSSr|kokSS|ko'kSSrrrVfrom_inclusive from_version to_inclusive to_versionrrnew_ruleQs z/_VersionRequirements.in_range..new_ruleNrZ)r3rbrdrarcrerr`rin_rangeGs z_VersionRequirements.in_rangeN)T)TF)rQrRrSrTr5r]r_rfrrrrrL!s    rLz0.2.2.36z0.2.3.0z0.2.3.13ZAUTH_SAFECOOKIEZDESCRIPTOR_COMPRESSIONz 0.3.1.1-alphaZ DORMANT_MODEz 0.4.0.1-alphaZ DROPGUARDSz 0.2.5.1-alphaZEVENT_AUTHDIR_NEWDESCSz0.1.1.10-alphaZEVENT_BUILDTIMEOUT_SETz 0.2.2.7-alphaZEVENT_CIRC_MINORz0.2.3.11-alphaZEVENT_CLIENTS_SEENz0.2.1.10-alphaZEVENT_CONF_CHANGEDz 0.2.3.3-alphaZEVENT_DESCCHANGEDz 0.1.2.2-alphaZ EVENT_GUARDz 0.1.2.5-alphaZEVENT_HS_DESC_CONTENTz 0.2.7.1-alphaZEVENT_NSz 0.1.2.3-alphaZEVENT_NETWORK_LIVENESSz 0.2.7.2-alphaZEVENT_NEWCONSENSUSz0.2.1.13-alphaZ EVENT_SIGNALz 0.2.3.1-alphaZ EVENT_STATUSZEVENT_STREAM_BWz 0.1.2.8-betaZEVENT_TRANSPORT_LAUNCHEDz 0.2.5.0-alphaZ EVENT_CONN_BWz 0.2.5.2-alphaZ EVENT_CIRC_BWZEVENT_CELL_STATSZEVENT_TB_EMPTYZ EVENT_HS_DESCZEXTENDCIRCUIT_PATH_OPTIONALz0.2.2.9ZFEATURE_EXTENDED_EVENTSz 0.2.2.1-alphaZFEATURE_VERBOSE_NAMESZGETINFO_CONFIG_TEXTZGETINFO_GEOIP_AVAILABLEz 0.3.2.1-alphaZGETINFO_MICRODESCRIPTORSz 0.3.5.1-alphaZGETINFO_UPTIMEZHIDDEN_SERVICE_V3z 0.3.3.1-alphaZHSFETCHZ HSFETCH_V3z 0.4.1.1-alphaZHSPOSTZ ADD_ONIONZADD_ONION_BASIC_AUTHz 0.2.9.1-alphaZADD_ONION_NON_ANONYMOUSz 0.2.9.3-alphaZADD_ONION_MAX_STREAMSZLOADCONFz0.2.1.1ZMICRODESCRIPTOR_IS_DEFAULTz0.2.3.3ZSAVECONF_FORCEZ TAKEOWNERSHIPz 0.2.2.28-betaZTORRC_CONTROL_SOCKETz0.2.0.30ZTORRC_PORT_FORWARDINGZ!TORRC_DISABLE_DEBUGGER_ATTACHMENTz0.2.3.9ZTORRC_VIA_STDINz 0.2.6.3-alpha)r)rTrr2Z stem.prereqr Z stem.utilZstem.util.enumZstem.util.systemZprereqZ_is_lru_cache_available functoolsrZstem.util.lru_cachercompiler&rr objectrrLZsafecookie_reqrfr]r enumEnumZ RequirementrrrrsS    / ;                                 ! " # $ % & ' ( ) * + , - . /