Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
# vim:ts=2:sw=2:expandtab
|
|
|
|
|
#
|
|
|
|
|
# i3 - an improved dynamic tiling window manager
|
|
|
|
|
# © 2009-2012 Michael Stapelberg and contributors (see also: LICENSE)
|
|
|
|
|
#
|
|
|
|
|
# parser-specs/commands.spec: Specification file for generate-command-parser.pl
|
|
|
|
|
# which will generate the appropriate header files for our C parser.
|
|
|
|
|
#
|
|
|
|
|
# Use :source highlighting.vim in vim to get syntax highlighting
|
|
|
|
|
# for this file.
|
|
|
|
|
|
|
|
|
|
state INITIAL:
|
|
|
|
|
# We have an end token here for all the commands which just call some
|
|
|
|
|
# function without using an explicit 'end' token.
|
|
|
|
|
end ->
|
|
|
|
|
'[' -> call cmd_criteria_init(); CRITERIA
|
|
|
|
|
'move' -> MOVE
|
|
|
|
|
'exec' -> EXEC
|
|
|
|
|
'exit' -> call cmd_exit()
|
|
|
|
|
'restart' -> call cmd_restart()
|
|
|
|
|
'reload' -> call cmd_reload()
|
2013-06-05 09:04:57 -04:00
|
|
|
'shmlog' -> SHMLOG
|
2013-06-05 09:06:53 -04:00
|
|
|
'debuglog' -> DEBUGLOG
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
'border' -> BORDER
|
|
|
|
|
'layout' -> LAYOUT
|
|
|
|
|
'append_layout' -> APPEND_LAYOUT
|
|
|
|
|
'workspace' -> WORKSPACE
|
|
|
|
|
'focus' -> FOCUS
|
|
|
|
|
'kill' -> KILL
|
|
|
|
|
'open' -> call cmd_open()
|
|
|
|
|
'fullscreen' -> FULLSCREEN
|
|
|
|
|
'split' -> SPLIT
|
|
|
|
|
'floating' -> FLOATING
|
|
|
|
|
'mark' -> MARK
|
2013-07-15 18:33:14 -04:00
|
|
|
'unmark' -> UNMARK
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
'resize' -> RESIZE
|
2012-04-08 14:34:31 -04:00
|
|
|
'rename' -> RENAME
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
'nop' -> NOP
|
|
|
|
|
'scratchpad' -> SCRATCHPAD
|
|
|
|
|
'mode' -> MODE
|
introduced i3 command for changing the hidden state and the mode of i3bar
The hidden_state and mode of each i3bar instance can now be controlled from within i3.
Therefore, two new i3 command were introduced:
_
bar hidden_state show|hide|toggle [<bar_id>]
show: always show the bar
hide: normal hide mode
toggle: toggle between show and hide (individually for each bar)
_
bar mode dock|hide|invisible|toggle [<bar_id>]
hide,dock: like before
invisible: always keep the bar hidden
toggle: toggle between dock and hide (individually for each bar)
This patch introduces a hidden_state ("hidden_state hide|show") in the
barconfig, which indicates the current hidden_state of each i3bar
instance. It only affects the bar when in hide mode. Additionally, a new
invisible mode was introduced. In order to change the hidden_state or
mode of the bar from i3, a barconfig-update event was introduced, for
which a bar can subscribe and the bar then gets notified about the
currently set hidden_state and mode in its barconfig.
For convenience, an id field ("id <bar_id>") was added to the barconfig, where one can
set the desired id for the corresponding bar. If the id is not specified, i3 will
deterministically choose an id; otherwise, with the previous random approach for finding
a new id, which is actually not shared with i3bar, as it would determine its id on
startup, the event-subscription would be destroyed on reload. Still, this issue remains
when manually changing the bar_id in the config and then reloading.
fixes #833, #651
2013-05-25 08:30:00 -04:00
|
|
|
'bar' -> BAR
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
|
|
|
|
|
state CRITERIA:
|
|
|
|
|
ctype = 'class' -> CRITERION
|
|
|
|
|
ctype = 'instance' -> CRITERION
|
|
|
|
|
ctype = 'window_role' -> CRITERION
|
|
|
|
|
ctype = 'con_id' -> CRITERION
|
|
|
|
|
ctype = 'id' -> CRITERION
|
|
|
|
|
ctype = 'con_mark' -> CRITERION
|
|
|
|
|
ctype = 'title' -> CRITERION
|
2012-01-24 18:00:27 -05:00
|
|
|
ctype = 'urgent' -> CRITERION
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
']' -> call cmd_criteria_match_windows(); INITIAL
|
|
|
|
|
|
|
|
|
|
state CRITERION:
|
|
|
|
|
'=' -> CRITERION_STR
|
|
|
|
|
|
|
|
|
|
state CRITERION_STR:
|
|
|
|
|
cvalue = word
|
|
|
|
|
-> call cmd_criteria_add($ctype, $cvalue); CRITERIA
|
|
|
|
|
|
|
|
|
|
# exec [--no-startup-id] <command>
|
|
|
|
|
state EXEC:
|
|
|
|
|
nosn = '--no-startup-id'
|
|
|
|
|
->
|
|
|
|
|
command = string
|
|
|
|
|
-> call cmd_exec($nosn, $command)
|
|
|
|
|
|
2013-06-05 09:04:57 -04:00
|
|
|
# shmlog <size>|toggle|on|off
|
|
|
|
|
state SHMLOG:
|
|
|
|
|
# argument may be a number
|
|
|
|
|
argument = string
|
|
|
|
|
-> call cmd_shmlog($argument)
|
|
|
|
|
|
2013-06-05 09:06:53 -04:00
|
|
|
# debuglog toggle|on|off
|
|
|
|
|
state DEBUGLOG:
|
|
|
|
|
argument = 'toggle', 'on', 'off'
|
|
|
|
|
-> call cmd_debuglog($argument)
|
|
|
|
|
|
2012-09-23 19:14:00 -04:00
|
|
|
# border normal|none|1pixel|toggle|1pixel
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
state BORDER:
|
2012-09-23 19:14:00 -04:00
|
|
|
border_style = 'normal', 'pixel'
|
|
|
|
|
-> BORDER_WIDTH
|
|
|
|
|
border_style = 'none', 'toggle'
|
|
|
|
|
-> call cmd_border($border_style, "0")
|
|
|
|
|
border_style = '1pixel'
|
|
|
|
|
-> call cmd_border($border_style, "1")
|
|
|
|
|
|
|
|
|
|
state BORDER_WIDTH:
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_border($border_style, "2")
|
|
|
|
|
border_width = word
|
|
|
|
|
-> call cmd_border($border_style, $border_width)
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
|
Introduce splith/splitv layouts, remove orientation
With this commit, the "default" layout is replaced by the splith and
splitv layouts. splith is equivalent to default with orientation
horizontal and splitv is equivalent to default with orientation
vertical.
The "split h" and "split v" commands continue to work as before, they
split the current container and you will end up in a split container
with layout splith (after "split h") or splitv (after "split v").
To change a splith container into a splitv container, use either "layout
splitv" or "layout toggle split". The latter command is used in the
default config as mod+l (previously "layout default"). In case you have
"layout default" in your config file, it is recommended to just replace
it by "layout toggle split", which will work as "layout default" did
before when pressing it once, but toggle between horizontal/vertical
when pressing it repeatedly.
The rationale behind this commit is that it’s cleaner to have all
parameters that influence how windows are rendered in the layout itself
rather than having a special parameter in combination with only one
layout. This enables us to change existing split containers in all cases
without breaking existing features (see ticket #464). Also, users should
feel more confident about whether they are actually splitting or just
changing an existing split container now.
As a nice side-effect, this commit brings back the "layout toggle"
feature we once had in i3 version 3 (see the userguide).
AFAIK, it is safe to use in-place restart to upgrade into versions
after this commit (switching to an older version will break your layout,
though).
Fixes #464
2012-08-03 21:04:00 -04:00
|
|
|
# layout default|stacked|stacking|tabbed|splitv|splith
|
|
|
|
|
# layout toggle [split|all]
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
state LAYOUT:
|
Introduce splith/splitv layouts, remove orientation
With this commit, the "default" layout is replaced by the splith and
splitv layouts. splith is equivalent to default with orientation
horizontal and splitv is equivalent to default with orientation
vertical.
The "split h" and "split v" commands continue to work as before, they
split the current container and you will end up in a split container
with layout splith (after "split h") or splitv (after "split v").
To change a splith container into a splitv container, use either "layout
splitv" or "layout toggle split". The latter command is used in the
default config as mod+l (previously "layout default"). In case you have
"layout default" in your config file, it is recommended to just replace
it by "layout toggle split", which will work as "layout default" did
before when pressing it once, but toggle between horizontal/vertical
when pressing it repeatedly.
The rationale behind this commit is that it’s cleaner to have all
parameters that influence how windows are rendered in the layout itself
rather than having a special parameter in combination with only one
layout. This enables us to change existing split containers in all cases
without breaking existing features (see ticket #464). Also, users should
feel more confident about whether they are actually splitting or just
changing an existing split container now.
As a nice side-effect, this commit brings back the "layout toggle"
feature we once had in i3 version 3 (see the userguide).
AFAIK, it is safe to use in-place restart to upgrade into versions
after this commit (switching to an older version will break your layout,
though).
Fixes #464
2012-08-03 21:04:00 -04:00
|
|
|
layout_mode = 'default', 'stacked', 'stacking', 'tabbed', 'splitv', 'splith'
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
-> call cmd_layout($layout_mode)
|
Introduce splith/splitv layouts, remove orientation
With this commit, the "default" layout is replaced by the splith and
splitv layouts. splith is equivalent to default with orientation
horizontal and splitv is equivalent to default with orientation
vertical.
The "split h" and "split v" commands continue to work as before, they
split the current container and you will end up in a split container
with layout splith (after "split h") or splitv (after "split v").
To change a splith container into a splitv container, use either "layout
splitv" or "layout toggle split". The latter command is used in the
default config as mod+l (previously "layout default"). In case you have
"layout default" in your config file, it is recommended to just replace
it by "layout toggle split", which will work as "layout default" did
before when pressing it once, but toggle between horizontal/vertical
when pressing it repeatedly.
The rationale behind this commit is that it’s cleaner to have all
parameters that influence how windows are rendered in the layout itself
rather than having a special parameter in combination with only one
layout. This enables us to change existing split containers in all cases
without breaking existing features (see ticket #464). Also, users should
feel more confident about whether they are actually splitting or just
changing an existing split container now.
As a nice side-effect, this commit brings back the "layout toggle"
feature we once had in i3 version 3 (see the userguide).
AFAIK, it is safe to use in-place restart to upgrade into versions
after this commit (switching to an older version will break your layout,
though).
Fixes #464
2012-08-03 21:04:00 -04:00
|
|
|
'toggle'
|
|
|
|
|
-> LAYOUT_TOGGLE
|
|
|
|
|
|
|
|
|
|
# layout toggle [split|all]
|
|
|
|
|
state LAYOUT_TOGGLE:
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_layout_toggle($toggle_mode)
|
|
|
|
|
toggle_mode = 'split', 'all'
|
|
|
|
|
-> call cmd_layout_toggle($toggle_mode)
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
|
|
|
|
|
# append_layout <path>
|
|
|
|
|
state APPEND_LAYOUT:
|
|
|
|
|
path = string -> call cmd_append_layout($path)
|
|
|
|
|
|
|
|
|
|
# workspace next|prev|next_on_output|prev_on_output
|
|
|
|
|
# workspace back_and_forth
|
|
|
|
|
# workspace <name>
|
2012-04-08 13:17:46 -04:00
|
|
|
# workspace number <number>
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
state WORKSPACE:
|
|
|
|
|
direction = 'next_on_output', 'prev_on_output', 'next', 'prev'
|
|
|
|
|
-> call cmd_workspace($direction)
|
|
|
|
|
'back_and_forth'
|
|
|
|
|
-> call cmd_workspace_back_and_forth()
|
2012-04-08 13:17:46 -04:00
|
|
|
'number'
|
|
|
|
|
-> WORKSPACE_NUMBER
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
workspace = string
|
|
|
|
|
-> call cmd_workspace_name($workspace)
|
|
|
|
|
|
2012-04-08 13:17:46 -04:00
|
|
|
state WORKSPACE_NUMBER:
|
|
|
|
|
workspace = string
|
|
|
|
|
-> call cmd_workspace_number($workspace)
|
|
|
|
|
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
# focus left|right|up|down
|
|
|
|
|
# focus output <output>
|
|
|
|
|
# focus tiling|floating|mode_toggle
|
|
|
|
|
# focus parent|child
|
|
|
|
|
# focus
|
|
|
|
|
state FOCUS:
|
|
|
|
|
direction = 'left', 'right', 'up', 'down'
|
|
|
|
|
-> call cmd_focus_direction($direction)
|
|
|
|
|
'output'
|
|
|
|
|
-> FOCUS_OUTPUT
|
|
|
|
|
window_mode = 'tiling', 'floating', 'mode_toggle'
|
|
|
|
|
-> call cmd_focus_window_mode($window_mode)
|
|
|
|
|
level = 'parent', 'child'
|
|
|
|
|
-> call cmd_focus_level($level)
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_focus()
|
|
|
|
|
|
|
|
|
|
state FOCUS_OUTPUT:
|
|
|
|
|
output = string
|
|
|
|
|
-> call cmd_focus_output($output)
|
|
|
|
|
|
2012-01-27 17:32:40 -05:00
|
|
|
# kill [window|client]
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
state KILL:
|
|
|
|
|
kill_mode = 'window', 'client'
|
|
|
|
|
-> call cmd_kill($kill_mode)
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_kill($kill_mode)
|
|
|
|
|
|
2012-01-27 17:32:40 -05:00
|
|
|
# fullscreen [global]
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
state FULLSCREEN:
|
|
|
|
|
fullscreen_mode = 'global'
|
|
|
|
|
-> call cmd_fullscreen($fullscreen_mode)
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_fullscreen($fullscreen_mode)
|
|
|
|
|
|
|
|
|
|
# split v|h|vertical|horizontal
|
|
|
|
|
state SPLIT:
|
2012-06-10 11:56:28 -04:00
|
|
|
direction = 'horizontal', 'vertical', 'v', 'h'
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
-> call cmd_split($direction)
|
|
|
|
|
|
|
|
|
|
# floating enable|disable|toggle
|
|
|
|
|
state FLOATING:
|
|
|
|
|
floating = 'enable', 'disable', 'toggle'
|
|
|
|
|
-> call cmd_floating($floating)
|
|
|
|
|
|
|
|
|
|
# mark <mark>
|
|
|
|
|
state MARK:
|
|
|
|
|
mark = string
|
|
|
|
|
-> call cmd_mark($mark)
|
|
|
|
|
|
2013-07-15 18:33:14 -04:00
|
|
|
# unmark [mark]
|
|
|
|
|
state UNMARK:
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_unmark($mark)
|
|
|
|
|
mark = string
|
|
|
|
|
-> call cmd_unmark($mark)
|
|
|
|
|
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
# resize
|
|
|
|
|
state RESIZE:
|
|
|
|
|
way = 'grow', 'shrink'
|
|
|
|
|
-> RESIZE_DIRECTION
|
|
|
|
|
|
|
|
|
|
state RESIZE_DIRECTION:
|
2012-04-08 09:59:49 -04:00
|
|
|
direction = 'up', 'down', 'left', 'right', 'width', 'height'
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
-> RESIZE_PX
|
|
|
|
|
|
|
|
|
|
state RESIZE_PX:
|
|
|
|
|
resize_px = word
|
|
|
|
|
-> RESIZE_TILING
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_resize($way, $direction, "10", "10")
|
|
|
|
|
|
|
|
|
|
state RESIZE_TILING:
|
|
|
|
|
'px'
|
|
|
|
|
->
|
|
|
|
|
'or'
|
|
|
|
|
-> RESIZE_TILING_OR
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_resize($way, $direction, $resize_px, "10")
|
|
|
|
|
|
|
|
|
|
state RESIZE_TILING_OR:
|
|
|
|
|
resize_ppt = word
|
2013-10-09 16:30:41 -04:00
|
|
|
-> RESIZE_TILING_FINAL
|
|
|
|
|
|
|
|
|
|
state RESIZE_TILING_FINAL:
|
|
|
|
|
'ppt', end
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
-> call cmd_resize($way, $direction, $resize_px, $resize_ppt)
|
|
|
|
|
|
2012-04-08 14:34:31 -04:00
|
|
|
# rename workspace <name> to <name>
|
2012-10-29 17:42:20 -04:00
|
|
|
# rename workspace to <name>
|
2012-04-08 14:34:31 -04:00
|
|
|
state RENAME:
|
|
|
|
|
'workspace'
|
|
|
|
|
-> RENAME_WORKSPACE
|
|
|
|
|
|
|
|
|
|
state RENAME_WORKSPACE:
|
2012-10-29 17:42:20 -04:00
|
|
|
old_name = 'to'
|
|
|
|
|
-> RENAME_WORKSPACE_LIKELY_TO
|
2012-04-08 14:34:31 -04:00
|
|
|
old_name = word
|
|
|
|
|
-> RENAME_WORKSPACE_TO
|
|
|
|
|
|
2012-10-29 17:42:20 -04:00
|
|
|
state RENAME_WORKSPACE_LIKELY_TO:
|
|
|
|
|
'to'
|
|
|
|
|
-> RENAME_WORKSPACE_NEW_NAME
|
|
|
|
|
new_name = word
|
|
|
|
|
-> call cmd_rename_workspace(NULL, $new_name)
|
|
|
|
|
|
2012-04-08 14:34:31 -04:00
|
|
|
state RENAME_WORKSPACE_TO:
|
|
|
|
|
'to'
|
2012-10-29 17:42:20 -04:00
|
|
|
-> RENAME_WORKSPACE_NEW_NAME
|
|
|
|
|
|
|
|
|
|
state RENAME_WORKSPACE_NEW_NAME:
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_rename_workspace(NULL, "to")
|
2012-04-08 14:34:31 -04:00
|
|
|
new_name = string
|
|
|
|
|
-> call cmd_rename_workspace($old_name, $new_name)
|
|
|
|
|
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
# move <direction> [<pixels> [px]]
|
2013-01-29 03:05:23 -05:00
|
|
|
# move [window|container] [to] workspace [<str>|next|prev|next_on_output|prev_on_output|current]
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
# move [window|container] [to] output <str>
|
|
|
|
|
# move [window|container] [to] scratchpad
|
|
|
|
|
# move workspace to [output] <str>
|
|
|
|
|
# move scratchpad
|
2012-03-23 08:39:17 -04:00
|
|
|
# move [window|container] [to] [absolute] position [ [<pixels> [px] <pixels> [px]] | center ]
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
state MOVE:
|
|
|
|
|
'window'
|
|
|
|
|
->
|
|
|
|
|
'container'
|
|
|
|
|
->
|
|
|
|
|
'to'
|
|
|
|
|
->
|
|
|
|
|
'workspace'
|
|
|
|
|
-> MOVE_WORKSPACE
|
|
|
|
|
'output'
|
|
|
|
|
-> MOVE_TO_OUTPUT
|
|
|
|
|
'scratchpad'
|
|
|
|
|
-> call cmd_move_scratchpad()
|
|
|
|
|
direction = 'left', 'right', 'up', 'down'
|
|
|
|
|
-> MOVE_DIRECTION
|
2012-03-23 08:39:17 -04:00
|
|
|
method = 'position'
|
|
|
|
|
-> MOVE_TO_POSITION
|
|
|
|
|
method = 'absolute'
|
|
|
|
|
-> MOVE_TO_ABSOLUTE_POSITION
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
|
|
|
|
|
state MOVE_DIRECTION:
|
|
|
|
|
pixels = word
|
|
|
|
|
-> MOVE_DIRECTION_PX
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_move_direction($direction, "10")
|
|
|
|
|
|
|
|
|
|
state MOVE_DIRECTION_PX:
|
|
|
|
|
'px'
|
|
|
|
|
-> call cmd_move_direction($direction, $pixels)
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_move_direction($direction, $pixels)
|
|
|
|
|
|
|
|
|
|
state MOVE_WORKSPACE:
|
2013-02-18 18:27:55 -05:00
|
|
|
'to '
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
-> MOVE_WORKSPACE_TO_OUTPUT
|
2013-01-29 03:05:23 -05:00
|
|
|
workspace = 'next_on_output', 'prev_on_output', 'next', 'prev', 'current'
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
-> call cmd_move_con_to_workspace($workspace)
|
2012-09-04 04:51:18 -04:00
|
|
|
'back_and_forth'
|
|
|
|
|
-> call cmd_move_con_to_workspace_back_and_forth()
|
2012-04-08 14:33:46 -04:00
|
|
|
'number'
|
|
|
|
|
-> MOVE_WORKSPACE_NUMBER
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
workspace = string
|
|
|
|
|
-> call cmd_move_con_to_workspace_name($workspace)
|
|
|
|
|
|
2012-04-08 14:33:46 -04:00
|
|
|
state MOVE_WORKSPACE_NUMBER:
|
|
|
|
|
number = string
|
|
|
|
|
-> call cmd_move_con_to_workspace_number($number)
|
|
|
|
|
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
state MOVE_TO_OUTPUT:
|
|
|
|
|
output = string
|
|
|
|
|
-> call cmd_move_con_to_output($output)
|
|
|
|
|
|
|
|
|
|
state MOVE_WORKSPACE_TO_OUTPUT:
|
|
|
|
|
'output'
|
|
|
|
|
->
|
|
|
|
|
output = string
|
|
|
|
|
-> call cmd_move_workspace_to_output($output)
|
|
|
|
|
|
2012-03-23 08:39:17 -04:00
|
|
|
state MOVE_TO_ABSOLUTE_POSITION:
|
|
|
|
|
'position'
|
|
|
|
|
-> MOVE_TO_POSITION
|
|
|
|
|
|
|
|
|
|
state MOVE_TO_POSITION:
|
|
|
|
|
'center'
|
|
|
|
|
-> call cmd_move_window_to_center($method)
|
|
|
|
|
coord_x = word
|
|
|
|
|
-> MOVE_TO_POSITION_X
|
|
|
|
|
|
|
|
|
|
state MOVE_TO_POSITION_X:
|
|
|
|
|
'px'
|
|
|
|
|
->
|
|
|
|
|
coord_y = word
|
|
|
|
|
-> MOVE_TO_POSITION_Y
|
|
|
|
|
|
|
|
|
|
state MOVE_TO_POSITION_Y:
|
|
|
|
|
'px', end
|
|
|
|
|
-> call cmd_move_window_to_position($method, $coord_x, $coord_y)
|
|
|
|
|
|
Implement a new parser for commands. (+test)
On the rationale of using a custom parser instead of a lex/yacc one, see this
quote from src/commands_parser.c:
We use a hand-written parser instead of lex/yacc because our commands are
easy for humans, not for computers. Thus, it’s quite hard to specify a
context-free grammar for the commands. A PEG grammar would be easier, but
there’s downsides to every PEG parser generator I have come accross so far.
This parser is basically a state machine which looks for literals or strings
and can push either on a stack. After identifying a literal or string, it
will either transition to the current state, to a different state, or call a
function (like cmd_move()).
Special care has been taken that error messages are useful and the code is
well testable (when compiled with -DTEST_PARSER it will output to stdout
instead of actually calling any function).
During the migration phase (I plan to completely switch to this parser before
4.2 will be released), the new parser will parse every command you send to
i3 and save the resulting call stack. Then, the old parser will parse your
input and actually execute the commands. Afterwards, both call stacks will be
compared and any differences will be logged.
The new parser works with 100% of the test suite and produces identical call
stacks.
2012-01-14 14:53:29 -05:00
|
|
|
# mode <string>
|
|
|
|
|
state MODE:
|
|
|
|
|
mode = string
|
|
|
|
|
-> call cmd_mode($mode)
|
|
|
|
|
|
|
|
|
|
state NOP:
|
|
|
|
|
comment = string
|
|
|
|
|
-> call cmd_nop($comment)
|
|
|
|
|
|
|
|
|
|
state SCRATCHPAD:
|
|
|
|
|
'show'
|
|
|
|
|
-> call cmd_scratchpad_show()
|
introduced i3 command for changing the hidden state and the mode of i3bar
The hidden_state and mode of each i3bar instance can now be controlled from within i3.
Therefore, two new i3 command were introduced:
_
bar hidden_state show|hide|toggle [<bar_id>]
show: always show the bar
hide: normal hide mode
toggle: toggle between show and hide (individually for each bar)
_
bar mode dock|hide|invisible|toggle [<bar_id>]
hide,dock: like before
invisible: always keep the bar hidden
toggle: toggle between dock and hide (individually for each bar)
This patch introduces a hidden_state ("hidden_state hide|show") in the
barconfig, which indicates the current hidden_state of each i3bar
instance. It only affects the bar when in hide mode. Additionally, a new
invisible mode was introduced. In order to change the hidden_state or
mode of the bar from i3, a barconfig-update event was introduced, for
which a bar can subscribe and the bar then gets notified about the
currently set hidden_state and mode in its barconfig.
For convenience, an id field ("id <bar_id>") was added to the barconfig, where one can
set the desired id for the corresponding bar. If the id is not specified, i3 will
deterministically choose an id; otherwise, with the previous random approach for finding
a new id, which is actually not shared with i3bar, as it would determine its id on
startup, the event-subscription would be destroyed on reload. Still, this issue remains
when manually changing the bar_id in the config and then reloading.
fixes #833, #651
2013-05-25 08:30:00 -04:00
|
|
|
|
|
|
|
|
# bar (hidden_state hide|show|toggle)|(mode dock|hide|invisible|toggle) [<bar_id>]
|
|
|
|
|
state BAR:
|
|
|
|
|
bar_type = 'hidden_state'
|
|
|
|
|
-> BAR_HIDDEN_STATE
|
|
|
|
|
bar_type = 'mode'
|
|
|
|
|
-> BAR_MODE
|
|
|
|
|
|
|
|
|
|
state BAR_HIDDEN_STATE:
|
|
|
|
|
bar_value = 'hide', 'show', 'toggle'
|
|
|
|
|
-> BAR_W_ID
|
|
|
|
|
|
|
|
|
|
state BAR_MODE:
|
|
|
|
|
bar_value = 'dock', 'hide', 'invisible', 'toggle'
|
|
|
|
|
-> BAR_W_ID
|
|
|
|
|
|
|
|
|
|
state BAR_W_ID:
|
|
|
|
|
bar_id = word
|
|
|
|
|
->
|
|
|
|
|
end
|
|
|
|
|
-> call cmd_bar($bar_type, $bar_value, $bar_id)
|