Mini project 2024: Easy command history navigation through the History browser panel

Title:	Easy command history navigation through the History browser panel
Student Name:	Linda Karlovska
Organization:	​OSGeo - Open Source Geospatial Foundation
Mentor Name:	Anna Petrasova, Martin Landa
GitHub Repository:	​view repository
Budget:	1000 € (via GRASS GIS ​Student Grants)

Abstract

This project builds upon the work initiated during the OSGeo sprint in Prague in the summer of 2023 which involved creating a new History Browser panel facilitating the access to command history. Starting December 8th, the new History Browser panel is already available in the GRASS development version (see the PR ​https://github.com/OSGeo/grass/pull/3234). However, it offers only a simple single-level display of commands from the history log and the option for launching module dialogs pre-filled based on the command history.

Goal

The core part of the work will be devoted to expanding the basic functionality of the History Browser by providing the following enhancements:

• Changing the plain text format of the history log (.wxgui_history) to JSON, allowing more information to be stored for each executed command, such as execution time, runtime duration, status code, region settings, if a mask was set, etc.

• Creating a context menu with options for "Run Command" and "Show Info." "Show Info" will display a small dialog about the respective process stored in the JSON file.

• Adding a symbol (green checkmark, yellow dot, or red cross) in front of each command in the tree based on the command's status value (completed, in progress, failed).

• Branching the tree based on the date of command execution (commands from a specific day could be rolled up).

• Filtering commands based on the status (completed, in process, failed)

Timeline

Time Period	Milestones
	Tasks	Status
January 8 - January 12 Week 1	Add pop-up command menu with an item for delete command from history + history tree refactoring ​https://github.com/OSGeo/grass/pull/3342	Merged
January 15 - January 19 Week 2	History tree refactoring ​https://github.com/OSGeo/grass/pull/3342	Merged

January 22 - January 26 Week 3	Changing the plain text format of the history log (.wxgui_history) to JSON and showing info about the command from history ​https://github.com/OSGeo/grass/pull/3365	In progress

January 29 - February 2 Week 4	Changing the plain text format of the history log (.wxgui_history) to JSON and showing info about the command from history

February 5 - February 9 Week 5	Showing info about the command from history within expanded command node

February 12 - February 16 Week 6	Adding a symbol in front of each command in the tree based on the command's status (completed, in progress, failed, aborted)

February 19 - February 23 Week 7

Branching the tree based on the date of command execution

February 26 - March 1 Week 8

Filtering commands based on the status