i3 FAQ - Individual question feed

i3 FAQ - Individual question feedhttps://faq.i3wm.org/questions/Frequently asked questions and answers about the i3 window managerenCopyright i3, 2012Sat, 13 Dec 2014 21:34:10 +0000How do I correctly qualify event subscriptions with the IPC interface?https://faq.i3wm.org/question/5115/how-do-i-correctly-qualify-event-subscriptions-with-the-ipc-interface/Hello everyone, I am developing a small Python library to communicate with the i3 IPC interface and experience some problems when trying to subscribe to events [as described in the official documentation](http://i3wm.org/docs/ipc.html#_subscribing_to_events). There the documentation puts the following example for event subscription: >**4.1 Subscribing to Events** >By sending a message of type SUBSCRIBE with a JSON-encoded array as payload you can register to an event. > **Example:** > type: SUBSCRIBE > payload: [ "workspace", "focus" ] I take this to mean that I can specifically subscribe to focus events of workspaces. Why else would I want to add `"focus"` to the payload. But it seems that - at least for me - there is no difference in the events received between subscribing to `["workspace", "focus"]` or subscribing to just `["workspace"]`. I first tried to subscribe to "new window" events by supplying `["window", "new"]` as payload to the subcription message. But when doing this, I still received messages for any other window change - "focus", "title" and "fullscreen_mode". This did not seem to be different from subscribing to just `["window"]`. Therefore my question: What am I missing? Sat, 06 Dec 2014 21:47:04 +0000https://faq.i3wm.org/question/5115/how-do-i-correctly-qualify-event-subscriptions-with-the-ipc-interface/Answer by Michael for Hello everyone, I am developing a small Python library to communicate with the i3 IPC interface and experience some problems when trying to subscribe to events <a href="http://i3wm.org/docs/ipc.html#_subscribing_to_events">as described in the official documentation</a>. There the documentation puts the following example for event subscription: <blockquote> 4.1 Subscribing to Events By sending a message of type SUBSCRIBE with a JSON-encoded array as payload you can register to an event. Example: <pre><code>type: SUBSCRIBE payload: [ "workspace", "focus" ] </code></pre> </blockquote> I take this to mean that I can specifically subscribe to focus events of workspaces. Why else would I want to add <code>"focus"</code> to the payload. But it seems that - at least for me - there is no difference in the events received between subscribing to <code>["workspace", "focus"]</code> or subscribing to just <code>["workspace"]</code>. I first tried to subscribe to "new window" events by supplying <code>["window", "new"]</code> as payload to the subcription message. But when doing this, I still received messages for any other window change - "focus", "title" and "fullscreen_mode". This did not seem to be different from subscribing to just <code>["window"]</code>. Therefore my question: What am I missing? https://faq.i3wm.org/question/5115/how-do-i-correctly-qualify-event-subscriptions-with-the-ipc-interface/?answer=5116#post-id-5116Can you clarify which part of the documentation seemed to suggested that? The truth is that event types are more coarse: the “window” event type simply contains a “change” member that tells you what changed. Both the “"change": "new"” event and the “"change": "focus"” event are of type “window”. As a rule of thumb: an event type is everything that has a subsection in section “4. Events” in http://i3wm.org/docs/ipc.html Any further filtering should be done in the application itself.Sat, 06 Dec 2014 22:18:21 +0000https://faq.i3wm.org/question/5115/how-do-i-correctly-qualify-event-subscriptions-with-the-ipc-interface/?answer=5116#post-id-5116Comment by Michael for Can you clarify which part of the documentation seemed to suggested that? The truth is that event types are more coarse: the “window” event type simply contains a “change” member that tells you what changed. Both the “"change": "new"” event and the “"change": "focus"” event are of type “window”. As a rule of thumb: an event type is everything that has a subsection in section “4. Events” in <a href="http://i3wm.org/docs/ipc.html">http://i3wm.org/docs/ipc.html</a> Any further filtering should be done in the application itself. https://faq.i3wm.org/question/5115/how-do-i-correctly-qualify-event-subscriptions-with-the-ipc-interface/?comment=5174#comment-5174fixed: http://c.i3wm.org/04fa40dSat, 13 Dec 2014 21:34:10 +0000https://faq.i3wm.org/question/5115/how-do-i-correctly-qualify-event-subscriptions-with-the-ipc-interface/?comment=5174#comment-5174Comment by Adaephon for Can you clarify which part of the documentation seemed to suggested that? The truth is that event types are more coarse: the “window” event type simply contains a “change” member that tells you what changed. Both the “"change": "new"” event and the “"change": "focus"” event are of type “window”. As a rule of thumb: an event type is everything that has a subsection in section “4. Events” in <a href="http://i3wm.org/docs/ipc.html">http://i3wm.org/docs/ipc.html</a> Any further filtering should be done in the application itself. https://faq.i3wm.org/question/5115/how-do-i-correctly-qualify-event-subscriptions-with-the-ipc-interface/?comment=5140#comment-5140Ok, I did some testing and found that I can subscribe multiple event types at once - for example `["workspace", "window", "mode"]`. So, am I right to assume that `"focus"` is just a typo or possibly a remnant from a time when there was a "focus" event?Mon, 08 Dec 2014 14:14:53 +0000https://faq.i3wm.org/question/5115/how-do-i-correctly-qualify-event-subscriptions-with-the-ipc-interface/?comment=5140#comment-5140Comment by Adaephon for Can you clarify which part of the documentation seemed to suggested that? The truth is that event types are more coarse: the “window” event type simply contains a “change” member that tells you what changed. Both the “"change": "new"” event and the “"change": "focus"” event are of type “window”. As a rule of thumb: an event type is everything that has a subsection in section “4. Events” in <a href="http://i3wm.org/docs/ipc.html">http://i3wm.org/docs/ipc.html</a> Any further filtering should be done in the application itself. https://faq.i3wm.org/question/5115/how-do-i-correctly-qualify-event-subscriptions-with-the-ipc-interface/?comment=5138#comment-5138Thanks for the quick response. To answer your question: the example in Section 4.1 - `["workspace", "focus"]` - lead me to believe that I could - and maybe even should - subcribe to specific events. I also updated my question accordingly.Mon, 08 Dec 2014 09:49:24 +0000https://faq.i3wm.org/question/5115/how-do-i-correctly-qualify-event-subscriptions-with-the-ipc-interface/?comment=5138#comment-5138