mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2025-01-06 12:09:26 +08:00
13123da89a
Re-format all Python files using black [1] version 21.4b0. The goal is
that from now on, we keep all Python files formatted using black. And
that we never have to discuss formatting during review (for these files
at least) ever again.
One change is needed in gdb.python/py-prettyprint.exp, because it
matches the string representation of an exception, which shows source
code. So the change in formatting must be replicated in the expected
regexp.
To document our usage of black I plan on adding this to the "GDB Python
Coding Standards" wiki page [2]:
--8<--
All Python source files under the `gdb/` directory must be formatted
using black version 21.4b0.
This specific version can be installed using:
$ pip3 install 'black == 21.4b0'
All you need to do to re-format files is run `black <file/directory>`,
and black will re-format any Python file it finds in there. It runs
quite fast, so the simplest is to do:
$ black gdb/
from the top-level.
If you notice that black produces changes unrelated to your patch, it's
probably because someone forgot to run it before you. In this case,
don't include unrelated hunks in your patch. Push an obvious patch
fixing the formatting and rebase your work on top of that.
-->8--
Once this is merged, I plan on setting a up an `ignoreRevsFile`
config so that git-blame ignores this commit, as described here:
https://github.com/psf/black#migrating-your-code-style-without-ruining-git-blame
I also plan on working on a git commit hook (checked in the repo) to
automatically check the formatting of the Python files on commit.
[1] https://pypi.org/project/black/
[2] https://sourceware.org/gdb/wiki/Internals%20GDB-Python-Coding-Standards
gdb/ChangeLog:
* Re-format all Python files using black.
gdb/testsuite/ChangeLog:
* Re-format all Python files using black.
* gdb.python/py-prettyprint.exp (run_lang_tests): Adjust.
Change-Id: I28588a22c2406afd6bc2703774ddfff47cd61919
91 lines
3.0 KiB
Python
91 lines
3.0 KiB
Python
# Copyright (C) 2011-2021 Free Software Foundation, Inc.
|
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation; either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
"""Configure GDB using the ELinOS environment."""
|
|
|
|
import os
|
|
import glob
|
|
import gdb
|
|
|
|
|
|
def warn(msg):
|
|
print "warning: %s" % msg
|
|
|
|
|
|
def get_elinos_environment():
|
|
"""Return the ELinOS environment.
|
|
|
|
If the ELinOS environment is properly set up, return a dictionary
|
|
which contains:
|
|
* The path to the ELinOS project at key 'project';
|
|
* The path to the ELinOS CDK at key 'cdk';
|
|
* The ELinOS target name at key 'target' (Eg. 'i486-linux');
|
|
* A list of Xenomai install prefixes (which could be empty, if
|
|
the ELinOS project does not include Xenomai) at key 'xenomai'.
|
|
|
|
If one of these cannot be found, print a warning; the corresponding
|
|
value in the returned dictionary will be None.
|
|
"""
|
|
result = {}
|
|
for key in ("project", "cdk", "target"):
|
|
var = "ELINOS_" + key.upper()
|
|
if var in os.environ:
|
|
result[key] = os.environ[var]
|
|
else:
|
|
warn("%s not set" % var)
|
|
result[key] = None
|
|
|
|
if result["project"] is not None:
|
|
result["xenomai"] = glob.glob(result["project"] + "/xenomai-[0-9.]*")
|
|
else:
|
|
result["xenomai"] = []
|
|
|
|
return result
|
|
|
|
|
|
def elinos_init():
|
|
"""Initialize debugger environment for ELinOS.
|
|
|
|
Let the debugger know where to find the ELinOS libraries on host. This
|
|
assumes that an ELinOS environment is properly set up. If some environment
|
|
variables are missing, warn about which library may be missing.
|
|
"""
|
|
elinos_env = get_elinos_environment()
|
|
|
|
solib_dirs = []
|
|
|
|
# System libraries
|
|
if None in (elinos_env[key] for key in ("cdk", "target")):
|
|
warn("ELinOS system libraries will not be loaded")
|
|
else:
|
|
solib_prefix = "%s/%s" % (elinos_env["cdk"], elinos_env["target"])
|
|
solib_dirs += ["%s/%s" % (solib_prefix, "lib")]
|
|
gdb.execute("set solib-absolute-prefix %s" % solib_prefix)
|
|
|
|
# Xenomai libraries. Those are optional, so have a lighter warning
|
|
# if they cannot be located.
|
|
if elinos_env["project"] is None:
|
|
warn("Xenomai libraries may not be loaded")
|
|
else:
|
|
for dir in elinos_env["xenomai"]:
|
|
solib_dirs += ["%s/%s" % (dir, "xenomai-build/usr/realtime/lib")]
|
|
|
|
if len(solib_dirs) != 0:
|
|
gdb.execute("set solib-search-path %s" % ":".join(solib_dirs))
|
|
|
|
|
|
if __name__ == "__main__":
|
|
elinos_init()
|