-ekdZddlmZddlZejeZddlmZm Z erddl m Z ddl m Z dZ ddZddZddZddZdS) zc Provide some utility functions useful for implementing different components in ``bokeh.server``. ) annotationsN) TYPE_CHECKINGSequence)socket)netutil) bind_socketscheck_allowlistcreate_hosts_allowlist match_hostaddress str | Noneportintreturntuple[list[socket], int]ctj|pd|}t|sJd|D}t|dks Jd|}|r||ksJ||fS)a 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) r)rr cBh|]}|dS)) getsockname).0ss 1lib/python3.11/site-packages/bokeh/server/util.py zbind_sockets..Fs% , , ,AQ]]__Q  , , ,rzMultiple ports assigned??)rrlenpop)r rssports actual_ports rrr0s(  491g > > >B r77NNN , , , , ,E u::???7???))++K #d"""" {?rhoststr allowlist Sequence[str]boolcXdvrdz|vrdStfd|DS)a Check a given request host against a allowlist. Args: host (str) : A host string to compare against a allowlist. If the host does not specify a port, then ``":80"`` is implicitly assumed. allowlist (seq[str]) : A list of host patterns to match against Returns: ``True``, if ``host`` matches any pattern in ``allowlist``, otherwise ``False`` ::80Tc38K|]}t|VdS)N)r )rpatternr s r z"check_allowlist..es-BBWz$((BBBBBBr)any)r r"s` rr r MsJ$ $e| yt BBBB BBB B BBr host_listSequence[str] | None int | None list[str]c|sdt|zgSg}|D]&}d|vrtd||dkr||>|d}t |dkr4|ddkrt d||d zt |d kri t|dn #t $rt d |zwxYw|ddkrt d||t d |z|S) an This allowlist 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 allowlist. 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 allowlist 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. z localhost:*zHost wildcard %r will allow connections originating from multiple (or possibly all) hostnames or IPs. Use non-wildcard values to restrict access explicitlyr&rrzEmpty host valuer'zInvalid port in host value: %szInvalid host value: %s)r!logwarningappendsplitr ValueErrorr)r,rhostsr partss rr r gss> *s4yy())E>> $;; KK78< > > > 3;; LL     3 u::??Qx2~~ !3444 LLe $ $ $ $ ZZ1__ JE!H  J J J !AD!HIII JQx2~~ !3444 LL    5<== = Ls CC;r)cd}d|vr|dd\}}d}d|vr!|dd\}}|dkrd}|||krdS|d}|d}t|t|krdSt||D]\}}||ks|dkrdSdS)aa 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 Nr&rr1F.T)rsplitr7rzip)r r) host_port pattern_port host_parts pattern_partshps rr r sd!I d{{++c1--i#L g~~ 'sA 6 6 3  LI$=$=uCJMM#&&M =C OO++uJ ..1 66Q#XX 55 4r)r r rrrr)r r!r"r#rr$)r,r-rr.rr/)r r!r)r!rr$)__doc__ __future__rlogging getLogger__name__r4typingrrrtornador__all__rr r r rrrNs#"""""g!!+*******  :CCCC4====~JJJJJJr