Library for manual file selection
mansel is a Python library and command line tool for manually selecting files and directories from a tree view.
- Graphical user interface with a tree view of the directory structure.
- Support for pre-selection of paths in the directory tree.
- Running total of the size of selected directories and files.
- Running total of selection size calculated in a background thread.
mansel can be installed with
pip install mansel
mansel package depends on
PySide2 which packages the Qt runtime and Python bindings to it.
mansel command line tool can be installed with
pip install mansel-pyqt
mansel-pyqt depends on
PyQt5 and requires that the Qt runtime be installed separately.
mansel-pyqt depend on the
mansel-lib package which can be installed directly if you want to use
mansel's features in another project without installing the command line tool.
mansel can be run from the command-line with
mansel --path PATH --selection SELECTION
PATH is the root path to use for file selection and
SELECTION is a file containing a newline delimited list of paths relative to
PATH which should be selected when the file selection window opens. Invoking
mansel opens a dialog window with the contents of
PATH shown as an expandable tree view with checkboxes by every file and directory. Individual files and directories can be selected and unselected and directories can be expanded to select individual files on paths below
OK is pressed to exit the window, the list of selected files and directories is printed to
-, then the selection list is read from
- A running tally of the current selection size is shown at the bottom of the window. The calculation is performed on a background thread. The size total is followed by "(Calculating)" while the selection size is being re-tallied.
Ctrl+Qall close the window without printing to
Ctrl+Enteris equivalent to pressing
mansel-cliis a wrapper for
mansel. Effectively, installing
manseldoes not list
PySide2as a dependency to allow it to be used with
PyQt5as well) and sets up a wrapper sript that calls
python -m mansel.
mansel in a larger Qt project, there are two main classes for interfaces for working with the manual file selection:
UIDialog(root_path, selection, parent): a complete dialog window displaying a tree view of a file system with checkboxes for all entries.
root_path: top level directory to show in the tree view of the file ssytem.
selection: list of paths relative to the
root_pathof files that should be selected when the dialog window is first shown.
parent: parent Qt object for the dialog window.
CheckableFileSystemModel: a data model of a file system that supports selecting items from a tree view.
mansel is distributed under the permissive 0BSD license.
Outside contirubtions are welcome.
Contributions should be licensed under the 0BSD license.
If you want your name added to the contributors list, add it to AUTHORS.md as part of your submission.
While the license does not require acknowledgement, acknowledgement is still appreciated if you use
mansel in your project.
If you make improvements to
mansel, please share them if sharing is feasible.
- treesel provides a terminal-based tree view of a directory for selecting a file to print to stdout. However, it only allows for a single file to be selected. Before writing
manselsome effort was spent looking for an existing project that could select and print files but
treeselwas not found. It was found later when doing a search to see if the name
treeselectwas available for a Python package.
- Urwid is a Python terminal interface library. One of the example projects in the Urwid documentation is a file browser naemd
browse.pywhich allows for multiple selection of files and then prints out the file paths on exit.
- fzf is a terminal program that allows for selection of file paths through fuzzy finding of the path strings. There are many similar projects (see
fzf's releated projects list).
fzfdoes not have a tree view but it does allow selecting and printing multiple file paths to stdout.
mansel meets its original design requirements (tree view file selection with the ability to preselect some files and with a running sum of the selected files' sizes). Here are some possible future improvements that could be made:
Implement a console version. This implementation would likely be based on
cursesmodule) or Urwid's
browse.py. Alternatively, it could use Prompt Toolkit.
Improve continuous integration:
- Run tests on new commits
- Run nightly tests against latest versions of dependencies
- Add pylint and pycodestyle tests
- Add UI tests that click on checkboxes and buttons
- Create PyPI package
- Create conda package
- Create other packages (PyInstaller? Linux snap package?)
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash||File type||Python version||Upload date|
|mansel_lib-0.1.0-py3-none-any.whl (9.1 kB) View hashes||Wheel||py3|
|mansel-lib-0.1.0.tar.gz (8.9 kB) View hashes||Source||None|
Hashes for mansel_lib-0.1.0-py3-none-any.whl