From 02cfeef0bb487190fac86c38b16ed9a6c77288c6 Mon Sep 17 00:00:00 2001 From: LaterComer <12015333+Later-Comer@users.noreply.github.com> Date: Sun, 14 Apr 2024 01:10:24 +0800 Subject: [PATCH] =?UTF-8?q?tools=E4=B8=8B=E6=9C=89=E4=B8=A4=E4=BB=BDKconfi?= =?UTF-8?q?glib=E6=96=87=EF=BC=8C=E5=88=A0=E9=99=A4=E5=A4=A7=E5=86=99?= =?UTF-8?q?=E7=89=88=E6=9C=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- tools/Kconfiglib/.gitignore | 4 - tools/Kconfiglib/LICENSE.txt | 5 - tools/Kconfiglib/MANIFEST.in | 2 - tools/Kconfiglib/README.rst | 841 ---- tools/Kconfiglib/alldefconfig.py | 27 - tools/Kconfiglib/allmodconfig.py | 46 - tools/Kconfiglib/allnoconfig.py | 45 - tools/Kconfiglib/allyesconfig.py | 56 - tools/Kconfiglib/defconfig.py | 43 - tools/Kconfiglib/genconfig.py | 154 - tools/Kconfiglib/guiconfig.py | 2324 ---------- tools/Kconfiglib/kconfiglib.py | 7160 ----------------------------- tools/Kconfiglib/listnewconfig.py | 76 - tools/Kconfiglib/makefile.patch | 48 - tools/Kconfiglib/menuconfig.py | 3278 ------------- tools/Kconfiglib/oldconfig.py | 246 - tools/Kconfiglib/olddefconfig.py | 28 - tools/Kconfiglib/savedefconfig.py | 49 - tools/Kconfiglib/setconfig.py | 92 - tools/Kconfiglib/setup.cfg | 7 - tools/Kconfiglib/setup.py | 96 - tools/Kconfiglib/testsuite.py | 3203 ------------- 22 files changed, 17830 deletions(-) delete mode 100644 tools/Kconfiglib/.gitignore delete mode 100644 tools/Kconfiglib/LICENSE.txt delete mode 100644 tools/Kconfiglib/MANIFEST.in delete mode 100644 tools/Kconfiglib/README.rst delete mode 100644 tools/Kconfiglib/alldefconfig.py delete mode 100644 tools/Kconfiglib/allmodconfig.py delete mode 100644 tools/Kconfiglib/allnoconfig.py delete mode 100644 tools/Kconfiglib/allyesconfig.py delete mode 100644 tools/Kconfiglib/defconfig.py delete mode 100644 tools/Kconfiglib/genconfig.py delete mode 100644 tools/Kconfiglib/guiconfig.py delete mode 100644 tools/Kconfiglib/kconfiglib.py delete mode 100644 tools/Kconfiglib/listnewconfig.py delete mode 100644 tools/Kconfiglib/makefile.patch delete mode 100644 tools/Kconfiglib/menuconfig.py delete mode 100644 tools/Kconfiglib/oldconfig.py delete mode 100644 tools/Kconfiglib/olddefconfig.py delete mode 100644 tools/Kconfiglib/savedefconfig.py delete mode 100644 tools/Kconfiglib/setconfig.py delete mode 100644 tools/Kconfiglib/setup.cfg delete mode 100644 tools/Kconfiglib/setup.py delete mode 100644 tools/Kconfiglib/testsuite.py diff --git a/tools/Kconfiglib/.gitignore b/tools/Kconfiglib/.gitignore deleted file mode 100644 index 4a18d79f037..00000000000 --- a/tools/Kconfiglib/.gitignore +++ /dev/null @@ -1,4 +0,0 @@ -*.py[co] -build/ -*.egg-info/ -dist/ diff --git a/tools/Kconfiglib/LICENSE.txt b/tools/Kconfiglib/LICENSE.txt deleted file mode 100644 index 8b31efca291..00000000000 --- a/tools/Kconfiglib/LICENSE.txt +++ /dev/null @@ -1,5 +0,0 @@ -Copyright (c) 2011-2019, Ulf Magnusson - -Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. - -THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, 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. diff --git a/tools/Kconfiglib/MANIFEST.in b/tools/Kconfiglib/MANIFEST.in deleted file mode 100644 index 881a7944b18..00000000000 --- a/tools/Kconfiglib/MANIFEST.in +++ /dev/null @@ -1,2 +0,0 @@ -# Include the license file in source distributions -include LICENSE.txt diff --git a/tools/Kconfiglib/README.rst b/tools/Kconfiglib/README.rst deleted file mode 100644 index b59f04ecef8..00000000000 --- a/tools/Kconfiglib/README.rst +++ /dev/null @@ -1,841 +0,0 @@ -.. contents:: Table of contents - :backlinks: none - -News ----- - -Dependency loop with recent linux-next kernels -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -To fix issues with dependency loops on recent linux-next kernels, apply `this -patch `_. Hopefully, -it will be in ``linux-next`` soon. - -``windows-curses`` is no longer automatically installed on Windows -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Starting with Kconfiglib 13.0.0, the `windows-curses -`__ package is no longer -automatically installed on Windows, and needs to be installed manually for the -terminal ``menuconfig`` to work. - -This fixes installation of Kconfiglib on MSYS2, which is not compatible with -``windows-curses``. See `this issue -`__. - -The ``menuconfig`` now shows a hint re. installing ``windows-curses`` when the -``curses`` module can't be imported on Windows. - -Sorry if this change caused problems! - -Overview --------- - -Kconfiglib is a `Kconfig -`__ -implementation in Python 2/3. It started out as a helper library, but now has a -enough functionality to also work well as a standalone Kconfig implementation -(including `terminal and GUI menuconfig interfaces `_ -and `Kconfig extensions`_). - -The entire library is contained in `kconfiglib.py -`_. The -bundled scripts are implemented on top of it. Implementing your own scripts -should be relatively easy, if needed. - -Kconfiglib is used exclusively by e.g. the `Zephyr -`__, `esp-idf -`__, and `ACRN -`__ projects. It is also used for many small helper -scripts in various projects. - -Since Kconfiglib is based around a library, it can be used e.g. to generate a -`Kconfig cross-reference -`_, using -the same robust Kconfig parser used for other Kconfig tools, instead of brittle -ad-hoc parsing. The documentation generation script can be found `here -`__. - -Kconfiglib implements the recently added `Kconfig preprocessor -`__. -For backwards compatibility, environment variables can be referenced both as -``$(FOO)`` (the new syntax) and as ``$FOO`` (the old syntax). The old syntax is -deprecated, but will probably be supported for a long time, as it's needed to -stay compatible with older Linux kernels. The major version will be increased -if support is ever dropped. Using the old syntax with an undefined environment -variable keeps the string as is. - -Note: See `this issue `__ if -you run into a "macro expanded to blank string" error with kernel 4.18+. - -See `this page -`__ for some -Kconfig tips and best practices. - -Installation ------------- - -Installation with pip -~~~~~~~~~~~~~~~~~~~~~ - -Kconfiglib is available on `PyPI `_ and can be -installed with e.g. - -.. code:: - - $ pip(3) install kconfiglib - -Microsoft Windows is supported. - -The ``pip`` installation will give you both the base library and the following -executables. All but two (``genconfig`` and ``setconfig``) mirror functionality -available in the C tools. - -- `menuconfig `_ - -- `guiconfig `_ - -- `oldconfig `_ - -- `olddefconfig `_ - -- `savedefconfig `_ - -- `defconfig `_ - -- `alldefconfig `_ - -- `allnoconfig `_ - -- `allmodconfig `_ - -- `allyesconfig `_ - -- `listnewconfig `_ - -- `genconfig `_ - -- `setconfig `_ - -``genconfig`` is intended to be run at build time. It generates a C header from -the configuration and (optionally) information that can be used to rebuild only -files that reference Kconfig symbols that have changed value. - -Starting with Kconfiglib version 12.2.0, all utilities are compatible with both -Python 2 and Python 3. Previously, ``menuconfig.py`` only ran under Python 3 -(i.e., it's now more backwards compatible than before). - -**Note:** If you install Kconfiglib with ``pip``'s ``--user`` flag, make sure -that your ``PATH`` includes the directory where the executables end up. You can -list the installed files with ``pip(3) show -f kconfiglib``. - -All releases have a corresponding tag in the git repository, e.g. ``v14.1.0`` -(the latest version). - -`Semantic versioning `_ is used. There's been ten small -changes to the behavior of the API, a Windows packaging change, and a hashbang -change to use ``python3`` -(`1 `_, -`2 `_, -`3 `_, -`4 `_, -`5 `_, -`6 `_, -`7 `_, -`8 `_, -`9 `_, -`10 `_, -`Windows packaging change `_, -`Python 3 hashbang change `_), -which is why the major version is at 14 rather than 2. I do major version bumps -for all behavior changes, even tiny ones, and most of these were fixes for baby -issues in the early days of the Kconfiglib 2 API. - -Manual installation -~~~~~~~~~~~~~~~~~~~ - -Just drop ``kconfiglib.py`` and the scripts you want somewhere. There are no -third-party dependencies, but the terminal ``menuconfig`` won't work on Windows -unless a package like `windows-curses -`__ is installed. - -Installation for the Linux kernel -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -See the module docstring at the top of `kconfiglib.py `_. - -Python version compatibility (2.7/3.2+) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Kconfiglib and all utilities run under both Python 2.7 and Python 3.2 and -later. The code mostly uses basic Python features and has no third-party -dependencies, so keeping it backwards-compatible is pretty low effort. - -The 3.2 requirement comes from ``argparse``. ``format()`` with unnumbered -``{}`` is used as well. - -A recent Python 3 version is recommended if you have a choice, as it'll give -you better Unicode handling. - -Getting started ---------------- - -1. `Install `_ the library and the utilities. - -2. Write `Kconfig - `__ - files that describe the available configuration options. See `this page - `__ for some - general Kconfig advice. - -3. Generate an initial configuration with e.g. ``menuconfig``/``guiconfig`` or - ``alldefconfig``. The configuration is saved as ``.config`` by default. - - For more advanced projects, the ``defconfig`` utility can be used to - generate the initial configuration from an existing configuration file. - Usually, this existing configuration file would be a minimal configuration - file, as generated by e.g. ``savedefconfig``. - -4. Run ``genconfig`` to generate a header file. By default, it is saved as - ``config.h``. - - Normally, ``genconfig`` would be run automatically as part of the build. - - Before writing a header file or other configuration output, Kconfiglib - compares the old contents of the file against the new contents. If there's - no change, the write is skipped. This avoids updating file metadata like the - modification time, and might save work depending on your build setup. - - Adding new configuration output formats should be relatively straightforward. - See the implementation of ``write_config()`` in `kconfiglib.py - `_. - The documentation for the ``Symbol.config_string`` property has some tips as - well. - -5. To update an old ``.config`` file after the Kconfig files have changed (e.g. - to add new options), run ``oldconfig`` (prompts for values for new options) - or ``olddefconfig`` (gives new options their default value). Entering the - ``menuconfig`` or ``guiconfig`` interface and saving the configuration will - also update it (the configuration interfaces always prompt for saving - on exit if it would modify the contents of the ``.config`` file). - - Due to Kconfig semantics, simply loading an old ``.config`` file performs an - implicit ``olddefconfig``, so building will normally not be affected by - having an outdated configuration. - -Whenever ``.config`` is overwritten, the previous version of the file is saved -to ``.config.old`` (or, more generally, to ``$KCONFIG_CONFIG.old``). - -Using ``.config`` files as Make input -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -``.config`` files use Make syntax and can be included directly in Makefiles to -read configuration values from there. This is why ``n``-valued -``bool``/``tristate`` values are written out as ``# CONFIG_FOO is not set`` (a -Make comment) in ``.config``, allowing them to be tested with ``ifdef`` in -Make. - -If you make use of this, you might want to pass ``--config-out `` to -``genconfig`` and include the configuration file it generates instead of -including ``.config`` directly. This has the advantage that the generated -configuration file will always be a "full" configuration file, even if -``.config`` is outdated. Otherwise, it might be necessary to run -``old(def)config`` or ``menuconfig``/``guiconfig`` before rebuilding with an -outdated ``.config``. - -If you use ``--sync-deps`` to generate incremental build information, you can -include ``deps/auto.conf`` instead, which is also a full configuration file. - -Useful helper macros -~~~~~~~~~~~~~~~~~~~~ - -The `include/linux/kconfig.h -`_ -header in the Linux kernel defines some useful helper macros for testing -Kconfig configuration values. - -``IS_ENABLED()`` is generally useful, allowing configuration values to be -tested in ``if`` statements with no runtime overhead. - -Incremental building -~~~~~~~~~~~~~~~~~~~~ - -See the docstring for ``Kconfig.sync_deps()`` in `kconfiglib.py -`_ for hints -on implementing incremental builds (rebuilding just source files that reference -changed configuration values). - -Running the ``scripts/basic/fixdep.c`` tool from the kernel on the output of -``gcc -MD `` might give you an idea of how it all fits together. - -Library documentation ---------------------- - -Kconfiglib comes with extensive documentation in the form of docstrings. To view it, run e.g. -the following command: - -.. code:: sh - - $ pydoc(3) kconfiglib - -For HTML output, add ``-w``: - -.. code:: sh - - $ pydoc(3) -w kconfiglib - -This will also work after installing Kconfiglib with ``pip(3)``. - -Documentation for other modules can be viewed in the same way (though a plain -``--help`` will work when they're run as executables): - -.. code:: sh - - $ pydoc(3) menuconfig/guiconfig/... - -A good starting point for learning the library is to read the module docstring -(which you could also just read directly at the beginning of `kconfiglib.py -`_). It -gives an introduction to symbol values, the menu tree, and expressions. - -After reading the module docstring, a good next step is to read the ``Kconfig`` -class documentation, and then the documentation for the ``Symbol``, ``Choice``, -and ``MenuNode`` classes. - -Please tell me if something is unclear or can be explained better. - -Library features ----------------- - -Kconfiglib can do the following, among other things: - -- **Programmatically get and set symbol values** - - See `allnoconfig.py - `_ and - `allyesconfig.py - `_, - which are automatically verified to produce identical output to the standard - ``make allnoconfig`` and ``make allyesconfig``. - -- **Read and write .config and defconfig files** - - The generated ``.config`` and ``defconfig`` (minimal configuration) files are - character-for-character identical to what the C implementation would generate - (except for the header comment). The test suite relies on this, as it - compares the generated files. - -- **Write C headers** - - The generated headers use the same format as ``include/generated/autoconf.h`` - from the Linux kernel. Output for symbols appears in the order that they're - defined, unlike in the C tools (where the order depends on the hash table - implementation). - -- **Implement incremental builds** - - This uses the same scheme as the ``include/config`` directory in the kernel: - Symbols are translated into files that are touched when the symbol's value - changes between builds, which can be used to avoid having to do a full - rebuild whenever the configuration is changed. - - See the ``sync_deps()`` function for more information. - -- **Inspect symbols** - - Printing a symbol or other item (which calls ``__str__()``) returns its - definition in Kconfig format. This also works for symbols defined in multiple - locations. - - A helpful ``__repr__()`` is on all objects too. - - All ``__str__()`` and ``__repr__()`` methods are deliberately implemented - with just public APIs, so all symbol information can be fetched separately as - well. - -- **Inspect expressions** - - Expressions use a simple tuple-based format that can be processed manually - if needed. Expression printing and evaluation functions are provided, - implemented with public APIs. - -- **Inspect the menu tree** - - The underlying menu tree is exposed, including submenus created implicitly - from symbols depending on preceding symbols. This can be used e.g. to - implement menuconfig-like functionality. - - See `menuconfig.py - `_/`guiconfig.py - `_ and the - minimalistic `menuconfig_example.py - `_ - example. - -Kconfig extensions -~~~~~~~~~~~~~~~~~~ - -The following Kconfig extensions are available: - -- ``source`` supports glob patterns and includes each matching file. A pattern - is required to match at least one file. - - A separate ``osource`` statement is available for cases where it's okay for - the pattern to match no files (in which case ``osource`` turns into a no-op). - -- A relative ``source`` statement (``rsource``) is available, where file paths - are specified relative to the directory of the current Kconfig file. An - ``orsource`` statement is available as well, analogous to ``osource``. - -- Preprocessor user functions can be defined in Python, which makes it simple - to integrate information from existing Python tools into Kconfig (e.g. to - have Kconfig symbols depend on hardware information stored in some other - format). - - See the *Kconfig extensions* section in the - `kconfiglib.py `_ - module docstring for more information. - -- ``def_int``, ``def_hex``, and ``def_string`` are available in addition to - ``def_bool`` and ``def_tristate``, allowing ``int``, ``hex``, and ``string`` - symbols to be given a type and a default at the same time. - - These can be useful in projects that make use of symbols defined in multiple - locations, and remove some Kconfig inconsistency. - -- Environment variables are expanded directly in e.g. ``source`` and - ``mainmenu`` statements, meaning ``option env`` symbols are redundant. - - This is the standard behavior with the new `Kconfig preprocessor - `__, - which Kconfiglib implements. - - ``option env`` symbols are accepted but ignored, which leads the caveat that - they must have the same name as the environment variables they reference - (Kconfiglib warns if the names differ). This keeps Kconfiglib compatible with - older Linux kernels, where the name of the ``option env`` symbol always - matched the environment variable. Compatibility with older Linux kernels is - the main reason ``option env`` is still supported. - - The C tools have dropped support for ``option env``. - -- Two extra optional warnings can be enabled by setting environment variables, - covering cases that are easily missed when making changes to Kconfig files: - - * ``KCONFIG_WARN_UNDEF``: If set to ``y``, warnings will be generated for all - references to undefined symbols within Kconfig files. The only gotcha is - that all hex literals must be prefixed with ``0x`` or ``0X``, to make it - possible to distinguish them from symbol references. - - Some projects (e.g. the Linux kernel) use multiple Kconfig trees with many - shared Kconfig files, leading to some safe undefined symbol references. - ``KCONFIG_WARN_UNDEF`` is useful in projects that only have a single - Kconfig tree though. - - ``KCONFIG_STRICT`` is an older alias for this environment variable, - supported for backwards compatibility. - - * ``KCONFIG_WARN_UNDEF_ASSIGN``: If set to ``y``, warnings will be generated - for all assignments to undefined symbols within ``.config`` files. By - default, no such warnings are generated. - - This warning can also be enabled/disabled by setting - ``Kconfig.warn_assign_undef`` to ``True``/``False``. - -Other features --------------- - -- **Single-file implementation** - - The entire library is contained in `kconfiglib.py - `_. - - The tools implemented on top of it are one file each. - -- **Robust and highly compatible with the C Kconfig tools** - -  The `test suite `_ - automatically compares output from Kconfiglib and the C tools - by diffing the generated ``.config`` files for the real kernel Kconfig and - defconfig files, for all ARCHes. - - This currently involves comparing the output for 36 ARCHes and 498 defconfig - files (or over 18000 ARCH/defconfig combinations in "obsessive" test suite - mode). All tests are expected to pass. - - A comprehensive suite of selftests is included as well. - -- **Not horribly slow despite being a pure Python implementation** - - The `allyesconfig.py - `_ - script currently runs in about 1.3 seconds on the Linux kernel on a Core i7 - 2600K (with a warm file cache), including the ``make`` overhead from ``make - scriptconfig``. Note that the Linux kernel Kconfigs are absolutely massive - (over 14k symbols for x86) compared to most projects, and also have overhead - from running shell commands via the Kconfig preprocessor. - - Kconfiglib is especially speedy in cases where multiple ``.config`` files - need to be processed, because the ``Kconfig`` files will only need to be parsed - once. - - For long-running jobs, `PyPy `_ gives a big performance - boost. CPython is faster for short-running jobs as PyPy needs some time to - warm up. - - Kconfiglib also works well with the - `multiprocessing `_ - module. No global state is kept. - -- **Generates more warnings than the C implementation** - - Generates the same warnings as the C implementation, plus additional ones. - Also detects dependency and ``source`` loops. - - All warnings point out the location(s) in the ``Kconfig`` files where a - symbol is defined, where applicable. - -- **Unicode support** - - Unicode characters in string literals in ``Kconfig`` and ``.config`` files are - correctly handled. This support mostly comes for free from Python. - -- **Windows support** - - Nothing Linux-specific is used. Universal newlines mode is used for both - Python 2 and Python 3. - - The `Zephyr `_ project uses Kconfiglib to - generate ``.config`` files and C headers on Linux as well as Windows. - -- **Internals that (mostly) mirror the C implementation** - - While being simpler to understand and tweak. - -Menuconfig interfaces ---------------------- - -Three configuration interfaces are currently available: - -- `menuconfig.py `_ - is a terminal-based configuration interface implemented using the standard - Python ``curses`` module. ``xconfig`` features like showing invisible symbols and - showing symbol names are included, and it's possible to jump directly to a symbol - in the menu tree (even if it's currently invisible). - - .. image:: https://raw.githubusercontent.com/ulfalizer/Kconfiglib/screenshots/screenshots/menuconfig.gif - - *There is now also a show-help mode that shows the help text of the currently - selected symbol in the help window at the bottom.* - - Starting with Kconfiglib 12.2.0, ``menuconfig.py`` runs under both Python 2 - and Python 3 (previously, it only ran under Python 3, so this was a - backport). Running it under Python 3 provides better support for Unicode text - entry (``get_wch()`` is not available in the ``curses`` module on Python 2). - - There are no third-party dependencies on \*nix. On Windows, - the ``curses`` modules is not available by default, but support - can be added by installing the ``windows-curses`` package: - - .. code-block:: shell - - $ pip install windows-curses - - This uses wheels built from `this repository - `_, which is in turn - based on Christoph Gohlke's `Python Extension Packages for Windows - `_. - - See the docstring at the top of `menuconfig.py - `_ for - more information about the terminal menuconfig implementation. - -- `guiconfig.py - `_ is a - graphical configuration interface written in `Tkinter - `_. Like ``menuconfig.py``, - it supports showing all symbols (with invisible symbols in red) and jumping - directly to symbols. Symbol values can also be changed directly from the - jump-to dialog. - - When single-menu mode is enabled, a single menu is shown at a time, like in - the terminal menuconfig. Only this mode distinguishes between symbols defined - with ``config`` and symbols defined with ``menuconfig``. - - ``guiconfig.py`` has been tested on X11, Windows, and macOS, and is - compatible with both Python 2 and Python 3. - - Despite being part of the Python standard library, ``tkinter`` often isn't - included by default in Python installations on Linux. These commands will - install it on a few different distributions: - - - Ubuntu: ``sudo apt install python-tk``/``sudo apt install python3-tk`` - - - Fedora: ``dnf install python2-tkinter``/``dnf install python3-tkinter`` - - - Arch: ``sudo pacman -S tk`` - - - Clear Linux: ``sudo swupd bundle-add python3-tcl`` - - Screenshot below, with show-all mode enabled and the jump-to dialog open: - - .. image:: https://raw.githubusercontent.com/ulfalizer/Kconfiglib/screenshots/screenshots/guiconfig.png - - To avoid having to carry around a bunch of GIFs, the image data is embedded - in ``guiconfig.py``. To use separate GIF files instead, change - ``_USE_EMBEDDED_IMAGES`` to ``False`` in ``guiconfig.py``. The image files - can be found in the `screenshots - `_ - branch. - - I did my best with the images, but some are definitely only art adjacent. - Touch-ups are welcome. :) - -- `pymenuconfig `_, built by `RomaVis - `_, is an older portable Python 2/3 TkInter - menuconfig implementation. - - Screenshot below: - - .. image:: https://raw.githubusercontent.com/RomaVis/pymenuconfig/master/screenshot.PNG - - While working on the terminal menuconfig implementation, I added a few APIs - to Kconfiglib that turned out to be handy. ``pymenuconfig`` predates - ``menuconfig.py`` and ``guiconfig.py``, and so didn't have them available. - Blame me for any workarounds. - -Examples --------- - -Example scripts -~~~~~~~~~~~~~~~ - -The `examples/ `_ directory contains some simple example scripts. Among these are the following ones. Make sure you run them with the latest version of Kconfiglib, as they might make use of newly added features. - -- `eval_expr.py `_ evaluates an expression in the context of a configuration. - -- `find_symbol.py `_ searches through expressions to find references to a symbol, also printing a "backtrace" with parents for each reference found. - -- `help_grep.py `_ searches for a string in all help texts. - -- `print_tree.py `_ prints a tree of all configuration items. - -- `print_config_tree.py `_ is similar to ``print_tree.py``, but dumps the tree as it would appear in ``menuconfig``, including values. This can be handy for visually diffing between ``.config`` files and different versions of ``Kconfig`` files. - -- `list_undefined.py `_ finds references to symbols that are not defined by any architecture in the Linux kernel. - -- `merge_config.py `_ merges configuration fragments to produce a complete .config, similarly to ``scripts/kconfig/merge_config.sh`` from the kernel. - -- `menuconfig_example.py `_ implements a configuration interface that uses notation similar to ``make menuconfig``. It's deliberately kept as simple as possible to demonstrate just the core concepts. - -Real-world examples -~~~~~~~~~~~~~~~~~~~ - -- `kconfig.py - `_ - from the `Zephyr `_ project handles - ``.config`` and header file generation, also doing configuration fragment - merging - -- `genrest.py - `_ - generates a Kconfig symbol cross-reference, which can be viewed `here - `__ - -- `CMake and IDE integration - `_ from - the ESP-IDF project, via a configuration server program. - -- `A script for turning on USB-related options - `_, - from the `syzkaller `_ project. - -- `Various automated checks - `_, - including a check for references to undefined Kconfig symbols in source code. - See the ``KconfigCheck`` class. - -- `Various utilities - `_ - from the `ACRN `_ project - -These use the older Kconfiglib 1 API, which was clunkier and not as general -(functions instead of properties, no direct access to the menu structure or -properties, uglier ``__str__()`` output): - -- `genboardscfg.py `_ from `Das U-Boot `_ generates some sort of legacy board database by pulling information from a newly added Kconfig-based configuration system (as far as I understand it :). - -- `gen-manual-lists.py `_ generated listings for an appendix in the `Buildroot `_ manual. (The listing has since been removed.) - -- `gen_kconfig_doc.py `_ from the `esp-idf `_ project generates documentation from Kconfig files. - -- `SConf `_ builds an interactive configuration interface (like ``menuconfig``) on top of Kconfiglib, for use e.g. with `SCons `_. - -- `kconfig-diff.py `_ -- a script by `dubiousjim `_ that compares kernel configurations. - -- Originally, Kconfiglib was used in chapter 4 of my `master's thesis `_ to automatically generate a "minimal" kernel for a given system. Parts of it bother me a bit now, but that's how it goes with old work. - -Sample ``make iscriptconfig`` session -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The following log should give some idea of the functionality available in the API: - -.. code-block:: - - $ make iscriptconfig - A Kconfig instance 'kconf' for the architecture x86 has been created. - >>> kconf # Calls Kconfig.__repr__() - - >>> kconf.mainmenu_text # Expanded main menu text - 'Linux/x86 4.14.0-rc7 Kernel Configuration' - >>> kconf.top_node # The implicit top-level menu - - >>> kconf.top_node.list # First child menu node - - >>> print(kconf.top_node.list) # Calls MenuNode.__str__() - config SRCARCH - string - option env="SRCARCH" - default "x86" - >>> sym = kconf.top_node.list.next.item # Item contained in next menu node - >>> print(sym) # Calls Symbol.__str__() - config 64BIT - bool "64-bit kernel" if ARCH = "x86" - default ARCH != "i386" - help - Say yes to build a 64-bit kernel - formerly known as x86_64 - Say no to build a 32-bit kernel - formerly known as i386 - >>> sym # Calls Symbol.__repr__() - - >>> sym.assignable # Currently assignable values (0, 1, 2 = n, m, y) - (0, 2) - >>> sym.set_value(0) # Set it to n - True - >>> sym.tri_value # Check the new value - 0 - >>> sym = kconf.syms["X86_MPPARSE"] # Look up symbol by name - >>> print(sym) - config X86_MPPARSE - bool "Enable MPS table" if (ACPI || SFI) && X86_LOCAL_APIC - default y if X86_LOCAL_APIC - help - For old smp systems that do not have proper acpi support. Newer systems - (esp with 64bit cpus) with acpi support, MADT and DSDT will override it - >>> default = sym.defaults[0] # Fetch its first default - >>> sym = default[1] # Fetch the default's condition (just a Symbol here) - >>> print(sym) - config X86_LOCAL_APIC - bool - default y - select IRQ_DOMAIN_HIERARCHY - select PCI_MSI_IRQ_DOMAIN if PCI_MSI - depends on X86_64 || SMP || X86_32_NON_STANDARD || X86_UP_APIC || PCI_MSI - >>> sym.nodes # Show the MenuNode(s) associated with it - [] - >>> kconfiglib.expr_str(sym.defaults[0][1]) # Print the default's condition - 'X86_64 || SMP || X86_32_NON_STANDARD || X86_UP_APIC || PCI_MSI' - >>> kconfiglib.expr_value(sym.defaults[0][1]) # Evaluate it (0 = n) - 0 - >>> kconf.syms["64BIT"].set_value(2) - True - >>> kconfiglib.expr_value(sym.defaults[0][1]) # Evaluate it again (2 = y) - 2 - >>> kconf.write_config("myconfig") # Save a .config - >>> ^D - $ cat myconfig - # Generated by Kconfiglib (https://github.com/ulfalizer/Kconfiglib) - CONFIG_64BIT=y - CONFIG_X86_64=y - CONFIG_X86=y - CONFIG_INSTRUCTION_DECODER=y - CONFIG_OUTPUT_FORMAT="elf64-x86-64" - CONFIG_ARCH_DEFCONFIG="arch/x86/configs/x86_64_defconfig" - CONFIG_LOCKDEP_SUPPORT=y - CONFIG_STACKTRACE_SUPPORT=y - CONFIG_MMU=y - ... - -Test suite ----------- - -The test suite is run with - -.. code:: - - $ python(3) Kconfiglib/testsuite.py - -`pypy `_ works too, and is much speedier for everything except ``allnoconfig.py``/``allnoconfig_simpler.py``/``allyesconfig.py``, where it doesn't have time to warm up since -the scripts are run via ``make scriptconfig``. - -The test suite must be run from the top-level kernel directory. It requires that the -Kconfiglib git repository has been cloned into it and that the makefile patch has been applied. - -To get rid of warnings generated for the kernel ``Kconfig`` files, add ``2>/dev/null`` to the command to -discard ``stderr``. - -**NOTE: Forgetting to apply the Makefile patch will cause some tests that compare generated configurations to fail** - -**NOTE: The test suite overwrites .config in the kernel root, so make sure to back it up.** - -The test suite consists of a set of selftests and a set of compatibility tests that -compare configurations generated by Kconfiglib with -configurations generated by the C tools, for a number of cases. See -`testsuite.py `_ -for the available options. - -The `tests/reltest `_ script runs the test suite -and all the example scripts for both Python 2 and Python 3, verifying that everything works. - -Rarely, the output from the C tools is changed slightly (most recently due to a -`change `_ I added). -If you get test suite failures, try running the test suite again against the -`linux-next tree `_, -which has all the latest changes. I will make it clear if any -non-backwards-compatible changes appear. - -A lot of time is spent waiting around for ``make`` and the C utilities (which need to reparse all the -Kconfig files for each defconfig test). Adding some multiprocessing to the test suite would make sense -too. - -Notes ------ - -* This is version 2 of Kconfiglib, which is not backwards-compatible with - Kconfiglib 1. A summary of changes between Kconfiglib 1 and Kconfiglib - 2 can be found `here - `__. - -* I sometimes see people add custom output formats, which is pretty - straightforward to do (see the implementations of ``write_autoconf()`` and - ``write_config()`` for a template, and also the documentation of the - ``Symbol.config_string`` property). If you come up with something you think - might be useful to other people, I'm happy to take it in upstream. Batteries - included and all that. - -* Kconfiglib assumes the modules symbol is ``MODULES``, which is backwards-compatible. - A warning is printed by default if ``option modules`` is set on some other symbol. - - Let me know if you need proper ``option modules`` support. It wouldn't be that - hard to add. - -Thanks ------- - -- To `RomaVis `_, for making - `pymenuconfig `_ and suggesting - the ``rsource`` keyword. - -- To `Mitja Horvat `_, for adding support - for user-defined styles to the terminal menuconfig. - -- To `Philip Craig `_ for adding - support for the ``allnoconfig_y`` option and fixing an obscure issue - with ``comment``\s inside ``choice``\s (that didn't affect correctness but - made outputs differ). ``allnoconfig_y`` is used to force certain symbols - to ``y`` during ``make allnoconfig`` to improve coverage. - -License -------- - -See `LICENSE.txt `_. SPDX license identifiers are used in the -source code. diff --git a/tools/Kconfiglib/alldefconfig.py b/tools/Kconfiglib/alldefconfig.py deleted file mode 100644 index 56c4caa92d7..00000000000 --- a/tools/Kconfiglib/alldefconfig.py +++ /dev/null @@ -1,27 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2018-2019, Ulf Magnusson -# SPDX-License-Identifier: ISC - -""" -Writes a configuration file where all symbols are set to their their default -values. - -The default output filename is '.config'. A different filename can be passed in -the KCONFIG_CONFIG environment variable. - -Usage for the Linux kernel: - - $ make [ARCH=] scriptconfig SCRIPT=Kconfiglib/alldefconfig.py -""" -import kconfiglib - - -def main(): - kconf = kconfiglib.standard_kconfig(__doc__) - kconf.load_allconfig("alldef.config") - print(kconf.write_config()) - - -if __name__ == "__main__": - main() diff --git a/tools/Kconfiglib/allmodconfig.py b/tools/Kconfiglib/allmodconfig.py deleted file mode 100644 index bfb72b40252..00000000000 --- a/tools/Kconfiglib/allmodconfig.py +++ /dev/null @@ -1,46 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2018-2019, Ulf Magnusson -# SPDX-License-Identifier: ISC - -""" -Writes a configuration file where as many symbols as possible are set to 'm'. - -The default output filename is '.config'. A different filename can be passed -in the KCONFIG_CONFIG environment variable. - -Usage for the Linux kernel: - - $ make [ARCH=] scriptconfig SCRIPT=Kconfiglib/allmodconfig.py -""" -import kconfiglib - - -def main(): - kconf = kconfiglib.standard_kconfig(__doc__) - - # See allnoconfig.py - kconf.warn = False - - for sym in kconf.unique_defined_syms: - if sym.orig_type == kconfiglib.BOOL: - # 'bool' choice symbols get their default value, as determined by - # e.g. 'default's on the choice - if not sym.choice: - # All other bool symbols get set to 'y', like for allyesconfig - sym.set_value(2) - elif sym.orig_type == kconfiglib.TRISTATE: - sym.set_value(1) - - for choice in kconf.unique_choices: - choice.set_value(2 if choice.orig_type == kconfiglib.BOOL else 1) - - kconf.warn = True - - kconf.load_allconfig("allmod.config") - - print(kconf.write_config()) - - -if __name__ == "__main__": - main() diff --git a/tools/Kconfiglib/allnoconfig.py b/tools/Kconfiglib/allnoconfig.py deleted file mode 100644 index de90d8bf46c..00000000000 --- a/tools/Kconfiglib/allnoconfig.py +++ /dev/null @@ -1,45 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2018-2019, Ulf Magnusson -# SPDX-License-Identifier: ISC - -""" -Writes a configuration file where as many symbols as possible are set to 'n'. - -The default output filename is '.config'. A different filename can be passed -in the KCONFIG_CONFIG environment variable. - -Usage for the Linux kernel: - - $ make [ARCH=] scriptconfig SCRIPT=Kconfiglib/allnoconfig.py -""" - -# See examples/allnoconfig_walk.py for another way to implement this script - -import kconfiglib - - -def main(): - kconf = kconfiglib.standard_kconfig(__doc__) - - # Avoid warnings that would otherwise get printed by Kconfiglib for the - # following: - # - # 1. Assigning a value to a symbol without a prompt, which never has any - # effect - # - # 2. Assigning values invalid for the type (only bool/tristate symbols - # accept 0/1/2, for n/m/y). The assignments will be ignored for other - # symbol types, which is what we want. - kconf.warn = False - for sym in kconf.unique_defined_syms: - sym.set_value(2 if sym.is_allnoconfig_y else 0) - kconf.warn = True - - kconf.load_allconfig("allno.config") - - print(kconf.write_config()) - - -if __name__ == "__main__": - main() diff --git a/tools/Kconfiglib/allyesconfig.py b/tools/Kconfiglib/allyesconfig.py deleted file mode 100644 index 90eb9b8d67f..00000000000 --- a/tools/Kconfiglib/allyesconfig.py +++ /dev/null @@ -1,56 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2018-2019, Ulf Magnusson -# SPDX-License-Identifier: ISC - -""" -Writes a configuration file where as many symbols as possible are set to 'y'. - -The default output filename is '.config'. A different filename can be passed -in the KCONFIG_CONFIG environment variable. - -Usage for the Linux kernel: - - $ make [ARCH=] scriptconfig SCRIPT=Kconfiglib/allyesconfig.py -""" -import kconfiglib - - -def main(): - kconf = kconfiglib.standard_kconfig(__doc__) - - # See allnoconfig.py - kconf.warn = False - - # Try to set all symbols to 'y'. Dependencies might truncate the value down - # later, but this will at least give the highest possible value. - # - # Assigning 0/1/2 to non-bool/tristate symbols has no effect (int/hex - # symbols still take a string, because they preserve formatting). - for sym in kconf.unique_defined_syms: - # Set choice symbols to 'm'. This value will be ignored for choices in - # 'y' mode (the "normal" mode), which will instead just get their - # default selection, but will set all symbols in m-mode choices to 'm', - # which is as high as they can go. - # - # Here's a convoluted example of how you might get an m-mode choice - # even during allyesconfig: - # - # choice - # tristate "weird choice" - # depends on m - sym.set_value(1 if sym.choice else 2) - - # Set all choices to the highest possible mode - for choice in kconf.unique_choices: - choice.set_value(2) - - kconf.warn = True - - kconf.load_allconfig("allyes.config") - - print(kconf.write_config()) - - -if __name__ == "__main__": - main() diff --git a/tools/Kconfiglib/defconfig.py b/tools/Kconfiglib/defconfig.py deleted file mode 100644 index b1792731f59..00000000000 --- a/tools/Kconfiglib/defconfig.py +++ /dev/null @@ -1,43 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2019, Ulf Magnusson -# SPDX-License-Identifier: ISC - -""" -Reads a specified configuration file, then writes a new configuration file. -This can be used to initialize the configuration from e.g. an arch-specific -configuration file. This input configuration file would usually be a minimal -configuration file, as generated by e.g. savedefconfig. - -The default output filename is '.config'. A different filename can be passed in -the KCONFIG_CONFIG environment variable. -""" -import argparse - -import kconfiglib - - -def main(): - parser = argparse.ArgumentParser( - formatter_class=argparse.RawDescriptionHelpFormatter, - description=__doc__) - - parser.add_argument( - "--kconfig", - default="Kconfig", - help="Top-level Kconfig file (default: Kconfig)") - - parser.add_argument( - "config", - metavar="CONFIGURATION", - help="Input configuration file") - - args = parser.parse_args() - - kconf = kconfiglib.Kconfig(args.kconfig, suppress_traceback=True) - print(kconf.load_config(args.config)) - print(kconf.write_config()) - - -if __name__ == "__main__": - main() diff --git a/tools/Kconfiglib/genconfig.py b/tools/Kconfiglib/genconfig.py deleted file mode 100644 index 62f065ba727..00000000000 --- a/tools/Kconfiglib/genconfig.py +++ /dev/null @@ -1,154 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2018-2019, Ulf Magnusson -# SPDX-License-Identifier: ISC - -""" -Generates a header file with #defines from the configuration, matching the -format of include/generated/autoconf.h in the Linux kernel. - -Optionally, also writes the configuration output as a .config file. See ---config-out. - -The --sync-deps, --file-list, and --env-list options generate information that -can be used to avoid needless rebuilds/reconfigurations. - -Before writing a header or configuration file, Kconfiglib compares the old -contents of the file against the new contents. If there's no change, the write -is skipped. This avoids updating file metadata like the modification time, and -might save work depending on your build setup. - -By default, the configuration is generated from '.config'. A different -configuration file can be passed in the KCONFIG_CONFIG environment variable. - -A custom header string can be inserted at the beginning of generated -configuration and header files by setting the KCONFIG_CONFIG_HEADER and -KCONFIG_AUTOHEADER_HEADER environment variables, respectively (this also works -for other scripts). The string is not automatically made a comment (this is by -design, to allow anything to be added), and no trailing newline is added, so -add '/* */', '#', and newlines as appropriate. - -See https://www.gnu.org/software/make/manual/make.html#Multi_002dLine for a -handy way to define multi-line variables in makefiles, for use with custom -headers. Remember to export the variable to the environment. -""" -import argparse -import os -import sys - -import kconfiglib - - -DEFAULT_SYNC_DEPS_PATH = "deps/" - - -def main(): - parser = argparse.ArgumentParser( - formatter_class=argparse.RawDescriptionHelpFormatter, - description=__doc__) - - parser.add_argument( - "--header-path", - metavar="HEADER_FILE", - help=""" -Path to write the generated header file to. If not specified, the path in the -environment variable KCONFIG_AUTOHEADER is used if it is set, and 'config.h' -otherwise. -""") - - parser.add_argument( - "--config-out", - metavar="CONFIG_FILE", - help=""" -Write the configuration to CONFIG_FILE. This is useful if you include .config -files in Makefiles, as the generated configuration file will be a full .config -file even if .config is outdated. The generated configuration matches what -olddefconfig would produce. If you use sync-deps, you can include -deps/auto.conf instead. --config-out is meant for cases where incremental build -information isn't needed. -""") - - parser.add_argument( - "--sync-deps", - metavar="OUTPUT_DIR", - nargs="?", - const=DEFAULT_SYNC_DEPS_PATH, - help=""" -Enable generation of symbol dependency information for incremental builds, -optionally specifying the output directory (default: {}). See the docstring of -Kconfig.sync_deps() in Kconfiglib for more information. -""".format(DEFAULT_SYNC_DEPS_PATH)) - - parser.add_argument( - "--file-list", - metavar="OUTPUT_FILE", - help=""" -Write a list of all Kconfig files to OUTPUT_FILE, with one file per line. The -paths are relative to $srctree (or to the current directory if $srctree is -unset). Files appear in the order they're 'source'd. -""") - - parser.add_argument( - "--env-list", - metavar="OUTPUT_FILE", - help=""" -Write a list of all environment variables referenced in Kconfig files to -OUTPUT_FILE, with one variable per line. Each line has the format NAME=VALUE. -Only environment variables referenced with the preprocessor $(VAR) syntax are -included, and not variables referenced with the older $VAR syntax (which is -only supported for backwards compatibility). -""") - - parser.add_argument( - "kconfig", - metavar="KCONFIG", - nargs="?", - default="Kconfig", - help="Top-level Kconfig file (default: Kconfig)") - - args = parser.parse_args() - - - kconf = kconfiglib.Kconfig(args.kconfig, suppress_traceback=True) - kconf.load_config() - - if args.header_path is None: - if "KCONFIG_AUTOHEADER" in os.environ: - kconf.write_autoconf() - else: - # Kconfiglib defaults to include/generated/autoconf.h to be - # compatible with the C tools. 'config.h' is used here instead for - # backwards compatibility. It's probably a saner default for tools - # as well. - kconf.write_autoconf("config.h") - else: - kconf.write_autoconf(args.header_path) - - if args.config_out is not None: - kconf.write_config(args.config_out, save_old=False) - - if args.sync_deps is not None: - kconf.sync_deps(args.sync_deps) - - if args.file_list is not None: - with _open_write(args.file_list) as f: - for path in kconf.kconfig_filenames: - f.write(path + "\n") - - if args.env_list is not None: - with _open_write(args.env_list) as f: - for env_var in kconf.env_vars: - f.write("{}={}\n".format(env_var, os.environ[env_var])) - - -def _open_write(path): - # Python 2/3 compatibility. io.open() is available on both, but makes - # write() expect 'unicode' strings on Python 2. - - if sys.version_info[0] < 3: - return open(path, "w") - return open(path, "w", encoding="utf-8") - - -if __name__ == "__main__": - main() diff --git a/tools/Kconfiglib/guiconfig.py b/tools/Kconfiglib/guiconfig.py deleted file mode 100644 index 7804fdc7c21..00000000000 --- a/tools/Kconfiglib/guiconfig.py +++ /dev/null @@ -1,2324 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2019, Ulf Magnusson -# SPDX-License-Identifier: ISC - -""" -Overview -======== - -A Tkinter-based menuconfig implementation, based around a treeview control and -a help display. The interface should feel familiar to people used to qconf -('make xconfig'). Compatible with both Python 2 and Python 3. - -The display can be toggled between showing the full tree and showing just a -single menu (like menuconfig.py). Only single-menu mode distinguishes between -symbols defined with 'config' and symbols defined with 'menuconfig'. - -A show-all mode is available that shows invisible items in red. - -Supports both mouse and keyboard controls. The following keyboard shortcuts are -available: - - Ctrl-S : Save configuration - Ctrl-O : Open configuration - Ctrl-A : Toggle show-all mode - Ctrl-N : Toggle show-name mode - Ctrl-M : Toggle single-menu mode - Ctrl-F, /: Open jump-to dialog - ESC : Close - -Running -======= - -guiconfig.py can be run either as a standalone executable or by calling the -menuconfig() function with an existing Kconfig instance. The second option is a -bit inflexible in that it will still load and save .config, etc. - -When run in standalone mode, the top-level Kconfig file to load can be passed -as a command-line argument. With no argument, it defaults to "Kconfig". - -The KCONFIG_CONFIG environment variable specifies the .config file to load (if -it exists) and save. If KCONFIG_CONFIG is unset, ".config" is used. - -When overwriting a configuration file, the old version is saved to -.old (e.g. .config.old). - -$srctree is supported through Kconfiglib. -""" - -# Note: There's some code duplication with menuconfig.py below, especially for -# the help text. Maybe some of it could be moved into kconfiglib.py or a shared -# helper script, but OTOH it's pretty nice to have things standalone and -# customizable. - -import errno -import os -import sys - -_PY2 = sys.version_info[0] < 3 - -if _PY2: - # Python 2 - from Tkinter import * - import ttk - import tkFont as font - import tkFileDialog as filedialog - import tkMessageBox as messagebox -else: - # Python 3 - from tkinter import * - import tkinter.ttk as ttk - import tkinter.font as font - from tkinter import filedialog, messagebox - -from kconfiglib import Symbol, Choice, MENU, COMMENT, MenuNode, \ - BOOL, TRISTATE, STRING, INT, HEX, \ - AND, OR, \ - expr_str, expr_value, split_expr, \ - standard_sc_expr_str, \ - TRI_TO_STR, TYPE_TO_STR, \ - standard_kconfig, standard_config_filename - - -# If True, use GIF image data embedded in this file instead of separate GIF -# files. See _load_images(). -_USE_EMBEDDED_IMAGES = True - - -# Help text for the jump-to dialog -_JUMP_TO_HELP = """\ -Type one or more strings/regexes and press Enter to list items that match all -of them. Python's regex flavor is used (see the 're' module). Double-clicking -an item will jump to it. Item values can be toggled directly within the dialog.\ -""" - - -def _main(): - menuconfig(standard_kconfig(__doc__)) - - -# Global variables used below: -# -# _root: -# The Toplevel instance for the main window -# -# _tree: -# The Treeview in the main window -# -# _jump_to_tree: -# The Treeview in the jump-to dialog. None if the jump-to dialog isn't -# open. Doubles as a flag. -# -# _jump_to_matches: -# List of Nodes shown in the jump-to dialog -# -# _menupath: -# The Label that shows the menu path of the selected item -# -# _backbutton: -# The button shown in single-menu mode for jumping to the parent menu -# -# _status_label: -# Label with status text shown at the bottom of the main window -# ("Modified", "Saved to ...", etc.) -# -# _id_to_node: -# We can't use Node objects directly as Treeview item IDs, so we use their -# id()s instead. This dictionary maps Node id()s back to Nodes. (The keys -# are actually str(id(node)), just to simplify lookups.) -# -# _cur_menu: -# The current menu. Ignored outside single-menu mode. -# -# _show_all_var/_show_name_var/_single_menu_var: -# Tkinter Variable instances bound to the corresponding checkboxes -# -# _show_all/_single_menu: -# Plain Python bools that track _show_all_var and _single_menu_var, to -# speed up and simplify things a bit -# -# _conf_filename: -# File to save the configuration to -# -# _minconf_filename: -# File to save minimal configurations to -# -# _conf_changed: -# True if the configuration has been changed. If False, we don't bother -# showing the save-and-quit dialog. -# -# We reset this to False whenever the configuration is saved. -# -# _*_img: -# PhotoImage instances for images - - -def menuconfig(kconf): - """ - Launches the configuration interface, returning after the user exits. - - kconf: - Kconfig instance to be configured - """ - global _kconf - global _conf_filename - global _minconf_filename - global _jump_to_tree - global _cur_menu - - _kconf = kconf - - _jump_to_tree = None - - _create_id_to_node() - - _create_ui() - - # Filename to save configuration to - _conf_filename = standard_config_filename() - - # Load existing configuration and check if it's outdated - _set_conf_changed(_load_config()) - - # Filename to save minimal configuration to - _minconf_filename = "defconfig" - - # Current menu in single-menu mode - _cur_menu = _kconf.top_node - - # Any visible items in the top menu? - if not _shown_menu_nodes(kconf.top_node): - # Nothing visible. Start in show-all mode and try again. - _show_all_var.set(True) - if not _shown_menu_nodes(kconf.top_node): - # Give up and show an error. It's nice to be able to assume that - # the tree is non-empty in the rest of the code. - _root.wait_visibility() - messagebox.showerror( - "Error", - "Empty configuration -- nothing to configure.\n\n" - "Check that environment variables are set properly.") - _root.destroy() - return - - # Build the initial tree - _update_tree() - - # Select the first item and focus the Treeview, so that keyboard controls - # work immediately - _select(_tree, _tree.get_children()[0]) - _tree.focus_set() - - # Make geometry information available for centering the window. This - # indirectly creates the window, so hide it so that it's never shown at the - # old location. - _root.withdraw() - _root.update_idletasks() - - # Center the window - _root.geometry("+{}+{}".format( - (_root.winfo_screenwidth() - _root.winfo_reqwidth())//2, - (_root.winfo_screenheight() - _root.winfo_reqheight())//2)) - - # Show it - _root.deiconify() - - # Prevent the window from being automatically resized. Otherwise, it - # changes size when scrollbars appear/disappear before the user has - # manually resized it. - _root.geometry(_root.geometry()) - - _root.mainloop() - - -def _load_config(): - # Loads any existing .config file. See the Kconfig.load_config() docstring. - # - # Returns True if .config is missing or outdated. We always prompt for - # saving the configuration in that case. - - print(_kconf.load_config()) - if not os.path.exists(_conf_filename): - # No .config - return True - - return _needs_save() - - -def _needs_save(): - # Returns True if a just-loaded .config file is outdated (would get - # modified when saving) - - if _kconf.missing_syms: - # Assignments to undefined symbols in the .config - return True - - for sym in _kconf.unique_defined_syms: - if sym.user_value is None: - if sym.config_string: - # Unwritten symbol - return True - elif sym.orig_type in (BOOL, TRISTATE): - if sym.tri_value != sym.user_value: - # Written bool/tristate symbol, new value - return True - elif sym.str_value != sym.user_value: - # Written string/int/hex symbol, new value - return True - - # No need to prompt for save - return False - - -def _create_id_to_node(): - global _id_to_node - - _id_to_node = {str(id(node)): node for node in _kconf.node_iter()} - - -def _create_ui(): - # Creates the main window UI - - global _root - global _tree - - # Create the root window. This initializes Tkinter and makes e.g. - # PhotoImage available, so do it early. - _root = Tk() - - _load_images() - _init_misc_ui() - _fix_treeview_issues() - - _create_top_widgets() - # Create the pane with the Kconfig tree and description text - panedwindow, _tree = _create_kconfig_tree_and_desc(_root) - panedwindow.grid(column=0, row=1, sticky="nsew") - _create_status_bar() - - _root.columnconfigure(0, weight=1) - # Only the pane with the Kconfig tree and description grows vertically - _root.rowconfigure(1, weight=1) - - # Start with show-name disabled - _do_showname() - - _tree.bind("", _tree_left_key) - _tree.bind("", _tree_right_key) - # Note: Binding this for the jump-to tree as well would cause issues due to - # the Tk bug mentioned in _tree_open() - _tree.bind("<>", _tree_open) - # add=True to avoid overriding the description text update - _tree.bind("<>", _update_menu_path, add=True) - - _root.bind("", _save) - _root.bind("", _open) - _root.bind("", _toggle_showall) - _root.bind("", _toggle_showname) - _root.bind("", _toggle_tree_mode) - _root.bind("", _jump_to_dialog) - _root.bind("/", _jump_to_dialog) - _root.bind("", _on_quit) - - -def _load_images(): - # Loads GIF images, creating the global _*_img PhotoImage variables. - # Base64-encoded images embedded in this script are used if - # _USE_EMBEDDED_IMAGES is True, and separate image files in the same - # directory as the script otherwise. - # - # Using a global variable indirectly prevents the image from being - # garbage-collected. Passing an image to a Tkinter function isn't enough to - # keep it alive. - - def load_image(name, data): - var_name = "_{}_img".format(name) - - if _USE_EMBEDDED_IMAGES: - globals()[var_name] = PhotoImage(data=data, format="gif") - else: - globals()[var_name] = PhotoImage( - file=os.path.join(os.path.dirname(__file__), name + ".gif"), - format="gif") - - # Note: Base64 data can be put on the clipboard with - # $ base64 -w0 foo.gif | xclip - - load_image("icon", "R0lGODlhMAAwAPEDAAAAAADQAO7u7v///yH5BAUKAAMALAAAAAAwADAAAAL/nI+gy+2Pokyv2jazuZxryQjiSJZmyXxHeLbumH6sEATvW8OLNtf5bfLZRLFITzgEipDJ4mYxYv6A0ubuqYhWk66tVTE4enHer7jcKvt0LLUw6P45lvEprT6c0+v7OBuqhYdHohcoqIbSAHc4ljhDwrh1UlgSydRCWWlp5wiYZvmSuSh4IzrqV6p4cwhkCsmY+nhK6uJ6t1mrOhuJqfu6+WYiCiwl7HtLjNSZZZis/MeM7NY3TaRKS40ooDeoiVqIultsrav92bi9c3a5KkkOsOJZpSS99m4k/0zPng4Gks9JSbB+8DIcoQfnjwpZCHv5W+ip4aQrKrB0uOikYhiMCBw1/uPoQUMBADs=") - load_image("n_bool", "R0lGODdhEAAQAPAAAAgICP///ywAAAAAEAAQAAACIISPacHtvp5kcb5qG85hZ2+BkyiRF8BBaEqtrKkqslEAADs=") - load_image("y_bool", "R0lGODdhEAAQAPEAAAgICADQAP///wAAACwAAAAAEAAQAAACMoSPacLtvlh4YrIYsst2cV19AvaVF9CUXBNJJoum7ymrsKuCnhiupIWjSSjAFuWhSCIKADs=") - load_image("n_tri", "R0lGODlhEAAQAPD/AAEBAf///yH5BAUKAAIALAAAAAAQABAAAAInlI+pBrAKQnCPSUlXvFhznlkfeGwjKZhnJ65h6nrfi6h0st2QXikFADs=") - load_image("m_tri", "R0lGODlhEAAQAPEDAAEBAeQMuv///wAAACH5BAUKAAMALAAAAAAQABAAAAI5nI+pBrAWAhPCjYhiAJQCnWmdoElHGVBoiK5M21ofXFpXRIrgiecqxkuNciZIhNOZFRNI24PhfEoLADs=") - load_image("y_tri", "R0lGODlhEAAQAPEDAAICAgDQAP///wAAACH5BAUKAAMALAAAAAAQABAAAAI0nI+pBrAYBhDCRRUypfmergmgZ4xjMpmaw2zmxk7cCB+pWiVqp4MzDwn9FhGZ5WFjIZeGAgA7") - load_image("m_my", "R0lGODlhEAAQAPEDAAAAAOQMuv///wAAACH5BAUKAAMALAAAAAAQABAAAAI5nIGpxiAPI2ghxFinq/ZygQhc94zgZopmOLYf67anGr+oZdp02emfV5n9MEHN5QhqICETxkABbQ4KADs=") - load_image("y_my", "R0lGODlhEAAQAPH/AAAAAADQAAPRA////yH5BAUKAAQALAAAAAAQABAAAAM+SArcrhCMSSuIM9Q8rxxBWIXawIBkmWonupLd565Um9G1PIs59fKmzw8WnAlusBYR2SEIN6DmAmqBLBxYSAIAOw==") - load_image("n_locked", "R0lGODlhEAAQAPABAAAAAP///yH5BAUKAAEALAAAAAAQABAAAAIgjB8AyKwN04pu0vMutpqqz4Hih4ydlnUpyl2r23pxUAAAOw==") - load_image("m_locked", "R0lGODlhEAAQAPD/AAAAAOQMuiH5BAUKAAIALAAAAAAQABAAAAIylC8AyKwN04ohnGcqqlZmfXDWI26iInZoyiore05walolV39ftxsYHgL9QBBMBGFEFAAAOw==") - load_image("y_locked", "R0lGODlhEAAQAPD/AAAAAADQACH5BAUKAAIALAAAAAAQABAAAAIylC8AyKzNgnlCtoDTwvZwrHydIYpQmR3KWq4uK74IOnp0HQPmnD3cOVlUIAgKsShkFAAAOw==") - load_image("not_selected", "R0lGODlhEAAQAPD/AAAAAP///yH5BAUKAAIALAAAAAAQABAAAAIrlA2px6IBw2IpWglOvTYhzmUbGD3kNZ5QqrKn2YrqigCxZoMelU6No9gdCgA7") - load_image("selected", "R0lGODlhEAAQAPD/AAAAAP///yH5BAUKAAIALAAAAAAQABAAAAIzlA2px6IBw2IpWglOvTah/kTZhimASJomiqonlLov1qptHTsgKSEzh9H8QI0QzNPwmRoFADs=") - load_image("edit", "R0lGODlhEAAQAPIFAAAAAKOLAMuuEPvXCvrxvgAAAAAAAAAAACH5BAUKAAUALAAAAAAQABAAAANCWLqw/gqMBp8cszJxcwVC2FEOEIAi5kVBi3IqWZhuCGMyfdpj2e4pnK+WAshmvxeAcETWlsxPkkBtsqBMa8TIBSQAADs=") - - -def _fix_treeview_issues(): - # Fixes some Treeview issues - - global _treeview_rowheight - - style = ttk.Style() - - # The treeview rowheight isn't adjusted automatically on high-DPI displays, - # so do it ourselves. The font will probably always be TkDefaultFont, but - # play it safe and look it up. - - _treeview_rowheight = font.Font(font=style.lookup("Treeview", "font")) \ - .metrics("linespace") + 2 - - style.configure("Treeview", rowheight=_treeview_rowheight) - - # Work around regression in https://core.tcl.tk/tk/tktview?name=509cafafae, - # which breaks tag background colors - - for option in "foreground", "background": - # Filter out any styles starting with ("!disabled", "!selected", ...). - # style.map() returns an empty list for missing options, so this should - # be future-safe. - style.map( - "Treeview", - **{option: [elm for elm in style.map("Treeview", query_opt=option) - if elm[:2] != ("!disabled", "!selected")]}) - - -def _init_misc_ui(): - # Does misc. UI initialization, like setting the title, icon, and theme - - _root.title(_kconf.mainmenu_text) - # iconphoto() isn't available in Python 2's Tkinter - _root.tk.call("wm", "iconphoto", _root._w, "-default", _icon_img) - # Reducing the width of the window to 1 pixel makes it move around, at - # least on GNOME. Prevent weird stuff like that. - _root.minsize(128, 128) - _root.protocol("WM_DELETE_WINDOW", _on_quit) - - # Use the 'clam' theme on *nix if it's available. It looks nicer than the - # 'default' theme. - if _root.tk.call("tk", "windowingsystem") == "x11": - style = ttk.Style() - if "clam" in style.theme_names(): - style.theme_use("clam") - - -def _create_top_widgets(): - # Creates the controls above the Kconfig tree in the main window - - global _show_all_var - global _show_name_var - global _single_menu_var - global _menupath - global _backbutton - - topframe = ttk.Frame(_root) - topframe.grid(column=0, row=0, sticky="ew") - - ttk.Button(topframe, text="Save", command=_save) \ - .grid(column=0, row=0, sticky="ew", padx=".05c", pady=".05c") - - ttk.Button(topframe, text="Save as...", command=_save_as) \ - .grid(column=1, row=0, sticky="ew") - - ttk.Button(topframe, text="Save minimal (advanced)...", - command=_save_minimal) \ - .grid(column=2, row=0, sticky="ew", padx=".05c") - - ttk.Button(topframe, text="Open...", command=_open) \ - .grid(column=3, row=0) - - ttk.Button(topframe, text="Jump to...", command=_jump_to_dialog) \ - .grid(column=4, row=0, padx=".05c") - - _show_name_var = BooleanVar() - ttk.Checkbutton(topframe, text="Show name", command=_do_showname, - variable=_show_name_var) \ - .grid(column=0, row=1, sticky="nsew", padx=".05c", pady="0 .05c", - ipady=".2c") - - _show_all_var = BooleanVar() - ttk.Checkbutton(topframe, text="Show all", command=_do_showall, - variable=_show_all_var) \ - .grid(column=1, row=1, sticky="nsew", pady="0 .05c") - - # Allow the show-all and single-menu status to be queried via plain global - # Python variables, which is faster and simpler - - def show_all_updated(*_): - global _show_all - _show_all = _show_all_var.get() - - _trace_write(_show_all_var, show_all_updated) - _show_all_var.set(False) - - _single_menu_var = BooleanVar() - ttk.Checkbutton(topframe, text="Single-menu mode", command=_do_tree_mode, - variable=_single_menu_var) \ - .grid(column=2, row=1, sticky="nsew", padx=".05c", pady="0 .05c") - - _backbutton = ttk.Button(topframe, text="<--", command=_leave_menu, - state="disabled") - _backbutton.grid(column=0, row=4, sticky="nsew", padx=".05c", pady="0 .05c") - - def tree_mode_updated(*_): - global _single_menu - _single_menu = _single_menu_var.get() - - if _single_menu: - _backbutton.grid() - else: - _backbutton.grid_remove() - - _trace_write(_single_menu_var, tree_mode_updated) - _single_menu_var.set(False) - - # Column to the right of the buttons that the menu path extends into, so - # that it can grow wider than the buttons - topframe.columnconfigure(5, weight=1) - - _menupath = ttk.Label(topframe) - _menupath.grid(column=0, row=3, columnspan=6, sticky="w", padx="0.05c", - pady="0 .05c") - - -def _create_kconfig_tree_and_desc(parent): - # Creates a Panedwindow with a Treeview that shows Kconfig nodes and a Text - # that shows a description of the selected node. Returns a tuple with the - # Panedwindow and the Treeview. This code is shared between the main window - # and the jump-to dialog. - - panedwindow = ttk.Panedwindow(parent, orient=VERTICAL) - - tree_frame, tree = _create_kconfig_tree(panedwindow) - desc_frame, desc = _create_kconfig_desc(panedwindow) - - panedwindow.add(tree_frame, weight=1) - panedwindow.add(desc_frame) - - def tree_select(_): - # The Text widget does not allow editing the text in its disabled - # state. We need to temporarily enable it. - desc["state"] = "normal" - - sel = tree.selection() - if not sel: - desc.delete("1.0", "end") - desc["state"] = "disabled" - return - - # Text.replace() is not available in Python 2's Tkinter - desc.delete("1.0", "end") - desc.insert("end", _info_str(_id_to_node[sel[0]])) - - desc["state"] = "disabled" - - tree.bind("<>", tree_select) - tree.bind("<1>", _tree_click) - tree.bind("", _tree_double_click) - tree.bind("", _tree_enter) - tree.bind("", _tree_enter) - tree.bind("", _tree_toggle) - tree.bind("n", _tree_set_val(0)) - tree.bind("m", _tree_set_val(1)) - tree.bind("y", _tree_set_val(2)) - - return panedwindow, tree - - -def _create_kconfig_tree(parent): - # Creates a Treeview for showing Kconfig nodes - - frame = ttk.Frame(parent) - - tree = ttk.Treeview(frame, selectmode="browse", height=20, - columns=("name",)) - tree.heading("#0", text="Option", anchor="w") - tree.heading("name", text="Name", anchor="w") - - tree.tag_configure("n-bool", image=_n_bool_img) - tree.tag_configure("y-bool", image=_y_bool_img) - tree.tag_configure("m-tri", image=_m_tri_img) - tree.tag_configure("n-tri", image=_n_tri_img) - tree.tag_configure("m-tri", image=_m_tri_img) - tree.tag_configure("y-tri", image=_y_tri_img) - tree.tag_configure("m-my", image=_m_my_img) - tree.tag_configure("y-my", image=_y_my_img) - tree.tag_configure("n-locked", image=_n_locked_img) - tree.tag_configure("m-locked", image=_m_locked_img) - tree.tag_configure("y-locked", image=_y_locked_img) - tree.tag_configure("not-selected", image=_not_selected_img) - tree.tag_configure("selected", image=_selected_img) - tree.tag_configure("edit", image=_edit_img) - tree.tag_configure("invisible", foreground="red") - - tree.grid(column=0, row=0, sticky="nsew") - - _add_vscrollbar(frame, tree) - - frame.columnconfigure(0, weight=1) - frame.rowconfigure(0, weight=1) - - # Create items for all menu nodes. These can be detached/moved later. - # Micro-optimize this a bit. - insert = tree.insert - id_ = id - Symbol_ = Symbol - for node in _kconf.node_iter(): - item = node.item - insert("", "end", iid=id_(node), - values=item.name if item.__class__ is Symbol_ else "") - - return frame, tree - - -def _create_kconfig_desc(parent): - # Creates a Text for showing the description of the selected Kconfig node - - frame = ttk.Frame(parent) - - desc = Text(frame, height=12, wrap="none", borderwidth=0, - state="disabled") - desc.grid(column=0, row=0, sticky="nsew") - - # Work around not being to Ctrl-C/V text from a disabled Text widget, with a - # tip found in https://stackoverflow.com/questions/3842155/is-there-a-way-to-make-the-tkinter-text-widget-read-only - desc.bind("<1>", lambda _: desc.focus_set()) - - _add_vscrollbar(frame, desc) - - frame.columnconfigure(0, weight=1) - frame.rowconfigure(0, weight=1) - - return frame, desc - - -def _add_vscrollbar(parent, widget): - # Adds a vertical scrollbar to 'widget' that's only shown as needed - - vscrollbar = ttk.Scrollbar(parent, orient="vertical", - command=widget.yview) - vscrollbar.grid(column=1, row=0, sticky="ns") - - def yscrollcommand(first, last): - # Only show the scrollbar when needed. 'first' and 'last' are - # strings. - if float(first) <= 0.0 and float(last) >= 1.0: - vscrollbar.grid_remove() - else: - vscrollbar.grid() - - vscrollbar.set(first, last) - - widget["yscrollcommand"] = yscrollcommand - - -def _create_status_bar(): - # Creates the status bar at the bottom of the main window - - global _status_label - - _status_label = ttk.Label(_root, anchor="e", padding="0 0 0.4c 0") - _status_label.grid(column=0, row=3, sticky="ew") - - -def _set_status(s): - # Sets the text in the status bar to 's' - - _status_label["text"] = s - - -def _set_conf_changed(changed): - # Updates the status re. whether there are unsaved changes - - global _conf_changed - - _conf_changed = changed - if changed: - _set_status("Modified") - - -def _update_tree(): - # Updates the Kconfig tree in the main window by first detaching all nodes - # and then updating and reattaching them. The tree structure might have - # changed. - - # If a selected/focused item is detached and later reattached, it stays - # selected/focused. That can give multiple selections even though - # selectmode=browse. Save and later restore the selection and focus as a - # workaround. - old_selection = _tree.selection() - old_focus = _tree.focus() - - # Detach all tree items before re-stringing them. This is relatively fast, - # luckily. - _tree.detach(*_id_to_node.keys()) - - if _single_menu: - _build_menu_tree() - else: - _build_full_tree(_kconf.top_node) - - _tree.selection_set(old_selection) - _tree.focus(old_focus) - - -def _build_full_tree(menu): - # Updates the tree starting from menu.list, in full-tree mode. To speed - # things up, only open menus are updated. The menu-at-a-time logic here is - # to deal with invisible items that can show up outside show-all mode (see - # _shown_full_nodes()). - - for node in _shown_full_nodes(menu): - _add_to_tree(node, _kconf.top_node) - - # _shown_full_nodes() includes nodes from menus rooted at symbols, so - # we only need to check "real" menus/choices here - if node.list and not isinstance(node.item, Symbol): - if _tree.item(id(node), "open"): - _build_full_tree(node) - else: - # We're just probing here, so _shown_menu_nodes() will work - # fine, and might be a bit faster - shown = _shown_menu_nodes(node) - if shown: - # Dummy element to make the open/closed toggle appear - _tree.move(id(shown[0]), id(shown[0].parent), "end") - - -def _shown_full_nodes(menu): - # Returns the list of menu nodes shown in 'menu' (a menu node for a menu) - # for full-tree mode. A tricky detail is that invisible items need to be - # shown if they have visible children. - - def rec(node): - res = [] - - while node: - if _visible(node) or _show_all: - res.append(node) - if node.list and isinstance(node.item, Symbol): - # Nodes from menu created from dependencies - res += rec(node.list) - - elif node.list and isinstance(node.item, Symbol): - # Show invisible symbols (defined with either 'config' and - # 'menuconfig') if they have visible children. This can happen - # for an m/y-valued symbol with an optional prompt - # ('prompt "foo" is COND') that is currently disabled. - shown_children = rec(node.list) - if shown_children: - res.append(node) - res += shown_children - - node = node.next - - return res - - return rec(menu.list) - - -def _build_menu_tree(): - # Updates the tree in single-menu mode. See _build_full_tree() as well. - - for node in _shown_menu_nodes(_cur_menu): - _add_to_tree(node, _cur_menu) - - -def _shown_menu_nodes(menu): - # Used for single-menu mode. Similar to _shown_full_nodes(), but doesn't - # include children of symbols defined with 'menuconfig'. - - def rec(node): - res = [] - - while node: - if _visible(node) or _show_all: - res.append(node) - if node.list and not node.is_menuconfig: - res += rec(node.list) - - elif node.list and isinstance(node.item, Symbol): - shown_children = rec(node.list) - if shown_children: - # Invisible item with visible children - res.append(node) - if not node.is_menuconfig: - res += shown_children - - node = node.next - - return res - - return rec(menu.list) - - -def _visible(node): - # Returns True if the node should appear in the menu (outside show-all - # mode) - - return node.prompt and expr_value(node.prompt[1]) and not \ - (node.item == MENU and not expr_value(node.visibility)) - - -def _add_to_tree(node, top): - # Adds 'node' to the tree, at the end of its menu. We rely on going through - # the nodes linearly to get the correct order. 'top' holds the menu that - # corresponds to the top-level menu, and can vary in single-menu mode. - - parent = node.parent - _tree.move(id(node), "" if parent is top else id(parent), "end") - _tree.item( - id(node), - text=_node_str(node), - # The _show_all test avoids showing invisible items in red outside - # show-all mode, which could look confusing/broken. Invisible symbols - # are shown outside show-all mode if an invisible symbol has visible - # children in an implicit menu. - tags=_img_tag(node) if _visible(node) or not _show_all else - _img_tag(node) + " invisible") - - -def _node_str(node): - # Returns the string shown to the right of the image (if any) for the node - - if node.prompt: - if node.item == COMMENT: - s = "*** {} ***".format(node.prompt[0]) - else: - s = node.prompt[0] - - if isinstance(node.item, Symbol): - sym = node.item - - # Print "(NEW)" next to symbols without a user value (from e.g. a - # .config), but skip it for choice symbols in choices in y mode, - # and for symbols of UNKNOWN type (which generate a warning though) - if sym.user_value is None and sym.type and not \ - (sym.choice and sym.choice.tri_value == 2): - - s += " (NEW)" - - elif isinstance(node.item, Symbol): - # Symbol without prompt (can show up in show-all) - s = "<{}>".format(node.item.name) - - else: - # Choice without prompt. Use standard_sc_expr_str() so that it shows up - # as ''. - s = standard_sc_expr_str(node.item) - - - if isinstance(node.item, Symbol): - sym = node.item - if sym.orig_type == STRING: - s += ": " + sym.str_value - elif sym.orig_type in (INT, HEX): - s = "({}) {}".format(sym.str_value, s) - - elif isinstance(node.item, Choice) and node.item.tri_value == 2: - # Print the prompt of the selected symbol after the choice for - # choices in y mode - sym = node.item.selection - if sym: - for sym_node in sym.nodes: - # Use the prompt used at this choice location, in case the - # choice symbol is defined in multiple locations - if sym_node.parent is node and sym_node.prompt: - s += " ({})".format(sym_node.prompt[0]) - break - else: - # If the symbol isn't defined at this choice location, then - # just use whatever prompt we can find for it - for sym_node in sym.nodes: - if sym_node.prompt: - s += " ({})".format(sym_node.prompt[0]) - break - - # In single-menu mode, print "--->" next to nodes that have menus that can - # potentially be entered. Print "----" if the menu is empty. We don't allow - # those to be entered. - if _single_menu and node.is_menuconfig: - s += " --->" if _shown_menu_nodes(node) else " ----" - - return s - - -def _img_tag(node): - # Returns the tag for the image that should be shown next to 'node', or the - # empty string if it shouldn't have an image - - item = node.item - - if item in (MENU, COMMENT) or not item.orig_type: - return "" - - if item.orig_type in (STRING, INT, HEX): - return "edit" - - # BOOL or TRISTATE - - if _is_y_mode_choice_sym(item): - # Choice symbol in y-mode choice - return "selected" if item.choice.selection is item else "not-selected" - - if len(item.assignable) <= 1: - # Pinned to a single value - return "" if isinstance(item, Choice) else item.str_value + "-locked" - - if item.type == BOOL: - return item.str_value + "-bool" - - # item.type == TRISTATE - if item.assignable == (1, 2): - return item.str_value + "-my" - return item.str_value + "-tri" - - -def _is_y_mode_choice_sym(item): - # The choice mode is an upper bound on the visibility of choice symbols, so - # we can check the choice symbols' own visibility to see if the choice is - # in y mode - return isinstance(item, Symbol) and item.choice and item.visibility == 2 - - -def _tree_click(event): - # Click on the Kconfig Treeview - - tree = event.widget - if tree.identify_element(event.x, event.y) == "image": - item = tree.identify_row(event.y) - # Select the item before possibly popping up a dialog for - # string/int/hex items, so that its help is visible - _select(tree, item) - _change_node(_id_to_node[item], tree.winfo_toplevel()) - return "break" - - -def _tree_double_click(event): - # Double-click on the Kconfig treeview - - # Do an extra check to avoid weirdness when double-clicking in the tree - # heading area - if not _in_heading(event): - return _tree_enter(event) - - -def _in_heading(event): - # Returns True if 'event' took place in the tree heading - - tree = event.widget - return hasattr(tree, "identify_region") and \ - tree.identify_region(event.x, event.y) in ("heading", "separator") - - -def _tree_enter(event): - # Enter press or double-click within the Kconfig treeview. Prefer to - # open/close/enter menus, but toggle the value if that's not possible. - - tree = event.widget - sel = tree.focus() - if sel: - node = _id_to_node[sel] - - if tree.get_children(sel): - _tree_toggle_open(sel) - elif _single_menu_mode_menu(node, tree): - _enter_menu_and_select_first(node) - else: - _change_node(node, tree.winfo_toplevel()) - - return "break" - - -def _tree_toggle(event): - # Space press within the Kconfig treeview. Prefer to toggle the value, but - # open/close/enter the menu if that's not possible. - - tree = event.widget - sel = tree.focus() - if sel: - node = _id_to_node[sel] - - if _changeable(node): - _change_node(node, tree.winfo_toplevel()) - elif _single_menu_mode_menu(node, tree): - _enter_menu_and_select_first(node) - elif tree.get_children(sel): - _tree_toggle_open(sel) - - return "break" - - -def _tree_left_key(_): - # Left arrow key press within the Kconfig treeview - - if _single_menu: - # Leave the current menu in single-menu mode - _leave_menu() - return "break" - - # Otherwise, default action - - -def _tree_right_key(_): - # Right arrow key press within the Kconfig treeview - - sel = _tree.focus() - if sel: - node = _id_to_node[sel] - # If the node can be entered in single-menu mode, do it - if _single_menu_mode_menu(node, _tree): - _enter_menu_and_select_first(node) - return "break" - - # Otherwise, default action - - -def _single_menu_mode_menu(node, tree): - # Returns True if single-menu mode is on and 'node' is an (interface) - # menu that can be entered - - return _single_menu and tree is _tree and node.is_menuconfig and \ - _shown_menu_nodes(node) - - -def _changeable(node): - # Returns True if 'node' is a Symbol/Choice whose value can be changed - - sc = node.item - - if not isinstance(sc, (Symbol, Choice)): - return False - - # This will hit for invisible symbols, which appear in show-all mode and - # when an invisible symbol has visible children (which can happen e.g. for - # symbols with optional prompts) - if not (node.prompt and expr_value(node.prompt[1])): - return False - - return sc.orig_type in (STRING, INT, HEX) or len(sc.assignable) > 1 \ - or _is_y_mode_choice_sym(sc) - - -def _tree_toggle_open(item): - # Opens/closes the Treeview item 'item' - - if _tree.item(item, "open"): - _tree.item(item, open=False) - else: - node = _id_to_node[item] - if not isinstance(node.item, Symbol): - # Can only get here in full-tree mode - _build_full_tree(node) - _tree.item(item, open=True) - - -def _tree_set_val(tri_val): - def tree_set_val(event): - # n/m/y press within the Kconfig treeview - - # Sets the value of the currently selected item to 'tri_val', if that - # value can be assigned - - sel = event.widget.focus() - if sel: - sc = _id_to_node[sel].item - if isinstance(sc, (Symbol, Choice)) and tri_val in sc.assignable: - _set_val(sc, tri_val) - - return tree_set_val - - -def _tree_open(_): - # Lazily populates the Kconfig tree when menus are opened in full-tree mode - - if _single_menu: - # Work around https://core.tcl.tk/tk/tktview?name=368fa4561e - # ("ttk::treeview open/closed indicators can be toggled while hidden"). - # Clicking on the hidden indicator will call _build_full_tree() in - # single-menu mode otherwise. - return - - node = _id_to_node[_tree.focus()] - # _shown_full_nodes() includes nodes from menus rooted at symbols, so we - # only need to check "real" menus and choices here - if not isinstance(node.item, Symbol): - _build_full_tree(node) - - -def _update_menu_path(_): - # Updates the displayed menu path when nodes are selected in the Kconfig - # treeview - - sel = _tree.selection() - _menupath["text"] = _menu_path_info(_id_to_node[sel[0]]) if sel else "" - - -def _item_row(item): - # Returns the row number 'item' appears on within the Kconfig treeview, - # starting from the top of the tree. Used to preserve scrolling. - # - # ttkTreeview.c in the Tk sources defines a RowNumber() function that does - # the same thing, but it's not exposed. - - row = 0 - - while True: - prev = _tree.prev(item) - if prev: - item = prev - row += _n_rows(item) - else: - item = _tree.parent(item) - if not item: - return row - row += 1 - - -def _n_rows(item): - # _item_row() helper. Returns the number of rows occupied by 'item' and # - # its children. - - rows = 1 - - if _tree.item(item, "open"): - for child in _tree.get_children(item): - rows += _n_rows(child) - - return rows - - -def _attached(item): - # Heuristic for checking if a Treeview item is attached. Doesn't seem to be - # good APIs for this. Might fail for super-obscure cases with tiny trees, - # but you'd just get a small scroll mess-up. - - return bool(_tree.next(item) or _tree.prev(item) or _tree.parent(item)) - - -def _change_node(node, parent): - # Toggles/changes the value of 'node'. 'parent' is the parent window - # (either the main window or the jump-to dialog), in case we need to pop up - # a dialog. - - if not _changeable(node): - return - - # sc = symbol/choice - sc = node.item - - if sc.type in (INT, HEX, STRING): - s = _set_val_dialog(node, parent) - - # Tkinter can return 'unicode' strings on Python 2, which Kconfiglib - # can't deal with. UTF-8-encode the string to work around it. - if _PY2 and isinstance(s, unicode): - s = s.encode("utf-8", "ignore") - - if s is not None: - _set_val(sc, s) - - elif len(sc.assignable) == 1: - # Handles choice symbols for choices in y mode, which are a special - # case: .assignable can be (2,) while .tri_value is 0. - _set_val(sc, sc.assignable[0]) - - else: - # Set the symbol to the value after the current value in - # sc.assignable, with wrapping - val_index = sc.assignable.index(sc.tri_value) - _set_val(sc, sc.assignable[(val_index + 1) % len(sc.assignable)]) - - -def _set_val(sc, val): - # Wrapper around Symbol/Choice.set_value() for updating the menu state and - # _conf_changed - - # Use the string representation of tristate values. This makes the format - # consistent for all symbol types. - if val in TRI_TO_STR: - val = TRI_TO_STR[val] - - if val != sc.str_value: - sc.set_value(val) - _set_conf_changed(True) - - # Update the tree and try to preserve the scroll. Do a cheaper variant - # than in the show-all case, that might mess up the scroll slightly in - # rare cases, but is fast and flicker-free. - - stayput = _loc_ref_item() # Item to preserve scroll for - old_row = _item_row(stayput) - - _update_tree() - - # If the reference item disappeared (can happen if the change was done - # from the jump-to dialog), then avoid messing with the scroll and hope - # for the best - if _attached(stayput): - _tree.yview_scroll(_item_row(stayput) - old_row, "units") - - if _jump_to_tree: - _update_jump_to_display() - - -def _set_val_dialog(node, parent): - # Pops up a dialog for setting the value of the string/int/hex - # symbol at node 'node'. 'parent' is the parent window. - - def ok(_=None): - # No 'nonlocal' in Python 2 - global _entry_res - - s = entry.get() - if sym.type == HEX and not s.startswith(("0x", "0X")): - s = "0x" + s - - if _check_valid(dialog, entry, sym, s): - _entry_res = s - dialog.destroy() - - def cancel(_=None): - global _entry_res - _entry_res = None - dialog.destroy() - - sym = node.item - - dialog = Toplevel(parent) - dialog.title("Enter {} value".format(TYPE_TO_STR[sym.type])) - dialog.resizable(False, False) - dialog.transient(parent) - dialog.protocol("WM_DELETE_WINDOW", cancel) - - ttk.Label(dialog, text=node.prompt[0] + ":") \ - .grid(column=0, row=0, columnspan=2, sticky="w", padx=".3c", - pady=".2c .05c") - - entry = ttk.Entry(dialog, width=30) - # Start with the previous value in the editbox, selected - entry.insert(0, sym.str_value) - entry.selection_range(0, "end") - entry.grid(column=0, row=1, columnspan=2, sticky="ew", padx=".3c") - entry.focus_set() - - range_info = _range_info(sym) - if range_info: - ttk.Label(dialog, text=range_info) \ - .grid(column=0, row=2, columnspan=2, sticky="w", padx=".3c", - pady=".2c 0") - - ttk.Button(dialog, text="OK", command=ok) \ - .grid(column=0, row=4 if range_info else 3, sticky="e", padx=".3c", - pady=".4c") - - ttk.Button(dialog, text="Cancel", command=cancel) \ - .grid(column=1, row=4 if range_info else 3, padx="0 .3c") - - # Give all horizontal space to the grid cell with the OK button, so that - # Cancel moves to the right - dialog.columnconfigure(0, weight=1) - - _center_on_root(dialog) - - # Hack to scroll the entry so that the end of the text is shown, from - # https://stackoverflow.com/questions/29334544/why-does-tkinters-entry-xview-moveto-fail. - # Related Tk ticket: https://core.tcl.tk/tk/info/2513186fff - def scroll_entry(_): - _root.update_idletasks() - entry.unbind("") - entry.xview_moveto(1) - entry.bind("", scroll_entry) - - # The dialog must be visible before we can grab the input - dialog.wait_visibility() - dialog.grab_set() - - dialog.bind("", ok) - dialog.bind("", ok) - dialog.bind("", cancel) - - # Wait for the user to be done with the dialog - parent.wait_window(dialog) - - # Regrab the input in the parent - parent.grab_set() - - return _entry_res - - -def _center_on_root(dialog): - # Centers 'dialog' on the root window. It often ends up at some bad place - # like the top-left corner of the screen otherwise. See the menuconfig() - # function, which has similar logic. - - dialog.withdraw() - _root.update_idletasks() - - dialog_width = dialog.winfo_reqwidth() - dialog_height = dialog.winfo_reqheight() - - screen_width = _root.winfo_screenwidth() - screen_height = _root.winfo_screenheight() - - x = _root.winfo_rootx() + (_root.winfo_width() - dialog_width)//2 - y = _root.winfo_rooty() + (_root.winfo_height() - dialog_height)//2 - - # Clamp so that no part of the dialog is outside the screen - if x + dialog_width > screen_width: - x = screen_width - dialog_width - elif x < 0: - x = 0 - if y + dialog_height > screen_height: - y = screen_height - dialog_height - elif y < 0: - y = 0 - - dialog.geometry("+{}+{}".format(x, y)) - - dialog.deiconify() - - -def _check_valid(dialog, entry, sym, s): - # Returns True if the string 's' is a well-formed value for 'sym'. - # Otherwise, pops up an error and returns False. - - if sym.type not in (INT, HEX): - # Anything goes for non-int/hex symbols - return True - - base = 10 if sym.type == INT else 16 - try: - int(s, base) - except ValueError: - messagebox.showerror( - "Bad value", - "'{}' is a malformed {} value".format( - s, TYPE_TO_STR[sym.type]), - parent=dialog) - entry.focus_set() - return False - - for low_sym, high_sym, cond in sym.ranges: - if expr_value(cond): - low_s = low_sym.str_value - high_s = high_sym.str_value - - if not int(low_s, base) <= int(s, base) <= int(high_s, base): - messagebox.showerror( - "Value out of range", - "{} is outside the range {}-{}".format(s, low_s, high_s), - parent=dialog) - entry.focus_set() - return False - - break - - return True - - -def _range_info(sym): - # Returns a string with information about the valid range for the symbol - # 'sym', or None if 'sym' doesn't have a range - - if sym.type in (INT, HEX): - for low, high, cond in sym.ranges: - if expr_value(cond): - return "Range: {}-{}".format(low.str_value, high.str_value) - - return None - - -def _save(_=None): - # Tries to save the configuration - - if _try_save(_kconf.write_config, _conf_filename, "configuration"): - _set_conf_changed(False) - - _tree.focus_set() - - -def _save_as(): - # Pops up a dialog for saving the configuration to a specific location - - global _conf_filename - - filename = _conf_filename - while True: - filename = filedialog.asksaveasfilename( - title="Save configuration as", - initialdir=os.path.dirname(filename), - initialfile=os.path.basename(filename), - parent=_root) - - if not filename: - break - - if _try_save(_kconf.write_config, filename, "configuration"): - _conf_filename = filename - break - - _tree.focus_set() - - -def _save_minimal(): - # Pops up a dialog for saving a minimal configuration (defconfig) to a - # specific location - - global _minconf_filename - - filename = _minconf_filename - while True: - filename = filedialog.asksaveasfilename( - title="Save minimal configuration as", - initialdir=os.path.dirname(filename), - initialfile=os.path.basename(filename), - parent=_root) - - if not filename: - break - - if _try_save(_kconf.write_min_config, filename, - "minimal configuration"): - - _minconf_filename = filename - break - - _tree.focus_set() - - -def _open(_=None): - # Pops up a dialog for loading a configuration - - global _conf_filename - - if _conf_changed and \ - not messagebox.askokcancel( - "Unsaved changes", - "You have unsaved changes. Load new configuration anyway?"): - - return - - filename = _conf_filename - while True: - filename = filedialog.askopenfilename( - title="Open configuration", - initialdir=os.path.dirname(filename), - initialfile=os.path.basename(filename), - parent=_root) - - if not filename: - break - - if _try_load(filename): - # Maybe something fancier could be done here later to try to - # preserve the scroll - - _conf_filename = filename - _set_conf_changed(_needs_save()) - - if _single_menu and not _shown_menu_nodes(_cur_menu): - # Turn on show-all if we're in single-menu mode and would end - # up with an empty menu - _show_all_var.set(True) - - _update_tree() - - break - - _tree.focus_set() - - -def _toggle_showname(_): - # Toggles show-name mode on/off - - _show_name_var.set(not _show_name_var.get()) - _do_showname() - - -def _do_showname(): - # Updates the UI for the current show-name setting - - # Columns do not automatically shrink/expand, so we have to update - # column widths ourselves - - tree_width = _tree.winfo_width() - - if _show_name_var.get(): - _tree["displaycolumns"] = ("name",) - _tree["show"] = "tree headings" - name_width = tree_width//3 - _tree.column("#0", width=max(tree_width - name_width, 1)) - _tree.column("name", width=name_width) - else: - _tree["displaycolumns"] = () - _tree["show"] = "tree" - _tree.column("#0", width=tree_width) - - _tree.focus_set() - - -def _toggle_showall(_): - # Toggles show-all mode on/off - - _show_all_var.set(not _show_all) - _do_showall() - - -def _do_showall(): - # Updates the UI for the current show-all setting - - # Don't allow turning off show-all if we'd end up with no visible nodes - if _nothing_shown(): - _show_all_var.set(True) - return - - # Save scroll information. old_scroll can end up negative here, if the - # reference item isn't shown (only invisible items on the screen, and - # show-all being turned off). - - stayput = _vis_loc_ref_item() - # Probe the middle of the first row, to play it safe. identify_row(0) seems - # to return the row before the top row. - old_scroll = _item_row(stayput) - \ - _item_row(_tree.identify_row(_treeview_rowheight//2)) - - _update_tree() - - if _show_all: - # Deep magic: Unless we call update_idletasks(), the scroll adjustment - # below is restricted to the height of the old tree, instead of the - # height of the new tree. Since the tree with show-all on is guaranteed - # to be taller, and we want the maximum range, we only call it when - # turning show-all on. - # - # Strictly speaking, something similar ought to be done when changing - # symbol values, but it causes annoying flicker, and in 99% of cases - # things work anyway there (with usually minor scroll mess-ups in the - # 1% case). - _root.update_idletasks() - - # Restore scroll - _tree.yview(_item_row(stayput) - old_scroll) - - _tree.focus_set() - - -def _nothing_shown(): - # _do_showall() helper. Returns True if no nodes would get - # shown with the current show-all setting. Also handles the - # (obscure) case when there are no visible nodes in the entire - # tree, meaning guiconfig was automatically started in - # show-all mode, which mustn't be turned off. - - return not _shown_menu_nodes( - _cur_menu if _single_menu else _kconf.top_node) - - -def _toggle_tree_mode(_): - # Toggles single-menu mode on/off - - _single_menu_var.set(not _single_menu) - _do_tree_mode() - - -def _do_tree_mode(): - # Updates the UI for the current tree mode (full-tree or single-menu) - - loc_ref_node = _id_to_node[_loc_ref_item()] - - if not _single_menu: - # _jump_to() -> _enter_menu() already updates the tree, but - # _jump_to() -> load_parents() doesn't, because it isn't always needed. - # We always need to update the tree here, e.g. to add/remove "--->". - _update_tree() - - _jump_to(loc_ref_node) - _tree.focus_set() - - -def _enter_menu_and_select_first(menu): - # Enters the menu 'menu' and selects the first item. Used in single-menu - # mode. - - _enter_menu(menu) - _select(_tree, _tree.get_children()[0]) - - -def _enter_menu(menu): - # Enters the menu 'menu'. Used in single-menu mode. - - global _cur_menu - - _cur_menu = menu - _update_tree() - - _backbutton["state"] = "disabled" if menu is _kconf.top_node else "normal" - - -def _leave_menu(): - # Leaves the current menu. Used in single-menu mode. - - global _cur_menu - - if _cur_menu is not _kconf.top_node: - old_menu = _cur_menu - - _cur_menu = _parent_menu(_cur_menu) - _update_tree() - - _select(_tree, id(old_menu)) - - if _cur_menu is _kconf.top_node: - _backbutton["state"] = "disabled" - - _tree.focus_set() - - -def _select(tree, item): - # Selects, focuses, and see()s 'item' in 'tree' - - tree.selection_set(item) - tree.focus(item) - tree.see(item) - - -def _loc_ref_item(): - # Returns a Treeview item that can serve as a reference for the current - # scroll location. We try to make this item stay on the same row on the - # screen when updating the tree. - - # If the selected item is visible, use that - sel = _tree.selection() - if sel and _tree.bbox(sel[0]): - return sel[0] - - # Otherwise, use the middle item on the screen. If it doesn't exist, the - # tree is probably really small, so use the first item in the entire tree. - return _tree.identify_row(_tree.winfo_height()//2) or \ - _tree.get_children()[0] - - -def _vis_loc_ref_item(): - # Like _loc_ref_item(), but finds a visible item around the reference item. - # Used when changing show-all mode, where non-visible (red) items will - # disappear. - - item = _loc_ref_item() - - vis_before = _vis_before(item) - if vis_before and _tree.bbox(vis_before): - return vis_before - - vis_after = _vis_after(item) - if vis_after and _tree.bbox(vis_after): - return vis_after - - return vis_before or vis_after - - -def _vis_before(item): - # _vis_loc_ref_item() helper. Returns the first visible (not red) item, - # searching backwards from 'item'. - - while item: - if not _tree.tag_has("invisible", item): - return item - - prev = _tree.prev(item) - item = prev if prev else _tree.parent(item) - - return None - - -def _vis_after(item): - # _vis_loc_ref_item() helper. Returns the first visible (not red) item, - # searching forwards from 'item'. - - while item: - if not _tree.tag_has("invisible", item): - return item - - next = _tree.next(item) - if next: - item = next - else: - item = _tree.parent(item) - if not item: - break - item = _tree.next(item) - - return None - - -def _on_quit(_=None): - # Called when the user wants to exit - - if not _conf_changed: - _quit("No changes to save (for '{}')".format(_conf_filename)) - return - - while True: - ync = messagebox.askyesnocancel("Quit", "Save changes?") - if ync is None: - return - - if not ync: - _quit("Configuration ({}) was not saved".format(_conf_filename)) - return - - if _try_save(_kconf.write_config, _conf_filename, "configuration"): - # _try_save() already prints the "Configuration saved to ..." - # message - _quit() - return - - -def _quit(msg=None): - # Quits the application - - # Do not call sys.exit() here, in case we're being run from a script - _root.destroy() - if msg: - print(msg) - - -def _try_save(save_fn, filename, description): - # Tries to save a configuration file. Pops up an error and returns False on - # failure. - # - # save_fn: - # Function to call with 'filename' to save the file - # - # description: - # String describing the thing being saved - - try: - # save_fn() returns a message to print - msg = save_fn(filename) - _set_status(msg) - print(msg) - return True - except EnvironmentError as e: - messagebox.showerror( - "Error saving " + description, - "Error saving {} to '{}': {} (errno: {})" - .format(description, e.filename, e.strerror, - errno.errorcode[e.errno])) - return False - - -def _try_load(filename): - # Tries to load a configuration file. Pops up an error and returns False on - # failure. - # - # filename: - # Configuration file to load - - try: - msg = _kconf.load_config(filename) - _set_status(msg) - print(msg) - return True - except EnvironmentError as e: - messagebox.showerror( - "Error loading configuration", - "Error loading '{}': {} (errno: {})" - .format(filename, e.strerror, errno.errorcode[e.errno])) - return False - - -def _jump_to_dialog(_=None): - # Pops up a dialog for jumping directly to a particular node. Symbol values - # can also be changed within the dialog. - # - # Note: There's nothing preventing this from doing an incremental search - # like menuconfig.py does, but currently it's a bit jerky for large Kconfig - # trees, at least when inputting the beginning of the search string. We'd - # need to somehow only update the tree items that are shown in the Treeview - # to fix it. - - global _jump_to_tree - - def search(_=None): - _update_jump_to_matches(msglabel, entry.get()) - - def jump_to_selected(event=None): - # Jumps to the selected node and closes the dialog - - # Ignore double clicks on the image and in the heading area - if event and (tree.identify_element(event.x, event.y) == "image" or - _in_heading(event)): - return - - sel = tree.selection() - if not sel: - return - - node = _id_to_node[sel[0]] - - if node not in _shown_menu_nodes(_parent_menu(node)): - _show_all_var.set(True) - if not _single_menu: - # See comment in _do_tree_mode() - _update_tree() - - _jump_to(node) - - dialog.destroy() - - def tree_select(_): - jumpto_button["state"] = "normal" if tree.selection() else "disabled" - - - dialog = Toplevel(_root) - dialog.geometry("+{}+{}".format( - _root.winfo_rootx() + 50, _root.winfo_rooty() + 50)) - dialog.title("Jump to symbol/choice/menu/comment") - dialog.minsize(128, 128) # See _create_ui() - dialog.transient(_root) - - ttk.Label(dialog, text=_JUMP_TO_HELP) \ - .grid(column=0, row=0, columnspan=2, sticky="w", padx=".1c", - pady=".1c") - - entry = ttk.Entry(dialog) - entry.grid(column=0, row=1, sticky="ew", padx=".1c", pady=".1c") - entry.focus_set() - - entry.bind("", search) - entry.bind("", search) - - ttk.Button(dialog, text="Search", command=search) \ - .grid(column=1, row=1, padx="0 .1c", pady="0 .1c") - - msglabel = ttk.Label(dialog) - msglabel.grid(column=0, row=2, sticky="w", pady="0 .1c") - - panedwindow, tree = _create_kconfig_tree_and_desc(dialog) - panedwindow.grid(column=0, row=3, columnspan=2, sticky="nsew") - - # Clear tree - tree.set_children("") - - _jump_to_tree = tree - - jumpto_button = ttk.Button(dialog, text="Jump to selected item", - state="disabled", command=jump_to_selected) - jumpto_button.grid(column=0, row=4, columnspan=2, sticky="ns", pady=".1c") - - dialog.columnconfigure(0, weight=1) - # Only the pane with the Kconfig tree and description grows vertically - dialog.rowconfigure(3, weight=1) - - # See the menuconfig() function - _root.update_idletasks() - dialog.geometry(dialog.geometry()) - - # The dialog must be visible before we can grab the input - dialog.wait_visibility() - dialog.grab_set() - - tree.bind("", jump_to_selected) - tree.bind("", jump_to_selected) - tree.bind("", jump_to_selected) - # add=True to avoid overriding the description text update - tree.bind("<>", tree_select, add=True) - - dialog.bind("", lambda _: dialog.destroy()) - - # Wait for the user to be done with the dialog - _root.wait_window(dialog) - - _jump_to_tree = None - - _tree.focus_set() - - -def _update_jump_to_matches(msglabel, search_string): - # Searches for nodes matching the search string and updates - # _jump_to_matches. Puts a message in 'msglabel' if there are no matches, - # or regex errors. - - global _jump_to_matches - - _jump_to_tree.selection_set(()) - - try: - # We could use re.IGNORECASE here instead of lower(), but this is - # faster for regexes like '.*debug$' (though the '.*' is redundant - # there). Those probably have bad interactions with re.search(), which - # matches anywhere in the string. - regex_searches = [re.compile(regex).search - for regex in search_string.lower().split()] - except re.error as e: - msg = "Bad regular expression" - # re.error.msg was added in Python 3.5 - if hasattr(e, "msg"): - msg += ": " + e.msg - msglabel["text"] = msg - # Clear tree - _jump_to_tree.set_children("") - return - - _jump_to_matches = [] - add_match = _jump_to_matches.append - - for node in _sorted_sc_nodes(): - # Symbol/choice - sc = node.item - - for search in regex_searches: - # Both the name and the prompt might be missing, since - # we're searching both symbols and choices - - # Does the regex match either the symbol name or the - # prompt (if any)? - if not (sc.name and search(sc.name.lower()) or - node.prompt and search(node.prompt[0].lower())): - - # Give up on the first regex that doesn't match, to - # speed things up a bit when multiple regexes are - # entered - break - - else: - add_match(node) - - # Search menus and comments - - for node in _sorted_menu_comment_nodes(): - for search in regex_searches: - if not search(node.prompt[0].lower()): - break - else: - add_match(node) - - msglabel["text"] = "" if _jump_to_matches else "No matches" - - _update_jump_to_display() - - if _jump_to_matches: - item = id(_jump_to_matches[0]) - _jump_to_tree.selection_set(item) - _jump_to_tree.focus(item) - - -def _update_jump_to_display(): - # Updates the images and text for the items in _jump_to_matches, and sets - # them as the items of _jump_to_tree - - # Micro-optimize a bit - item = _jump_to_tree.item - id_ = id - node_str = _node_str - img_tag = _img_tag - visible = _visible - for node in _jump_to_matches: - item(id_(node), - text=node_str(node), - tags=img_tag(node) if visible(node) else - img_tag(node) + " invisible") - - _jump_to_tree.set_children("", *map(id, _jump_to_matches)) - - -def _jump_to(node): - # Jumps directly to 'node' and selects it - - if _single_menu: - _enter_menu(_parent_menu(node)) - else: - _load_parents(node) - - _select(_tree, id(node)) - - -# Obscure Python: We never pass a value for cached_nodes, and it keeps pointing -# to the same list. This avoids a global. -def _sorted_sc_nodes(cached_nodes=[]): - # Returns a sorted list of symbol and choice nodes to search. The symbol - # nodes appear first, sorted by name, and then the choice nodes, sorted by - # prompt and (secondarily) name. - - if not cached_nodes: - # Add symbol nodes - for sym in sorted(_kconf.unique_defined_syms, - key=lambda sym: sym.name): - # += is in-place for lists - cached_nodes += sym.nodes - - # Add choice nodes - - choices = sorted(_kconf.unique_choices, - key=lambda choice: choice.name or "") - - cached_nodes += sorted( - [node for choice in choices for node in choice.nodes], - key=lambda node: node.prompt[0] if node.prompt else "") - - return cached_nodes - - -def _sorted_menu_comment_nodes(cached_nodes=[]): - # Returns a list of menu and comment nodes to search, sorted by prompt, - # with the menus first - - if not cached_nodes: - def prompt_text(mc): - return mc.prompt[0] - - cached_nodes += sorted(_kconf.menus, key=prompt_text) - cached_nodes += sorted(_kconf.comments, key=prompt_text) - - return cached_nodes - - -def _load_parents(node): - # Menus are lazily populated as they're opened in full-tree mode, but - # jumping to an item needs its parent menus to be populated. This function - # populates 'node's parents. - - # Get all parents leading up to 'node', sorted with the root first - parents = [] - cur = node.parent - while cur is not _kconf.top_node: - parents.append(cur) - cur = cur.parent - parents.reverse() - - for i, parent in enumerate(parents): - if not _tree.item(id(parent), "open"): - # Found a closed menu. Populate it and all the remaining menus - # leading up to 'node'. - for parent in parents[i:]: - # We only need to populate "real" menus/choices. Implicit menus - # are populated when their parents menus are entered. - if not isinstance(parent.item, Symbol): - _build_full_tree(parent) - return - - -def _parent_menu(node): - # Returns the menu node of the menu that contains 'node'. In addition to - # proper 'menu's, this might also be a 'menuconfig' symbol or a 'choice'. - # "Menu" here means a menu in the interface. - - menu = node.parent - while not menu.is_menuconfig: - menu = menu.parent - return menu - - -def _trace_write(var, fn): - # Makes fn() be called whenever the Tkinter Variable 'var' changes value - - # trace_variable() is deprecated according to the docstring, - # which recommends trace_add() - if hasattr(var, "trace_add"): - var.trace_add("write", fn) - else: - var.trace_variable("w", fn) - - -def _info_str(node): - # Returns information about the menu node 'node' as a string. - # - # The helper functions are responsible for adding newlines. This allows - # them to return "" if they don't want to add any output. - - if isinstance(node.item, Symbol): - sym = node.item - - return ( - _name_info(sym) + - _help_info(sym) + - _direct_dep_info(sym) + - _defaults_info(sym) + - _select_imply_info(sym) + - _kconfig_def_info(sym) - ) - - if isinstance(node.item, Choice): - choice = node.item - - return ( - _name_info(choice) + - _help_info(choice) + - 'Mode: {}\n\n'.format(choice.str_value) + - _choice_syms_info(choice) + - _direct_dep_info(choice) + - _defaults_info(choice) + - _kconfig_def_info(choice) - ) - - # node.item in (MENU, COMMENT) - return _kconfig_def_info(node) - - -def _name_info(sc): - # Returns a string with the name of the symbol/choice. Choices are shown as - # . - - return (sc.name if sc.name else standard_sc_expr_str(sc)) + "\n\n" - - -def _value_info(sym): - # Returns a string showing 'sym's value - - # Only put quotes around the value for string symbols - return "Value: {}\n".format( - '"{}"'.format(sym.str_value) - if sym.orig_type == STRING - else sym.str_value) - - -def _choice_syms_info(choice): - # Returns a string listing the choice symbols in 'choice'. Adds - # "(selected)" next to the selected one. - - s = "Choice symbols:\n" - - for sym in choice.syms: - s += " - " + sym.name - if sym is choice.selection: - s += " (selected)" - s += "\n" - - return s + "\n" - - -def _help_info(sc): - # Returns a string with the help text(s) of 'sc' (Symbol or Choice). - # Symbols and choices defined in multiple locations can have multiple help - # texts. - - s = "" - - for node in sc.nodes: - if node.help is not None: - s += node.help + "\n\n" - - return s - - -def _direct_dep_info(sc): - # Returns a string describing the direct dependencies of 'sc' (Symbol or - # Choice). The direct dependencies are the OR of the dependencies from each - # definition location. The dependencies at each definition location come - # from 'depends on' and dependencies inherited from parent items. - - return "" if sc.direct_dep is _kconf.y else \ - 'Direct dependencies (={}):\n{}\n' \ - .format(TRI_TO_STR[expr_value(sc.direct_dep)], - _split_expr_info(sc.direct_dep, 2)) - - -def _defaults_info(sc): - # Returns a string describing the defaults of 'sc' (Symbol or Choice) - - if not sc.defaults: - return "" - - s = "Default" - if len(sc.defaults) > 1: - s += "s" - s += ":\n" - - for val, cond in sc.orig_defaults: - s += " - " - if isinstance(sc, Symbol): - s += _expr_str(val) - - # Skip the tristate value hint if the expression is just a single - # symbol. _expr_str() already shows its value as a string. - # - # This also avoids showing the tristate value for string/int/hex - # defaults, which wouldn't make any sense. - if isinstance(val, tuple): - s += ' (={})'.format(TRI_TO_STR[expr_value(val)]) - else: - # Don't print the value next to the symbol name for choice - # defaults, as it looks a bit confusing - s += val.name - s += "\n" - - if cond is not _kconf.y: - s += " Condition (={}):\n{}" \ - .format(TRI_TO_STR[expr_value(cond)], - _split_expr_info(cond, 4)) - - return s + "\n" - - -def _split_expr_info(expr, indent): - # Returns a string with 'expr' split into its top-level && or || operands, - # with one operand per line, together with the operand's value. This is - # usually enough to get something readable for long expressions. A fancier - # recursive thingy would be possible too. - # - # indent: - # Number of leading spaces to add before the split expression. - - if len(split_expr(expr, AND)) > 1: - split_op = AND - op_str = "&&" - else: - split_op = OR - op_str = "||" - - s = "" - for i, term in enumerate(split_expr(expr, split_op)): - s += "{}{} {}".format(indent*" ", - " " if i == 0 else op_str, - _expr_str(term)) - - # Don't bother showing the value hint if the expression is just a - # single symbol. _expr_str() already shows its value. - if isinstance(term, tuple): - s += " (={})".format(TRI_TO_STR[expr_value(term)]) - - s += "\n" - - return s - - -def _select_imply_info(sym): - # Returns a string with information about which symbols 'select' or 'imply' - # 'sym'. The selecting/implying symbols are grouped according to which - # value they select/imply 'sym' to (n/m/y). - - def sis(expr, val, title): - # sis = selects/implies - sis = [si for si in split_expr(expr, OR) if expr_value(si) == val] - if not sis: - return "" - - res = title - for si in sis: - res += " - {}\n".format(split_expr(si, AND)[0].name) - return res + "\n" - - s = "" - - if sym.rev_dep is not _kconf.n: - s += sis(sym.rev_dep, 2, - "Symbols currently y-selecting this symbol:\n") - s += sis(sym.rev_dep, 1, - "Symbols currently m-selecting this symbol:\n") - s += sis(sym.rev_dep, 0, - "Symbols currently n-selecting this symbol (no effect):\n") - - if sym.weak_rev_dep is not _kconf.n: - s += sis(sym.weak_rev_dep, 2, - "Symbols currently y-implying this symbol:\n") - s += sis(sym.weak_rev_dep, 1, - "Symbols currently m-implying this symbol:\n") - s += sis(sym.weak_rev_dep, 0, - "Symbols currently n-implying this symbol (no effect):\n") - - return s - - -def _kconfig_def_info(item): - # Returns a string with the definition of 'item' in Kconfig syntax, - # together with the definition location(s) and their include and menu paths - - nodes = [item] if isinstance(item, MenuNode) else item.nodes - - s = "Kconfig definition{}, with parent deps. propagated to 'depends on'\n" \ - .format("s" if len(nodes) > 1 else "") - s += (len(s) - 1)*"=" - - for node in nodes: - s += "\n\n" \ - "At {}:{}\n" \ - "{}" \ - "Menu path: {}\n\n" \ - "{}" \ - .format(node.filename, node.linenr, - _include_path_info(node), - _menu_path_info(node), - node.custom_str(_name_and_val_str)) - - return s - - -def _include_path_info(node): - if not node.include_path: - # In the top-level Kconfig file - return "" - - return "Included via {}\n".format( - " -> ".join("{}:{}".format(filename, linenr) - for filename, linenr in node.include_path)) - - -def _menu_path_info(node): - # Returns a string describing the menu path leading up to 'node' - - path = "" - - while node.parent is not _kconf.top_node: - node = node.parent - - # Promptless choices might appear among the parents. Use - # standard_sc_expr_str() for them, so that they show up as - # ''. - path = " -> " + (node.prompt[0] if node.prompt else - standard_sc_expr_str(node.item)) + path - - return "(Top)" + path - - -def _name_and_val_str(sc): - # Custom symbol/choice printer that shows symbol values after symbols - - # Show the values of non-constant (non-quoted) symbols that don't look like - # numbers. Things like 123 are actually symbol references, and only work as - # expected due to undefined symbols getting their name as their value. - # Showing the symbol value for those isn't helpful though. - if isinstance(sc, Symbol) and not sc.is_constant and not _is_num(sc.name): - if not sc.nodes: - # Undefined symbol reference - return "{}(undefined/n)".format(sc.name) - - return '{}(={})'.format(sc.name, sc.str_value) - - # For other items, use the standard format - return standard_sc_expr_str(sc) - - -def _expr_str(expr): - # Custom expression printer that shows symbol values - return expr_str(expr, _name_and_val_str) - - -def _is_num(name): - # Heuristic to see if a symbol name looks like a number, for nicer output - # when printing expressions. Things like 16 are actually symbol names, only - # they get their name as their value when the symbol is undefined. - - try: - int(name) - except ValueError: - if not name.startswith(("0x", "0X")): - return False - - try: - int(name, 16) - except ValueError: - return False - - return True - - -if __name__ == "__main__": - _main() diff --git a/tools/Kconfiglib/kconfiglib.py b/tools/Kconfiglib/kconfiglib.py deleted file mode 100644 index c67895ced6b..00000000000 --- a/tools/Kconfiglib/kconfiglib.py +++ /dev/null @@ -1,7160 +0,0 @@ -# Copyright (c) 2011-2019, Ulf Magnusson -# SPDX-License-Identifier: ISC - -""" -Overview -======== - -Kconfiglib is a Python 2/3 library for scripting and extracting information -from Kconfig (https://www.kernel.org/doc/Documentation/kbuild/kconfig-language.txt) -configuration systems. - -See the homepage at https://github.com/ulfalizer/Kconfiglib for a longer -overview. - -Since Kconfiglib 12.0.0, the library version is available in -kconfiglib.VERSION, which is a (, , ) tuple, e.g. -(12, 0, 0). - - -Using Kconfiglib on the Linux kernel with the Makefile targets -============================================================== - -For the Linux kernel, a handy interface is provided by the -scripts/kconfig/Makefile patch, which can be applied with either 'git am' or -the 'patch' utility: - - $ wget -qO- https://raw.githubusercontent.com/ulfalizer/Kconfiglib/master/makefile.patch | git am - $ wget -qO- https://raw.githubusercontent.com/ulfalizer/Kconfiglib/master/makefile.patch | patch -p1 - -Warning: Not passing -p1 to patch will cause the wrong file to be patched. - -Please tell me if the patch does not apply. It should be trivial to apply -manually, as it's just a block of text that needs to be inserted near the other -*conf: targets in scripts/kconfig/Makefile. - -Look further down for a motivation for the Makefile patch and for instructions -on how you can use Kconfiglib without it. - -If you do not wish to install Kconfiglib via pip, the Makefile patch is set up -so that you can also just clone Kconfiglib into the kernel root: - - $ git clone git://github.com/ulfalizer/Kconfiglib.git - $ git am Kconfiglib/makefile.patch (or 'patch -p1 < Kconfiglib/makefile.patch') - -Warning: The directory name Kconfiglib/ is significant in this case, because -it's added to PYTHONPATH by the new targets in makefile.patch. - -The targets added by the Makefile patch are described in the following -sections. - - -make kmenuconfig ----------------- - -This target runs the curses menuconfig interface with Python 3. As of -Kconfiglib 12.2.0, both Python 2 and Python 3 are supported (previously, only -Python 3 was supported, so this was a backport). - - -make guiconfig --------------- - -This target runs the Tkinter menuconfig interface. Both Python 2 and Python 3 -are supported. To change the Python interpreter used, pass -PYTHONCMD= to 'make'. The default is 'python'. - - -make [ARCH=] iscriptconfig --------------------------------- - -This target gives an interactive Python prompt where a Kconfig instance has -been preloaded and is available in 'kconf'. To change the Python interpreter -used, pass PYTHONCMD= to 'make'. The default is 'python'. - -To get a feel for the API, try evaluating and printing the symbols in -kconf.defined_syms, and explore the MenuNode menu tree starting at -kconf.top_node by following 'next' and 'list' pointers. - -The item contained in a menu node is found in MenuNode.item (note that this can -be one of the constants kconfiglib.MENU and kconfiglib.COMMENT), and all -symbols and choices have a 'nodes' attribute containing their menu nodes -(usually only one). Printing a menu node will print its item, in Kconfig -format. - -If you want to look up a symbol by name, use the kconf.syms dictionary. - - -make scriptconfig SCRIPT=