TEST_BUILD    ?= test/.build

TEST_SRC      := $(TEST_BUILD)/source

TEST_BIN      := $(TEST_BUILD)/bin

TEST_CPPFLAGS := -I$(TEST_SRC) $(CPPFLAGS)

TEST_CFLAGS   := -std=c23 -g -O0 \

	-Wno-unused-function -Wno-unused-variable -Wno-unused-parameter

ifeq ($(TEST_COVERAGE),1)

TEST_CFLAGS += -fprofile-instr-generate -fcoverage-mapping

endif

$(TEST_SRC) $(TEST_BIN):

	@mkdir -p $@

$(TEST_SRC)/swm.c: swm.c | $(TEST_SRC)

	@cp -p $< $@

$(TEST_SRC)/config.h: config.def.h | $(TEST_SRC)

	@cp -p $< $@

TEST_COMMON := Makefile config.mk $(TEST_SRC)/swm.c $(TEST_SRC)/config.h \

	swm.h util.c util.h $(PROTO) ext-workspace-v1-protocol.c

$(TEST_BIN)/unit: test/unit.c $(TEST_COMMON) | $(TEST_BIN)

	@echo "cc   test/unit.c => $@"

	@$(CC) $(TEST_CPPFLAGS) $(TEST_CFLAGS) test/unit.c util.c \

		ext-workspace-v1-protocol.c $(LDLIBS) -o $@

$(TEST_BIN)/swm: $(TEST_COMMON) | $(TEST_BIN)

	@echo "cc   swm.c => $@"

	@$(CC) $(TEST_CPPFLAGS) $(TEST_CFLAGS) $(TEST_SRC)/swm.c util.c \

		ext-workspace-v1-protocol.c $(LDLIBS) -o $@

test-build: $(TEST_BIN)/unit $(TEST_BIN)/swm

test: test-build

	@SWM_TEST_BUILD=$(abspath $(TEST_BUILD)) PKG_CONFIG=$(PKG_CONFIG) $(PYTHON) test/run.py

test-unit: $(TEST_BIN)/unit

	@SWM_TEST_BUILD=$(abspath $(TEST_BUILD)) PKG_CONFIG=$(PKG_CONFIG) $(PYTHON) test/run.py unit

test-integration: $(TEST_BIN)/swm

	@SWM_TEST_BUILD=$(abspath $(TEST_BUILD)) PKG_CONFIG=$(PKG_CONFIG) $(PYTHON) test/run.py integration

coverage:

	@$(MAKE) --no-print-directory TEST_BUILD=$(TEST_BUILD)/coverage TEST_COVERAGE=1 test-build

	@SWM_TEST_BUILD=$(abspath $(TEST_BUILD)/coverage) PKG_CONFIG=$(PKG_CONFIG) \

		$(PYTHON) test/run.py coverage

test-clean:

	@SWM_TEST_BUILD=$(abspath $(TEST_BUILD)) $(PYTHON) test/run.py clean

.PHONY: all man fmt install uninstall archive package clean coverage

.PHONY: test-build test test-unit test-integration test-clean

Make builds one focused C unit-test binary and a test compositor, then the

Python runner executes them alongside native Wayland and XWayland clients,

including a two-output run. Unchanged binaries are reused; use the narrower

targets while developing:

    make test-unit

    make test-integration

Coverage is informational and has its own target:

    make coverage

Generated test files live under `test/.build/`; remove them with

`make test-clean`. All targets require Python 3 and the normal build

dependencies. Integration tests additionally require PyWayland and its protocol

scanner, xcffib, wlr-randr, and Xwayland; coverage requires LLVM's coverage

tools.

PYTHON    ?= python3

<?xml version="1.0" encoding="UTF-8"?>

<protocol name="input_method_unstable_v2">

  <copyright>

    Copyright © 2008-2011 Kristian Høgsberg

    Copyright © 2010-2011 Intel Corporation

    Copyright © 2012-2013 Collabora, Ltd.

    Copyright © 2012, 2013 Intel Corporation

    Copyright © 2015, 2016 Jan Arne Petersen

    Copyright © 2017, 2018 Red Hat, Inc.

    Copyright © 2018       Purism SPC

    Permission is hereby granted, free of charge, to any person obtaining a

    copy of this software and associated documentation files (the "Software"),

    to deal in the Software without restriction, including without limitation

    the rights to use, copy, modify, merge, publish, distribute, sublicense,

    and/or sell copies of the Software, and to permit persons to whom the

    Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice (including the next

    paragraph) shall be included in all copies or substantial portions of the

    Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL

    THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

    DEALINGS IN THE SOFTWARE.

  </copyright>

  <description summary="Protocol for creating input methods">

    This protocol allows applications to act as input methods for compositors.

    An input method context is used to manage the state of the input method.

    Text strings are UTF-8 encoded, their indices and lengths are in bytes.

    This document adheres to the RFC 2119 when using words like "must",

    "should", "may", etc.

    Warning! The protocol described in this file is experimental and

    backward incompatible changes may be made. Backward compatible changes

    may be added together with the corresponding interface version bump.

    Backward incompatible changes are done by bumping the version number in

    the protocol and interface names and resetting the interface version.

    Once the protocol is to be declared stable, the 'z' prefix and the

    version number in the protocol and interface names are removed and the

    interface version number is reset.

  </description>

  <interface name="zwp_input_method_v2" version="1">

    <description summary="input method">

      An input method object allows for clients to compose text.

      The objects connects the client to a text input in an application, and

      lets the client to serve as an input method for a seat.

      The zwp_input_method_v2 object can occupy two distinct states: active and

      inactive. In the active state, the object is associated to and

      communicates with a text input. In the inactive state, there is no

      associated text input, and the only communication is with the compositor.

      Initially, the input method is in the inactive state.

      Requests issued in the inactive state must be accepted by the compositor.

      Because of the serial mechanism, and the state reset on activate event,

      they will not have any effect on the state of the next text input.

      There must be no more than one input method object per seat.

    </description>

    <enum name="error">

      <entry name="role" value="0" summary="wl_surface has another role"/>

    </enum>

    <event name="activate">

      <description summary="input method has been requested">

        Notification that a text input focused on this seat requested the input

        method to be activated.

        This event serves the purpose of providing the compositor with an

        active input method.

        This event resets all state associated with previous enable, disable,

        surrounding_text, text_change_cause, and content_type events, as well

        as the state associated with set_preedit_string, commit_string, and

        delete_surrounding_text requests. In addition, it marks the

        zwp_input_method_v2 object as active, and makes any existing

        zwp_input_popup_surface_v2 objects visible.

        The surrounding_text, and content_type events must follow before the

        next done event if the text input supports the respective

        functionality.

        State set with this event is double-buffered. It will get applied on

        the next zwp_input_method_v2.done event, and stay valid until changed.

      </description>

    </event>

    <event name="deactivate">

      <description summary="deactivate event">

        Notification that no focused text input currently needs an active

        input method on this seat.

        This event marks the zwp_input_method_v2 object as inactive. The

        compositor must make all existing zwp_input_popup_surface_v2 objects

        invisible until the next activate event.

        State set with this event is double-buffered. It will get applied on

        the next zwp_input_method_v2.done event, and stay valid until changed.

      </description>

    </event>

    <event name="surrounding_text">

      <description summary="surrounding text event">

        Updates the surrounding plain text around the cursor, excluding the

        preedit text.

        If any preedit text is present, it is replaced with the cursor for the

        purpose of this event.

        The argument text is a buffer containing the preedit string, and must

        include the cursor position, and the complete selection. It should

        contain additional characters before and after these. There is a

        maximum length of wayland messages, so text can not be longer than 4000

        bytes.

        cursor is the byte offset of the cursor within the text buffer.

        anchor is the byte offset of the selection anchor within the text

        buffer. If there is no selected text, anchor must be the same as

        cursor.

        If this event does not arrive before the first done event, the input

        method may assume that the text input does not support this

        functionality and ignore following surrounding_text events.

        Values set with this event are double-buffered. They will get applied

        and set to initial values on the next zwp_input_method_v2.done

        event.

        The initial state for affected fields is empty, meaning that the text

        input does not support sending surrounding text. If the empty values

        get applied, subsequent attempts to change them may have no effect.

      </description>

      <arg name="text" type="string"/>

      <arg name="cursor" type="uint"/>

      <arg name="anchor" type="uint"/>

    </event>

    <event name="text_change_cause">

      <description summary="indicates the cause of surrounding text change">

        Tells the input method why the text surrounding the cursor changed.

        Whenever the client detects an external change in text, cursor, or

        anchor position, it must issue this request to the compositor. This

        request is intended to give the input method a chance to update the

        preedit text in an appropriate way, e.g. by removing it when the user

        starts typing with a keyboard.

        cause describes the source of the change.

        The value set with this event is double-buffered. It will get applied

        and set to its initial value on the next zwp_input_method_v2.done

        event.

        The initial value of cause is input_method.

      </description>

      <arg name="cause" type="uint" enum="zwp_text_input_v3.change_cause"/>

    </event>

    <event name="content_type">

      <description summary="content purpose and hint">

        Indicates the content type and hint for the current

        zwp_input_method_v2 instance.

        Values set with this event are double-buffered. They will get applied

        on the next zwp_input_method_v2.done event.

        The initial value for hint is none, and the initial value for purpose

        is normal.

      </description>

      <arg name="hint" type="uint" enum="zwp_text_input_v3.content_hint"/>

      <arg name="purpose" type="uint" enum="zwp_text_input_v3.content_purpose"/>

    </event>

    <event name="done">

      <description summary="apply state">

        Atomically applies state changes recently sent to the client.

        The done event establishes and updates the state of the client, and

        must be issued after any changes to apply them.

        Text input state (content purpose, content hint, surrounding text, and

        change cause) is conceptually double-buffered within an input method

        context.

        Events modify the pending state, as opposed to the current state in use

        by the input method. A done event atomically applies all pending state,

        replacing the current state. After done, the new pending state is as

        documented for each related request.

        Events must be applied in the order of arrival.

        Neither current nor pending state are modified unless noted otherwise.

      </description>

    </event>

    <request name="commit_string">

      <description summary="commit string">

        Send the commit string text for insertion to the application.

        Inserts a string at current cursor position (see commit event

        sequence). The string to commit could be either just a single character

        after a key press or the result of some composing.

        The argument text is a buffer containing the string to insert. There is

        a maximum length of wayland messages, so text can not be longer than

        4000 bytes.

        Values set with this event are double-buffered. They must be applied

        and reset to initial on the next zwp_text_input_v3.commit request.

        The initial value of text is an empty string.

      </description>

      <arg name="text" type="string"/>

    </request>

    <request name="set_preedit_string">

      <description summary="pre-edit string">

        Send the pre-edit string text to the application text input.

        Place a new composing text (pre-edit) at the current cursor position.

        Any previously set composing text must be removed. Any previously

        existing selected text must be removed. The cursor is moved to a new

        position within the preedit string.

        The argument text is a buffer containing the preedit string. There is

        a maximum length of wayland messages, so text can not be longer than

        4000 bytes.

        The arguments cursor_begin and cursor_end are counted in bytes relative

        to the beginning of the submitted string buffer. Cursor should be

        hidden by the text input when both are equal to -1.

        cursor_begin indicates the beginning of the cursor. cursor_end

        indicates the end of the cursor. It may be equal or different than

        cursor_begin.

        Values set with this event are double-buffered. They must be applied on

        the next zwp_input_method_v2.commit event.

        The initial value of text is an empty string. The initial value of

        cursor_begin, and cursor_end are both 0.

      </description>

      <arg name="text" type="string"/>

      <arg name="cursor_begin" type="int"/>

      <arg name="cursor_end" type="int"/>

    </request>

    <request name="delete_surrounding_text">

      <description summary="delete text">

        Remove the surrounding text.

        before_length and after_length are the number of bytes before and after

        the current cursor index (excluding the preedit text) to delete.

        If any preedit text is present, it is replaced with the cursor for the

        purpose of this event. In effect before_length is counted from the

        beginning of preedit text, and after_length from its end (see commit

        event sequence).

        Values set with this event are double-buffered. They must be applied

        and reset to initial on the next zwp_input_method_v2.commit request.

        The initial values of both before_length and after_length are 0.

      </description>

      <arg name="before_length" type="uint"/>

      <arg name="after_length" type="uint"/>

    </request>

    <request name="commit">

      <description summary="apply state">

        Apply state changes from commit_string, set_preedit_string and

        delete_surrounding_text requests.

        The state relating to these events is double-buffered, and each one

        modifies the pending state. This request replaces the current state

        with the pending state.

        The connected text input is expected to proceed by evaluating the

        changes in the following order:

        1. Replace existing preedit string with the cursor.

        2. Delete requested surrounding text.

        3. Insert commit string with the cursor at its end.

        4. Calculate surrounding text to send.

        5. Insert new preedit text in cursor position.

        6. Place cursor inside preedit text.

        The serial number reflects the last state of the zwp_input_method_v2

        object known to the client. The value of the serial argument must be

        equal to the number of done events already issued by that object. When

        the compositor receives a commit request with a serial different than

        the number of past done events, it must proceed as normal, except it

        should not change the current state of the zwp_input_method_v2 object.

      </description>

      <arg name="serial" type="uint"/>

    </request>

    <request name="get_input_popup_surface">

      <description summary="create popup surface">

        Creates a new zwp_input_popup_surface_v2 object wrapping a given

        surface.

        The surface gets assigned the "input_popup" role. If the surface

        already has an assigned role, the compositor must issue a protocol

        error.

      </description>

      <arg name="id" type="new_id" interface="zwp_input_popup_surface_v2"/>

      <arg name="surface" type="object" interface="wl_surface"/>

    </request>

    <request name="grab_keyboard">

      <description summary="grab hardware keyboard">

        Allow an input method to receive hardware keyboard input and process

        key events to generate text events (with pre-edit) over the wire. This

        allows input methods which compose multiple key events for inputting

        text like it is done for CJK languages.

        The compositor should send all keyboard events on the seat to the grab

        holder via the returned wl_keyboard object. Nevertheless, the

        compositor may decide not to forward any particular event. The

        compositor must not further process any event after it has been

        forwarded to the grab holder.

        Releasing the resulting wl_keyboard object releases the grab.

      </description>

      <arg name="keyboard" type="new_id"

        interface="zwp_input_method_keyboard_grab_v2"/>

    </request>

    <event name="unavailable">

      <description summary="input method unavailable">

        The input method ceased to be available.

        The compositor must issue this event as the only event on the object if

        there was another input_method object associated with the same seat at

        the time of its creation.

        The compositor must issue this request when the object is no longer

        usable, e.g. due to seat removal.

        The input method context becomes inert and should be destroyed after

        deactivation is handled. Any further requests and events except for the

        destroy request must be ignored.

      </description>

    </event>

    <request name="destroy" type="destructor">

      <description summary="destroy the text input">

        Destroys the zwp_text_input_v2 object and any associated child

        objects, i.e. zwp_input_popup_surface_v2 and

        zwp_input_method_keyboard_grab_v2.

      </description>

    </request>

  </interface>

  <interface name="zwp_input_popup_surface_v2" version="1">

    <description summary="popup surface">

      This interface marks a surface as a popup for interacting with an input

      method.

      The compositor should place it near the active text input area. It must

      be visible if and only if the input method is in the active state.

      The client must not destroy the underlying wl_surface while the

      zwp_input_popup_surface_v2 object exists.

    </description>

    <event name="text_input_rectangle">

      <description summary="set text input area position">

        Notify about the position of the area of the text input expressed as a

        rectangle in surface local coordinates.

        This is a hint to the input method telling it the relative position of

        the text being entered.

      </description>

      <arg name="x" type="int"/>

      <arg name="y" type="int"/>

      <arg name="width" type="int"/>

      <arg name="height" type="int"/>

    </event>

    <request name="destroy" type="destructor"/>

  </interface>

  <interface name="zwp_input_method_keyboard_grab_v2" version="1">

    <!-- Closely follows wl_keyboard version 6 -->

    <description summary="keyboard grab">

      The zwp_input_method_keyboard_grab_v2 interface represents an exclusive

      grab of the wl_keyboard interface associated with the seat.

    </description>

    <event name="keymap">

      <description summary="keyboard mapping">

        This event provides a file descriptor to the client which can be

        memory-mapped to provide a keyboard mapping description.

      </description>

      <arg name="format" type="uint" enum="wl_keyboard.keymap_format"

        summary="keymap format"/>

      <arg name="fd" type="fd" summary="keymap file descriptor"/>

      <arg name="size" type="uint" summary="keymap size, in bytes"/>

    </event>

    <event name="key">

      <description summary="key event">

        A key was pressed or released.

        The time argument is a timestamp with millisecond granularity, with an

        undefined base.

      </description>

      <arg name="serial" type="uint" summary="serial number of the key event"/>

      <arg name="time" type="uint" summary="timestamp with millisecond granularity"/>

      <arg name="key" type="uint" summary="key that produced the event"/>

      <arg name="state" type="uint" enum="wl_keyboard.key_state"

        summary="physical state of the key"/>

    </event>

    <event name="modifiers">

      <description summary="modifier and group state">

        Notifies clients that the modifier and/or group state has changed, and

        it should update its local state.

      </description>

      <arg name="serial" type="uint" summary="serial number of the modifiers event"/>

      <arg name="mods_depressed" type="uint" summary="depressed modifiers"/>

      <arg name="mods_latched" type="uint" summary="latched modifiers"/>

      <arg name="mods_locked" type="uint" summary="locked modifiers"/>

      <arg name="group" type="uint" summary="keyboard layout"/>

    </event>

    <request name="release" type="destructor">

      <description summary="release the grab object"/>

    </request>

    <event name="repeat_info">

      <description summary="repeat rate and delay">

        Informs the client about the keyboard's repeat rate and delay.

        This event is sent as soon as the zwp_input_method_keyboard_grab_v2

        object has been created, and is guaranteed to be received by the

        client before any key press event.

        Negative values for either rate or delay are illegal. A rate of zero

        will disable any repeating (regardless of the value of delay).

        This event can be sent later on as well with a new value if necessary,

        so clients should continue listening for the event past the creation

        of zwp_input_method_keyboard_grab_v2.

      </description>

      <arg name="rate" type="int"

	   summary="the rate of repeating keys in characters per second"/>

      <arg name="delay" type="int"

	   summary="delay in milliseconds since key down until repeating starts"/>

    </event>

  </interface>

  <interface name="zwp_input_method_manager_v2" version="1">

    <description summary="input method manager">

      The input method manager allows the client to become the input method on

      a chosen seat.

      No more than one input method must be associated with any seat at any

      given time.

    </description>

    <request name="get_input_method">

      <description summary="request an input method object">

        Request a new input zwp_input_method_v2 object associated with a given

        seat.

      </description>

      <arg name="seat" type="object" interface="wl_seat"/>

      <arg name="input_method" type="new_id" interface="zwp_input_method_v2"/>

    </request>

    <request name="destroy" type="destructor">

      <description summary="destroy the input method manager">

        Destroys the zwp_input_method_manager_v2 object.

        The zwp_input_method_v2 objects originating from it remain valid.

      </description>

    </request>

  </interface>

</protocol>

<?xml version="1.0" encoding="UTF-8"?>

<!-- SPDX-License-Identifier: MIT -->

<protocol name="virtual_keyboard_unstable_v1">

  <copyright>

    Copyright © 2008-2011 Kristian Høgsberg

    Copyright © 2010-2013 Intel Corporation

    Copyright © 2012-2013 Collabora, Ltd.

    Copyright © 2018 Purism SPC

    Permission is hereby granted, free of charge, to any person obtaining a

    copy of this software and associated documentation files (the "Software"),

    to deal in the Software without restriction, including without limitation

    the rights to use, copy, modify, merge, publish, distribute, sublicense,

    and/or sell copies of the Software, and to permit persons to whom the

    Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included

    in all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

    DEALINGS IN THE SOFTWARE.

  </copyright>

  <interface name="zwp_virtual_keyboard_v1" version="1">

    <description summary="virtual keyboard"/>

    <request name="keymap">

      <arg name="format" type="uint"/>

      <arg name="fd" type="fd"/>

      <arg name="size" type="uint"/>

    </request>

    <enum name="error">

      <entry name="no_keymap" value="0" summary="No keymap was set"/>

    </enum>

    <request name="key">

      <arg name="time" type="uint"/>

      <arg name="key" type="uint"/>

      <arg name="state" type="uint"/>

    </request>

    <request name="modifiers">

      <arg name="mods_depressed" type="uint"/>

      <arg name="mods_latched" type="uint"/>

      <arg name="mods_locked" type="uint"/>

      <arg name="group" type="uint"/>

    </request>

    <request name="destroy" type="destructor" since="1"/>

  </interface>

  <interface name="zwp_virtual_keyboard_manager_v1" version="1">

    <description summary="virtual keyboard manager"/>

    <enum name="error">

      <entry name="unauthorized" value="0"

        summary="client not authorized to use the interface"/>

    </enum>

    <request name="create_virtual_keyboard">

      <arg name="seat" type="object" interface="wl_seat"/>

      <arg name="id" type="new_id" interface="zwp_virtual_keyboard_v1"/>

    </request>

  </interface>

</protocol>

<?xml version="1.0" encoding="UTF-8"?>

<protocol name="wlr_foreign_toplevel_management_unstable_v1">

  <copyright>

    Copyright © 2018 Ilia Bozhinov

    Permission to use, copy, modify, distribute, and sell this

    software and its documentation for any purpose is hereby granted

    without fee, provided that the above copyright notice appear in

    all copies and that both that copyright notice and this permission

    notice appear in supporting documentation, and that the name of

    the copyright holders not be used in advertising or publicity

    pertaining to distribution of the software without specific,

    written prior permission.  The copyright holders make no

    representations about the suitability of this software for any

    purpose.  It is provided "as is" without express or implied

    warranty.

    THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS

    SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND

    FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY

    SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES

    WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN

    AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,

    ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF

    THIS SOFTWARE.

  </copyright>

  <interface name="zwlr_foreign_toplevel_manager_v1" version="3">

    <description summary="list and control opened apps">

      The purpose of this protocol is to enable the creation of taskbars

      and docks by providing them with a list of opened applications and

      letting them request certain actions on them, like maximizing, etc.

      After a client binds the zwlr_foreign_toplevel_manager_v1, each opened

      toplevel window will be sent via the toplevel event

    </description>

    <event name="toplevel">

      <description summary="a toplevel has been created">

        This event is emitted whenever a new toplevel window is created. It

        is emitted for all toplevels, regardless of the app that has created

        them.

        All initial details of the toplevel(title, app_id, states, etc.) will

        be sent immediately after this event via the corresponding events in

        zwlr_foreign_toplevel_handle_v1.

      </description>

      <arg name="toplevel" type="new_id" interface="zwlr_foreign_toplevel_handle_v1"/>

    </event>

    <request name="stop">

      <description summary="stop sending events">

        Indicates the client no longer wishes to receive events for new toplevels.

        However the compositor may emit further toplevel_created events, until

        the finished event is emitted.

        The client must not send any more requests after this one.

      </description>

    </request>

    <event name="finished" type="destructor">

      <description summary="the compositor has finished with the toplevel manager">

        This event indicates that the compositor is done sending events to the

        zwlr_foreign_toplevel_manager_v1. The server will destroy the object

        immediately after sending this request, so it will become invalid and

        the client should free any resources associated with it.

      </description>

    </event>

  </interface>

  <interface name="zwlr_foreign_toplevel_handle_v1" version="3">

    <description summary="an opened toplevel">

      A zwlr_foreign_toplevel_handle_v1 object represents an opened toplevel

      window. Each app may have multiple opened toplevels.

      Each toplevel has a list of outputs it is visible on, conveyed to the

      client with the output_enter and output_leave events.

    </description>

    <event name="title">

      <description summary="title change">

        This event is emitted whenever the title of the toplevel changes.

      </description>

      <arg name="title" type="string"/>

    </event>

    <event name="app_id">

      <description summary="app-id change">

        This event is emitted whenever the app-id of the toplevel changes.

      </description>

      <arg name="app_id" type="string"/>

    </event>

    <event name="output_enter">

      <description summary="toplevel entered an output">

        This event is emitted whenever the toplevel becomes visible on

        the given output. A toplevel may be visible on multiple outputs.

      </description>

      <arg name="output" type="object" interface="wl_output"/>

    </event>

    <event name="output_leave">

      <description summary="toplevel left an output">

        This event is emitted whenever the toplevel stops being visible on

        the given output. It is guaranteed that an entered-output event

        with the same output has been emitted before this event.

      </description>

      <arg name="output" type="object" interface="wl_output"/>

    </event>

    <request name="set_maximized">

      <description summary="requests that the toplevel be maximized">

        Requests that the toplevel be maximized. If the maximized state actually

        changes, this will be indicated by the state event.

      </description>

    </request>

    <request name="unset_maximized">

      <description summary="requests that the toplevel be unmaximized">

        Requests that the toplevel be unmaximized. If the maximized state actually

        changes, this will be indicated by the state event.

      </description>

    </request>

    <request name="set_minimized">

      <description summary="requests that the toplevel be minimized">

        Requests that the toplevel be minimized. If the minimized state actually

        changes, this will be indicated by the state event.

      </description>

    </request>

    <request name="unset_minimized">

      <description summary="requests that the toplevel be unminimized">

        Requests that the toplevel be unminimized. If the minimized state actually

        changes, this will be indicated by the state event.

      </description>

    </request>

    <request name="activate">

      <description summary="activate the toplevel">

        Request that this toplevel be activated on the given seat.

        There is no guarantee the toplevel will be actually activated.

      </description>

      <arg name="seat" type="object" interface="wl_seat"/>

    </request>

    <enum name="state">

      <description summary="types of states on the toplevel">

        The different states that a toplevel can have. These have the same meaning

        as the states with the same names defined in xdg-toplevel

      </description>

      <entry name="maximized"  value="0" summary="the toplevel is maximized"/>

      <entry name="minimized"  value="1" summary="the toplevel is minimized"/>

      <entry name="activated"  value="2" summary="the toplevel is active"/>

      <entry name="fullscreen" value="3" summary="the toplevel is fullscreen" since="2"/>

    </enum>

    <event name="state">

      <description summary="the toplevel state changed">

        This event is emitted immediately after the zlw_foreign_toplevel_handle_v1

        is created and each time the toplevel state changes, either because of a

        compositor action or because of a request in this protocol.

      </description>

      <arg name="state" type="array"/>

    </event>

    <event name="done">

      <description summary="all information about the toplevel has been sent">

        This event is sent after all changes in the toplevel state have been

        sent.

        This allows changes to the zwlr_foreign_toplevel_handle_v1 properties

        to be seen as atomic, even if they happen via multiple events.

      </description>

    </event>

    <request name="close">

      <description summary="request that the toplevel be closed">

        Send a request to the toplevel to close itself. The compositor would

        typically use a shell-specific method to carry out this request, for

        example by sending the xdg_toplevel.close event. However, this gives

        no guarantees the toplevel will actually be destroyed. If and when

        this happens, the zwlr_foreign_toplevel_handle_v1.closed event will

        be emitted.

      </description>

    </request>

    <request name="set_rectangle">

      <description summary="the rectangle which represents the toplevel">

        The rectangle of the surface specified in this request corresponds to

        the place where the app using this protocol represents the given toplevel.

        It can be used by the compositor as a hint for some operations, e.g

        minimizing. The client is however not required to set this, in which

        case the compositor is free to decide some default value.

        If the client specifies more than one rectangle, only the last one is

        considered.

        The dimensions are given in surface-local coordinates.

        Setting width=height=0 removes the already-set rectangle.

      </description>

      <arg name="surface" type="object" interface="wl_surface"/>

      <arg name="x" type="int"/>

      <arg name="y" type="int"/>

      <arg name="width" type="int"/>

      <arg name="height" type="int"/>

    </request>

    <enum name="error">

      <entry name="invalid_rectangle" value="0"

        summary="the provided rectangle is invalid"/>

    </enum>

    <event name="closed">

      <description summary="this toplevel has been destroyed">

        This event means the toplevel has been destroyed. It is guaranteed there

        won't be any more events for this zwlr_foreign_toplevel_handle_v1. The

        toplevel itself becomes inert so any requests will be ignored except the

        destroy request.

      </description>

    </event>

    <request name="destroy" type="destructor">

      <description summary="destroy the zwlr_foreign_toplevel_handle_v1 object">

        Destroys the zwlr_foreign_toplevel_handle_v1 object.

        This request should be called either when the client does not want to

        use the toplevel anymore or after the closed event to finalize the

        destruction of the object.

      </description>

    </request>

    <!-- Version 2 additions -->

    <request name="set_fullscreen" since="2">

      <description summary="request that the toplevel be fullscreened">

        Requests that the toplevel be fullscreened on the given output. If the

        fullscreen state and/or the outputs the toplevel is visible on actually

        change, this will be indicated by the state and output_enter/leave

        events.

        The output parameter is only a hint to the compositor. Also, if output

        is NULL, the compositor should decide which output the toplevel will be

        fullscreened on, if at all.

      </description>

      <arg name="output" type="object" interface="wl_output" allow-null="true"/>

    </request>

    <request name="unset_fullscreen" since="2">

      <description summary="request that the toplevel be unfullscreened">

        Requests that the toplevel be unfullscreened. If the fullscreen state

        actually changes, this will be indicated by the state event.

      </description>

    </request>

    <!-- Version 3 additions -->

    <event name="parent" since="3">

      <description summary="parent change">

        This event is emitted whenever the parent of the toplevel changes.

        No event is emitted when the parent handle is destroyed by the client.

      </description>

      <arg name="parent" type="object" interface="zwlr_foreign_toplevel_handle_v1" allow-null="true"/>

    </event>

  </interface>

</protocol>

<?xml version="1.0" encoding="UTF-8"?>

<!-- SPDX-License-Identifier: MIT -->

<protocol name="wlr_virtual_pointer_unstable_v1">

  <copyright>

    Copyright © 2019 Josef Gajdusek

    Permission is hereby granted, free of charge, to any person obtaining a

    copy of this software and associated documentation files, to deal in the

    Software without restriction, including without limitation the rights to

    use, copy, modify, merge, publish, distribute, sublicense, and/or sell

    copies, subject to inclusion of this notice. THE SOFTWARE IS PROVIDED

    "AS IS", WITHOUT WARRANTY OF ANY KIND.

  </copyright>

  <interface name="zwlr_virtual_pointer_v1" version="2">

    <description summary="virtual pointer"/>

    <enum name="error">

      <entry name="invalid_axis" value="0" summary="invalid axis"/>

      <entry name="invalid_axis_source" value="1" summary="invalid source"/>

    </enum>

    <request name="motion">

      <arg name="time" type="uint"/><arg name="dx" type="fixed"/>

      <arg name="dy" type="fixed"/>

    </request>

    <request name="motion_absolute">

      <arg name="time" type="uint"/><arg name="x" type="uint"/>

      <arg name="y" type="uint"/><arg name="x_extent" type="uint"/>

      <arg name="y_extent" type="uint"/>

    </request>

    <request name="button">

      <arg name="time" type="uint"/><arg name="button" type="uint"/>

      <arg name="state" type="uint" enum="wl_pointer.button_state"/>

    </request>

    <request name="axis">

      <arg name="time" type="uint"/>

      <arg name="axis" type="uint" enum="wl_pointer.axis"/>

      <arg name="value" type="fixed"/>

    </request>

    <request name="frame"/>

    <request name="axis_source">

      <arg name="axis_source" type="uint" enum="wl_pointer.axis_source"/>

    </request>

    <request name="axis_stop">

      <arg name="time" type="uint"/>

      <arg name="axis" type="uint" enum="wl_pointer.axis"/>

    </request>

    <request name="axis_discrete">

      <arg name="time" type="uint"/>

      <arg name="axis" type="uint" enum="wl_pointer.axis"/>

      <arg name="value" type="fixed"/><arg name="discrete" type="int"/>

    </request>

    <request name="destroy" type="destructor" since="1"/>

  </interface>

  <interface name="zwlr_virtual_pointer_manager_v1" version="2">

    <description summary="virtual pointer manager"/>

    <request name="create_virtual_pointer">

      <arg name="seat" type="object" interface="wl_seat" allow-null="true"/>

      <arg name="id" type="new_id" interface="zwlr_virtual_pointer_v1"/>

    </request>

    <request name="destroy" type="destructor" since="1"/>

    <request name="create_virtual_pointer_with_output" since="2">

      <arg name="seat" type="object" interface="wl_seat" allow-null="true"/>

      <arg name="output" type="object" interface="wl_output" allow-null="true"/>

      <arg name="id" type="new_id" interface="zwlr_virtual_pointer_v1"/>

    </request>

  </interface>

</protocol>

.build/

__pycache__/

#!/usr/bin/env python3

"""Protocol clients used by the Python integration runner."""

from __future__ import annotations

import ctypes

import mmap

import os

import struct

import subprocess

import sys

import tempfile

import time

from pathlib import Path

from pywayland.client import Display

from protocols.ext_session_lock_v1 import (

    ExtSessionLockManagerV1,

)

from protocols.ext_workspace_v1 import ExtWorkspaceManagerV1

from protocols.idle_inhibit_unstable_v1 import ZwpIdleInhibitManagerV1

from protocols.input_method_unstable_v2 import ZwpInputMethodManagerV2

from protocols.keyboard_shortcuts_inhibit_unstable_v1 import (

    ZwpKeyboardShortcutsInhibitManagerV1,

)

from protocols.pointer_constraints_unstable_v1 import ZwpPointerConstraintsV1

from protocols.relative_pointer_unstable_v1 import ZwpRelativePointerManagerV1

from protocols.text_input_unstable_v3 import ZwpTextInputManagerV3

from protocols.virtual_keyboard_unstable_v1 import ZwpVirtualKeyboardManagerV1

from protocols.wayland import (

    WlCompositor,

    WlKeyboard,

    WlOutput,

    WlSeat,

    WlShm,

)

from protocols.wlr_foreign_toplevel_management_unstable_v1 import (

    ZwlrForeignToplevelManagerV1,

)

from protocols.wlr_layer_shell_unstable_v1 import ZwlrLayerShellV1

from protocols.wlr_output_power_management_unstable_v1 import (

    ZwlrOutputPowerManagerV1,

)

from protocols.wlr_virtual_pointer_unstable_v1 import ZwlrVirtualPointerManagerV1

from protocols.xdg_shell import XdgPositioner, XdgToplevel, XdgWmBase

class Failure(RuntimeError):

    """Report a protocol-client failure."""

class Connection:

    """Bind requested globals on one Wayland connection."""

    def __init__(self, *interfaces):

        self.display = Display()

        self.display.connect()

        self.registry = self.display.get_registry()

        self.interfaces = {interface.name: interface for interface in interfaces}

        self.globals: dict[str, object] = {}

        self.registry.dispatcher["global"] = self._global

        self.display.roundtrip()

    def _global(self, registry, name: int, interface: str, version: int) -> None:

        wanted = self.interfaces.get(interface)

        if wanted is not None and interface not in self.globals:

            self.globals[interface] = registry.bind(name, wanted, min(version, wanted.version))

    def get(self, interface):

        """Return a required bound global."""

        try:

            return self.globals[interface.name]

        except KeyError as error:

            raise Failure(f"compositor does not advertise {interface.name}") from error

    def roundtrips(self, count: int = 1) -> None:

        """Complete several request/event exchanges."""

        for _ in range(count):

            if self.display.roundtrip() < 0:

                raise Failure("Wayland roundtrip failed")

    def close(self) -> None:

        """Disconnect from the compositor."""

        self.display.disconnect()

def create_buffer(shm, width: int, height: int, color: int):

    """Create a solid-color shared-memory buffer."""

    size = width * height * 4

    with tempfile.TemporaryFile(dir=os.environ.get("SWM_TEST_DIR")) as stream:

        stream.truncate(size)

        pixels = mmap.mmap(stream.fileno(), size)

        pixels[:] = struct.pack("=I", color) * (width * height)

        pixels.flush()

        pool = shm.create_pool(stream.fileno(), size)

        buffer = pool.create_buffer(0, width, height, width * 4, WlShm.format.argb8888)

        pool.destroy()

    buffer.dispatcher["release"] = lambda proxy: proxy.destroy()

    return buffer

class Window:

    """Own one mapped XDG toplevel and report configure state."""

    def __init__(

        self,

        connection: Connection,

        title: str,

        color: int,

        parent=None,

        fullscreen: bool = False,

        report: Path | None = None,

    ):

        self.connection = connection

        self.compositor = connection.get(WlCompositor)

        self.shm = connection.get(WlShm)

        self.wm_base = connection.get(XdgWmBase)

        self.title = title

        self.color = color

        self.width = 320

        self.height = 200

        self.fullscreen = False

        self.running = True

        self.report = report