first commit

myenv/lib/python3.10/site-packages/Xlib/support/__init__.py

@@ -0,0 +1,26 @@
+# Xlib.support.__init__ -- support code package
+#
+#    Copyright (C) 2000 Peter Liljenberg <petli@ctrl-c.liu.se>
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public License
+# as published by the Free Software Foundation; either version 2.1
+# of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See the GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the
+#    Free Software Foundation, Inc.,
+#    59 Temple Place,
+#    Suite 330,
+#    Boston, MA 02111-1307 USA
+
+__all__ = [
+    'lock',
+    'connect'
+    # The platform specific modules should not be listed here
+    ]

myenv/lib/python3.10/site-packages/Xlib/support/connect.py

@@ -0,0 +1,102 @@
+# Xlib.support.connect -- OS-independent display connection functions
+#
+#    Copyright (C) 2000 Peter Liljenberg <petli@ctrl-c.liu.se>
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public License
+# as published by the Free Software Foundation; either version 2.1
+# of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See the GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the
+#    Free Software Foundation, Inc.,
+#    59 Temple Place,
+#    Suite 330,
+#    Boston, MA 02111-1307 USA
+
+import sys
+import importlib
+
+# List the modules which contain the corresponding functions
+
+_display_mods = {
+    'OpenVMS': 'vms_connect',
+    }
+
+_default_display_mod = 'unix_connect'
+
+_socket_mods = {
+    'OpenVMS': 'vms_connect'
+    }
+
+_default_socket_mod = 'unix_connect'
+
+_auth_mods = {
+    'OpenVMS': 'vms_connect'
+    }
+
+_default_auth_mod = 'unix_connect'
+
+
+# Figure out which OS we're using.
+# sys.platform is either "OS-ARCH" or just "OS".
+
+_parts = sys.platform.split('-')
+platform = _parts[0]
+del _parts
+
+
+def _relative_import(modname):
+    return importlib.import_module('..' + modname, __name__)
+
+
+def get_display(display):
+    """dname, protocol, host, dno, screen = get_display(display)
+
+    Parse DISPLAY into its components.  If DISPLAY is None, use
+    the default display.  The return values are:
+
+      DNAME    -- the full display name (string)
+      PROTOCOL -- the protocol to use (None if automatic)
+      HOST     -- the host name (string, possibly empty)
+      DNO      -- display number (integer)
+      SCREEN   -- default screen number (integer)
+    """
+
+    modname = _display_mods.get(platform, _default_display_mod)
+    mod = _relative_import(modname)
+    return mod.get_display(display)
+
+
+def get_socket(dname, protocol, host, dno):
+    """socket = get_socket(dname, protocol, host, dno)
+
+    Connect to the display specified by DNAME, PROTOCOL, HOST and DNO, which
+    are the corresponding values from a previous call to get_display().
+
+    Return SOCKET, a new socket object connected to the X server.
+    """
+
+    modname = _socket_mods.get(platform, _default_socket_mod)
+    mod = _relative_import(modname)
+    return mod.get_socket(dname, protocol, host, dno)
+
+
+def get_auth(sock, dname, protocol, host, dno):
+    """auth_name, auth_data = get_auth(sock, dname, protocol, host, dno)
+
+    Return authentication data for the display on the other side of
+    SOCK, which was opened with DNAME, HOST and DNO, using PROTOCOL.
+
+    Return AUTH_NAME and AUTH_DATA, two strings to be used in the
+    connection setup request.
+    """
+
+    modname = _auth_mods.get(platform, _default_auth_mod)
+    mod = _relative_import(modname)
+    return mod.get_auth(sock, dname, protocol, host, dno)

myenv/lib/python3.10/site-packages/Xlib/support/lock.py

@@ -0,0 +1,44 @@
+# Xlib.support.lock -- allocate a lock
+#
+#    Copyright (C) 2000 Peter Liljenberg <petli@ctrl-c.liu.se>
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public License
+# as published by the Free Software Foundation; either version 2.1
+# of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See the GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the
+#    Free Software Foundation, Inc.,
+#    59 Temple Place,
+#    Suite 330,
+#    Boston, MA 02111-1307 USA
+
+class _DummyLock(object):
+    def __init__(self):
+
+        # This might be nerdy, but by assigning methods like this
+        # instead of defining them all, we create a single bound
+        # method object once instead of one each time one of the
+        # methods is called.
+
+        # This gives some speed improvements which should reduce the
+        # impact of the threading infrastructure in the regular code,
+        # when not using threading.
+
+        self.acquire = self.release = self.locked = self.__noop
+
+    def __noop(self, *args):
+        return
+
+
+# More optimisations: we use a single lock for all lock instances
+_dummy_lock = _DummyLock()
+
+def allocate_lock():
+    return _dummy_lock

myenv/lib/python3.10/site-packages/Xlib/support/unix_connect.py

@@ -0,0 +1,217 @@
+# Xlib.support.unix_connect -- Unix-type display connection functions
+#
+#    Copyright (C) 2000,2002 Peter Liljenberg <petli@ctrl-c.liu.se>
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public License
+# as published by the Free Software Foundation; either version 2.1
+# of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See the GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the
+#    Free Software Foundation, Inc.,
+#    59 Temple Place,
+#    Suite 330,
+#    Boston, MA 02111-1307 USA
+
+import re
+import os
+import platform
+import socket
+from Xlib import error, xauth
+
+
+SUPPORTED_PROTOCOLS = (None, 'tcp', 'unix')
+
+# Darwin funky socket.
+uname = platform.uname()
+if (uname[0] == 'Darwin') and ([int(x) for x in uname[2].split('.')] >= [9, 0]):
+    SUPPORTED_PROTOCOLS += ('darwin',)
+    DARWIN_DISPLAY_RE = re.compile(r'^/private/tmp/[-:a-zA-Z0-9._]*:(?P<dno>[0-9]+)(\.(?P<screen>[0-9]+))?$')
+
+DISPLAY_RE = re.compile(r'^((?P<proto>tcp|unix)/)?(?P<host>[-:a-zA-Z0-9._]*):(?P<dno>[0-9]+)(\.(?P<screen>[0-9]+))?$')
+
+
+def get_display(display):
+    # Use $DISPLAY if display isn't provided
+    if display is None:
+        display = os.environ.get('DISPLAY', '')
+
+    re_list = [(DISPLAY_RE, {})]
+
+    if 'darwin' in SUPPORTED_PROTOCOLS:
+        re_list.insert(0, (DARWIN_DISPLAY_RE, {'protocol': 'darwin'}))
+
+    for re, defaults in re_list:
+        m = re.match(display)
+        if m is not None:
+            protocol, host, dno, screen = [
+                m.groupdict().get(field, defaults.get(field))
+                for field in ('proto', 'host', 'dno', 'screen')
+            ]
+            break
+    else:
+        raise error.DisplayNameError(display)
+
+    if protocol == 'tcp' and not host:
+        # Host is mandatory when protocol is TCP.
+        raise error.DisplayNameError(display)
+
+    dno = int(dno)
+    if screen:
+        screen = int(screen)
+    else:
+        screen = 0
+
+    return display, protocol, host, dno, screen
+
+
+def _get_tcp_socket(host, dno):
+    s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    s.connect((host, 6000 + dno))
+    return s
+
+
+def _get_unix_socket(address):
+    s = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+    s.connect(address)
+    return s
+
+
+def get_socket(dname, protocol, host, dno):
+    assert protocol in SUPPORTED_PROTOCOLS
+    try:
+        # Darwin funky socket.
+        if protocol == 'darwin':
+            s = _get_unix_socket(dname)
+
+        # TCP socket, note the special case: `unix:0.0` is equivalent to `:0.0`.
+        elif (protocol is None or protocol != 'unix') and host and host != 'unix':
+            s = _get_tcp_socket(host, dno)
+
+        # Unix socket.
+        else:
+            address = '/tmp/.X11-unix/X%d' % dno
+            if not os.path.exists(address):
+                # Use abstract address.
+                address = '\0' + address
+            try:
+                s = _get_unix_socket(address)
+            except socket.error:
+                if not protocol and not host:
+                    # If no protocol/host was specified, fallback to TCP.
+                    s = _get_tcp_socket(host, dno)
+                else:
+                    raise
+    except socket.error as val:
+        raise error.DisplayConnectionError(dname, str(val))
+
+    # Make sure that the connection isn't inherited in child processes.
+    _ensure_not_inheritable(s)
+
+    return s
+
+
+def _ensure_not_inheritable(sock):
+    # According to PEP446, in Python 3.4 and above,
+    # it is not inherited in child processes by default.
+    # However, just in case, we explicitly make it non-inheritable.
+    # Also, we don't use the code like the following,
+    # because there would be no possibility of backporting to past versions.
+    #   if sys.version_info.major == 3 and sys.version_info.minor >= 4:
+    #       sock.set_inheritable(False)
+    #       return
+    # We just check if the socket has `set_inheritable`.
+    if hasattr(sock, 'set_inheritable'):
+        sock.set_inheritable(False)
+        return
+
+    # On Windows,
+    # Python doesn't support fcntl module because Windows doesn't have fcntl API.
+    # At least by not importing fcntl, we will be able to import python-xlib on Windows.
+    if platform.system() == 'Windows':
+        # so.. unfortunately, for Python 3.3 and below, on Windows,
+        # we can't make sure that the connection isn't inherited in child processes for now.
+        return
+
+    import fcntl
+    fcntl.fcntl(sock.fileno(), fcntl.F_SETFD, fcntl.FD_CLOEXEC)
+
+
+def new_get_auth(sock, dname, protocol, host, dno):
+    assert protocol in SUPPORTED_PROTOCOLS
+    # Translate socket address into the xauth domain
+    if protocol == 'darwin':
+        family = xauth.FamilyLocal
+        addr = socket.gethostname()
+
+    elif protocol == 'tcp':
+        family = xauth.FamilyInternet
+
+        # Convert the prettyprinted IP number into 4-octet string.
+        # Sometimes these modules are too damn smart...
+        octets = sock.getpeername()[0].split('.')
+        addr = bytearray(int(x) for x in octets)
+    else:
+        family = xauth.FamilyLocal
+        addr = socket.gethostname().encode()
+
+    try:
+        au = xauth.Xauthority()
+    except error.XauthError:
+        return b'', b''
+
+    while 1:
+        try:
+            return au.get_best_auth(family, addr, dno)
+        except error.XNoAuthError:
+            pass
+
+        # We need to do this to handle ssh's X forwarding.  It sets
+        # $DISPLAY to localhost:10, but stores the xauth cookie as if
+        # DISPLAY was :10.  Hence, if localhost and not found, try
+        # again as a Unix socket.
+        if family == xauth.FamilyInternet and addr == b'\x7f\x00\x00\x01':
+            family = xauth.FamilyLocal
+            addr = socket.gethostname().encode()
+        else:
+            return b'', b''
+
+
+def old_get_auth(sock, dname, host, dno):
+    # Find authorization cookie
+    auth_name = auth_data = b''
+
+    try:
+        # We could parse .Xauthority, but xauth is simpler
+        # although more inefficient
+        data = os.popen('xauth list %s 2>/dev/null' % dname).read()
+
+        # If there's a cookie, it is of the format
+        #      DISPLAY SCHEME COOKIE
+        # We're interested in the two last parts for the
+        # connection establishment
+        lines = data.split('\n')
+        if len(lines) >= 1:
+            parts = lines[0].split(None, 2)
+            if len(parts) == 3:
+                auth_name = parts[1]
+                hexauth = parts[2]
+                auth = b''
+
+                # Translate hexcode into binary
+                for i in range(0, len(hexauth), 2):
+                    auth = auth + chr(int(hexauth[i:i+2], 16))
+
+                auth_data = auth
+    except os.error:
+        pass
+
+    return auth_name, auth_data
+
+get_auth = new_get_auth

myenv/lib/python3.10/site-packages/Xlib/support/vms_connect.py

@@ -0,0 +1,74 @@
+# Xlib.support.vms_connect -- VMS-type display connection functions
+#
+#    Copyright (C) 2000 Peter Liljenberg <petli@ctrl-c.liu.se>
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public License
+# as published by the Free Software Foundation; either version 2.1
+# of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See the GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the
+#    Free Software Foundation, Inc.,
+#    59 Temple Place,
+#    Suite 330,
+#    Boston, MA 02111-1307 USA
+
+import re
+import socket
+
+from Xlib import error
+
+display_re = re.compile(r'^([-a-zA-Z0-9._]*):([0-9]+)(\.([0-9]+))?$')
+
+def get_display(display):
+
+    # Use dummy display if none is set.  We really should
+    # check DECW$DISPLAY instead, but that has to wait
+
+    if display is None:
+        return ':0.0', None, 'localhost', 0, 0
+
+    m = display_re.match(display)
+    if not m:
+        raise error.DisplayNameError(display)
+
+    name = display
+
+    # Always return a host, since we don't have AF_UNIX sockets
+    host = m.group(1)
+    if not host:
+        host = 'localhost'
+
+    dno = int(m.group(2))
+    screen = m.group(4)
+    if screen:
+        screen = int(screen)
+    else:
+        screen = 0
+
+    return name, None, host, dno, screen
+
+
+def get_socket(dname, protocol, host, dno):
+    try:
+        # Always use TCP/IP sockets.  Later it would be nice to
+        # be able to use DECNET och LOCAL connections.
+
+        s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        s.connect((host, 6000 + dno))
+
+    except socket.error as val:
+        raise error.DisplayConnectionError(dname, str(val))
+
+    return s
+
+
+def get_auth(sock, dname, host, dno):
+    # VMS doesn't have xauth
+    return '', ''