Questions

• Is there a way to automate this with conan and CMake?

At this stage, each C++ file take several seconds to compile, and most of that overhead comes from the headers we include. Those headers have to be read, preprocessed, lexed, and parsed for every C++ unit.

Compiling a standard set of headers ahead of time will save that effort for individual files and speed up the build significantly.

See: https://cmake.org/cmake/help/latest/command/target_precompile_headers.html

Wizard

Page 1: Select a path.

Then:

flowchart TD
    exists{Does path exist?}
    exists --Yes--> isgit
    exists --No--> askcreate

    isgit{Is it a git repo?}
    isgit --Yes--> askreinit
    isgit --No--> init

    askcreate[Ask to create] --> create{Create dir?}
    create --Yes--> setmkdir[Set mkdir true] --> discover
    create --No--> fail
    
    askreinit[Ask to reinit] --> reinit{Reinit?}
    reinit --Yes--> setreinit[Set reinit true] --> discover
    reinit --No--> fail

    discover{Is path below an<br>existing git repo?}
    discover --Yes--> asksub
    discover --No--> init

    asksub[Ask whether to<br>create a subrepo] --> sub{Create subrepo?}
    sub --Yes--> init
    sub --No--> fail

    fail[Fail]
    init[Init repo at path]

Page 2: Enter description

Optional; no validation

Page 3: Select default branch and workdir

Page 4: Summary

Permissions will be another ticket.

• Create that ticket

As a user, I want to know what I can do first when I open the app.

An empty window is bad UX.

Acceptance Criteria

• On opening, show the welcome window
• An option to create a repo
• An option to clone a repo
• An option to open a repo
• Close the window after one of those actions completes

Update the cmake scripts to make use of the new functions
in particular, qt_standard_project_setup() and qt_deploy_runtime_dependencies().

This will have to be the first GUI task because we need a spot to display licences, attributions, etc (e.g. our icons will come from icons8 which requires attribution).

Acceptance Criteria

• Help / About menu item
  • App name
  • App version
  • License
  • FOSS deps
    • see #2 (comment)
  • icons8 attribution

As a user, I want to open a repository so that I can work with it.

Acceptance Criteria

• Browse the system for a repository path
• Reads the repository and creates the in-memory objects
• Opens a "Repository" MDI window (possibly empty, just show the name in the title bar for now)

Implementation

Use QFileDialog with fileMode == QFileDialog::Directory.
Use git_repository_open_ext.

• Builds on Windows (MSVC)
• Builds on Linux (gcc)

Optional:

• Builds on Mac (clang)

• BLOCKED: Wait until it shows up in conancenter, or switch to qt's conan repo
• Update the cmake scripts to make use of the new functions
  in particular, qt_standard_project_setup() and qt_deploy_runtime_dependencies().

We don't want libgit2xx to be a child of goot's source. We should move the rest of /src to /src/goot.