Loading repository data…
Konvt / repository
A powerful and high-performance terminal progress bar for Modern C++.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
include/pace/.tqdm-like interface: Chainable methods powered by template metaprogramming.{LeftBorder}{Prefix}{Percent}{Starting}{Filler}{Lead}{Remain}{Ending}{Counter}{Speed}{Elapsed}{ETA}{Postfix}{RightBorder}
30.87% | [=========> ] | 662933732/2147483647 | 11.92 MHz | +00:00:55 | -00:02:03
{LeftBorder}{Prefix}{Percent}{Starting}{Filler}{Lead}{Remain}{Ending}{Counter}{Speed}{Elapsed}{ETA}{Postfix}{RightBorder}
35.22% | ██████████▋ | 47275560/134217727 | 16.80 MHz | +00:00:02 | -00:00:05
{LeftBorder}{Prefix}{Lead}{Percent}{Counter}{Speed}{Elapsed}{ETA}{Postfix}{RightBorder}
\ | 48.64% | 65288807/134217727 | 17.84 MHz | +00:00:03 | -00:00:03
{LeftBorder}{Prefix}{Percent}{Starting}{Filler}{Lead}{Filler}{Ending}{Counter}{Speed}{Elapsed}{ETA}{Postfix}{RightBorder}
39.82% | [-------<=>--------------------] | 53458698/134217727 | 17.89 MHz | +00:00:02 | -00:00:04
{LeftBorder}{Prefix}{Percent}{Starting}{Filler}{Lead}{Filler}{Ending}{Counter}{Speed}{Elapsed}{ETA}{Postfix}{RightBorder}
73.93% | [ ==== ] | 99224978/134217727 | 81.02 MHz | +00:00:01 | -00:00:00
#include "pace/ProgressBar.hpp"
int main()
{
pace::ProgressBar<> bar { pace::option::Remain( "-" ),
pace::option::Filler( "=" ),
pace::option::Except<>(),
pace::option::RemainForecolor( "#A52A2A" ),
pace::option::FillerForecolor( 0x0099FF ),
pace::option::InfoForecolor( pace::Color::Yellow ),
pace::option::Quota( 100 ) };
for ( auto _ = 0; _ < 100; ++_ )
bar.tick();
}
For more examples, see GUIDE.md and demo/.
If the CMake version is greater than 3.11, you can use FetchContent to automatically import project dependencies.
Add the following lines to your CMakeLists.txt:
include(FetchContent)
FetchContent_Declare(
pace
GIT_REPOSITORY https://github.com/Konvt/pace.git
GIT_TAG main # the stable branch
)
FetchContent_MakeAvailable(pace)
# ...
target_link_libraries(YourProject PRIVATE pace::pace)
Download the release package (zip file) from Releases.
Unzip the compressed package and add the following code at the corresponding position in the CMakeLists.txt file of the project:
# If the decompressed files are placed in a path that CMake can directly search, the following line is not needed.
list(APPEND CMAKE_PREFIX_PATH "path/to/package/lib/cmake")
find_package(pace CONFIG REQUIRED)
# ...
add_executable(YourProject ${SOURCES})
target_link_libraries(YourProject PRIVATE pace)
Use git to introduce pace as a sub-module into your project directory:
git submodule add https://github.com/Konvt/pace path/to/pace
git submodule update --init --recursive
Then, add the following lines to your CMakeLists.txt:
add_subdirectory(path/to/pace)
# ...
add_executable(YourProject ${SOURCES})
target_link_libraries(YourProject PRIVATE pace)
Note: The
mainbranch ofpaceis the stable version. If you need the latest updates, you can switch to thenightlybranch:
cd path/to/pace
git checkout nightly
The sample files under demo/ can be compiled using the following commands.
cmake -S . -DPACE_BUILD_DEMO=ON -B build
cmake --build build --target demo
# Or use demo_{filename} to compile the specified file under demo/
Or compile directly using the make command in the demo/ folder.
make all
# Or use {filename} to compile the specified file under demo/
Execute the following commands to install pace to the default directory of the system.
cmake -S . -DPACE_INSTALL=ON -B build
# Or install it to the specified directory:
# cmake -S . -DPACE_INSTALL=ON -DCMAKE_INSTALL_PREFIX=/usr -B build
cmake --install build
# Equivalent instructions can be:
# cmake --build build --target install
When uninstalling, it needs to rely on the cache files generated during installation. If the cache files has been removed, the installation command generation can be executed again.
Execute the following commands to remove pace from the system.
cmake --build build --target uninstall
If you are using a compiler that already supports the module feature, you can use the pace.cppm file in the module/ and import it within your project.
When using it officially, be sure to import std in the code file at the same time; otherwise, strange compilation errors will occur as of now.
You can copy include/pace to the inclusion path of the project, and then directly include the corresponding header file within the source file.
No, as mentioned in the Features section, updating the progress bar can essentially be regarded as zero overhead.
In fact, the progress update is based on the average cost. The more tasks there are or the longer the execution time of each task is, the smaller the cost per update will be.
However, the specific performance largely depends on the single-core performance of the processor.
Absolutely. I designed this library to work seamlessly on both systems, providing a unified visualization of iteration progress.
Btw, it should be noted that if it is on the Windows platform, then pace will depend on the Windows.h header file; Moreover, NOMINMAX will be defined to disable the min and max macros.
As pointed out at the beginning, there is no problem.
Although only UTF-8 encoded strings are currently supported, using any non-UTF-8 encoded string will result in an exception.
If you are using the C++20, pace's functions also support u8string.
This project is licensed under the MIT license.
On AMD Ryzen 7 5800H with -Og optimization and Policy::Async execution strategy, tick call overhead measured ≤5ns in tight loop tests. ↩
Selected from shared topics, language and repository description—not editorial ratings.
Fynnius /
A powerful C# library for creating custom stock screeners using TradingView's API. Retrieve market data for stocks, crypto, and forex without web scraping. Features comprehensive filtering, sorting, and a CLI tool for quick market analysis.
76/100 healthitsfuad /
Cp2P is a powerful CLI tool that automatically generates Python bindings for C++ code. It supports multiple compilers and platforms, making it easy to create Python interfaces for your C++ libraries.
47/100 healthmishra9759harshit /
A powerful Windows Diagnostic CLI Tool developed in C language that detects and fixes Windows problems automatically using CMD commands. This tool is designed to streamline troubleshooting, boost system performance, and enhance user experience with a single, easy-to-use interface.
Crown0815 /
ConventionalChangelog is a powerful, lightweight CLI tool built in C#, automating changelog generation from conventional commits in Git repos. Run with one command for structured logs highlighting features, fixes, and breaks. Supports commit relationships, message overrides, and hash display. Ideal for SemVer compliance and consistent docs.
52/100 healthkdcllc /
Streamline access to Azure resources in your local Docker containers with AppAuthentication, a powerful .NET Core CLI tool. Leverage Microsoft Managed Identity for secure, hassle-free authentication. Simplify cloud-native development with C#-based solutions, enabling seamless integration and efficient workflows
30/100 healthlakshaykamat /
A simple yet powerful command-line calculator written in C that supports basic arithmetic operations and advanced mathematical functions with a custom power implementation.
36/100 health