binutils-gdb/gdb/doc
Simon Marchi 1256af7d1a python: Provide textual representation for Inferior and Objfile
Printing a GDB Python object is notoriously not helpful:

>>> print(gdb.selected_inferior())
<gdb.Inferior object at 0x7fea59aed198>
>>> print(gdb.objfiles())
[<gdb.Objfile object at 0x7fea59b57c90>]

This makes printing debug traces more difficult than it should be.  This
patch provides some repr() implementation for these two types (more to
come if people agree with the idea, but I want to test the water first).
Here's the same example as above, but with this patch:

>>> print(gdb.selected_inferior())
<gdb.Inferior num=1>
>>> print(gdb.objfiles())
[<gdb.Objfile filename=/home/emaisin/build/binutils-gdb-gcc-git/gdb/test>]

I implemented repr rather than str, because when printing a list (or
another container I suppose), Python calls the repr method of the
elements.  This is useful when printing a list of inferiors or objfiles.
The print(gdb.objfiles()) above would not have worked if I had
implemented str.

I found this post useful to understand the difference between repr and
str:

  https://stackoverflow.com/questions/1436703/difference-between-str-and-repr

gdb/ChangeLog:

	* python/py-inferior.c (infpy_repr): New.
	(inferior_object_type): Register infpy_repr.
	* python/py-objfile.c (objfpy_repr): New.
	(objfile_object_type): Register objfpy_repr.

gdb/testsuite/ChangeLog:

	* gdb.python/py-inferior.exp: Test repr() of gdb.Inferior.
	* gdb.python/py-objfile.exp: Test repr() of gdb.Objfile.
	* gdb.python/py-symtab.exp: Update test printing an objfile.

gdb/doc/ChangeLog:

	* python.texi (Basic Python): Mention the string representation
	of GDB Python objects.
2018-09-13 11:54:38 -04:00
..
.gitignore Update and add .gitignore's 2016-09-21 13:12:21 -04:00
a4rc.sed
agentexpr.texi Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
all-cfg.texi Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
annotate.texinfo Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
ChangeLog python: Provide textual representation for Inferior and Objfile 2018-09-13 11:54:38 -04:00
doxy-index.in Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
Doxyfile-base.in Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
Doxyfile-gdb-api.in Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
Doxyfile-gdb-xref.in Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
Doxyfile-gdbserver.in Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
fdl.texi
filter-for-doxygen
filter-params.pl
gdb.texinfo Add debug output about skipping files and functions 2018-09-12 12:25:26 -04:00
gpl.texi
guile.texi Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
lpsrc.sed
Makefile.in Install and generate docs for gdb-add-index 2018-01-12 15:29:06 -05:00
psrc.sed
python.texi python: Provide textual representation for Inferior and Objfile 2018-09-13 11:54:38 -04:00
refcard.tex Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
stabs.texinfo Update copyright year range in all GDB files 2018-01-02 07:38:06 +04:00
stack_frame.eps
stack_frame.pdf
stack_frame.png
stack_frame.svg
stack_frame.txt