appwindows 1.0.5__tar.gz

appwindows-1.0.5/.clang-format

@@ -0,0 +1 @@
+BasedOnStyle: Google

appwindows-1.0.5/.gitignore

@@ -0,0 +1,5 @@
+.venv/
+.vscode/
+.idea/
+dist/
+test.py

appwindows-1.0.5/LICENSE.md

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025 Terochkin A.S
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

appwindows-1.0.5/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: appwindows
+Version: 1.0.5
+Summary: The appwindows library solves the problem of working with a graphical shell on different operating systems.
+Author-Email: "Terochkin A.S" <apparser.development@gmail.com>
+License-File: LICENSE.md
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: Microsoft :: Windows :: Windows 11
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: X11 Applications
+Classifier: Environment :: Win32 (MS Windows)
+Project-URL: Repository, https://github.com/lexter0705/appwindows
+Project-URL: Issues, https://github.com/lexter0705/appwindows/issues
+Requires-Python: >=3.7
+Requires-Dist: numpy>=2.0
+Description-Content-Type: text/markdown
+
+<img src="https://raw.githubusercontent.com/lexter0705/appwindows/refs/heads/master/appwindows.svg" alt="" width="40%" >
+
+# Appwindows
+The appwindows library solves the problem of working with a graphical shell on different operating systems.
+# Install
+On windows:
+```bash
+pip install appwindows
+```
+On linux xorg:
+```bash
+sudo apt install libx11-dev pkg-config
+pip install appwindows
+```
+# Supported platforms:
+1) Windows
+2) Linux with X Server
+# Docs
+All documentation <a href="#">here</a>
+# For Developers
+1) If something doesn't work - open issue.
+2) If you want something fixed - open issue.
+3) If you can help with the library - email.
+
+apparser.development@gmail.com
+
+Any help in development is welcome)!

appwindows-1.0.5/README.md

@@ -0,0 +1,27 @@
+<img src="https://raw.githubusercontent.com/lexter0705/appwindows/refs/heads/master/appwindows.svg" alt="" width="40%" >
+
+# Appwindows
+The appwindows library solves the problem of working with a graphical shell on different operating systems.
+# Install
+On windows:
+```bash
+pip install appwindows
+```
+On linux xorg:
+```bash
+sudo apt install libx11-dev pkg-config
+pip install appwindows
+```
+# Supported platforms:
+1) Windows
+2) Linux with X Server
+# Docs
+All documentation <a href="#">here</a>
+# For Developers
+1) If something doesn't work - open issue.
+2) If you want something fixed - open issue.
+3) If you can help with the library - email.
+
+apparser.development@gmail.com
+
+Any help in development is welcome)!

appwindows-1.0.5/__init__.py

@@ -0,0 +1,3 @@
+from .appwindows import *
+from . import geometry
+from . import exceptions

appwindows-1.0.5/appwindows.svg

@@ -0,0 +1,6 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="512" height="512" rx="45" fill="#595783"/>
+<rect x="128.849" y="94" width="324" height="258" rx="13" fill="white" fill-opacity="0.7"/>
+<rect x="93.8491" y="127" width="324" height="258" rx="13" fill="white" fill-opacity="0.7"/>
+<rect x="59" y="160" width="324" height="258" rx="13" fill="white" fill-opacity="0.7"/>
+</svg>

appwindows-1.0.5/meson.build

@@ -0,0 +1,126 @@
+project('appwindows', 'cpp',
+        license : 'BSD 3-Clause License',
+        meson_version : '>=0.56.0',
+        default_options : [
+            'cpp_std=c++17',
+            'buildtype=release',
+            'default_library=shared',
+            'b_ndebug=if-release',
+        ]
+)
+
+pybind11_dep = dependency('pybind11', required : true)
+python_dep = dependency('python3', required : true)
+
+py3 = import('python').find_installation('python3', pure : false)
+
+python_install_dir = py3.get_install_dir()
+
+appwindows_inc = include_directories('src/appwindows',
+                                     'src/appwindows/core')
+geometry_inc = include_directories('src/appwindows/core/geometry')
+exceptions_inc = include_directories('src/appwindows/core/exceptions')
+
+
+appwindows_sources = files(
+    'src/appwindows/appwindows.cc',
+    'src/appwindows/core/bind.cc',
+    'src/appwindows/core/platform.cc',
+    'src/appwindows/core/geometry/size.cc',
+    'src/appwindows/core/geometry/point.cc',
+)
+geometry_sources = files(
+    'src/appwindows/core/geometry/point.cc',
+    'src/appwindows/core/geometry/size.cc',
+    'src/appwindows/core/geometry/geometry.cc'
+)
+exceptions_sources = files('src/appwindows/core/exceptions/exceptions.cc')
+
+platform_deps = []
+platform_args = []
+
+if host_machine.system() == 'windows'
+    appwindows_sources += files(
+        'src/appwindows/windows/window.getters.cc',
+        'src/appwindows/windows/window.setters.cc',
+        'src/appwindows/windows/finder.cc'
+    )
+    appwindows_inc = [appwindows_inc, include_directories('src/appwindows/windows')]
+    platform_args = ['-DWINDOWS_USED=1']
+
+elif host_machine.system() == 'linux'
+    xdg_session_type = run_command('sh', '-c', 'loginctl show-session $(loginctl | grep $(whoami) | awk "{print $1}") -p Type', check: false)
+    session_type = xdg_session_type.stdout().strip()
+    message('!!!!!!!!!!!!!!!!!!!!!!!!!!')
+    message(session_type)
+    message('!!!!!!!!!!!!!!!!!!!!!!!!!!')
+    if session_type == 'Type=wayland'
+        wayland_dep = dependency('wayland-client', required : true)
+        wayland_dep.found()
+        appwindows_sources += files(
+            'src/appwindows/wayland/window.getters.cc',
+            'src/appwindows/wayland/window.setters.cc',
+            'src/appwindows/wayland/finder.cc'
+        )
+        appwindows_inc = [appwindows_inc, include_directories('src/appwindows/wayland')]
+        platform_deps += wayland_dep
+        platform_args += ['-DWAYLAND_USED=1']
+    elif session_type == 'Type=x11'
+        x11_dep = dependency('x11', required : true)
+        xext_dep = dependency('xext', required : false)
+        xfixes_dep = dependency('xfixes', required : false)
+        xinerama_dep = dependency('xinerama', required : false)
+        x11_dep.found()
+        xext_dep.found()
+        xfixes_dep.found()
+        xinerama_dep.found()
+        appwindows_sources += files(
+            'src/appwindows/x_server/window.getters.cc',
+            'src/appwindows/x_server/window.setters.cc',
+            'src/appwindows/x_server/finder.cc'
+        )
+        appwindows_inc = [appwindows_inc, include_directories('src/appwindows/x_server')]
+        platform_deps += [x11_dep, xext_dep, xfixes_dep, xinerama_dep]
+        platform_args += ['-DX_SERVER_USED=1']
+    else
+        warning('Neither Wayland nor X11 found, building without platform-specific features')
+    endif
+
+else
+    error('Unsupported platform: ' + host_machine.system())
+endif
+
+
+
+appwindows_mod = py3.extension_module('appwindows',
+                                      sources : appwindows_sources,
+                                      dependencies : [pybind11_dep, platform_deps],
+                                      include_directories : [appwindows_inc, exceptions_inc, geometry_inc],
+                                      install : true,
+                                      cpp_args : platform_args,
+                                      subdir : 'appwindows')
+
+geometry_mod = py3.extension_module('geometry',
+                                    sources : geometry_sources,
+                                    dependencies : [pybind11_dep],
+                                    include_directories : geometry_inc,
+                                    install : true,
+                                    subdir : 'appwindows')
+
+exceptions_mod = py3.extension_module('exceptions',
+                                      sources : exceptions_sources,
+                                      dependencies : [pybind11_dep],
+                                      include_directories : exceptions_inc,
+                                      install : true,
+                                      subdir : 'appwindows')
+
+configure_file(
+    input : '__init__.py',
+    output : '__init__.py',
+    copy : true
+)
+
+install_data(
+    '__init__.py',
+    install_dir : python_install_dir / 'appwindows'
+)

appwindows-1.0.5/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = [
+    "meson-python>=0.10",
+    "pybind11>=2.10.0"
+]
+build-backend = "mesonpy"
+
+[project]
+dependencies = ["numpy >= 2.0"]
+name = "appwindows"
+version = "1.0.5"
+authors = [
+    { name = "Terochkin A.S", email = "apparser.development@gmail.com" },
+]
+description = "The appwindows library solves the problem of working with a graphical shell on different operating systems."
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: BSD License",
+    "Operating System :: Microsoft :: Windows :: Windows 10",
+    "Operating System :: Microsoft :: Windows :: Windows 11",
+    "Operating System :: POSIX :: Linux",
+    "Environment :: X11 Applications",
+    "Environment :: Win32 (MS Windows)"
+]
+license-files = ["LICENSE.md"]
+
+[project.urls]
+Repository = "https://github.com/lexter0705/appwindows"
+Issues = "https://github.com/lexter0705/appwindows/issues"
+
+[tool.mesonpy]
+machine-file = false
+
+[tool.mesonpy.args]
+buildtype = "release"
+default-library = "shared"

appwindows-1.0.5/src/appwindows/appwindows.cc

@@ -0,0 +1,22 @@
+#include <pybind11/pybind11.h>
+#include <pybind11/stl.h>
+
+#include "./core/bind.h"
+#include "./core/platform.h"
+
+namespace py = pybind11;
+
+PYBIND11_MODULE(appwindows, m) {
+  m.doc() =
+      "Python bindings for appwindows library\n\n"
+      "The appwindows library solves the problem of working with a graphical "
+      "shell on different operating systems.";
+
+  appwindows::core::bind_window(m);
+  appwindows::core::bind_finder(m);
+
+  m.def("get_finder", &appwindows::get_finder,
+        "Get the window finder instance\n\n"
+        "Returns:\n"
+        "    Finder: Instance of window finder interface");
+}

appwindows-1.0.5/src/appwindows/core/bind.cc

@@ -0,0 +1,103 @@
+#include "bind.h"
+
+#include <pybind11/numpy.h>
+#include <pybind11/pybind11.h>
+#include <pybind11/stl.h>
+
+#include "finder.h"
+#include "window.h"
+
+namespace py = pybind11;
+
+namespace appwindows {
+namespace core {
+
+void bind_window(py::module &m) {
+  py::class_<Window, std::shared_ptr<Window>>(
+      m, "Window", "Interface representing an application window")
+      .def(
+          "get_points",
+          [](Window &self) {
+            auto points = self.get_points();
+            return points ? *points : std::vector<Point>{};
+          },
+          "Get all points associated with the window\n"
+          ""
+          "Returns:\n"
+          "    list[Point]: List of points")
+      .def(
+          "get_title",
+          [](const Window &self) {
+            const auto title = self.get_title();
+            return title ? *title : std::string{};
+          },
+          "Get the window title\n\n"
+          "Returns:\n"
+          "    str: Window title")
+      .def(
+          "get_size",
+          [](const Window &self) {
+            auto size = self.get_size();
+            return size ? *size : Size{0, 0};
+          },
+          "Get current window size\n\n"
+          "Returns:\n"
+          "    Size: Current window dimensions")
+      .def(
+          "get_screenshot",
+          [](const Window &self) { return self.get_screenshot(); },
+          "Get current window image\n\n"
+          "Returns:\n"
+          "    ndarray: image in ndarray")
+      .def("to_foreground", &Window::to_foreground, "Moved window to forground")
+      .def("to_background", &Window::to_background,
+           "Moved window to background")
+      .def("set_minimize", &Window::set_minimize,
+           "Set window active state\n\n"
+           "Args:\n"
+           "    active (bool): True to activate window",
+           py::arg("active"))
+      .def("set_fullscreen", &Window::set_fullscreen,
+           "Maximize or restore the window\n\n"
+           "Args:\n"
+           "    is_maximize (bool): True to maximize window",
+           py::arg("is_maximize"))
+      .def("resize", &Window::resize,
+           "Resize the window\n\n"
+           "Args:\n"
+           "    size (appwindows.geometry.Size): New window dimensions\n\n"
+           "Raises:\n"
+           "    InvalidSizeError: If size is invalid",
+           py::arg("size"))
+      .def("move", &Window::move,
+           "Move window to specified position\n\n"
+           "Args:\n"
+           "    point (appwindows.geometry.Point): New window position",
+           py::arg("point"))
+      .def("close", &Window::close, "Close the window");
+}
+
+void bind_finder(py::module &m) {
+  py::class_<Finder, std::shared_ptr<Finder>>(
+      m, "Finder", "Interface for finding application windows")
+      .def(
+          "get_window_by_title",
+          [](const Finder &self, const std::string &title) {
+            return self.get_window_by_title(title);
+          },
+          "Find window by its title\n\n"
+          "Args:\n"
+          "    title (str): Window title to search for\n\n"
+          "Returns:\n"
+          "    Window | None: Found window or null if window does not exist",
+          py::arg("title"))
+      .def(
+          "get_all_windows",
+          [](const Finder &self) { return self.get_all_windows(); },
+          "Find all opened windows\n\n"
+          "Returns:\n"
+          "    list[Window]: Found windows\n\n");
+}
+
+}  // namespace core
+}  // namespace appwindows

appwindows-1.0.5/src/appwindows/core/bind.h

@@ -0,0 +1,14 @@
+#pragma once
+
+#include <pybind11/pybind11.h>
+
+namespace py = pybind11;
+
+namespace appwindows {
+namespace core {
+
+void bind_window(py::module &m);
+void bind_finder(py::module &m);
+
+}  // namespace windows
+}  // namespace appwindows

appwindows-1.0.5/src/appwindows/core/exceptions/exceptions.cc

@@ -0,0 +1,11 @@
+#include <pybind11/pybind11.h>
+
+#include "invalid_size.h"
+#include "window_does_not_exist.h"
+
+namespace py = pybind11;
+
+PYBIND11_MODULE(exceptions, m) {
+  py::register_exception<appwindows::core::exceptions::InvalidSizeException>(m, "InvalidSizeException");
+  py::register_exception<appwindows::core::exceptions::WindowDoesNotExistException>(m, "WindowDoesNotExistException");
+}

appwindows-1.0.5/src/appwindows/core/exceptions/invalid_size.h

@@ -0,0 +1,19 @@
+#pragma once
+
+#include <stdexcept>
+#include <string>
+
+namespace appwindows {
+namespace core {
+namespace exceptions {
+
+class InvalidSizeException final : public std::invalid_argument {
+ public:
+  explicit InvalidSizeException(const int width, const int height)
+      : invalid_argument("Invalid width(" + std::to_string(width) +
+                         ") or height(" + std::to_string(height) + ")") {}
+};
+
+}  // namespace exceptions
+}  // namespace core
+}  // namespace appwindows

appwindows-1.0.5/src/appwindows/core/exceptions/window_does_not_exist.h

@@ -0,0 +1,17 @@
+#pragma once
+
+#include <stdexcept>
+
+namespace appwindows {
+namespace core {
+namespace exceptions {
+
+class WindowDoesNotExistException final : public std::runtime_error {
+ public:
+  explicit WindowDoesNotExistException()
+      : runtime_error("Window does not exist") {}
+};
+
+}  // namespace exceptions
+}  // namespace core
+}  // namespace appwindows

appwindows-1.0.5/src/appwindows/core/finder.h

@@ -0,0 +1,24 @@
+#pragma once
+
+#include <memory>
+#include <vector>
+
+#include "window.h"
+
+namespace appwindows {
+namespace core {
+
+class Finder {
+ public:
+  virtual ~Finder() = default;
+  [[nodiscard]]
+  virtual std::shared_ptr<Window> get_window_by_title(
+      std::string title) const = 0;
+  [[nodiscard]]
+  virtual std::vector<std::shared_ptr<Window>> 
+      get_all_windows() const = 0;
+
+};
+
+}  // namespace core
+}  // namespace appwindows

appwindows-1.0.5/src/appwindows/core/geometry/geometry.cc

@@ -0,0 +1,43 @@
+#include <pybind11/pybind11.h>
+
+#include "point.h"
+#include "size.h"
+
+namespace py = pybind11;
+
+PYBIND11_MODULE(geometry, m) {
+  py::class_<appwindows::core::Point>(
+      m, "Point", "Represents a 2D point with x and y coordinates")
+      .def(py::init<int, int>(),
+           "Create a point with specified coordinates\n\n"
+           "Args:\n"
+           "    x (int): X coordinate\n"
+           "    y (int): Y coordinate",
+           py::arg("x"), py::arg("y"))
+      .def("__add__", &appwindows::core::Point::operator+, "Add two points")
+      .def("__sub__", &appwindows::core::Point::operator-,
+           "Subtract two points")
+      .def("__mul__", &appwindows::core::Point::operator*,
+           "Multiply two points")
+      .def("__truediv__", &appwindows::core::Point::operator/,
+           "Divide two points")
+      .def_property_readonly("x", &appwindows::core::Point::get_x,
+                             "X coordinate")
+      .def_property_readonly("y", &appwindows::core::Point::get_y,
+                             "Y coordinate");
+
+  py::class_<appwindows::core::Size>(
+      m, "Size", "Represents dimensions with width and height")
+      .def(py::init<int, int>(),
+           "Create size with specified dimensions\n\n"
+           "Args:\n"
+           "    width (int): Width dimension\n"
+           "    height (int): Height dimension\n\n"
+           "Raises:\n"
+           "    InvalidSizeError: If width or height are invalid",
+           py::arg("width"), py::arg("height"))
+      .def_property_readonly("width", &appwindows::core::Size::get_width,
+                             "Width dimension")
+      .def_property_readonly("height", &appwindows::core::Size::get_height,
+                             "Height dimension");
+}

appwindows-1.0.5/src/appwindows/core/geometry/point.cc

@@ -0,0 +1,34 @@
+#include "point.h"
+
+#include <stdexcept>
+
+namespace appwindows {
+namespace core {
+
+Point::Point(const int x, const int y) : x_(x), y_(y) {}
+
+Point Point::operator+(const Point& other) const{
+  return Point{x_ + other.get_x(), y_ + other.get_y()};
+}
+
+Point Point::operator-(const Point& other) const{
+  return Point{x_ - other.get_x(), y_ - other.get_y()};
+}
+
+Point Point::operator/(const Point& other) const {
+  if (other.get_x() == 0 || other.get_y() == 0) {
+    throw std::invalid_argument("Division by zero in Point coordinates");
+  }
+  return Point{x_ / other.get_x(), y_ / other.get_y()};
+}
+
+Point Point::operator*(const Point& other) const{
+  return Point{x_ * other.get_x(), y_ * other.get_y()};
+}
+
+int Point::get_x() const { return x_; }
+
+int Point::get_y() const { return y_; }
+
+}  // namespace core
+}  // namespace appwindows

appwindows-1.0.5/src/appwindows/core/geometry/point.h

@@ -0,0 +1,22 @@
+#pragma once
+
+namespace appwindows {
+namespace core {
+
+class Point {
+ public:
+  Point(int x, int y);
+  Point operator+(const Point& other) const;
+  Point operator-(const Point& other) const;
+  Point operator*(const Point& other) const;
+  Point operator/(const Point& other) const;
+  [[nodiscard]] int get_x() const;
+  [[nodiscard]] int get_y() const;
+
+ private:
+  int x_;
+  int y_;
+};
+
+}  // namespace core
+}  // namespace appwindows

appwindows-1.0.5/src/appwindows/core/geometry/size.cc

@@ -0,0 +1,14 @@
+#include "size.h"
+
+#include "../exceptions/invalid_size.h"
+
+namespace appwindows {
+namespace core {
+
+Size::Size(const int width, const int height) : width_(width), height_(height) {
+  if (width <= 0) throw exceptions::InvalidSizeException(width, height);
+  if (height <= 0) throw exceptions::InvalidSizeException(width, height);
+}
+
+}  // namespace core
+}  // namespace appwindows

appwindows-1.0.5/src/appwindows/core/geometry/size.h

@@ -0,0 +1,18 @@
+#pragma once
+
+namespace appwindows {
+namespace core {
+
+class Size {
+ public:
+  Size(int width, int height);
+  [[nodiscard]] int get_width() const noexcept { return width_; };
+  [[nodiscard]] int get_height() const noexcept { return height_; };
+
+ private:
+  int width_;
+  int height_;
+};
+
+}  // namespace core
+}  // namespace appwindows

appwindows-1.0.5/src/appwindows/core/platform.cc

@@ -0,0 +1,20 @@
+#include "platform.h"
+
+#ifdef WINDOWS_USED
+#include "../windows/finder.h"
+#elif X_SERVER_USED
+#include "../x_server/finder.h"
+#endif
+
+namespace appwindows {
+std::shared_ptr<core::Finder> get_finder() {
+#ifdef WINDOWS_USED
+  return std::make_shared<windows::FinderWindows>();
+#elif X_SERVER_USED
+  return std::make_shared<x_server::FinderXServer>();
+#else
+#error "Unsoported platform"
+#endif
+}
+
+}  // namespace appwindows