# Lister reference

Listers are special segment collections which allow to show some list of segments for each entity in the list of entities (multiply their segments list by a list of entities). E.g. `powerline.listers.vim.tablister` presented with `powerline.segments.vim.tabnr` and `….file_name` as segments will emit segments with buffer names and tabpage numbers for each tabpage shown by vim.

Listers appear in configuration as irregular segments having `segment_list` as their type and `segments` key with a list of segments (a bit more details in Themes section of configuration reference).

More information in Writing listers section.

Currently only Vim listers are available.

## Vim listers

`powerline.listers.vim.``bufferlister`(show_unlisted=False)

  List all buffers in segment_info format

  Specifically generates a list of segment info dictionaries with `buffer` and `bufnr` keys set to buffer-specific ones, `window`, `winnr` and `window_id` keys set to None.

  Adds either `buf:` or `buf_nc:` prefix to all segment highlight groups.

  Parameters: | show_unlisted (bool) – True if unlisted buffers should be shown as well. Current buffer is always shown.

`powerline.listers.vim.``tablister`()

  List all tab pages in segment_info format

  Specifically generates a list of segment info dictionaries with `window`, `winnr`, `window_id`, `buffer` and `bufnr` keys set to tab-local ones and additional `tabpage` and `tabnr` keys.

  Adds either `tab:` or `tab_nc:` prefix to all segment highlight groups.

  Works best with vim-7.4 or later: earlier versions miss tabpage object and thus window objects are not available as well.

## Pdb listers

`powerline.listers.pdb.``frame_lister`(maxframes=3, full_stack=False)

  List all frames in segment_info format

  Parameters:

  - full_stack (bool) – If true, then all frames in the stack are listed. Normally N first frames are discarded where N is a number of frames present at the first invocation of the prompt minus one.
  - maxframes (int) – Maximum number of frames to display.