\jdUdZddlmZgdZddlZddlZddlmZm Z m Z ddl m Z ddlmZmZdd lmZmZmZmZmZmZm Z mZmZdd lmZmZdd lmZeege fZ dZ!d e"d <ejFjIdrddl%m Z!dZ&d e"d<ejFjIdrddl'm Z&e(e)de&e!e fZ*de"d<dZ+GddZ,de"d< ejZZ.ddZ/ddZ0ddZ1ddZ2d dZ3y)!aThe package provides top-level helpers which use a lazily initialised default parser. These are convenience functions, for more control it is perfectly acceptable to instantiate and call parsers directly. The default parser does use a cache keyed on the user-agent string, but its exact behaviour is unspecified, if you require a consistent behaviour or specific algorithm, set up your own parser (global or not). For convenience, direct aliases are also provided for: - :mod:`core types <.types>` - :mod:`caching utilities <.caching>` - :mod:`ua_parser.basic.Parser` as :class:`BasicParser` This way importing anything but the top-level package should not be necessary unless you want to *implement* a parser. ) annotations)OS BasicResolverCacheCachingResolverDefaultedResultDeviceDomainMatchers PartialResultResolverResult UserAgent load_builtinsload_lazy_builtinsparse parse_deviceparse_osparse_user_agentN)CallableOptionalcast)r )rS3Fifo) rr r r rr r rr)rr)IS_GRAALzOptional[_ResolverCtor] Re2Resolverre2 RegexResolver ua_parser_rs _ResolverCtorBestAvailableResolver)rrcReZdZdZed dZd dZd dZd dZddZ ddZ ddZ y )Parserz^Wrapper object, provides convenience methods around an underlying :class:`Resolver`. cJ|tt|tdS)zfrom_matchers(Matchers) -> Parser Instantiates a parser from the provided :class:`~ua_parser.core.Matchers` using the default resolver stack. i)rr!r)clsms ` resolved (whether to success or failure). r,)r.uadomainss r(__call__zParser.__call__bs }}R))r*cL||tjjS)z+Convenience method for parsing all domains.)r ALLcompleter.r1s r(rz Parser.parseisB #,,..r*cD||tjjS)z=Convenience method for parsing the :class:`UserAgent` domain.)r USER_AGENT user_agentr7s r(rzParser.parse_user_agentmsB))*555r*cD||tjjS)z6Convenience method for parsing the :class:`OS` domain.)r rosr7s r(rzParser.parse_osqsB "%%%r*cD||tjjS)z:Convenience method for parsing the :class:`Device` domain.)r DEVICEdevicer7s r(rzParser.parse_deviceusB &---r*N)r'r returnr$)r-r r@None)r1strr2r r@r )r.r r1rBr@r)r.r r1rBr@Optional[UserAgent])r.r r1rBr@ Optional[OS])r.r r1rBr@Optional[Device]) __name__ __module__ __qualname____doc__ classmethodr)r/r3rrrrr*r(r$r$Ns; KK!*/6&.r*r$parserclt5|dk(rtjdx}rtt|cdddSt s t str t}n t}tj|a tcdddS dddtdtd|#1swYxYw)NrLzmodule z has no attribute )_lazy_globals_lockglobalsgetrr$rrrrrr)rLAttributeErrorrF)namepmatcherss r( __getattr__rUs  8  IMM(++q+FA x-/(?))(3F  78,.@I JJ!s0B*AB**B3cXddlm}||tjj S)aParses the :class:`.UserAgent`, :class:`.OS`, and :class:`.Device` information using the :data:`global parser `. Equivalent to calling each of :func:`parse_user_agent`, :func:`parse_os`, and :func:`parse_device` but *may* be more efficient than calling them separately depending on the underlying parser. Even in the best case, prefer the domain-specific helpers if you're not going to use *all* of them. rrL)rLr r5r6r1rLs r(rrs! "fjj ! * * ,,r*cPddlm}||tjjS)zgParses the :class:`browser <.UserAgent>` information using the :data:`global parser `. rrW)rXrLr r9r:rYs r(rrs  "f'' ( 3 33r*cPddlm}||tjjS)zVParses the :class:`.OS` information using the :data:`global parser `. rrW)rXrLr rr<rYs r(rrs "fii # ##r*cPddlm}||tjjS)zZParses the :class:`.Device` information using the :data:`global parser `. rrW)rXrLr r>r?rYs r(rrs "fmm $ + ++r*)rRrBr@r$)r1rBr@r)r1rBr@rC)r1rBr@rD)r1rBr@rE)4rI __future__r__all__importlib.util importlib threadingtypingrrrbasicr rcachingrrrcorerr r r rr rrloadersrrutilsrr r__annotations__util find_specrrregexnextfilterr!VERSIONr$LockrNrUrrrrrKr*r(rps&# *++,5   7(X-. '+ $+ >>E",)- &- >>N+0'+ 4-m<=(} ).).X $Y^^%K*-&4$,r*