About

Cross-platform flexible autocomplete library for your CLI applications

Features

• Cross-platform: MacOS, Linux, Windows
• Write your own autocomplete rules
• Setup your own highlight colors
• single header version of the library
• static and dynamic versions of the library

Config Example

1. After git may follow: config, init, clone
2. After config may follow: --global, user.name, user.email
3. After --global may follow: user.name, user.email
4. After user.name may follow optional value: "[name]"
5. ...

git
config
--global
user.name
"[name]"
user.email
"[email]"
user.name
"[name]"
user.email
"[email]"
init
[repository_name]
clone
[url]

Simple Example

More complex example with: color settings, handling optional values and line title configurationyou will find here

#include<stdio.h>
#include"../include/autocomplete.h"intmain() {
// Parsing the configuration file
Tree* rules = tree_create("../example.config");
fprintf(
stderr,
"Attention! Please run the executable file only\n"" through the command line!\n\n""- To switch the prompts press UP or DOWN arrow.\n""- To move cursor press LEFT or RIGHT arrow.\n""- To edit input press DELETE or BACKSPACE key.\n""- To apply current prompt press TAB key.\n\n"
);
// Listening processwhile (1) {
// Get user inputchar* str = input(rules);
printf("\n%s\n", str);
// Stop listening if user needif (strcmp(str, "") == 0) {
free(str);
break;
}
// Free user input stringfree(str);
}
// Free rulestree_free(rules);
return0;
}

How to start

git clone https://github.com/DieTime/CLI-AutoComplete.git
cd CLI-AutoComplete/
cmake -DCMAKE_BUILD_TYPE=Release -S . -B ./cmake-build
cmake --build ./cmake-build --config Release
----------------------- RUN EXAMPLE ---------------------
# Unixcd builds/examples/unix/Release
./custom_example
# MinGWcd builds/examples/mingw/Release
custom_example.exe
# MSVCcd builds/examples/msvc/Release
custom_example.exe

Linking a shared library [Releases]

Unix

gcc -o <executable><paths/of/source/files> -L<path/to/shared/lib/folder> -I<path/to/include/folder> -lcliac -Wl,-rpath,<path/to/shared/lib/folder>

Windows MSVC from VS Command Prompt

cl /EHsc <paths/of/source/files> /Fe<executable>.exe /I<path/to/include/folder> /link <path/to/shared/lib/file(.lib)>

Windows MinGW

gcc -o <executable>.exe <paths/of/source/files> -L<path/to/shared/lib/folder> -I<path/to/include/folder> -lcliac

Linking a static library [Releases]

Unix

gcc -o <executable><paths/of/source/files> -L<path/to/static/lib/folder> -I<path/to/include/folder> -lcliac

Windows MSVC from VS Command Prompt

cl /EHsc <paths/of/source/files> /Fe<executable>.exe /I<path/to/include/folder> /link <path/to/static/lib/file(.lib)>

Windows MinGW

gcc -o <executable>.exe <paths/of/source/files> -L<path/to/static/lib/folder> -I<path/to/include/folder> -lcliac

About changes

A detailed description of the changes can be found in CHANGELOG.md

Support the author

You can support me so that there will be more good open source projects in the future