Ef dZddlmZmZmZmZddlZededsdZ e Z e Z ndZ e Z eZ dZeZej$d kDr ed ned d ZGd deZdZy)aMiscellaneous utility functions and classes. This module is used internally by Tornado. It is not necessarily expected that the functions and classes defined here will be useful to other applications, but they are documented here in case they are. The one public-facing part of this module is the `Configurable` class and its `~Configurable.configure` method, which becomes a part of the interface of its subclasses, including `.AsyncHTTPClient`, `.IOLoop`, and `.Resolver`. )absolute_importdivisionprint_functionwith_statementNc|SNss @/usr/lib/python3/dist-packages/zmq/eventloop/minitornado/util.pyursrc$|jdS)Nunicode_escape)decoder s rrrsxx())rcft|trttur|jd}|j ddk(r t |ddS|j d}t dj|dddd|dgd} t||dS#t$rtd|dzwxYw)a Imports an object by name. import_object('x') is equivalent to 'import x'. import_object('x.y.z') is equivalent to 'from x.y import z'. >>> import tornado.escape >>> import_object('tornado.escape') is tornado.escape True >>> import_object('tornado.escape.utf8') is tornado.escape.utf8 True >>> import_object('tornado') is tornado True >>> import_object('tornado.missing_module') Traceback (most recent call last): ... ImportError: No module named missing_module zutf-8.rNzNo module named %s) isinstance unicode_typestrencodecount __import__splitjoingetattrAttributeError ImportError)namepartsobjs r import_objectr$%s$$ %#\*A{{7# zz#!$d++ JJsOE SXXeCRj)4b {A FC<sE"I&& <.r:;;', 'exec', dont_inherit=True) exec(code, glob, loc) ah def raise_exc_info(exc_info): raise exc_info[0], exc_info[1], exc_info[2] def exec_in(code, glob, loc=None): if isinstance(code, basestring): # exec(string) inherits the caller's future imports; compile # the string first to prevent that. code = compile(code, '', 'exec', dont_inherit=True) exec code in glob, loc cjt|dr |jS|jr|jdSy)aLProvides the errno from an Exception object. There are cases that the errno attribute was not set so we pull the errno out of the args but if someone instantiates an Exception without any args you will get a tuple error. So this function abstracts all that behavior to give you a safe way to get the errno. errnorN)hasattrr'args)es rerrno_from_exceptionr+as/q'ww vvayrceZdZdZdZdZfdZedZedZ dZ edZ edZ ed Z ed ZxZS) ConfigurableaBase class for configurable interfaces. A configurable interface is an (abstract) class whose constructor acts as a factory function for one of its implementation subclasses. The implementation subclass as well as optional keyword arguments to its initializer can be set globally at runtime with `configure`. By using the constructor as the factory method, the interface looks like a normal class, `isinstance` works as usual, etc. This pattern is most useful when the choice of implementation is likely to be a global decision (e.g. when `~select.epoll` is available, always use it instead of `~select.select`), or when a previously-monolithic class has been split into specialized subclasses. Configurable subclasses must define the class methods `configurable_base` and `configurable_default`, and use the instance method `initialize` instead of ``__init__``. Nc|j}i}||ur8|j}|jr|j|jn|}|j|tt ||}|j|i||Sr )configurable_baseconfigured_class_Configurable__impl_kwargsupdatesuperr-__new__ initialize)clsr)kwargsbase init_kwargsimplinstance __class__s rr4zConfigurable.__new__s$$& $;'')D!!""4#5#56D6"s3D9 T1[1rct)zReturns the base class of a configurable hierarchy. This will normally return the class in which it is defined. (which is *not* necessarily the same as the cls classmethod parameter). NotImplementedErrorr6s rr/zConfigurable.configurable_bases "##rct)zBReturns the implementation class to be used if none is configured.r>r@s rconfigurable_defaultz!Configurable.configurable_defaults "##rcy)zInitialize a `Configurable` subclass instance. Configurable classes should use `initialize` instead of ``__init__``. .. versionchanged:: 4.2 Now accepts positional arguments in addition to keyword arguments. Nr )selfs rr5zConfigurable.initializesrc |j}t|ttfr t |}|t ||st d|z||_||_y)zSets the class to use when the base class is instantiated. Keyword arguments will be saved and added to the arguments passed to the constructor. This can be used to set global defaults for some parameters. NzInvalid subclass of %s) r/rrbytesr$ issubclass ValueError_Configurable__impl_classr1)r6r:r7r8s r configurezConfigurable.configures[$$& d\51 2 &D  JtS$95;< < #rc||j}|j|j|_|jS)z'Returns the currently configured class.)r/rIrBr6r8s rr0zConfigurable.configured_classs;$$&    # # 8 8 :D    rcR|j}|j|jfSr r/rIr1rLs r_save_configurationz Configurable._save_configurations'$$&!!4#5#566rcL|j}|d|_|d|_y)NrrN)r6savedr8s r_restore_configurationz#Configurable._restore_configurations($$&!!H"1Xr)__name__ __module__ __qualname____doc__rIr1r4 classmethodr/rBr5rJr0rOrS __classcell__)r<s@rr-r-ss&LM"$$$$  $ $!!77&&rr-cx|j|j|jdzdzzdzztdz S)zrls QP #tBx LO*L O