summaryrefslogtreecommitdiff
path: root/menuconfig.py
AgeCommit message (Collapse)Author
2019-01-15Update copyright years for 2019Ulf Magnusson
2018-12-24menuconfig: Prompt for save if a different .config would be savedUlf Magnusson
Previously, menuconfig.py only prompted for saving the configuration if .config didn't exist or the user changed symbol values within the interface. Also make it prompt for save if Kconfig symbols have been added, removed, or have had their defaults changed, provided it would make the saved .config differ from the loaded one. This usually won't matter for correctness, because loading an outdated configuration performs an implicit olddefconfig, but it's less confusing. Also add a Kconfig.missing_syms attribute that records all assignments to undefined symbols in the most recently loaded .config file. This is needed to implement the check for whether the saved .config would be different. As an unrelated change, always prompt for saving if a .config has been loaded from within the menuconfig interface. The intention is probably often to save the configuration somewhere else, even if it isn't modified.
2018-12-15menuconfig: Add show-help modeUlf Magnusson
Pressing F toggles show-help mode, where the help window at the bottom displays the help text of the currently selected item, if any. Can be handy when browsing through symbols. Also mention the different modes that are available in the module docstring.
2018-12-08Make {load,write}_config(filename=None) implement the standard behaviorUlf Magnusson
Make the previously obligatory 'filename' argument to load_config() and write_config() default to None, and have that implement the behavior you'd usually want: read/write either KCONFIG_CONFIG or ".config" if unset, and read the 'option defconfig_list' configuration file if KCONFIG_CONFIG/".config" doesn't exist. For load_config(), filename=None also allows the configuration file to be missing without raising an error. load_config() returns True if a local configuration file was loaded, which is useful to check in the menuconfig (if no local configuration file exists, we always want to prompt for saving the configuration when exiting). Also add a 'verbose' argument (default True) to load_config() and read_config() that makes them print which files were read/written in filename=None mode. Also generalize olddefconfig.py and oldconfig.py to not require there to already be a local configuration file. This was a bit silly for olddefconfig.py in particular. Remove the examples/defconfig.py script. It's a duplicate of olddefconfig.py.
2018-12-07menuconfig: Code formatting nitUlf Magnusson
2018-11-28menuconfig: Clarify the scope of the named choice special-casingUlf Magnusson
One thing that irks me a bit about it is that it might give the idea that menuconfigs have to include it, making things seem more complex than they really are.
2018-11-28menuconfig: Improve comment re. multiply-defined choice symbolsUlf Magnusson
The thing it's talking about usually happens when some file with a named choice is included multiple times with different dependencies.
2018-11-28menuconfig: Fix variable name typo in commentUlf Magnusson
2018-11-28menuconfig: Only list duplicated choice symbols onceUlf Magnusson
When a Kconfig file defined a named choice and was included multiple times, the choice symbols were listed multiple times in the menuconfig as well (due to commit 17d7c1e ("menuconfig: Show all symbols at each menu location for multi.def. choices")). That's probably not what you want. Tweak it so that each symbol is only shown once, with the prompt that was used for it at whatever choice definition location is entered. Also change how the choice selection is displayed before the choice is entered, so that the prompt used for the selected symbol at that particular location is used. Previously, the prompt at the first definition location for the symbol was always used. (Note that all of this is only about how things are displayed. It's not essential to functionality, in case you're writing your own menuconfig.)
2018-11-21menuconfig: Mention that menus can be 'menuconfig' symbolsUlf Magnusson
They're either proper menus, choices, or 'menuconfig' symbols.
2018-11-21menuconfig: Print '----' instead of '---> (empty)'Ulf Magnusson
This matches the C tools and is a bit less spammy. Maybe it's less clear what it means at a glance, but it's probably less confusing for disabled 'menuconfig' symbols at least.
2018-11-18menuconfig: Never snap scroll back to max_scrollUlf Magnusson
When scroll > max_scroll (blank space at the bottom of the menu, and also scrolled down), moving the cursor down would snap the scroll back to max_scroll, with a small annoying jump. This could happen when going into show-all mode and moving the cursor down near the bottom of a menu, for example. Fix it by leaving the scroll as-is when scroll >= max_scroll (increasing it by one otherwise).
2018-11-18menuconfig: Tighten up _shown_nodes() a bitUlf Magnusson
Move the addition of the visible child nodes and use += instead of extend().
2018-11-18menuconfig: Get rid of a temporary list in the jump-to implemenationUlf Magnusson
Not noticeable performance-wise, but a bit neater.
2018-11-07menuconfig: Support HOME and END in the jump-to dialogUlf Magnusson
Oversight. END can be handy for viewing all choices, menus, and comments, which appear at the end. Also support Ctrl-D as an alias for Page Down. Ctrl-U is already used by the edit box (erase to beginning of line). Also change the jump-to dialog title to hint that other things besides symbols can be jumped to.
2018-11-04Comment grammar nitUlf Magnusson
2018-11-04menuconfig: Move cursor to choice selection when entering choicesUlf Magnusson
Previously, the first entry was selected, like for menus. Also tweak _center_vertically() so that the menu is never scrolled down when all entries fit on the screen.
2018-11-02menuconfig: Fix crash when toggling symbols without a typeUlf Magnusson
Trying to toggle the following symbol crashed the menuconfig: config FOO prompt "foo" Symbols defined without a type are pointless and generate a warning (particular definition locations can omit the type, but some definition location should give a type if the symbol is defined in multiple locations). We should never crash for them though. Fix the crash. The code assumed that the symbol's current value would appear in Symbol.assignable, like for a visible bool/tristate, but symbols without types get their name as their value. Also skip printing "(NEW)" next to symbols without a type.
2018-11-01menuconfig: Add quotes around filename for .config loading errorsUlf Magnusson
Turns into a weird-looking 'Error loading ' otherwise. Maybe Enter should be ignored for empty filenames instead...
2018-10-31Make errno/strerror/filename available on IOErrorUlf Magnusson
An error reporting flaw was that most raised IOErrors got their errno/strerror/filename fields stripped, due to wanting to show a custom messages. The problem was that adding back 'errno' and 'strerror' made IOError.__str__() always return a fixed string ("[Errno <errno>] <strerror>"), ignoring any custom message. This is friendly to users, but unfriendly to scripts (the menuconfig had a workaround). Make things friendly to both by raising an internal subclass of IOError instead, that preserves errno/strerror/filename but prints a custom message. The exception can then still be caught as IOError/OSError by scripts.
2018-10-22menuconfig: Mention jump-to in info dialog helpUlf Magnusson
Might be hard to discover that [/] works inside the info dialog otherwise.
2018-10-21menuconfig: Show the selected symbol for promptless choicesUlf Magnusson
If a choice is defined in multiple locations to add symbols, and show-all mode is turned on to reveal one of the promptless definitions, then it doesn't hurt to show the selected symbol next to it.
2018-10-21menuconfig: _node_str() simplification nitUlf Magnusson
2018-10-16menuconfig: Use Kconfig.unique_choices in jump-toUlf Magnusson
Use Kconfig.unique_choices instead of Kconfig.choices in the jump-to dialog, as choices defined in multiple locations should only get their menu nodes added once (to avoid redundant entries). I noticed a related Kconfiglib issue while working on this: Kconfig.choices has been identical to Kconfig.unique_choices all long, so things were never actually broken. That means Kconfig.choices should be fixed to match its description though. The next commit will do that.
2018-10-15menuconfig: Simplify _sorted_menu_comment_nodes()Ulf Magnusson
Can use the same function for both sort keys, and the logic can be simplified a bit too. The += is deliberate, to do in-place modification.
2018-10-14menuconfig: Fix some minor resizing jumpiness on gnome-terminalUlf Magnusson
gnome-terminal jerks a bit whenever the terminal is shrunk so that the row with the cursor on it disappears. This is probably gnome-terminal shoddiness, but it's pretty easy to work around by drawing stuff at the top last, so do it. No need to do it for the jump-to dialog, because the cursor is already in the edit box at the top there.
2018-10-14menuconfig: Switch back to "very visible" cursor after Ctrl-FUlf Magnusson
Was set back to "normal" instead due to a typo, which is inconsistent with the rest of the code.
2018-10-14menuconfig: Mention some ncurses ESCDELAY investigationUlf Magnusson
2018-10-14menuconfig: Mention some potential (though never seen) ESCDELAY iffinessUlf Magnusson
2018-10-14menuconfig: Mention that jump-to has been generalized in docstringUlf Magnusson
Can jump to choices, menus, and comments now as well.
2018-10-14menuconfig: Fix crash when pressing Ctrl-F with no matches in jump-to dialogUlf Magnusson
Ctrl-F is the jump-to dialog view-help shortcut. It needs to check whether there are any matches, like Enter/jump-to does.
2018-10-14menuconfig: Add jump-to for choices, menus, and commentsUlf Magnusson
For choices, search the name and the prompt. This is the same as for symbols, except names are optional (and rare) for choices. For menus and comments, search the prompt (title text). When jumping to a non-empty choice or menu, jump into it instead of jumping to its menu node. If show-all mode is off and there are visible items in the choice/menu, then jump to the first visible node. Otherwise, enable show-all and jump to the first node.
2018-10-13menuconfig: Do not show range hint for symbols without rangesUlf Magnusson
The 'no range constraints' input dialog hint for int/hex symbols might be more confusing than helpful, especially if you assume it was something the symbol author put there. Only show the range hint for symbols with active ranges instead, and show nothing for other symbols.
2018-10-10menuconfig: Comment formatting nitsUlf Magnusson
2018-10-10menuconfig: Improve/fix promptless choice handlingUlf Magnusson
The code assumed that all parent (interface) menus always have a prompt, which is false for items in promptless choices. This lead to a crash e.g. when viewing the symbol information for a symbol within a promptless choice. Promptless choices with children can show up "legitimately" when people define choices in multiple locations to add symbols, though this is broken in the C tools. Use standard_sc_expr_str(node.item) instead of the non-existing prompt for promptless choices. That way they show up as <choice (name if any>)>, which is consistent with how they're shown elsewhere. This commit also changes how choices names are displayed in show-name/show-all mode, to the standard_sc_expr_str() format.
2018-10-05menuconfig: Fix Page Up typo in docstringUlf Magnusson
2018-10-05menuconfig: Remove "Value for " prefix from input dialog titlesUlf Magnusson
The prompt and type alone make it obvious, and it prevents many dialogs from getting overly wide.
2018-10-02menuconfig: Mark quit_dialog() as internalUlf Magnusson
Oversight. The _ hides it from e.g. pydoc.
2018-09-19menuconfig: Fix some nits reported by flake8Ulf Magnusson
- Remove some unused imports - Replace a lambda with a plain function - Shorten some long lines - Remove some redundant backslashes within brackets
2018-09-14menuconfig: Fix typo re. menuconfig()Ulf Magnusson
No idea where "menu." came from.
2018-09-14menuconfig: Reorganize code a bitUlf Magnusson
- Point out where the styling part starts and ends - Move _style_attr() into the styling part (by moving the comment) - Move _name_and_val_str() and _expr_str() to later in the file, closer to where they're used (mostly in the help dialog) - Turn _input_dialog() input handling into one if-elif-... chain, like for the other dialogs.
2018-09-14menuconfig: Fix a small symbol information display issueUlf Magnusson
Prevent the 'Symbol/choice/menu/comment information' title string from disappearing when it won't fit on the terminal. Piggyback some code nits: - Remove a redundant 'global _style' - Use 'elif' after checking for KEY_RESIZE - Consistently use '_sel_node_i = _menu_scroll = 0' to reset positions, e.g. when entering menus
2018-09-14menuconfig: RGB color implementation nitsUlf Magnusson
- Make the coding style a bit more consistent with the rest of the code - Allow colors to be allocated from the xterm 256-color grayscale range, and emulate it when dynamically allocating colors. Never allocate above color number 255 though, as anything there would be unknown territory. - Switch back to consistently passing tuples to functions. This was the original design, before I suggested changing it... - Remove some repeated information from docstrings and fix some small typos - Make use of the element1=element2 feature in the style definition for the 'default' style
2018-09-14menuconfig: Add RGB color support to styles.Mitja HORVAT
Styles can now take a HTML notation as a color value: - on terminals that support RGB color mode these are rendered perfeclty - on 256 color terminals the closes matching color is used - on other terminals, the current color palette is scanned and the closes matching color is used. This has few quirks Example: Use "pure" red as selection foreground and "pure" blue as background: MENUCONFIG_STYLE="selection=fg:#ff0000,bg:#0000ff" Additionally, it is possible to copy the style from other elements, for example: MENUCONFIG_STYLE="selection=fg:#ff0000,bg:#0000ff path=selection" In the notation above, the "path" style will be copied from "selection".
2018-09-09menuconfig: Menu drawing code nitUlf Magnusson
2018-09-09menuconfig: Fix some glitching on small terminalsUlf Magnusson
- 'mainmenu' and dialog titles now get clipped instead of disappearing when they don't fit - Lines of text no longer wrap to the next line (this glitch was mostly hidden if something was printed on the next line) - Text in a dialog can no longer end up on top of the dialog's frame
2018-09-08menuconfig: Pass a style string to _styled_win()Ulf Magnusson
Enforces that all windows are created from styles defined via the new styling mechanism.
2018-09-08menuconfig: Print warnings instead of having StyleErrorUlf Magnusson
Mostly motivated by curses.COLORS, which depends on the terminal. It's probably friendlier to run even if the style gets a bit messed up, but it's also nice to point out problems. Missing style templates and missing styles to the left of '=' are pointed out now too, with the help of some flag hackery. Prefix the warnings with 'menuconfig warning:' to make it easier to distinguish them from warnings from Kconfiglib.
2018-09-08menuconfig: Ignore non-existent style templatesUlf Magnusson
This is consistent with non-existent styles being ignored, and gives some forwards/backwards compatibility. I wonder if there should be a warning for both instead. Piggyback some nits.
2018-09-07menuconfig: Fix off-by-one in range check for COLORSUlf Magnusson
"color values are expected to be in the range 0 to COLORS-1", from init_color(3ncurses).