ó mÜJ]c@`sdZddlmZmZmZmZddlZejeƒZ ddl m Z d Z d „Z d „Zd „Zd „ZdS(uc Provide some utility functions useful for implementing different components in ``bokeh.server``. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tnetutilu bind_socketsucheck_whitelistucreate_hosts_whitelistu match_hostcC`stjd|pdd|ƒ}t|ƒs0t‚d„|Dƒ}t|ƒdks^tdƒ‚|jƒ}|r…||ks…t‚n||fS(uô Bind a socket to a port on an address. Args: address (str) : An address to bind a port on, e.g. ``"localhost"`` port (int) : A port number to bind. Pass 0 to have the OS automatically choose a free port. This function returns a 2-tuple with the new socket as the first element, and the port that was bound as the second. (Useful when passing 0 as a port number to bind any free port.) Returns: (socket, port) tportitaddresscS`s h|]}|jƒd’qS(i(t getsockname(t.0ts((s0lib/python2.7/site-packages/bokeh/server/util.pys Ds iuMultiple ports assigned??(Rt bind_socketstlentAssertionErrortpop(RRtsstportst actual_port((s0lib/python2.7/site-packages/bokeh/server/util.pyR .s c`sCdˆkrˆd‰nˆ|kr)tSt‡fd†|DƒƒS(u¸ Check a given request host against a whitelist. Args: host (str) : A host string to compare against a whitelist. If the host does not specify a port, then ``":80"`` is implicitly assumed. whitelist (seq[str]) : A list of host patterns to match against Returns: ``True``, if ``host`` matches any pattern in ``whitelist``, otherwise ``False`` u:u:80c3`s|]}tˆ|ƒVqdS(N(t match_host(Rtpattern(thost(s0lib/python2.7/site-packages/bokeh/server/util.pys cs(tTruetany(Rt whitelist((Rs0lib/python2.7/site-packages/bokeh/server/util.pytcheck_whitelistKs    cC`sK|sdt|ƒgSg}x'|D]}d|krItjd|ƒn|dkrh|j|ƒq$n|jdƒ}t|ƒdkr¼|ddkr¨tdƒ‚n|j|d ƒq$t|ƒd kr3yt|dƒWn!tk rtd |ƒ‚nX|ddkr#tdƒ‚n|j|ƒq$td |ƒ‚q$W|S( un This whitelist can be used to restrict websocket or other connections to only those explicitly originating from approved hosts. Args: host_list (seq[str]) : A list of string `` or `:` values to add to the whitelist. If no port is specified in a host string, then ``":80"`` is implicitly assumed. port (int) : If ``host_list`` is empty or ``None``, then the whitelist will be the single item list `` [ 'localhost:' ]`` If ``host_list`` is not empty, this parameter has no effect. Returns: list[str] Raises: ValueError, if host or port values are invalid Note: If any host in ``host_list`` contains a wildcard ``*`` a warning will be logged regarding permissive websocket connections. u localhost:u*u›Host wildcard %r will allow connections originating from multiple (or possibly all) hostnames or IPs. Use non-wildcard values to restrict access explicitlyu:iiuuEmpty host valueu:80iuInvalid port in host value: %suInvalid host value: %s(tstrtlogtwarningtappendtsplitR t ValueErrortint(t host_listRthostsRtparts((s0lib/python2.7/site-packages/bokeh/server/util.pytcreate_hosts_whitelistes4      cC`s d|kr'|jddƒ\}}nd}d|kri|jddƒ\}}|dkrod}qond}|dk r‹||kr‹tS|jdƒ}|jdƒ}t|ƒt|ƒkrÅtSx?t||ƒD].\}}||ksÕ|dkrÿqÕqÕtSqÕWtS(ua Match a host string against a pattern Args: host (str) A hostname to compare to the given pattern pattern (str) A string representing a hostname pattern, possibly including wildcards for ip address octets or ports. This function will return ``True`` if the hostname matches the pattern, including any wildcards. If the pattern contains a port, the host string must also contain a matching port. Returns: bool Examples: >>> match_host('192.168.0.1:80', '192.168.0.1:80') True >>> match_host('192.168.0.1:80', '192.168.0.1') True >>> match_host('192.168.0.1:80', '192.168.0.1:8080') False >>> match_host('192.168.0.1', '192.168.0.2') False >>> match_host('192.168.0.1', '192.168.*.*') True >>> match_host('alice', 'alice') True >>> match_host('alice:80', 'alice') True >>> match_host('alice', 'bob') False >>> match_host('foo.example.com', 'foo.example.com.net') False >>> match_host('alice', '*') True >>> match_host('alice', '*:*') True >>> match_host('alice:80', '*') True >>> match_host('alice:80', '*:80') True >>> match_host('alice:8080', '*:80') False u:iu*u.N(trsplittNonetFalseRR tzipR(RRt host_portt pattern_portthtp((s0lib/python2.7/site-packages/bokeh/server/util.pyR¤s&2    (u bind_socketsucheck_whitelistucreate_hosts_whitelistu match_host(t__doc__t __future__RRRRtloggingt getLoggert__name__RttornadoRt__all__R RR"R(((s0lib/python2.7/site-packages/bokeh/server/util.pyt s"      ?