A terminal viewer for x86 instruction/intrinsic information using Python 3 + curses

README
Issues 6

x86-info-term

x86-info-term is a curses-based viewer for x86 instruction info built with Python 3. It combines the following data sources:

Intrinsics from the Intel Intrinsics Guide.
Performance info from uops.info.

Features

Offline use: after the data sources are downloaded on the first run, requires no network access to run
More advanced filtering: multiple filters are allowed, and so is filtering by regular expression (using Python's regex syntax).
Keyboard-only navigation: using a combination of vim- and emacs-style key bindings, x86-info-term is sure to delight and/or annoy everyone.
100% Pretty Cool

Key bindings

Scrolling

Ctrl-Y: one line up
Ctrl-E: one line down
Ctrl-U: one half-page up
Ctrl-D: one half-page down
Page Up: one page up
Page Down: one page down (who would've thought?)
h, Left: scroll tables left (right now, just the performance data from uops.info)
l, Right: scroll tables right

Cursor movement

This is for the intrinsic-selection cursor, not for text editing: see "Filtering" below for that

j, Down: one row down
k, Up: one row up
J: ten rows down
K: ten rows up
u: one half-page up
d: one half-page down
g, Home: first row
G, End: last row

Detail view

Each intrinsic can be expanded/collapsed to show/hide complete data

Space, Enter: toggle open/close of selected row
o: open selected row
c: close selected row
O: open all rows
C: close all rows

Filtering

f, /, Tab: from the normal browsing mode, start entering a filter
most normal keys, arrow keys, delete/backspace, etc.: edit the filter with usual key meanings
Enter, Tab: keep filter, return to browsing mode
Esc: remove current filter and return to browsing mode
Ctrl-F: move cursor forward one character
Ctrl-B: move cursor back one character
Ctrl-W: delete word before cursor
Ctrl-U: delete line before cursor
Ctrl-K: delete line after cursor

0 Open More issues

Closed

Fix for missing varname

When I run this today, I get a failure to build cache, because some stuff like vzeroall has no paramname (the parameter is void).

opened May 15, 2020 by travisdowns 6

Closed

Missing license

This project is very interesting, but unfortunately doesn't specify a license.

opened May 23, 2020 by Maratyszcza 4

Closed

Failed to decode uops.info data

I guess the data from uops.info has changed. Any idea?

Traceback (most recent call last):
  File "x86_info_term.py", line 1308, in <module>
    main()
  File "x86_info_term.py", line 1291, in main
    args, cache = get_cache()
  File "x86_info_term.py", line 1288, in get_cache
    return args, get_info(args)
  File "x86_info_term.py", line 1242, in get_info
    [version, data] = dataset.parse_fn(dataset.full_path)
  File "x86_info_term.py", line 390, in parse_uops_info
    tp = meas.attrib['TP']
KeyError: 'TP'

opened Nov 24, 2020 by hghwng 3

Closed

Fixed unknown attribute `realname`

When trying to launch x86_info_term, I get the following error: AttributeError: module 'posixpath' has no attribute 'realname'. I don't see any reference to the method realname in the os.path documentation.

This pull request only replace realname by abspath.

opened Dec 28, 2020 by jaja360 2

Closed

Unnatural behavior for the backspace key

In the readme, it says: most normal keys, arrow keys, delete/backspace, etc.: edit the filter with usual key meanings.

Therefore, I would expect the backspace key to have the usual meaning (delete 1 character left of cursor). Currently, the backspace key send the cursor back to the beginning of line.

opened Dec 28, 2020 by jaja360 1

Closed