chore: weekly flake update

[Automated] Weekly flake update 2026-08-24

.clang-format

@@ -0,0 +1,3 @@
+BasedOnStyle: LLVM
+IndentWidth: 4
+ColumnLimit: 210

.envrc

@@ -1 +1 @@
-use nix
+use flake

.github/workflows/release.yml

@@ -0,0 +1,55 @@
+name: Release PR
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        required: true
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release_pr:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - uses: DeterminateSystems/nix-installer-action@v12
+
+      - name: Create release branch
+        run: |
+          git checkout -B release/${{ inputs.version }}
+
+      - name: Set version in flake.nix
+        run: |
+          sed -i "s/version = \".*\";/version = \"${{ inputs.version }}\";/" flake.nix
+
+      - name: Update flake inputs
+        run: nix flake update
+
+      - name: Commit changes
+        run: |
+          git add flake.nix flake.lock
+          git commit -m "chore(release): ${{ inputs.version }}"
+
+      - name: Push branch
+        run: |
+          git push origin release/${{ inputs.version }}
+
+      - name: Create Pull Request
+        run: |
+          gh pr create \
+            --base main \
+            --head release/${{ inputs.version }} \
+            --title "[Automatic] Release PR ${{ inputs.version }}" \
+            --body "Automated release PR.\nAfter the test's succesfull run, create manually a release with a new tag matching ${{ inputs.version }}"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/test.yml

@@ -0,0 +1,42 @@
+name: test
+
+on:
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Install clang
+      run: | 
+        sudo apt-get update
+        sudo apt-get install -y clang-format
+    - name: Check format
+      run: |
+        clang-format --version
+        find src -name "*.c" -o -name "*.h" | xargs clang-format --dry-run --Werror
+
+    - name: Install dependencies
+      run: |
+        sudo apt-get install -y \
+          gcc \
+          make \
+          pkg-config \
+          libcjson-dev \
+          libncurses-dev \
+          libgit2-dev \
+          git \
+          neovim
+    - name: Prepare environnement
+      run: mkdir -p ~/Documents/Notes
+    - name: Build
+      run: make
+
+    - name: Run tests
+      run: |
+        export TERM=xterm
+        make test

.github/workflows/weeklyUpdate.yml

@@ -0,0 +1,58 @@
+name: Weekly Flake Update
+
+on:
+  schedule:
+    - cron: "0 3 * * 1"  # every Monday at 03:00 UTC
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  flake_update:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: DeterminateSystems/nix-installer-action@v12
+
+      - name: Set branch name (date)
+        id: vars
+        run: |
+          echo "branch=flake-update/$(date +%Y-%m-%d)" >> $GITHUB_OUTPUT
+
+      - name: Create update branch
+        run: |
+          git checkout -B ${{ steps.vars.outputs.branch }}
+
+      - name: Update flake inputs
+        run: |
+          nix flake update
+
+      - name: Commit changes
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add flake.lock
+          git commit -m "chore: weekly flake update" || echo "No changes to commit"
+
+      - name: Push branch
+        run: |
+          git push origin ${{ steps.vars.outputs.branch }} --force
+
+      - name: Install GitHub CLI
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y gh
+
+      - name: Create Pull Request
+        run: |
+          gh pr create \
+            --base main \
+            --head ${{ steps.vars.outputs.branch }} \
+            --title "[Automated] Weekly flake update $(date +%Y-%m-%d)" \
+            --body "Automated weekly update of flake inputs for $(date +%Y-%m-%d)."
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -8,3 +8,4 @@ result
 massif.out.*
 *.out.*
 vgcore.*
+.direnv/

CONTRIBUTING.md

@@ -10,7 +10,7 @@ This project aims to remain minimal, terminal-focused, and easy to extend. Contr
 
 Please use the standardized debugging and error-handling functions defined in [/src/utils.c](./src/utils.c):
 
-* `debug(...)`
+* `debug("message", ...)`
   Used for formatted debugging output (printf-style formatting).
 
 * `altDebug(...)`
@@ -21,6 +21,8 @@ Please use the standardized debugging and error-handling functions defined in [/
 
   * `"user"`: errors caused by user input or configuration
   * `"program"`: internal or unexpected program errors
+* `warn(condition, "message", ...)`
+  Used for formatted warning (printf-style formatting).
 
 ---
 
@@ -37,7 +39,7 @@ Format:
 Examples:
 
 * `Editor (#1): add support for Microsoft Word`
-* `README.md: fix typos`
+* `docs: fix typos in README.md`
 * `Journal: improve entry parsing logic`
 
 Keep commit messages short and descriptive.
@@ -58,7 +60,7 @@ To add support for a new editor, you must update both documentation and source c
   * Add the editor name to `supportedEditor[]`
   * Increment `numEditor`
 
-* If the editor executable name differs from its logical name (for example `neovim` → `nvim`), update `doesEditorExist()` in `src/utils.c`
+* If the editor executable name differs from its logical name (for example `neovim` → `nvim`), update `isEditorValid()` in `src/utils.c`
 
 * Modify `openEditor()` in `src/utils.c`:
 
@@ -67,6 +69,15 @@ To add support for a new editor, you must update both documentation and source c
 
 ---
 
+## Changing default configuration
+
+If you want to change the default configuration or add a new option:
+1. Update [README's documentation](./README.md#configuration)
+2. In `./src/utils.c`, update the function `initAppFilesAndDirs()` which creates a default configuration if `~/.config/notewrapper/config.json` or if neither `-c` nor `--config` is set.
+3. In `./src/main.c` where the JSON is parsed, add the parsing logic. Do not forget the debugging information, errors when wrong type or when an important field is missing and add a default value if a less important field is missing.
+
+---
+
 ## Before opening a pull request
 
 Before submitting a pull request, ensure that:
@@ -76,3 +87,12 @@ Before submitting a pull request, ensure that:
   * `make`, or
   * `nix-build` (on NixOS)
 * There are **no warnings or errors**
+
+---
+
+## Continuous integration
+
+All PR will need to pass these checks:
+1. `clang-format`. Running `find src -name "*.c" -o -name "*.h" | xargs clang-format -i` will automatically apply those rules.
+2. The program must build without warning or error.
+3. The program must run for five seconds without crashing.

README.md

@@ -1,7 +1,11 @@
 # NoteWrapper
 
+Note: This project fullfills all my usecases for now, so my main source for features ideas dried out. So if you have good ideas, feel free to open an issue ;)
+
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/tomasriveral/notewrapper)
 
+![demo.gif](demo.gif)
+
 ## Why?
 
 I started journaling and note-taking with **[Obsidian](https://obsidian.md/)** but wanted to use only free software. I also tried **[Logseq](https://logseq.com/)** and **[Joplin](https://github.com/laurent22/joplin)**, but I preferred a terminal-based workflow.
@@ -21,7 +25,7 @@ The goal was to create a terminal-based interface for accessing vaults and notes
 * Standard Markdown files (no custom format)
 * Journal support with flexible entry formats
 * Real-time Markdown rendering via Vivify
-* Backup support using `rsync`
+* Backup different directories into different destinations
 * Supports multiple editors
 
 ---
@@ -39,10 +43,12 @@ Before building NoteWrapper, you must install the following dependencies:
 * `sed`
 * `ripgrep`
 * `fzf`
+* `libgit2`
 
 You must also have a [supported editor (and their associated plugin if needed)](#editor-support) installed:
 
 * `helix`
+* `jed`
 * `kakoune`
 * `micro`
 * `nano`
@@ -54,6 +60,26 @@ You must also have a [supported editor (and their associated plugin if needed)](
 
 ## How to install
 
+### Nix flakes
+
+Add this to your inputs in flake.nix:
+
+```nix
+notewrapper = {
+  url = "github:tomasriveral/notewrapper";
+};
+```
+If your flake already inputs nixpkgs and/or flake-utils, you can follow it:
+```nix
+notewrapper = {
+  url = "github:tomasriveral/notewrapper;
+  inputs.nixpkgs.follow = "nixpkgs";
+  inputs.flake-utils.follow = "flake-utils";
+};
+```
+
+### Building from source
+
 1. Install all required dependencies listed above.
 2. Ensure you have a supported editor installed.
 3. Clone the repository:
@@ -77,7 +103,7 @@ nix-build
 make
 ```
 
-5. Configure `./config.json` (it is automatically created on first launch if it does not already exist).
+5. [Configure](#configuration) `~/.config/notewrapper/config.json` (it is automatically created on first launch if it does not already exist).
 6. Run the program:
 
 ```shell
@@ -86,7 +112,7 @@ make
 
 ---
 
-## Packaging
+### Packaging
 
 There is currently no official package available for NoteWrapper.
 
@@ -102,7 +128,6 @@ As a NixOS user, I will likely package it for **nixpkgs** in the future if the p
 Usage: notewrapper [options]
 Options:
   -c, --config <path/to/config>               Specify the config file.
-  -d, --directory <path/to/directory>         Specify the vaults' directory.
   -h, --help                                  Display this message.
   -e, --editor                                Specify the editor to open.
   -j, --jump                                  Jump to the end of the file on opening.
@@ -135,23 +160,26 @@ NoteWrapper relies on certain editor features, so not all functionality is suppo
 
 ### Features requiring editor support:
 
-* **Bufferless rendering**: updates the rendered view while typing (without saving)
-* **Cursor following**: rendered view follows the cursor position
-* **Jump to end on open**: automatically moves the cursor to the end of the file
+* **Bufferless rendering**: updates the rendered view while typing (without saving). You won't need to save the file to see it updated in your browser.
+* **Cursor following**: rendered view follows the cursor position. When you scroll in your editor, it will automatically scroll your browser view.
+* **Jump to end on open**: automatically moves the cursor to the end of the file when oppening.
 
-The first two features depend on [Vivify's editor integration](https://github.com/jannis-baum/Vivify?tab=readme-ov-file#existing-integration) and are mainly useful if you want external Markdown rendering in your browser.
+The first two features depend on [Vivify's editor integration](https://github.com/jannis-baum/Vivify?tab=readme-ov-file#existing-integration)[^1] and are mainly useful if you want external Markdown rendering in your browser.
+
+[^1]: Eventhough the features are Vivify-related, please report bugs and ask questions in this repo.
 
 If your editor does not support these features, you can implement a plugin using [Vivify's API](https://github.com/jannis-baum/Vivify?tab=readme-ov-file#editor-support).
 
 | Editor    | Bufferless  | Cursor  | Jump to end  | Aditional requirements                                   |
 | --------- | ----------- | ------- | ------------ | ---------------------------------------------------------|
-| Helix     | ❌          | ❌      | ✅           | —                                                        |
-| Kakoune   | ❌          | ❌      | ✅           | —                                                        |
-| Micro     | ❌          | ✅      | ✅           | [micro-vivify](https://codeberg.org/gibbert/micro-vivify) and [modifications to your `init.lua`](./docs/micro.md)|
-| Nano      | ❌          | ❌      | ✅           | —                                                        |
-| Neovim    | ✅          | ✅      | ✅           | [vivify-vim](https://github.com/jannis-baum/vivify.vim)  |
-| Vi        | ❌          | ❌      | ✅           |                                                          |
-| Vim       | ✅          | ✅      | ✅           | [vivify-vim](https://github.com/jannis-baum/vivify.vim)  |
+| [Helix](https://helix-editor.com/)     | ❌          | ❌      | ✅           | —                                                        |
+| [Jed](https://www.jedsoft.org/jed/)       | ❌          | ❌      | ✅           | —                                                        |
+| [Kakoune](http://kakoune.org/)   | ❌          | ❌      | ✅           | —                                                        |
+| [Micro](https://micro-editor.github.io/)     | ❌          | ✅      | ✅           | [micro-vivify](https://codeberg.org/gibbert/micro-vivify) and [modifications to your `init.lua`](./docs/micro.md)|
+| [Nano](https://www.nano-editor.org/)      | ❌          | ❌      | ✅           | —                                                        |
+| [Neovim](https://neovim.io/)    | ✅          | ✅      | ✅           | [vivify-vim](https://github.com/jannis-baum/vivify.vim)  |
+| [Vi](https://en.wikipedia.org/wiki/Vi_(text_editor))        | ❌          | ❌      | ✅           |                                                          |
+| [Vim](https://www.vim.org/)       | ✅          | ✅      | ✅           | [vivify-vim](https://github.com/jannis-baum/vivify.vim)  |
 
 [How to add support for another editor](./CONTRIBUTING.md#adding-editor-support)
 
@@ -163,7 +191,7 @@ Edit `~/.config/notewrapper/config.json`. If it does not exist, it will be creat
 
 ```json
 {
-  "directory": "~/Documents/Notes/",
+  "directory": ["~/Documents/Notes/", "/other/paths/"],
   "render": true,
   "jumpToEndOfFileOnLaunch": true,
   "editor": "neovim",
@@ -172,26 +200,49 @@ Edit `~/.config/notewrapper/config.json`. If it does not exist, it will be creat
   "newLineOnOpening": true,
   "backup": {
     "enable": false,
-    "directory": "/path/to/backup",
+    "directory": {
+        "~/Documents/Notes": "path/to/backup1",
+        "/other/paths/": "path/to/backup2"
+    },
     "interval": "weekly",
-    "rsyncArgs": ["-Lqah", "--update"]
+    "rsyncArgs": ["-Lqah", "--update"],
+    "git": {
+        "enable": false,
+        "name": "Example Example",
+        "email": "mail@example.com"
+    }
   }
 }
 ```
 
 ### Fields
 
-* `directory`: root directory containing all vaults
+* `directory`: Array of directories containing the vaults.
 * `render`: enable/disable Vivify rendering
 * `jumpToEndOfFileOnLaunch`: move cursor to end of file on open
-* `editor`: selected editor (must be supported)
+* `editor`: selected editor (must be supported). If not set, it defaults to `$EDITOR`.
 * `journalRegex`: regex used to detect journal files
 * `dateEntry`: format for journal entries (see `strftime`)
 * `newLineOnOpening`: add a newline when opening a note
 * `backup.enable`: enable automatic backups using `rsync`
-* `backup.directory`: destination directory for backups
+* `backup.directory`: backup's destination for each directory
 * `backup.interval`: backup frequency (`daily`, `weekly`, `monthly`, or integer)
 * `backup.rsyncArgs`: arguments passed to `rsync`
+* `git.enable`: enable git version control for backups
+* `git.name` and `git.email` are for the commits signature
+
+> [!NOTE]
+> * The git backup implementation relies a lot on the IO speed of your drive. A low speed one (or a web mounted one) could create blanks between closing a document and the TUI opening.
+> * Directories must end with `/`.
+> * All directories used must exist.
+> * Elements of `directory` and `backup.directory` must match exactly.  
+> * Directories set in `directory` but not in `backup.directory` won't be backed up.
+> * Directories set in `backup.directory` but not in `directory` will be ignored.
+> * `journalRegex` must match if the file name ends with `.md` and if it doesn't.
+> * It is recommended to keep `-q` or `--quiet` flag in `rsyncArgs` to avoid interference with `ncurses`.
+> * If `rsync` fails, you will see it inside `ncurses`.
+> * If you want the git backup but without rsync, you can leave `backup.directory` empty or map each directory to itself. When enabled, git will apply to all your vaults.
+> * Each vault gets its own git repository that will be created the first time you select the vault with the option enabled.
 
 ---
 
@@ -207,6 +258,7 @@ It is recommended to use a browser different from your main one for rendering.
 ## Planned features
 
 * [ ] A converter between journal types
-* [ ] Support multiple vault directories
-* [ ] Port NoteWrapper to other editors (non-exhaustive list of planned ports: `emacs -nw`, `jed`, `ad`, flow-control, `ee`, `amp`, `dte`, `cano`, `mle`, `zee`, `ptext`, `kibi`, `ox`, `ne`, `dit`, `zile`, `moe`, `joe`, `pico`, `vis`)
-* [ ] Default to $EDITOR
+* [x] Support multiple vault directories
+* [ ] Port NoteWrapper to other editors (non-exhaustive list of planned ports: `emacs -nw`, `ad`, flow-control, `ee`, `amp`, `dte`, `cano`, `mle`, `zee`, `ptext`, `kibi`, `ox`, `ne`, `dit`, `zile`, `moe`, `joe`, `pico`, `vis`)
+* [x] Default to $EDITOR
+* [ ] Refactoring the source code

config.json

@@ -1,14 +0,0 @@
-{
-  "directory": "~/Documents/Notes/",
-  "render": true,
-  "jumpToEndOfFileOnLaunch": true,
-  "editor": "neovim",
-  "journalRegex": ".*journal.*",
-  "dateEntry": "# %Y %m %d %a",
-  "newLineOnOpening": true,
-  "backup": {
-    "enable": false,
-    "directory": "/path/to/backup",
-    "interval": "weekly"
-  }
-}

default.nix

@@ -1,35 +0,0 @@
-{ pkgs ? import <nixpkgs> {} }:
-
-pkgs.stdenv.mkDerivation {
-  pname = "notewrapper";
-  version = "1.0";
-
-  src = ./.;
-
-  nativeBuildInputs = [
-    pkgs.pkg-config
-  ];
-
-  buildInputs = [
-    pkgs.ncurses
-    pkgs.cjson
-    pkgs.fzf
-    pkgs.gnused
-    pkgs.ripgrep
-  ];
-
-  buildPhase = ''
-    make
-  '';
-
-  installPhase = ''
-    mkdir -p $out/bin
-    cp notewrapper $out/bin/
-  '';
-
-  meta = with pkgs.lib; {
-    description = " Journaling and notetaking TUI wrapper on top of neovim, vim and nano.";
-    license = licenses.gpl3Only;
-    platforms = platforms.linux;
-  };
-}

demo.tape

@@ -0,0 +1,190 @@
+Require echo
+
+Set Shell "zsh"
+Set TypingSpeed 35ms
+Set FontSize 18
+Set Width 1800
+Set Height 900
+
+Output demo.gif
+
+# ─────────────────────────────────────────────────────────────────────
+# Introduction
+# ─────────────────────────────────────────────────────────────────────
+
+Type "echo 'Welcome to NoteWrapper!'"
+Sleep 800ms
+Enter
+Sleep 1500ms
+
+Type "notewrapper --help"
+Sleep 500ms
+Enter
+Sleep 4000ms
+
+# ─────────────────────────────────────────────────────────────────────
+# Create / open a unified journal
+# ─────────────────────────────────────────────────────────────────────
+
+Type "notewrapper"
+Sleep 700ms
+Enter
+Sleep 1500ms
+
+Down
+Sleep 500ms
+Down
+Sleep 500ms
+Down
+Sleep 700ms
+
+Enter
+Sleep 1200ms
+
+Down
+Sleep 600ms
+Enter
+Sleep 1500ms
+
+# Enter the editor
+Type "i"
+Sleep 800ms
+
+Type "NoteWrapper uses standard Markdown files, so you can open your notes in any other application that supports Markdown."
+Sleep 700ms
+Enter
+Sleep 800ms
+
+Type "This is a unified journal: all your daily entries live in the same file. You can also configure NoteWrapper to use monthly or other time-based entries."
+Sleep 700ms
+Enter
+Sleep 800ms
+
+Type "And, although you can't see it in this demo, this Markdown file is rendered live in my browser thanks to Vivify!"
+Sleep 1500ms
+Sleep 3000ms
+
+# Leave the editor
+Escape
+Sleep 500ms
+Type ":q!"
+Sleep 800ms
+Enter
+Sleep 1500ms
+
+# ─────────────────────────────────────────────────────────────────────
+# Create / open a divided journal
+# ─────────────────────────────────────────────────────────────────────
+
+Down
+Sleep 500ms
+Down
+Sleep 500ms
+Down
+Sleep 700ms
+
+Enter
+Sleep 2000ms
+
+Enter
+Sleep 1000ms
+
+Type "i"
+Sleep 800ms
+
+Type "And this is a divided journal."
+Sleep 500ms
+Type " It uses one file per entry."
+Sleep 700ms
+Enter
+Sleep 1000ms
+
+Type "Find the dates and journal divisions a little too cumbersome?"
+Sleep 700ms
+Enter
+Sleep 1500ms
+
+Type "Don't worry: NoteWrapper also works with basic notes."
+Sleep 800ms
+
+Type " It distinguishes them using a regular expression, which defaults to `.*journal.*`."
+Sleep 800ms
+Enter
+Sleep 700ms
+
+Type " The unified or divided journal mode is chosen when you first create the journal."
+Sleep 1000ms
+Enter
+Sleep 1500ms
+
+# ─────────────────────────────────────────────────────────────────────
+# Search
+# ─────────────────────────────────────────────────────────────────────
+
+Type "Let me show you one last cool feature."
+Sleep 1000ms
+
+Type " Have you ever forgotten when or where you wrote something?"
+Sleep 1000ms
+Enter
+Sleep 800ms
+
+Type "Well ... NoteWrapper was made for you!"
+Sleep 1500ms
+
+Escape
+Sleep 500ms
+Type ":q!"
+Sleep 800ms
+Enter
+Sleep 1500ms
+
+# Navigate to search
+Down
+Sleep 500ms
+Down
+Sleep 500ms
+Down
+Sleep 800ms
+
+Enter
+Sleep 1500ms
+
+Down
+Sleep 500ms
+Down
+Sleep 800ms
+
+Enter
+Sleep 2000ms
+
+# Search all notes with fzf
+Type "c"
+Sleep 300ms
+Type "o"
+Sleep 300ms
+Type "o"
+Sleep 300ms
+Type "l"
+Sleep 1500ms
+
+# Show the search result / preview
+Up
+Sleep 2000ms
+Enter
+Sleep 1000ms
+
+# ─────────────────────────────────────────────────────────────────────
+# Final note
+# ─────────────────────────────────────────────────────────────────────
+
+Type "i"
+Sleep 700ms
+
+Type "Never lose a note."
+Sleep 1500ms
+Enter
+Sleep 1000ms
+
+Type "P. S. Don't mind the broken fzf preview. Normally, you'll see the context around your search result, but sometimes `sed` breaks when fzf is opened for the first time."
+Sleep 5000ms

flake.lock

@@ -0,0 +1,61 @@
+{
+  "nodes": {
+    "flake-utils": {
+      "inputs": {
+        "systems": "systems"
+      },
+      "locked": {
+        "lastModified": 1731533236,
+        "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "type": "github"
+      }
+    },
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1790463110,
+        "narHash": "sha256-hKlVl12B1dF0Q5vd9dY3lIJM5mFGWYSlXwSLAqHZ1+s=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "e158d9ed9b51c98974c5e66e1ba1c9e0255fecaa",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixos-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "flake-utils": "flake-utils",
+        "nixpkgs": "nixpkgs"
+      }
+    },
+    "systems": {
+      "locked": {
+        "lastModified": 1681028828,
+        "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
+        "owner": "nix-systems",
+        "repo": "default",
+        "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-systems",
+        "repo": "default",
+        "type": "github"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

flake.nix

@@ -0,0 +1,65 @@
+{
+  description = "NoteWrapper";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+
+  outputs = { self, nixpkgs, flake-utils}:
+    flake-utils.lib.eachDefaultSystem (system:
+      let
+        pkgs = import nixpkgs { inherit system; };
+      in {
+        packages.default = pkgs.stdenv.mkDerivation (finalAttrs: {
+          pname = "notewrapper";
+          version = "v2.3.0";
+
+          src = ./.;
+
+          nativeBuildInputs = with pkgs; [
+            pkg-config
+            gnumake
+          ];
+
+          buildInputs = with pkgs; [
+            ncurses
+            cjson
+            vivify
+            rsync
+            ripgrep
+            fzf
+            gnused
+            libgit2
+          ];
+
+          buildPhase = ''
+            make VERSION=${finalAttrs.version}
+          '';
+
+          installPhase = ''
+            mkdir -p $out/bin
+            cp notewrapper $out/bin/
+          '';
+        });
+
+        devShells.default = pkgs.mkShell {
+          packages = with pkgs; [
+            cjson
+            ncurses
+            pkg-config
+            gdb
+            valgrind
+            clang-tools
+            gnumake
+            libgit2
+            vhs
+          ];
+        };
+
+        apps.default = {
+          type = "app";
+          program = "${self.packages.${system}.default}/bin/notewrapper";
+        };
+      });
+}

makefile

@@ -1,9 +1,12 @@
 CC := gcc
 
-CFLAGS := -Wall -Wextra -O2 \
-	$(shell pkg-config --cflags libcjson ncurses)
+VERSION := $(shell git describe --tags --always --dirty)
 
-LDFLAGS := $(shell pkg-config --libs libcjson ncurses)
+CFLAGS := -Wall -Wextra -Werror -O2 \
+		  -DVERSION=\"$(VERSION)\" \
+	      $(shell pkg-config --cflags libcjson ncurses libgit2)
+
+LDFLAGS := $(shell pkg-config --libs libcjson ncurses libgit2)
 
 SRC := src/main.c src/ui.c src/utils.c src/notes.c
 TARGET := notewrapper
@@ -20,3 +23,17 @@ run: $(TARGET)
 
 clean:
 	rm -f $(TARGET)
+
+test: $(TARGET)
+	@timeout 5s ./$(TARGET); \
+	status=$$?; \
+	if [ $$status -eq 124 ]; then \
+		echo "Program ran for 5 seconds without crashing ✅"; \
+		exit 0; \
+	elif [ $$status -ne 0 ]; then \
+		echo "Program crashed ❌"; \
+		exit 1; \
+	else \
+		echo "Program exited cleanly ✅"; \
+		exit 0; \
+	fi

shell.nix

@@ -1,12 +0,0 @@
-{ pkgs ? import <nixpkgs> {} }:
-
-pkgs.mkShell {
-  buildInputs = [
-    pkgs.cjson
-    pkgs.ncurses
-    pkgs.pkg-config
-    pkgs.gdb
-    pkgs.valgrind
-    pkgs.kdePackages.kcachegrind
-  ];
-}

src/notes.c

@@ -1,17 +1,45 @@
 #include "notes.h"
-#include "ui.h"
+#include "utils.h"
 
-char **getJournalsFromVault(char *pathToVault, char *vault, char *journalRegex,  int *count, int shouldDebug) {
+char *getDirectoryFromVault(char *targetVault, char **vaultsArray, int vaultTotalNumber, int *vaultNumberPerDirectory, char **directoryArray, int directoryNumber, int shouldDebug) {
+    debug("Searching the vault %s inside all the directories...", targetVault);
+    debug("Here are how many vaults there is per directory:");
+    for (int i = 0; i < directoryNumber; i++) {
+        altDebug("%d for %s\n", vaultNumberPerDirectory[i], directoryArray[i]);
+    }
+    debug("Here are all the vaults in the order they will be searched:");
+    for (int i = 0; i < vaultTotalNumber; i++) {
+        altDebug("%s\n", vaultsArray[i]);
+    }
+    int index = 0;
+
+    for (int i = 0; i < directoryNumber; i++) {
+        for (int j = 0; j < vaultNumberPerDirectory[i]; j++) {
+            if (strcmp(vaultsArray[index], targetVault) == 0) {
+                debug("%s found in %s. (index %d)", targetVault, directoryArray[i], index);
+                return directoryArray[i];
+            }
+            index++;
+        }
+    }
+    error(1, "program", "the vault %s was not found", targetVault);
+    return "this makes the compiler and clangd happy. Who doesn't want GCC and clangd to be happy? "
+           "Such person would be a terrible monster... One must imagine GCC and clangd happy.";
+}
+
+char **getJournalsFromVault(char *pathToVault, char *vault, char *journalRegex, int *count, int shouldDebug) {
     debug("Searching %s for journals", vault);
-    // originally from https://www.geeksforgeeks.org/c/c-program-list-files-sub-directories-directory/
+    // originally from
+    // https://www.geeksforgeeks.org/c/c-program-list-files-sub-directories-directory/
     struct dirent *vaultEntry;
     char tempPath[PATH_MAX];
-    snprintf(tempPath, sizeof(tempPath), "%s/%s", pathToVault, vault); // sets the full absolute path to fullPathEntry
+    snprintf(tempPath, sizeof(tempPath), "%s/%s", pathToVault,
+             vault); // sets the full absolute path to fullPathEntry
     DIR *vaultDirectory = opendir(tempPath);
-    error(vaultDirectory==NULL, "program", "Could not open directory %s", tempPath);
+    error(vaultDirectory == NULL, "program", "Could not open directory %s", tempPath);
     char **journalsArray = NULL; // will contain all the notes
-    int journalsCount = 0; // we need to count how many notes there is to always readjust how many memory we alloc
-    
+    int journalsCount = 0;       // we need to count how many notes there is to always readjust how many memory we alloc
+
     // https://stackoverflow.com/a/1085120 for regex code
     regex_t regex;
     int regexReturn;
@@ -23,20 +51,21 @@ char **getJournalsFromVault(char *pathToVault, char *vault, char *journalRegex,
     // for readdir()
     debug("┌------------------------------------------\nDetected files and dirs from the vault");
     while ((vaultEntry = readdir(vaultDirectory)) != NULL) { // we iterate over every entry from the dir. So files and dirs (. and .. included)
-      altDebug("%s  ", vaultEntry->d_name);
-      if (vaultEntry->d_name[0] != '.') { // if the entry don't start with a dot (so hidden dirs and hidden files)
-        regexReturn = regexec(&regex, vaultEntry->d_name, 0, NULL, 0);
-        if (!regexReturn) { // if the regex matches
-          altDebug("matched with the regex. It is a journal.\n");
-          journalsArray = realloc(journalsArray, (journalsCount + 1)*sizeof(char*)); // resize notesArray so that
-          journalsArray[journalsCount] = strdup(vaultEntry->d_name); // copy the dir name into notesArray
-          journalsCount++;
+        altDebug("%s  ", vaultEntry->d_name);
+        if (vaultEntry->d_name[0] != '.') { // if the entry don't start with a dot (so hidden dirs and hidden files)
+            regexReturn = regexec(&regex, vaultEntry->d_name, 0, NULL, 0);
+            if (!regexReturn) { // if the regex matches
+                altDebug("matched with the regex. It is a journal.\n");
+                journalsArray = realloc(journalsArray,
+                                        (journalsCount + 1) * sizeof(char *)); // resize notesArray so that
+                journalsArray[journalsCount] = strdup(vaultEntry->d_name);     // copy the dir name into notesArray
+                journalsCount++;
+            } else {
+                altDebug("did not matched with the regex. It is a note.\n");
+            }
         } else {
-          altDebug("did not matched with the regex. It is a note.\n");
+            altDebug(" was ignored\n");
         }
-      } else {
-        altDebug(" was ignored\n");
-      }
     }
     altDebug("└ ------------------------------\n");
     // free's some used memory
@@ -45,42 +74,51 @@ char **getJournalsFromVault(char *pathToVault, char *vault, char *journalRegex,
     return journalsArray;
 }
 
-char** getNotesFromVault(char *pathToVault, char *vault, char *journalRegex, int *count, int shouldDebug) {
-    // this function is inputed a path to a vault (which was selected before) and outpus all the suitable notes (so not the hidden ones)
-    // originally from https://www.geeksforgeeks.org/c/c-program-list-files-sub-directories-directory/
+char **getNotesFromVault(char *pathToVault, char *vault, char *journalRegex, int *count, int shouldDebug) {
+    // this function is inputed a path to a vault (which was selected before) and outpus all the
+    // suitable notes (so not the hidden ones) originally from
+    // https://www.geeksforgeeks.org/c/c-program-list-files-sub-directories-directory/
     debug("Searching %s for notes", vault);
-    struct dirent *vaultEntry; 
+    struct dirent *vaultEntry;
     char tempPath[PATH_MAX];
-    snprintf(tempPath, sizeof(tempPath), "%s/%s", pathToVault, vault); // sets the full absolute path to fullPathEntry
+    snprintf(tempPath, sizeof(tempPath), "%s/%s", pathToVault,
+             vault); // sets the full absolute path to fullPathEntry
     DIR *vaultDirectory = opendir(tempPath);
-    error(vaultDirectory==NULL, "program", "Could not open directory %s", tempPath);
+    error(vaultDirectory == NULL, "program", "Could not open directory %s", tempPath);
     char **notesArray = NULL; // will contain all the notes
-    int notesCount = 0; // we need to count how many notes there is to always readjust how many memory we alloc
+    int notesCount = 0;       // we need to count how many notes there is to always readjust how many memory we alloc
     // Refer https://pubs.opengroup.org/onlinepubs/7990989775/xsh/readdir.html
     // for readdir()
     debug("┌------------------------------\nDetected Files and dirs from the vault:");
     while ((vaultEntry = readdir(vaultDirectory)) != NULL) {
-      char *entryName = vaultEntry->d_name;
-      int entryLenght = strlen(entryName);
-      altDebug("%s ", entryName);
-      // for the regex code https://stackoverflow.com/a/1085120 
-      regex_t regex;
-      int regexReturn;
-      // compiles the regex
-      regexReturn = regcomp(&regex, journalRegex, 0);
-      if (entryName[0] != '.') { // if the entry don't start with a dot (so hidden dirs and hidden files)
-        char fullPathEntry[PATH_MAX]; // creates a string of size of the maximum path lenght
-        snprintf(fullPathEntry, sizeof(fullPathEntry), "%s/%s/%s", pathToVault, vault, entryName); // sets the full absolute path to fullPathEntry
-        // check if it matches the regex. If it does not match regexReturn != 0.
-        regexReturn = regexec(&regex, entryName, 0, NULL, 0);
-        struct stat metadataPathEntry;
-        if (stat(fullPathEntry, &metadataPathEntry) == 0 && entryName[entryLenght - 3] == '.' && entryName[entryLenght - 2] == 'm' && entryName[entryLenght - 1] == 'd' && regexReturn && S_ISREG(metadataPathEntry.st_mode)) { // if this entry is a file ending in .md and that does no match the regex
-          notesArray = realloc(notesArray, (notesCount + 1)*sizeof(char*)); // resize notesArray so that
-          notesArray[notesCount] = strdup(entryName); // copy the dir name into notesArray
-          notesCount++;
-          altDebug("did not match with the regex. It is a note.\n");
-        } else if (!regexReturn) {altDebug("matched with the regex. It is a journal.\n");}
-      } else {altDebug("was ignored\n");}
+        char *entryName = vaultEntry->d_name;
+        int entryLenght = strlen(entryName);
+        altDebug("%s ", entryName);
+        // for the regex code https://stackoverflow.com/a/1085120
+        regex_t regex;
+        int regexReturn;
+        // compiles the regex
+        regexReturn = regcomp(&regex, journalRegex, 0);
+        if (entryName[0] != '.') {        // if the entry don't start with a dot (so hidden dirs and hidden files)
+            char fullPathEntry[PATH_MAX]; // creates a string of size of the maximum path lenght
+            snprintf(fullPathEntry, sizeof(fullPathEntry), "%s/%s/%s", pathToVault, vault,
+                     entryName); // sets the full absolute path to fullPathEntry
+            // check if it matches the regex. If it does not match regexReturn != 0.
+            regexReturn = regexec(&regex, entryName, 0, NULL, 0);
+            struct stat metadataPathEntry;
+            if (stat(fullPathEntry, &metadataPathEntry) == 0 && entryName[entryLenght - 3] == '.' && entryName[entryLenght - 2] == 'm' && entryName[entryLenght - 1] == 'd' && regexReturn &&
+                S_ISREG(metadataPathEntry.st_mode)) {                                // if this entry is a file ending in .md and
+                                                                                     // that does no match the regex
+                notesArray = realloc(notesArray, (notesCount + 1) * sizeof(char *)); // resize notesArray so that
+                notesArray[notesCount] = strdup(entryName);                          // copy the dir name into notesArray
+                notesCount++;
+                altDebug("did not match with the regex. It is a note.\n");
+            } else if (!regexReturn) {
+                altDebug("matched with the regex. It is a journal.\n");
+            }
+        } else {
+            altDebug("was ignored\n");
+        }
     }
     altDebug("└ ------------------------------\n");
 
@@ -90,148 +128,194 @@ char** getNotesFromVault(char *pathToVault, char *vault, char *journalRegex, int
     return notesArray;
 }
 
-char **getVaultsFromDirectory(char *dirString, int *count, int shouldDebug) { 
-    // this function is inputed a path to a directory (which comes usually from the config file) and outpus all the suitable directories (so not the hidden ones) which will serve as separate vaults for notes
-    debug("Opening %s ", dirString);
-    // originally from https://www.geeksforgeeks.org/c/c-program-list-files-sub-directories-directory/
-    struct dirent *vaultsDirectoryEntry;
-    DIR *vaultsDirectory = opendir(dirString);
-    error(vaultsDirectory==NULL, "program", "Could not open directory %s", dirString);
-    char **dirsArray = NULL; // will contain all the dirs/vaults
-    int dirsCount = 0; // we need to count how many dirs there is to always readjust how many memory we alloc
-    // Refer https://pubs.opengroup.org/onlinepubs/7990989775/xsh/readdir.html
-    // for readdir()
-    debug("┌------------------------------\n Detected files and dirs from the directory:");
-    while ((vaultsDirectoryEntry = readdir(vaultsDirectory)) != NULL) {
-      altDebug("%s\n", vaultsDirectoryEntry->d_name);
-      if (vaultsDirectoryEntry->d_name[0] != '.') { // if the entry don't start with a dot (so hidden dirs and hidden files)
-        char fullPathEntry[PATH_MAX]; // creates a string of size of the maximum path lenght
-        snprintf(fullPathEntry, sizeof(fullPathEntry), "%s/%s", dirString, vaultsDirectoryEntry->d_name); // sets the full absolute path to fullPathEntry
-        
-        struct stat metadataPathEntry;
-        if (stat(fullPathEntry, &metadataPathEntry) == 0 && S_ISDIR(metadataPathEntry.st_mode)) { // if this entry is a directory
-          dirsArray = realloc(dirsArray, (dirsCount + 1)*sizeof(char*)); // resize dirsArray so that
-          dirsArray[dirsCount] = strdup(vaultsDirectoryEntry->d_name); // copy the dir name into dirsArray
-          dirsCount++;
+char **getVaultsFromDirectories(char **directoryStringArray, int directoryNumber, int *vaultsPerDirectoryNumber, int *count, int shouldDebug) {
+    // to avoid having to work with a tree-dimensional array. We will use a 2d and
+    // vaultsPerDirectoryNumber will indicate the width of the directories.
+    char **vaultsArray = NULL;
+    int nthVault = 0; // this is only used internally to set the string into the right place in
+                      // directoryStringArray.
+    int previousStartIndex = 0;
+    for (int i = 0; i < directoryNumber; i++) {
+        debug("Opening %s", directoryStringArray[i]);
+        // originally from
+        // https://www.geeksforgeeks.org/c/c-program-list-files-sub-directories-directory/
+        struct dirent *vaultsDirectoryEntry;
+        DIR *vaultsDirectory = opendir(directoryStringArray[i]);
+        error(!vaultsDirectory, "program", "Could not open directory %s", directoryStringArray[i]);
+        vaultsPerDirectoryNumber[i] = 0;
+        debug("┌------------------------------\n Detected files and dirs %s:", directoryStringArray[i]);
+        // Refer https://pubs.opengroup.org/onlinepubs/7990989775/xsh/readdir.html
+        // for readdir()
+        while ((vaultsDirectoryEntry = readdir(vaultsDirectory)) != NULL) {
+            char *entryName = vaultsDirectoryEntry->d_name; // gets the entry as a string value
+            altDebug("%s", entryName);
+            if (entryName[0] != '.') {            // if not hidden file/dir
+                char tempFullEntryPath[PATH_MAX]; // we recreate the full path to check it's
+                                                  // proprieties
+                snprintf(tempFullEntryPath, PATH_MAX, "%s%s", directoryStringArray[i], entryName);
+                altDebug(" (%s)", tempFullEntryPath);
+                // checking the metadata to see if it is a dir
+                struct stat metadataEntry;
+                if (stat(tempFullEntryPath, &metadataEntry) == 0 && S_ISDIR(metadataEntry.st_mode)) { // get's the metadata (stat should return 0 if
+                                                                                                      // fails) and sees if it is a dir.
+                    altDebug(" is a vault");
+                    vaultsArray = realloc(vaultsArray, sizeof(char *) * (nthVault + 1)); // resize vaultsArray
+                    error(vaultsArray == NULL, "program", "realloc failed");
+                    vaultsPerDirectoryNumber[i]++;             // it will be used later to know which vaults
+                                                               // goes into which directory
+                    vaultsArray[nthVault] = strdup(entryName); // we use strdup and not strcpy, because memory used with
+                                                               // opendir and readdir will be closed.
+                    error(vaultsArray[nthVault] == NULL, "program", "strdup failed");
+                    nthVault++; // it is used immediatly to set the vault into directoryStringArray
+                } else {
+                    altDebug(" is not a vault (not a dir.)");
+                }
+            } else {
+                altDebug(" is not a vault (hidden file/dir)");
+            }
         }
-      }
+        // we sort entries for the same vault. We can't sort them all. This would break the order.
+        qsort(vaultsArray + previousStartIndex, nthVault - previousStartIndex, sizeof(const char *),
+              compareString); // sorts the vaults alphabetically
+        closedir(vaultsDirectory);
+        previousStartIndex = nthVault;
     }
-    altDebug("└------------------------------\n");
-
-    // free's some used memory
-    closedir(vaultsDirectory);
-    *count = dirsCount;
-    return dirsArray;
+    // we calculate once the total number of vaults to avoid recalculation every time we use it
+    *count = 0;
+    for (int i = 0; i < directoryNumber; i++) {
+        *count += vaultsPerDirectoryNumber[i];
+    }
+    return vaultsArray;
 }
 
-char *updateJournal(char *path, char *journal, char *timeFormat, int *journalWasUpdated, int shouldDebug) {
-  path[PATH_MAX] = '\0'; // it assures it is a string (Most cases this does nothing). But rewriting at least one bytes make the compile happy. He doesn't want to return an unchanged input.
-  debug("Handling the journal %s", path);
+char *updateJournal(char *path, char *journal, char *timeFormat, int *journalWasUpdated, int *returnNoteSelection, int shouldDebug) {
+    path[PATH_MAX] = '\0'; // it assures it is a string (Most cases this does nothing). But rewriting at least
+                           // one bytes make the compile happy. He doesn't want to return an unchanged input.
+    debug("Handling the journal %s", path);
 
-  char *date = getFormatedTime(timeFormat, shouldDebug);
-  debug("Formated time for the journal's entry is %s", date);
-  char dateWithExtension[PATH_MAX];
-  snprintf(dateWithExtension, PATH_MAX, "%s.md", date);
-  sanitize(dateWithExtension);
-  debug("Sanitized date: %s\n(it might be used later for a file name if the journal is divided)", dateWithExtension);
-  struct stat metadata;
-  error(stat(path, &metadata), "program", "stat() failed to get information about %s", path);
-  if (S_ISREG(metadata.st_mode)) {
-    debug("%s is a unified journal.", path);
-    if (!isStringInFile(path, date, shouldDebug)) { // if there is no entry for current date
-      appendToFile(path, date, shouldDebug);
-      *journalWasUpdated = 1;
-    } // if there is an entry do nothing 
-  } else if (S_ISDIR(metadata.st_mode)) {
-      debug("%s is a divided journal.", path);
-      struct dirent *dividedJournalEntry;
-      // snprintf does not like to have the same variable as input and output so we use a buffer
-      char temp[PATH_MAX];
-      snprintf(temp, PATH_MAX, "%s/", path); // appends a /. For safety
-      strncpy(path, temp, PATH_MAX);
-      DIR *dividedJournalDirectory = opendir(path);
-      error(dividedJournalDirectory==NULL, "program", "Could not open directory %s", path);
-      /*char **entryArray = NULL; // will contain all the entries of the divided journal
-      // This time it will be different. We must add "invert" the extraOptions to the options so that the Create new entry in journal is on top
-      entryArray = realloc(entryArray, sizeof(char*));*/
-      // simpler to just malloc 2 and later realloc
-      const int extraOptions = 3; 
-      char **entryArray = malloc(extraOptions*sizeof(char*));
-      char *createEntryMessage = malloc(PATH_MAX);
-      snprintf(createEntryMessage, PATH_MAX, "Create new entry for the journal %s", journal);
-      entryArray[0] = createEntryMessage;
-      entryArray[1] = "Open random entry";
-      entryArray[2] = "Search inside entries";
-      int entryCount = extraOptions; // we need to count how many dirs there is to always readjust how many memory we alloc
-      // Refer https://pubs.opengroup.org/onlinepubs/7990989775/xsh/readdir.html
-      // for readdir()
-      debug("┌------------------------------\n Detected files and dirs from %s:", path);
-      // iterates over all the entries from the dir
-      while ((dividedJournalEntry = readdir(dividedJournalDirectory)) != NULL) {
-        altDebug("%s\n", dividedJournalEntry->d_name);
-        if (dividedJournalEntry->d_name[0] != '.') { // if the entry don't start with a dot (so hidden dirs and hidden files)
-          char fullPathEntry[PATH_MAX]; // creates a string of size of the maximum path lenght
-          snprintf(fullPathEntry, sizeof(fullPathEntry), "%s/%s", path, dividedJournalEntry->d_name); // sets the full absolute path to fullPathEntry
-          
-          struct stat metadataPathEntry;
-          if (stat(fullPathEntry, &metadataPathEntry) == 0 && S_ISREG(metadataPathEntry.st_mode)) { // if this entry is a directory
-            entryArray = realloc(entryArray, (entryCount + 1)*sizeof(char*));
-            entryArray[entryCount] = strdup(dividedJournalEntry->d_name); // copy the dir name into entryArray
-            entryCount++;
-          }
-        }
-      }
-      altDebug("└------------------------------\n");
-      // free's some used memory
-      closedir(dividedJournalDirectory);
-      qsort(entryArray + extraOptions, entryCount - extraOptions, sizeof(const char *), reverseCompareString); // sorts the journals entries alphabetically. // the + extraOptions - extraOptions is to not sort "Create new entry for the journal" or Open random entry which is the first element
-
-      // we must now select to create new entry or to enter in old one
-      char *selectedOption = ncursesSelect(entryArray, "Create new entry or acces old entry (Use arrows or WASD, Enter to select):", extraOptions, entryCount - extraOptions, " ", " ", "", shouldDebug); // the "Create new entry for the journal %s" will be the only options. All other will be extraOptions. This is made so that "Create [...] %s" will always be on top
-      debug("Selected option from journal entry selection: %s", selectedOption);
-      if (strcmp(selectedOption, createEntryMessage) == 0) { // create new entry
-        char temp[PATH_MAX];
-        error(strlen(path)+1+strlen(dateWithExtension)+1>PATH_MAX, "Error file path too long. %s/%s must not exceed PATH_MAX", path, dateWithExtension); 
-        snprintf(temp, PATH_MAX, "%s/%s", path, dateWithExtension);
-        strncpy(path, temp, PATH_MAX);
-        if (!isStringInArray(dateWithExtension, (const char **)entryArray, entryCount)) { // it only creates it if it doesn't already exist
-                                                              // if it does exist it will just pass the full path
-          debug("Creating entry %s inside %s", date, path);
-          FILE *file;
-          file = fopen(path, "w");
-          error(file == NULL, "program", "%s couldn't be created", path);
-          debug("Writing %s\\n to %s", date, path);
-          fprintf(file, "%s\n", date);
-          fclose(file);
-          free(createEntryMessage);
-          *journalWasUpdated = 1;
-        } else {
-          debug("Today's entry (%s) already exist. We won't create a new one.", dateWithExtension);
-        }
-      } else if (strcmp(selectedOption, entryArray[1]) == 0) { // if we choosed to open a random entry
-        // setting up the seed for rand()
-        srand(time(NULL)); // not totaly random, just pseudorandom
-        int randomEntry = extraOptions + (rand() % (entryCount - extraOptions)); // we get a random number between extraOptions and entryCount (so all journal entries and not extraOptions)
-        char temp[PATH_MAX];
-        snprintf(temp, PATH_MAX, "%s/%s", path, entryArray[randomEntry]); // reconstruct the path
-        strncpy(path, temp, PATH_MAX);
-        debug("Selected random entry %s. It's path is %s.", entryArray[randomEntry], path);
-      } else if (strcmp(selectedOption, entryArray[2]) == 0) { // if we choosed to search
-        char *temp = fzfSelect(path, "Input text to be searched", shouldDebug); // uses ripgrep and fzf to search inside the files
-        char *selectedOption = malloc(PATH_MAX); // we can't just use path as both input and output of snprintf
-        snprintf(selectedOption, PATH_MAX, "%s/%s", path, temp);
-        path = strdup(selectedOption);
-        free(selectedOption);
-      } else { // we just recreate the path to the selected entry
+    char *date = getFormatedTime(timeFormat, shouldDebug);
+    debug("Formated time for the journal's entry is %s", date);
+    char dateWithExtension[PATH_MAX];
+    snprintf(dateWithExtension, PATH_MAX, "%s.md", date);
+    sanitize(dateWithExtension);
+    debug("Sanitized date: %s\n(it might be used later for a file name if the journal is divided)", dateWithExtension);
+    struct stat metadata;
+    stat(path, &metadata);
+    if (S_ISREG(metadata.st_mode)) {
+        debug("%s is a unified journal.", path);
+        if (!isStringInFile(path, date, shouldDebug)) { // if there is no entry for current date
+            appendToFile(path, date, shouldDebug);
+            *journalWasUpdated = 1;
+        } // if there is an entry do nothing
+    } else if (S_ISDIR(metadata.st_mode)) {
+        debug("%s is a divided journal.", path);
+        struct dirent *dividedJournalEntry;
         // snprintf does not like to have the same variable as input and output so we use a buffer
         char temp[PATH_MAX];
-        snprintf(temp, PATH_MAX, "%s/%s", path, selectedOption);
+        snprintf(temp, PATH_MAX, "%s/", path); // appends a /. For safety
         strncpy(path, temp, PATH_MAX);
-        debug("Returning path to the selected entry: %s", path);
-      }
-  } else {
-    error(1, "program", "%s is not a file and not a directory.", path);
-  }
-  
-  return path;
+        DIR *dividedJournalDirectory = opendir(path);
+        error(dividedJournalDirectory == NULL, "program", "Could not open directory %s", path);
+        /*char **entryArray = NULL; // will contain all the entries of the divided journal
+        // This time it will be different. We must add "invert" the extraOptions to the options so
+        that the Create new entry in journal is on top entryArray = realloc(entryArray,
+        sizeof(char*));*/
+        // simpler to just malloc 2 and later realloc
+        const int extraOptions = 4;
+        char **entryArray = malloc(extraOptions * sizeof(char *));
+        char *createEntryMessage = malloc(PATH_MAX);
+        snprintf(createEntryMessage, PATH_MAX, "Create new entry for the journal %s", journal);
+        entryArray[0] = createEntryMessage;
+        entryArray[1] = "Open random entry";
+        entryArray[2] = "Search inside entries";
+        entryArray[3] = "Return to the note selection";
+        int entryCount = extraOptions; // we need to count how many dirs there is to always readjust
+                                       // how many memory we alloc
+        // Refer https://pubs.opengroup.org/onlinepubs/7990989775/xsh/readdir.html
+        // for readdir()
+        debug("┌------------------------------\n Detected files and dirs from %s:", path);
+        // iterates over all the entries from the dir
+        while ((dividedJournalEntry = readdir(dividedJournalDirectory)) != NULL) {
+            altDebug("%s\n", dividedJournalEntry->d_name);
+            if (dividedJournalEntry->d_name[0] != '.') { // if the entry don't start with a dot (so hidden dirs and hidden files)
+                char fullPathEntry[PATH_MAX];            // creates a string of size of the maximum path lenght
+                snprintf(fullPathEntry, sizeof(fullPathEntry), "%s/%s", path,
+                         dividedJournalEntry->d_name); // sets the full absolute path to fullPathEntry
+
+                struct stat metadataPathEntry;
+                if (stat(fullPathEntry, &metadataPathEntry) == 0 && S_ISREG(metadataPathEntry.st_mode)) { // if this entry is a directory
+                    entryArray = realloc(entryArray, (entryCount + 1) * sizeof(char *));
+                    entryArray[entryCount] = strdup(dividedJournalEntry->d_name); // copy the dir name into entryArray
+                    entryCount++;
+                }
+            }
+        }
+        altDebug("└------------------------------\n");
+        // free's some used memory
+        closedir(dividedJournalDirectory);
+        qsort(entryArray + extraOptions, entryCount - extraOptions, sizeof(const char *),
+              reverseCompareString); // sorts the journals entries alphabetically. // the +
+                                     // extraOptions - extraOptions is to not sort "Create new entry
+                                     // for the journal" or Open random entry which is the first
+                                     // element
+
+        // we must now select to create new entry or to enter in old one
+        char *selectedOption =
+            ncursesSelect(entryArray, "Create new entry or acces old entry (Use arrows or WASD, Enter to select or use 1-9 to quick select):", extraOptions, entryCount - extraOptions, " ", " ", "",
+                          shouldDebug); // the "Create new entry for the journal %s" will be the only options. All
+                                        // other will be extraOptions. This is made so that "Create [...] %s" will
+                                        // always be on top
+        debug("Selected option from journal entry selection: %s", selectedOption);
+        if (strcmp(selectedOption, createEntryMessage) == 0) { // create new entry
+            char temp[PATH_MAX];
+            error(strlen(path) + 1 + strlen(dateWithExtension) + 1 > PATH_MAX, "Error file path too long. %s/%s must not exceed PATH_MAX", path, dateWithExtension);
+            snprintf(temp, PATH_MAX, "%s/%s", path, dateWithExtension);
+            strncpy(path, temp, PATH_MAX);
+            if (!isStringInArray(dateWithExtension, (const char **)entryArray,
+                                 entryCount)) { // it only creates it if it doesn't already exist
+                                                // if it does exist it will just pass the full path
+                debug("Creating entry %s inside %s", date, path);
+                FILE *file;
+                file = fopen(path, "w");
+                error(file == NULL, "program", "%s couldn't be created", path);
+                debug("Writing %s\\n to %s", date, path);
+                fprintf(file, "%s\n", date);
+                fclose(file);
+                free(createEntryMessage);
+                *journalWasUpdated = 1;
+            } else {
+                debug("Today's entry (%s) already exist. We won't create a new one.", dateWithExtension);
+            }
+        } else if (strcmp(selectedOption, entryArray[1]) == 0) { // if we choosed to open a random entry
+            // setting up the seed for rand()
+            srand(time(NULL));                                                       // not totaly random, just pseudorandom
+            int randomEntry = extraOptions + (rand() % (entryCount - extraOptions)); // we get a random number between extraOptions and entryCount (so
+                                                                                     // all journal entries and not extraOptions)
+            char temp[PATH_MAX];
+            snprintf(temp, PATH_MAX, "%s/%s", path,
+                     entryArray[randomEntry]); // reconstruct the path
+            strncpy(path, temp, PATH_MAX);
+            debug("Selected random entry %s. It's path is %s.", entryArray[randomEntry], path);
+        } else if (strcmp(selectedOption, entryArray[2]) == 0) { // if we choosed to search
+            char *temp = fzfSelect(path, "Input text to be searched",
+                                   shouldDebug);     // uses ripgrep and fzf to search inside the files
+            char *selectedOption = malloc(PATH_MAX); // we can't just use path as both input and output of snprintf
+            snprintf(selectedOption, PATH_MAX, "%s/%s", path, temp);
+            path = strdup(selectedOption);
+            free(selectedOption);
+        } else if (strcmp(selectedOption, "Return to the note selection") == 0) {
+            *returnNoteSelection = 1;
+        } else { // we just recreate the path to the selected entry
+            // snprintf does not like to have the same variable as input and output so we use a
+            // buffer
+            char temp[PATH_MAX];
+            snprintf(temp, PATH_MAX, "%s/%s", path, selectedOption);
+            strncpy(path, temp, PATH_MAX);
+            debug("Returning path to the selected entry: %s", path);
+        }
+    } else {
+        error(1, "program", "%s is not a file and not a directory.", path);
+    }
+
+    return path;
 }

src/notes.h

@@ -1,22 +1,31 @@
 #ifndef NOTES_H
 #define NOTES_H
-#include "utils.h"
 #include "ui.h"
+#include "utils.h"
+// find which directory contains targetVault
+char *getDirectoryFromVault(char *targetVault, char **vaultsArray, int vaultTotalNumber, int *vaultNumberPerDirectory, char **directoryArray, int directoryNumber, int shouldDebug);
 // gets the journals from the vault.
-//to distinguish journals from note we use regex. 
-//Note: we must handle them separatly as journals can either be a single file (which will treat specially) or a directory.
+// to distinguish journals from note we use regex.
+// Note: we must handle them separatly as journals can either be a single file (which will treat
+// specially) or a directory.
 char **getJournalsFromVault(char *pathToVault, char *vault, char *journalRegex, int *count, int shouldDebug);
-// this function is inputed a path to a vault (which was selected before) and outpus all the suitable notes (so not the hidden ones).
-// journalRegex is the regex code for the journals. If a note matches this code, it is treated as a journal and it is not outputed from this function.
+// this function is inputed a path to a vault (which was selected before) and outpus all the
+// suitable notes (so not the hidden ones). journalRegex is the regex code for the journals. If a
+// note matches this code, it is treated as a journal and it is not outputed from this function.
 char **getNotesFromVault(char *pathToVault, char *vault, char *journalRegex, int *count, int shouldDebug);
-// this function is inputed a path to a directory (which comes usually from the config file) and outpus all the suitable directories (so not the hidden ones) which will serve as separate vaults for notes.
-char **getVaultsFromDirectory(char *dirString, int *count, int shouldDebug);
+// function gets as input an array of directoryNumber strings. Which are the directories the
+// function will search for vaults. it returns an array of vaults. the vaults are organized in order
+// per directory. vaultsPerDirectoryNumber and count should be initiallized before calling the
+// function and the address be inputed. count is the total number of vaults.
+// vaultsPerDirectoryNumber gives how many vaults each directory has.
+char **getVaultsFromDirectories(char **directoryStringArray, int directoryNumber, int *vaultsPerDirectoryNumber, int *count, int shouldDebug);
 // path is the path to the file.
 // journal is the name of the file.
 // journalWasUpdated will be set to 1 if a new entry was created
 // handles both type of journal (divided and unified).
 // creates new entry with date.
 // for divided select if we want to acces to a new entry or a old one.
+// returnNoteSelection tells us if the user wants to go back to the note selection.
 // returns the path to the file that needs to be opened.
-char *updateJournal(char *path, char *journal, char *timeFormat, int *journalWasUpdated, int shouldDebug);
+char *updateJournal(char *path, char *journal, char *timeFormat, int *journalWasUpdated, int *returnNoteSelection, int shouldDebug);
 #endif

src/ui.c

@@ -1,160 +1,178 @@
 #include "ui.h"
+#include "utils.h"
 
-void createNewVault(char *dirToVault, int bypass, char *bypassvalue, int shouldDebug) {
-  int duplicateWarning = 0; // set to 1 later if the vault you tried to create already existed
-  int emptyWarning = 0; // set to 1 later if inpted empty name
+void createNewVault(char **directoriesArray, int directoryCount, char **vaultsArray, int vaultCount, int bypass, char *bypassvalue, int shouldDebug) {
+    int duplicateWarning = 0; // set to 1 later if the vault you tried to create already existed
+    int emptyWarning = 0;     // set to 1 later if inpted empty name
 input_screen:
-  char *vaultName = malloc(PATH_MAX);
-  if (!bypass) { // if won't bypass (if -v or --vault weren't set)
-    echo();
-    keypad(stdscr, FALSE);
-    // color code from https://stackoverflow.com/a/73396575
-    start_color();
-    clear();
-    use_default_colors();
-    init_pair(1, COLOR_WHITE, -1); // -1 is blank
-    init_pair(2, COLOR_RED, -1);
-    attron(COLOR_PAIR(1));
-    printw("Enter the name of the new vault: ");
-    mvprintw(3, 0, "Unsafe characters such as \\ and / will be replaced by _");
-    attroff(COLOR_PAIR(1));
-    if (duplicateWarning) {
-      attron(COLOR_PAIR(2));
-      mvprintw(4, 0, "A vault with this name already exists. Please input another name");
-      attroff(COLOR_PAIR(2));
+    // choose in which directory the vault will be created
+    char *dirToVault =
+        ncursesSelect(directoriesArray, "Select a directory, in which the vault will remain (Use arrows or WASD, Enter to select or use 1-9 to quick select)", directoryCount, 0, "", "", " ", shouldDebug);
+    char *vaultName = malloc(PATH_MAX);
+    if (!bypass) { // if won't bypass (if -v or --vault weren't set)
+        echo();
+        keypad(stdscr, FALSE);
+        // color code from https://stackoverflow.com/a/73396575
+        start_color();
+        clear();
+        use_default_colors();
+        init_pair(1, COLOR_WHITE, -1); // -1 is blank
+        init_pair(2, COLOR_RED, -1);
+        attron(COLOR_PAIR(1));
+        printw("Enter the name of the new vault: ");
+        mvprintw(3, 0, "Unsafe characters such as \\ and / will be replaced by _");
+        attroff(COLOR_PAIR(1));
+        if (duplicateWarning) {
+            attron(COLOR_PAIR(2));
+            mvprintw(4, 0, "A vault with this name already exists. Please input another name");
+            attroff(COLOR_PAIR(2));
+        }
+        if (emptyWarning) {
+            attron(COLOR_PAIR(2));
+            mvprintw(5, 0, "The vault's name must not be empty. Please input another name");
+            attroff(COLOR_PAIR(2));
+        }
+        move(1, 1); // replace cursor
+        wgetnstr(stdscr, vaultName, PATH_MAX - 1);
+        refresh();
+        endwin();
+        reset_shell_mode();
+        fflush(stdout);
+        fflush(stderr);
+    } else {
+        strncpy(vaultName, bypassvalue, PATH_MAX - 2); // -2 (and later -1) because indexing
+        vaultName[PATH_MAX - 1] = '\0';
     }
-    if (emptyWarning) {
-      attron(COLOR_PAIR(2));
-      mvprintw(5, 0, "The vault's name must not be empty. Please input another name");
-      attroff(COLOR_PAIR(2));
+    // check if no empty string
+    if (strcmp(vaultName, "") == 0) {
+        emptyWarning = 1;
+        goto input_screen;
     }
-    move(1, 1); // replace cursor 
-    wgetnstr(stdscr, vaultName, PATH_MAX-1);
-    refresh();
-    endwin();
-    reset_shell_mode();
-    fflush(stdout);
-    fflush(stderr);
-  } else {
-    strncpy(vaultName, bypassvalue, PATH_MAX -2); // -2 (and later -1) because indexing
-    vaultName[PATH_MAX-1] = '\0';
-  }
-  // check if no empty string
-  if (strcmp(vaultName, "") == 0) {
-    emptyWarning = 1;
-    goto input_screen;
-  }
-  debug("Inputed vaultName=%s", vaultName);
-  sanitize(vaultName);
-  debug("Sanitized vaultName=%s", vaultName);
+    debug("Inputed vaultName=%s", vaultName);
+    sanitize(vaultName);
+    debug("Sanitized vaultName=%s", vaultName);
 
-  struct stat st = {0}; // https://stackoverflow.com/a/7430262
-  char vaultFullPath[PATH_MAX];
-  sprintf(vaultFullPath, "%s/%s/", dirToVault, vaultName);
-  if (stat(vaultFullPath, &st) == -1) {
-    mkdir(vaultFullPath, 0744);
-  } else {
-    // if stat(...) != -1 it means the vault already exist. We will go back to the input screen with a new message.
-    duplicateWarning = 1;
-    goto input_screen;
-  }
-  free(vaultName);
+    if (!isStringInArray(vaultName, (const char **)vaultsArray,
+                         vaultCount)) { // if vault doesnt already exists. We avoid vaults with the
+                                        // same name even if they are from different directories.
+        char vaultFullPath[PATH_MAX];   // recreating the full path
+        sprintf(vaultFullPath, "%s/%s/", dirToVault, vaultName);
+
+        mkdir(vaultFullPath, 0744);
+    } else {
+        duplicateWarning = 1;
+        goto input_screen;
+    }
+    free(vaultName);
 }
 
 char *createNewNote(char dirToVault[PATH_MAX], char *vaultFromDir, int bypass, char *bypassvalue, char *journalRegex, int shouldDebug) {
-  // input from user for the name
-  char *fileName = malloc(BUFFER_SIZE);
-  if (!bypass) { // if we don't bypass. (if -n or --note weren't set.)
-    echo();
-    keypad(stdscr, FALSE);
-    clear();
-    printw("Enter the name of the new note: ");
-    mvprintw(3, 0, "Unsafe characters such as \\, and / will be replaced by _");
-    mvprintw(4, 0, "If the name matches with the regex for a journal (%s), it will create a journal instead of a note.", journalRegex);
-    move(1,1);
-    wgetnstr(stdscr, fileName, BUFFER_SIZE-4); //limits the buffer to prevent overflow (-4 to account indexing and from ".md" in case we need to add it later)
-    refresh();
-    endwin();
-    reset_shell_mode();
-    fflush(stdout);
-    fflush(stderr);
-  } else { // bypasses user input if we bypass is set to 1
-    strncpy(fileName, bypassvalue, BUFFER_SIZE);
-    fileName[BUFFER_SIZE-1] = '\0';
-  }
-  error(strcmp(fileName, "") == 0, "user", "fileName is empty"); // replace this with a warning and add a warning if duplicate file and handle case where multiple warnings (if such case is possible)
-  // check/sanitize the input
-  debug("Inputed fileName=%s", fileName);
-  sanitize(fileName);
-  debug("Sanitized fileName=%s (We might append .md later", fileName);
-  // we trow an error if the file already exists (previous behaviour was overwriting the file)
-  char path[PATH_MAX];
-  snprintf(path, PATH_MAX, "%s/%s/%s", dirToVault, vaultFromDir, fileName);
-  struct stat st;
-  error(stat(path, &st) == 0, "user", "%s already exists", fileName);
-  // if it matches with the journalRegex we treat it as a journal instead of a note
-  regex_t regex;
-  int regexReturn = regcomp(&regex, journalRegex, 0);
-  error(regexReturn, "program", "Regex compilation failed.");
-  regexReturn = regexec(&regex, fileName, 0, NULL, 0);
-  if (!regexReturn) {
-    debug("%s matches with %s treating it as a journal", fileName, journalRegex);
-    char **options = malloc(32); // the number of bytes is exactly what in the two strings
-    options[0] = "Divided journal";
-    options[1] = "Unified journal";
-    char *optionSelected = ncursesSelect(options, "Select which type of journal you want to create  (Use arrows or WASD, Enter to select):", 2, 0, "", "", " ", shouldDebug);
-    debug("%s was selected to be a %s", fileName, optionSelected);
-    if (strcmp(optionSelected, options[0]) == 0) { // if it is a divided journal
-      char *fileFullPath = malloc(PATH_MAX);
-      snprintf(fileFullPath, PATH_MAX, "%s/%s/%s/", dirToVault, vaultFromDir, fileName);
-      struct stat st = {0};
-      if (stat(fileFullPath, &st) == -1) {
-        error(!mkdir(fileFullPath, 0744), "program", "mkdir failed");
-      } else {
-        error(1, "program", "%s could not be created", fileFullPath);
-      }
-      free(fileFullPath);
-    } else { // if it is a unified journal
-      char *fileFullPath = malloc(PATH_MAX);
-      snprintf(fileFullPath, PATH_MAX, "%s/%s/%s", dirToVault, vaultFromDir, fileName);
-      int len = strlen(fileFullPath);
-      if (fileFullPath[len-3] != '.' || fileFullPath[len-2] != 'm' || fileFullPath[len-1] != 'd') { // there might be a cleaner way to do this
-        error(len > PATH_MAX - 3, "user", "%s is too big (greater than PATH_MAX-3) and we can't append .md", fileFullPath);
-        strncat(fileFullPath, ".md", PATH_MAX);
-        // we checked before if fileName didn't already exist.
-        // we must redo it as we add a .mode
-        struct stat st;
-        error(stat(fileFullPath, &st) == 0, "user", "%s already exists", fileFullPath);
-      }
-      FILE *filePointer;
-      filePointer = fopen(fileFullPath, "w"); // creates and opens the file
-      error(filePointer == NULL, "program", "The %s couldn't be created.", fileFullPath);
-      fprintf(filePointer, "### %s\n", fileName);
-      fclose(filePointer); // closes the file so that nvim could open it
-      free(fileFullPath);
+    // input from user for the name
+    char *fileName = malloc(BUFFER_SIZE);
+    if (!bypass) { // if we don't bypass. (if -n or --note weren't set.)
+        echo();
+        keypad(stdscr, FALSE);
+        clear();
+        printw("Enter the name of the new note: ");
+        mvprintw(3, 0, "Unsafe characters such as \\, and / will be replaced by _");
+        mvprintw(4, 0,
+                 "If the name matches with the regex for a journal (%s), it will create a journal "
+                 "instead of a note.",
+                 journalRegex);
+        move(1, 1);
+        wgetnstr(stdscr, fileName,
+                 BUFFER_SIZE - 4); // limits the buffer to prevent overflow (-4 to account indexing
+                                   // and from ".md" in case we need to add it later)
+        refresh();
+        endwin();
+        reset_shell_mode();
+        fflush(stdout);
+        fflush(stderr);
+    } else { // bypasses user input if we bypass is set to 1
+        strncpy(fileName, bypassvalue, BUFFER_SIZE);
+        fileName[BUFFER_SIZE - 1] = '\0';
     }
-    free(options); // they are useless now
-  } else { // normal process for a note
-    debug("%s does not match with %s treating it as a note", fileName, journalRegex);
-    // if there is no .md add an .md
-    int len = strlen(fileName);
-    if (fileName[len-3] != '.' || fileName[len-2] != 'm' || fileName[len-1] != 'd') { // there might be a cleaner way to do this
-      strcat(fileName, ".md"); // this should not cause an overflow issue as we get at most 252 chars (+'.'+'m'+'d'+'\0' makes it to 256) with wgetnstr
+    error(strcmp(fileName, "") == 0, "user",
+          "fileName is empty"); // replace this with a warning and add a warning if duplicate file and
+                                // handle case where multiple warnings (if such case is possible)
+    // check/sanitize the input
+    debug("Inputed fileName=%s", fileName);
+    sanitize(fileName);
+    debug("Sanitized fileName=%s (We might append .md later", fileName);
+    // we trow an error if the file already exists (previous behaviour was overwriting the file)
+    char path[PATH_MAX];
+    snprintf(path, PATH_MAX, "%s/%s/%s", dirToVault, vaultFromDir, fileName);
+    struct stat st;
+    error(stat(path, &st) == 0, "user", "%s already exists", fileName);
+    // if it matches with the journalRegex we treat it as a journal instead of a note
+    regex_t regex;
+    int regexReturn = regcomp(&regex, journalRegex, 0);
+    error(regexReturn, "program", "Regex compilation failed.");
+    regexReturn = regexec(&regex, fileName, 0, NULL, 0);
+    if (!regexReturn) {
+        debug("%s matches with %s treating it as a journal", fileName, journalRegex);
+        char **options = malloc(32); // the number of bytes is exactly what in the two strings
+        options[0] = "Divided journal";
+        options[1] = "Unified journal";
+        char *optionSelected = ncursesSelect(options,
+                                             "Select which type of journal you want to create  "
+                                             "(Use arrows or WASD, Enter to select):",
+                                             2, 0, "", "", " ", shouldDebug);
+        debug("%s was selected to be a %s", fileName, optionSelected);
+        if (strcmp(optionSelected, options[0]) == 0) { // if it is a divided journal
+            char *fileFullPath = malloc(PATH_MAX);
+            snprintf(fileFullPath, PATH_MAX, "%s/%s/%s/", dirToVault, vaultFromDir, fileName);
+            struct stat st = {0};
+            if (stat(fileFullPath, &st) == -1) {
+                error(mkdir(fileFullPath, 0744), "program", "mkdir failed");
+            } else {
+                error(1, "program", "%s could not be created", fileFullPath);
+            }
+            free(fileFullPath);
+        } else { // if it is a unified journal
+            char *fileFullPath = malloc(PATH_MAX);
+            // we append .md directly to fileName and not only to fileFullPath to avoid passing the wrong fileName later.
+            int lenName = strlen(fileName);
+            if (fileName[lenName - 3] != '.' && fileName[lenName - 2] != 'm' && fileName[lenName - 2] != '1') {
+                strcat(fileName, ".md");
+                debug("We just appended .md to %s", fileName);
+            }
+            snprintf(fileFullPath, PATH_MAX, "%s/%s/%s", dirToVault, vaultFromDir, fileName);
+            // we verify if the file doesn't already exist as we might just have changed the fileName and (by extension) the file path.
+            struct stat metadata;
+            error(stat(fileFullPath, &metadata) == 0, "user", "%s already exists", fileFullPath);
+            FILE *filePointer;
+            filePointer = fopen(fileFullPath, "w"); // creates and opens the file
+            error(filePointer == NULL, "program", "The %s couldn't be created.", fileFullPath);
+            fprintf(filePointer, "### %s\n", fileName);
+            fclose(filePointer); // closes the file so that nvim could open it
+            free(fileFullPath);
+        }
+        free(options); // they are useless now
+    } else {           // normal process for a note
+        debug("%s does not match with %s treating it as a note", fileName, journalRegex);
+        // if there is no .md add an .md
+        int len = strlen(fileName);
+        if (fileName[len - 3] != '.' || fileName[len - 2] != 'm' || fileName[len - 1] != 'd') { // there might be a cleaner way to do this
+            strcat(fileName, ".md");                                                            // this should not cause an overflow issue as we get at most
+                                                                                                // 252 chars (+'.'+'m'+'d'+'\0' makes it to 256) with wgetnstr
+        }
+        char *fileFullPath = malloc(PATH_MAX); // this dinamically allocated because we use it in
+                                               // the main function to call openEditor
+        sprintf(fileFullPath, "%s/%s/%s", dirToVault, vaultFromDir, fileName);
+        FILE *filePointer;
+        filePointer = fopen(fileFullPath, "w"); // creates and opens the file
+        error(filePointer == NULL, "program", "The %s couldn't be created.", fileFullPath);
+        fprintf(filePointer, "### %s\n", fileName);
+        fclose(filePointer); // closes the file so that nvim could open it
+        free(fileFullPath);
     }
-    char *fileFullPath = malloc(PATH_MAX); // this dinamically allocated because we use it in the main function to call openEditor
-    sprintf(fileFullPath, "%s/%s/%s", dirToVault, vaultFromDir, fileName);
-    FILE *filePointer;
-    filePointer = fopen(fileFullPath, "w"); // creates and opens the file
-    error(filePointer == NULL, "program", "The %s couldn't be created.", fileFullPath);
-    fprintf(filePointer, "### %s\n", fileName);
-    fclose(filePointer); // closes the file so that nvim could open it
-    free(fileFullPath);
-  }
-  return fileName;
+    return fileName;
 }
 
-char* fzfSelect(char *pathToFiles, char *selectText, int shouldDebug) {
-    // we are gonna write each line of each files (with the filename and the line number to an index)
+char *fzfSelect(char *pathToFiles, char *selectText, int shouldDebug) {
+    // we are gonna write each line of each files (with the filename and the line number to an
+    // index)
     char command[CMD_BUFFER];
     char indexFile[] = "/tmp/notewrapper_index_XXXXXX";
 
@@ -162,17 +180,7 @@ char* fzfSelect(char *pathToFiles, char *selectText, int shouldDebug) {
     error(fd == -1, "program", "mkstemp failed");
     close(fd);
 
-    /*
-     * STEP 1:
-     * Build index once into temp file
-     * format: file:line:content
-     */
-    snprintf(command, sizeof(command),
-        "rg --line-number --no-heading --color=never . \"%s\" > %s",
-        pathToFiles,
-        indexFile
-    );
-    
+    snprintf(command, sizeof(command), "rg --line-number --no-heading --color=never . \"%s\" > %s", pathToFiles, indexFile);
     debug("INDEX CMD: %s", command);
 
     if (system(command) != 0) {
@@ -180,53 +188,13 @@ char* fzfSelect(char *pathToFiles, char *selectText, int shouldDebug) {
         error(1, "program", "rg indexing failed");
     }
 
-    /*
-     * STEP 2:
-     * Use fzf on the index file (NO rg anymore)
-     */
-    /*
-      EXPLANATION:
-      
-      cat %s
-        → feeds prebuilt index file (format: file:line:content) into fzf
-      
-      fzf --delimiter ':'
-        → splits each line into fields:
-           {1} = file path
-           {2} = line number
-           {3} = content
-      
-      --prompt
-        → UI prompt text shown in fzf
-      
-      --preview
-        → runs a shell command for selected item:
-           file={1}  → current file
-           line={2}  → line number of match
-      
-      nl -ba "$file"
-        → prints file with line numbers
-      
-      sed -n "$((line-5)),$((line+5))p"
-        → extracts a window of 5 lines above and below match
-      
-      sed "... -> ..."
-        → highlights the matched line (middle of window) with red arrow
-      
-      --preview-window=right:60%:hidden
-        → preview appears on right, 60% width, initially hidden
-      
-      --bind 'change:show-preview'
-        → preview only appears after first selection change (not at startup)
-    */
     snprintf(command, sizeof(command),
              "cat %s | fzf --delimiter ':' --prompt='%s' "
-             "--preview 'file={1}; line={2}; nl -ba \"$file\" | sed -n \"$((line-5)),$((line+5))p\" | sed \"$((line-$(($((line-5))))+1))s/^/\\x1b[31m-> \\x1b[0m/\"' "
+             "--preview 'file={1}; line={2}; nl -ba \"$file\" | sed -n \"$((line-5)),$((line+5))p\" | "
+             "sed \"$((line-$(($((line-5))))+1))s/^/\\x1b[31m-> \\x1b[0m/\"' "
              "--preview-window=right:60%%:hidden "
              "--bind 'change:show-preview'",
-             indexFile,
-             selectText ? selectText : "> "
-    );
+             indexFile, selectText ? selectText : "> ");
     debug("FZF CMD: %s", command);
 
     FILE *fzfPipe = popen(command, "r");
@@ -242,16 +210,25 @@ char* fzfSelect(char *pathToFiles, char *selectText, int shouldDebug) {
         buffer[strcspn(buffer, "\n")] = '\0';
         result = strdup(buffer);
     }
+    debug("Buffer: %s", buffer);
+    debug("result: %s", result);
 
     // cut at first ':'
     result = strtok(result, ":");
-    // cut at / (because we need the full paths before and we only need to return the journal entry)
-    char *token = strtok(result, "/");
-    result = NULL;
-    while (token != NULL) {
-      result = token;
-      token = strtok(NULL, "/"); //Passing NULL means “don’t start a new string, resume
+    // we need to cut out the whole pathToFiles
+    int pathToFilesLen = strlen(pathToFiles);
+    int cutOut = 0;
+    for (int i = 0; i < pathToFilesLen; i++) {
+        if (pathToFiles[i] == result[i]) {
+            cutOut = i;
+        }
     }
+    result += cutOut + 1; // the + 1 cuts the first /
+
+    // in case we select a journal, we won't open the entry just yet. We only need to return the journal name (everything before [now the first] /
+    result = strtok(result, "/");
+
+    debug("Cleaned note: %s", result);
 
     // clean up
     pclose(fzfPipe);
@@ -260,81 +237,147 @@ char* fzfSelect(char *pathToFiles, char *selectText, int shouldDebug) {
     return result;
 }
 
-char* ncursesSelect(char **options, char *optionsText, int optionsNumber, int extraOptionsNumber, char *bottomText, char *middleText, char *topText, int shouldDebug) {
-    int highlight = 0; //curently highlighted option
+char *ncursesSelect(char **options, char *optionsText, int optionsNumber, int extraOptionsNumber, char *bottomText, char *middleText, char *topText,
+                    int shouldDebug) { // TODO we should see how it handles larges strings (like large directories)
+    int highlight = 0;                 // curently highlighted option
     int key;
 
-    cbreak();               // disable line buffering
-    noecho();               // don't echo key presses
-    keypad(stdscr, TRUE);   // enable arrow keys 
+    cbreak();             // disable line buffering
+    noecho();             // don't echo key presses
+    keypad(stdscr, TRUE); // enable arrow keys
     start_color();
-    curs_set(0); // sets the cursor to invisible. (We will emulate the cursor with a hightlight that go up and down).
+    curs_set(0); // sets the cursor to invisible. (We will emulate the cursor with a hightlight that
+                 // go up and down).
     use_default_colors();
     init_pair(1, COLOR_WHITE, -1); // color for optionsNumber (so notes, vaults, etc.)
-    init_pair(2, COLOR_BLUE, -1); // color for extraOptionsNumber (so settings, delete notes, create vault, etc.)
+    init_pair(2, COLOR_BLUE,
+              -1); // color for extraOptionsNumber (so settings, delete notes, create vault, etc.)
     while (1) {
-      clear();
-      attron(COLOR_PAIR(1));
-      mvprintw(0,0, "%s", optionsText);
-      int offset = 1;
-      if (strcmp(bottomText, "") != 0) {
-        mvprintw(offset, 1, "%s", bottomText);
-        offset++;
-      }
-      // Print options with highlighting
-      for (int i = 0; i < optionsNumber; i++) {
-        if (i == highlight) {
-          attron(A_REVERSE);
-        }   // highlight selected
-        mvprintw(i+offset, 2, "%s", options[i]);
-        if (i == highlight) {
-          attroff(A_REVERSE);
+        clear();
+        attron(COLOR_PAIR(1));
+        mvprintw(0, 0, "%s", optionsText);
+        int offset = 1;
+        if (strcmp(bottomText, "") != 0) {
+            mvprintw(offset, 1, "%s", bottomText);
+            offset++;
         }
-      }
-      attroff(COLOR_PAIR(1));
-      if (strcmp(middleText, "") != 0) {
-        mvprintw(offset+optionsNumber, 1, "%s", middleText);
-        offset++;
-      }
-      // Printf extraOptions with highlighting
-      attron(COLOR_PAIR(2));
-      for (int k = optionsNumber; k < optionsNumber + extraOptionsNumber; k++) {
-        if (k == highlight) {
-          attron(A_REVERSE);
+        // Print options with highlighting
+        for (int i = 0; i < optionsNumber; i++) {
+            if (i == highlight) {
+                attron(A_REVERSE);
+            } // highlight selected
+            mvprintw(i + offset, 2, "%s", options[i]);
+            if (i == highlight) {
+                attroff(A_REVERSE);
+            }
         }
-        mvprintw(k+offset, 2, "%s", options[k]);
-        if (k == highlight) {
-          attroff(A_REVERSE);
+        attroff(COLOR_PAIR(1));
+        if (strcmp(middleText, "") != 0) {
+            mvprintw(offset + optionsNumber, 1, "%s", middleText);
+            offset++;
         }
-      }
-      attroff(COLOR_PAIR(2));
-      attron(COLOR_PAIR(1));
-      mvprintw(offset+optionsNumber+extraOptionsNumber, 1, "%s", topText);
-      attroff(COLOR_PAIR(1));
-      key = getch(); //get some int which value correspond to some key being pressed
+        // Printf extraOptions with highlighting
+        attron(COLOR_PAIR(2));
+        for (int k = optionsNumber; k < optionsNumber + extraOptionsNumber; k++) {
+            if (k == highlight) {
+                attron(A_REVERSE);
+            }
+            mvprintw(k + offset, 2, "%s", options[k]);
+            if (k == highlight) {
+                attroff(A_REVERSE);
+            }
+        }
+        attroff(COLOR_PAIR(2));
+        attron(COLOR_PAIR(1));
+        mvprintw(offset + optionsNumber + extraOptionsNumber, 1, "%s", topText);
+        attroff(COLOR_PAIR(1));
+        key = getch(); // get some int which value correspond to some key being pressed
 
-      switch(key) {
+        switch (key) {
         case KEY_UP:
         case 'w':
         case 'W':
-          highlight--;
-          if (highlight < 0) {
-            highlight = optionsNumber + extraOptionsNumber - 1;// can't select the -1nth option
-          }
-          break;
+            highlight--;
+            if (highlight < 0) {
+                highlight = optionsNumber + extraOptionsNumber - 1; // can't select the -1nth option
+            }
+            break;
         case 's':
         case 'S':
         case KEY_DOWN:
-          highlight++;
-          if (highlight >= optionsNumber + extraOptionsNumber) {
-            highlight = 0;
-          }
-          break;
+            highlight++;
+            if (highlight >= optionsNumber + extraOptionsNumber) {
+                highlight = 0;
+            }
+            break;
+        case '1':
+            if (optionsNumber + extraOptionsNumber >= 1) {
+                debug("Quickselected option 1.");
+                highlight = 0;
+                goto end_loop;
+            }
+            break;
+        case '2':
+            if (optionsNumber + extraOptionsNumber >= 1) {
+                debug("Quickselected option 2.");
+                highlight = 1;
+                goto end_loop;
+            }
+            break;
+        case '3':
+            if (optionsNumber + extraOptionsNumber >= 1) {
+                debug("Quickselected option 3.");
+                highlight = 2;
+                goto end_loop;
+            }
+            break;
+        case '4':
+            if (optionsNumber + extraOptionsNumber >= 1) {
+                debug("Quickselected option 4.");
+                highlight = 3;
+                goto end_loop;
+            }
+            break;
+        case '5':
+            if (optionsNumber + extraOptionsNumber >= 1) {
+                debug("Quickselected option 5.");
+                highlight = 4;
+                goto end_loop;
+            }
+            break;
+        case '6':
+            if (optionsNumber + extraOptionsNumber >= 1) {
+                debug("Quickselected option 6.");
+                highlight = 5;
+                goto end_loop;
+            }
+            break;
+        case '7':
+            if (optionsNumber + extraOptionsNumber >= 1) {
+                debug("Quickselected option 7.");
+                highlight = 6;
+                goto end_loop;
+            }
+            break;
+        case '8':
+            if (optionsNumber + extraOptionsNumber >= 1) {
+                debug("Quickselected option 8.");
+                highlight = 7;
+                goto end_loop;
+            }
+            break;
+        case '9':
+            if (optionsNumber + extraOptionsNumber >= 1) {
+                debug("Quickselected option 9.");
+                highlight = 8;
+                goto end_loop;
+            }
+            break;
         case 10: //\n
-          goto end_loop;
-      }
+            goto end_loop;
+        }
     }
-    end_loop:
+end_loop:
     endwin(); // end ncurses mode
     fflush(stderr);
     debug("Selected option: %s", options[highlight]);

src/ui.h

@@ -1,45 +1,44 @@
 #ifndef UI_H
 #define UI_H
 
+#include "utils.h"
+#include <ctype.h>
+#include <limits.h>
+#include <ncurses.h>
+#include <pwd.h>
+#include <regex.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
-#include <ncurses.h>
-#include <unistd.h>
 #include <sys/stat.h>
-#include <pwd.h>
-#include <ctype.h>
-#include <limits.h>
-#include <regex.h>
-#include "utils.h"
-#define CMD_BUFFER 4096 // for fzfSelect
+#include <unistd.h>
+#define CMD_BUFFER 4096    // for fzfSelect
 #define RESULT_BUFFER 1024 // for fzfSelect
 
-/*Uses ncurses to get an input from the user. 
-Creates a new note with this input. 
-also can create a journal if the name matches with journalRegex. 
-returns the path to the note. 
+/*Uses ncurses to get an input from the user.
+Creates a new note with this input.
+also can create a journal if the name matches with journalRegex.
+returns the path to the note.
 If you want to bypass the input TUI set bypass to 1 and bypassvalue to the note name
 */
 char *createNewNote(char dirToVault[PATH_MAX], char *vaultFromDir, int bypass, char *bypassvalue, char *journalRegex, int debug);
-/*Uses ncurses to get an input from the user. 
-Creates a new vault with this input. 
-If vault already exists, prints a warning. 
+/*
+Chooses in which directory it want to create the vault.
+Uses ncurses to get an input from the user.
+Creates a new vault with this input.
+If vault already exists, prints a warning.
 returns nothing. */
-void createNewVault(char *dirToVault, int bypass, char *bypassvalue, int debug);
+void createNewVault(char **directoriesArray, int directoryCount, char **vaultsArray, int vaultCount, int bypass, char *bypassvalue, int debug);
 // uses fzf and ripgrep to search inside the files to choose between all the options.
-char* fzfSelect(char *pathToFiles, char *selectText, int shouldDebug);
-/*this function is used multiple times let the user select one options from many with ncurses in a TUI.
-options is the array of strings with all the options.
-optionsText is the text that will be printed at the top (For example: "Please select ...").
-we distinguish options from extraOptions.
+char *fzfSelect(char *pathToFiles, char *selectText, int shouldDebug);
+/*this function is used multiple times let the user select one options from many with ncurses in a
+TUI. options is the array of strings with all the options. optionsText is the text that will be
+printed at the top (For example: "Please select ..."). we distinguish options from extraOptions.
 options could be the list of all notes or all vaults.
-extraOptions are options that are special and have a special color (for ex: "Delete vault", "Settings", etc.).
-note: extraOptions should be at the end of options.
-topText is printed between options text and the start of options.
-middleText (usally \n) is printed between options and extraOptions.
-bottomText is printed bellow. 
-topText and middle must be exactly one line. If you want empty lines use " " and not "". 
-returns the selected option. */ 
-char* ncursesSelect(char **options, char *optionsText, int optionsNumber, int extraOptionsNumber, char *bottomText, char *middleText, char *topText, int debug);
+extraOptions are options that are special and have a special color (for ex: "Delete vault",
+"Settings", etc.). note: extraOptions should be at the end of options. topText is printed between
+options text and the start of options. middleText (usally \n) is printed between options and
+extraOptions. bottomText is printed bellow. topText and middle must be exactly one line. If you want
+empty lines use " " and not "". returns the selected option. */
+char *ncursesSelect(char **options, char *optionsText, int optionsNumber, int extraOptionsNumber, char *bottomText, char *middleText, char *topText, int debug);
 #endif

src/utils.h

@@ -1,55 +1,61 @@
 #ifndef UTILS_H
 #define UTILS_H
 
+#include <cjson/cJSON.h>
+#include <ctype.h>
+#include <dirent.h>
+#include <errno.h>
+#include <ftw.h>
+#include <git2.h>
+#include <limits.h>
+#include <ncurses.h>
+#include <pwd.h>
+#include <regex.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
-#include <dirent.h>
 #include <sys/stat.h>
-#include <unistd.h>
-#include <ftw.h>
-#include <pwd.h>
-#include <ncurses.h>
-#include <ctype.h>
 #include <sys/wait.h>
-#include <limits.h>
-#include <cjson/cJSON.h>
-#include <regex.h>
-#include <errno.h> 
 #include <time.h>
-#include <ftw.h>
-#define BUFFER_SIZE 256 //standard buffer size.
-// the three supported values are "daily" "weekly" and "monthly" (for months we use the avarage lenght of a month in a non leap year). All values were calculated on my loyal TI-30 ECO RS
+#include <unistd.h>
+
+#ifndef VERSION
+#define VERSION "dev"
+#endif
+#define BUFFER_SIZE 256 // standard buffer size.
+// the three supported values are "daily" "weekly" and "monthly" (for months we use the avarage
+// lenght of a month in a non leap year). All values were calculated on my loyal TI-30 ECO RS
 #define DAILY 86400
 #define WEEKLY 604800
 #define MONTHLY 2628000 // calculated from the average lenght of a non leap year
-#define debug(message, ...) \
-    _debug(shouldDebug, __FILE__, __LINE__, __func__, message, ##__VA_ARGS__)
-#define altDebug(message, ...) \
-    _altDebug(shouldDebug, message, ##__VA_ARGS__)
-#define error(condition, type, message, ...) \
-  _error(shouldDebug, condition, type, __FILE__, __LINE__, __func__, message, ##__VA_ARGS__)
+#define debug(message, ...) _debug(shouldDebug, __FILE__, __LINE__, __func__, message, ##__VA_ARGS__)
+#define altDebug(message, ...) _altDebug(shouldDebug, message, ##__VA_ARGS__)
+#define error(condition, type, message, ...) _error(shouldDebug, condition, type, __FILE__, __LINE__, __func__, message, ##__VA_ARGS__)
+#define warn(condition, message, ...) _warn(condition, __FILE__, __LINE__, __func__, message, ##__VA_ARGS__)
 // you must edit this two values if you want to add suport for an editor
 extern const char *supportedEditor[]; // array of supported editors
-extern const int numEditors; // number of supported editors
+extern const int numEditors;          // number of supported editors
 
-
-//compares two strings alphabetically.
-//this function is used for qsort
+// compares two strings alphabetically.
+// this function is used for qsort
 int compareString(const void *a, const void *b);
 // compares two strings in reversed alphabetical order
 // this function is used for qsort
 int reverseCompareString(const void *a, const void *b);
+// checks if editor is supported and if it installed.
 // this basically checks all the dirs from your path for the editor. This is a safety check.
-// If the executable from an editor is not the editor name (for example neovim and nvim), you must handle at the start of the function.
-int doesEditorExist(char *editorToCheck, int debug);
+// If the executable from an editor is not the editor name (for example neovim and nvim), you must
+// handle at the start of the function. This can return an error and stop the program.
+int isEditorValid(char *editorToCheck, int useDefaultEditor, int debug);
 // please use the macro debug instead of _debug.
-//formated debugging.
+// formated debugging.
 void _debug(const int d, const char *file, const int line, const char *function, const char *message, ...);
-//use for less formal debuggin. (usefull if enumerating or making a list).
+// use for less formal debuggin. (usefull if enumerating or making a list).
 void _altDebug(const int d, const char *message, ...);
 // formated error.
 void _error(const int shouldDebug, const int condition, const char *type, const char *file, const int line, const char *function, const char *message, ...);
+// formated warn
+void _warn(const int condition, const char *file, const int line, const char *function, const char *message, ...);
 // Returns 1 if the string is in the array.
 // Returns 0 if the string is not in the array.
 // If you want to only check the first n elements of the array, pass n as len.
@@ -63,8 +69,8 @@ void appendToFile(const char *path, const char *string, const int shouldDebug);
 // replace unwanted chars by '_'.
 // '.' is replaced if it is only the first two chars
 void sanitize(char *string);
-//from https://stackoverflow.com/a/5467788.
-//deletes an entire directory. Use with parsimony and carefullness.
+// from https://stackoverflow.com/a/5467788.
+// deletes an entire directory. Use with parsimony and carefullness.
 int rmrf(char *path, int shouldDebug);
 // Inputs are the path to the file, the editor to open and some rendering option.
 // render: if we render the .md file with Vivify.
@@ -77,6 +83,19 @@ int openEditor(char *path, char *editor, int render, int shouldJumpToEndOfFile,
 char *getFormatedTime(char *format, int shouldDebug);
 /* Caclulates if we need to do another backup (by reading ~/.cache/NoteWrapper/backupTime.txt.
 If need launches in the background rsync to do the backuping.
-rsyncArgs is the array of arguments to be passed to rsync. Do not inclue destination or source. It will be added in the function.*/
-void handleBackups(const char *pathOfVaults, const char *pathOfBackup, const char *homeDir, const int interval, const char **rsyncArgs, const int rsyncArgsNumber,  const int shouldDebug);
+Each pair of source/destination will launch one rsync process.
+If a pair don't need to be backed up, the destination should be set to NULL.
+rsyncArgs is the array of arguments to be passed to rsync. Do not inclue destination or source. It
+will be added in the function.
+backupMessage will be set to 1 if a backup was launched.*/
+void handleBackups(char **sourceDirectoryArray, const int sourceDirectoryNumber, char **destinationDirectoryArray, const char *homeDir, const int interval, const char **rsyncArgs, const int rsyncArgsNumber,
+                   const int forceBackup, int *backupMessage, const int shouldDebug);
+/*Equivalent of git init.
+If the directory wasn't git initialized. We do it.*/
+void ensureGitDirectory(const char *path, const char *vault, const char *signatureName, const char *signatureEmail, const int shouldDebug);
+/*Configures git, stages everything, commits everything*/
+void gitBackupUpdate(const char *path, const char *vault, const char *signatureName, const char *signatureEmail, const char *commitMsg, const int shouldDebug);
+// yyyy-mm-dd hh:mm:ss
+// Don't forget to free the pointer.
+char *getDateAndTime();
 #endif