ALL: Reorganized to avoid IDEs showing external and / or private elements

Author: Kalmat

CHANGES.txt

@@ -1,4 +1,5 @@
-0.1, 2023/08/21 -- Linux: Improved window geometry (thanks to elraymond - (https://github.com/elraymond)
+0.4, 2023/08/25 -- Reorganized to avoid IDEs showing external and / or private elements
+0.3, 2023/08/21 -- Linux: Improved window geometry (thanks to elraymond - (https://github.com/elraymond)
                    ALL: Improved default onQuery/onSet methods
 0.0.5, 2023/07/19 -- Initial release
 0.0.1, 2023/05/22 -- Initial version

dist/PyWinBox-0.3-py3-none-any.whl

@@ -116,6 +116,7 @@ class MoveResize(IntEnum):
 
 
 class DataFormat(IntEnum):
+    # I guess 16 is not used in Python (no difference between short and long int)
     STR = 8
     INT = 32
 
@@ -134,5 +135,3 @@ class StackMode(IntEnum):
 class HintAction(IntEnum):
     KEEP = -1
     REMOVE = -2
-
-

dist/PyWinBox-0.4-py3-none-any.whl

@@ -9,13 +9,28 @@
 
 
 class ScreensInfo(TypedDict):
+    """
+    Container class to handle ScreensInfo struct:
+
+        - screen_number (str): int (sequential)
+        - is_default (bool): ''True'' if the screen is the default screen
+        - screen (Xlib.Struct): screen Struct (see Xlib documentation)
+        - root (Xlib.xobject.drawable.Window): root X-Window object belonging to screen
+    """
     screen_number: str
     is_default: bool
     screen: Struct
     root: XWindow
 
 
 class DisplaysInfo(TypedDict):
+    """
+    Container class to handle DisplaysInfo struct:
+
+        - name: Display name (as per Xlib.display.Display(name))
+        - is_default: ''True'' if the display is the default display
+        - screens: list of ScreensInfo structs belonging to display
+    """
     name: str
     is_default: bool
     screens: List[ScreensInfo]
@@ -25,7 +40,22 @@ class DisplaysInfo(TypedDict):
 Perhaps unnecesary since structs below are defined in Xlib.xobject.icccm.*, though in a more complex way.
 """
 class WmHints(TypedDict):
-    # {'flags': 103, 'input': 1, 'initial_state': 1, 'icon_pixmap': <Pixmap 0x02a22304>, 'icon_window': <Window 0x00000000>, 'icon_x': 0, 'icon_y': 0, 'icon_mask': <Pixmap 0x02a2230b>, 'window_group': <Window 0x02a00001>}
+    """
+    Container class to handle WmHints struct:
+
+    Example:
+         {
+            'flags': 103,
+            'input': 1,
+            'initial_state': 1,
+            'icon_pixmap': <Pixmap 0x02a22304>,
+            'icon_window': <Window 0x00000000>,
+            'icon_x': 0,
+            'icon_y': 0,
+            'icon_mask': <Pixmap 0x02a2230b>,
+            'window_group': <Window 0x02a00001>
+        }
+    """
     flags: int
     input_mode: int
     initial_state: int
@@ -38,12 +68,31 @@ class WmHints(TypedDict):
 
 
 class Aspect(TypedDict):
+    """Container class to handle Aspect struct (num, denum)"""
     num: int
     denum: int
 
 
 class WmNormalHints(TypedDict):
-    # {'flags': 848, 'min_width': 387, 'min_height': 145, 'max_width': 0, 'max_height': 0, 'width_inc': 9, 'height_inc': 18, 'min_aspect': <class 'Xlib.protocol.rq.DictWrapper'>({'num': 0, 'denum': 0}), 'max_aspect': <class 'Xlib.protocol.rq.DictWrapper'>({'num': 0, 'denum': 0}), 'base_width': 66, 'base_height': 101, 'win_gravity': 1}
+    """
+    Container class to handle WmNormalHints
+
+    Example:
+        {
+            'flags': 848,
+            'min_width': 387,
+            'min_height': 145,
+            'max_width': 0,
+            'max_height': 0,
+            'width_inc': 9,
+            'height_inc': 18,
+            'min_aspect': <class 'Xlib.protocol.rq.DictWrapper'>({'num': 0, 'denum': 0}),
+            'max_aspect': <class 'Xlib.protocol.rq.DictWrapper'>({'num': 0, 'denum': 0}),
+            'base_width': 66,
+            'base_height': 101,
+            'win_gravity': 1
+        }
+    """
     flags: int
     min_width: int
     min_height: int

src/ewmhlib/Props.py

@@ -1,25 +1,23 @@
-from __future__ import annotations
-
-import sys
-assert sys.platform == "linux"
-
-from ._ewmhlib import (getAllDisplaysInfo, getDisplayFromRoot, getDisplayFromWindow,
-                       getProperty, getPropertyValue, changeProperty, sendMessage, _xlibGetAllWindows,
-                       defaultDisplay, defaultScreen, defaultRoot, RootWindow, defaultRootWindow, EwmhWindow
-                       )
-import ewmhlib.Props as Props
-import ewmhlib.Structs as Structs
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
 
 __all__ = [
-    "version", "getAllDisplaysInfo", "getDisplayFromRoot", "getDisplayFromWindow",
+    "version", "displaysCount", "getDisplaysNames", "getDisplaysInfo", "getDisplayFromRoot", "getDisplayFromWindow",
     "getProperty", "getPropertyValue", "changeProperty", "sendMessage",
-    "defaultDisplay", "defaultScreen", "defaultRoot", "defaultRootWindow", "RootWindow", "EwmhWindow"
+    "defaultDisplay", "defaultScreen", "defaultRoot", "defaultRootWindow", "RootWindow", "EwmhWindow",
+    "Props", "Structs"
 ]
 
-
 __version__ = "0.0.1"
 
 
 def version(numberOnly: bool = True):
     """Returns the current version of ewmhlib module, in the form ''x.x.xx'' as string"""
     return ("" if numberOnly else "EWMHlib-")+__version__
+
+
+from ._main import (displaysCount, getDisplaysNames, getDisplaysInfo, getDisplayFromRoot, getDisplayFromWindow,
+                    getProperty, getPropertyValue, changeProperty, sendMessage,
+                    defaultDisplay, defaultScreen, defaultRoot, RootWindow, defaultRootWindow, EwmhWindow,
+                    Props, Structs
+                    )