1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
=====================
Debugging & Profiling
=====================
Things can go wrong, these tools may help you find the cause. If you know any
more tricks please share them.
GObject Instance Count Leak Check
---------------------------------
Requires a development (only available in debug mode) version of glib. Jhbuild
recommended.
::
jhbuild shell
GOBJECT_DEBUG=instance-count GTK_DEBUG=interactive ./quodlibet.py
* In the GTK Inspector switch to the "Statistics" tab
* Sort by "Cumulative" and do the action which you suspect does leak or where
you want to make sure it doesn't repeatedly. Like for example opening
and closing a window or switching between media files to present.
* If something in the "Cumulative" column steadily increases there probably
is a leak.
cProfile Performance Profiling
------------------------------
* https://docs.python.org/2/library/profile.html
* bundled with python
::
python -m cProfile -s [sort_order] quodlibet.py > cprof.txt
where ``sort_order`` can one of the following:
calls, cumulative, file, line, module, name, nfl, pcalls, stdname, time
Example output::
885311 function calls (866204 primitive calls) in 12.110 seconds
Ordered by: cumulative time
ncalls tottime percall cumtime percall filename:lineno(function)
1 0.002 0.002 12.112 12.112 quodlibet.py:11(<module>)
1 0.007 0.007 12.026 12.026 quodlibet.py:25(main)
19392/13067 0.151 0.000 4.342 0.000 __init__.py:639(__get__)
1 0.003 0.003 4.232 4.232 quodlibetwindow.py:121(__init__)
1 0.000 0.000 4.029 4.029 quodlibetwindow.py:549(select_browser)
1 0.002 0.002 4.022 4.022 albums.py:346(__init__)
...
...
SnakeViz - cProfile Based Visualization
---------------------------------------
* https://jiffyclub.github.io/snakeviz/
* ``pip install snakeviz``
::
python -m cProfile -o prof.out quodlibet.py
snakeviz prof.out
Sysprof - System-wide Performance Profiler for Linux
----------------------------------------------------
* http://sysprof.com/
::
sysprof-cli -c "python quodlibet/quodlibet.py"
sysprof capture.syscap
GDB
---
::
gdb --args python quodlibet/quodlibet.py
# type "run" and hit enter
Debugging Wayland Issues
------------------------
::
mutter --nested --wayland
# start your app, it should show up in the nested mutter
::
weston
# start your app, it should show up in the nested weston
Debugging HiDPI Issue
---------------------
::
GDK_SCALE=2 ./quodlibet/quodlibet.py
::
MUTTER_DEBUG_NUM_DUMMY_MONITORS=2 MUTTER_DEBUG_DUMMY_MONITOR_SCALES=1,2 mutter --nested --wayland
# start your app, it should show up in the nested mutter
|
