This repository represents the Lynar Studios - Standard Library (ls-std).
Patrick-Christopher Mattulat 1e04fae753 Merge remote-tracking branch 'origin/dev' into dev | 3 years ago | |
---|---|---|
config | 3 years ago | |
doc | 3 years ago | |
include | 3 years ago | |
source | 3 years ago | |
test | 3 years ago | |
.gitignore | 4 years ago | |
CMakeLists.txt | 3 years ago | |
LICENSE.MIT | 4 years ago | |
README.md | 3 years ago |
This is a cross-platform standard library written in C++ offering functionalities you'd usually miss in C++ standard library, especially if you'd search for cross-platform implementations. This library has been tested on Windows, Linux and MacOS systems.
This library provides boxing classes for primitive data types (e.g. string, int, long, float...) to add additional functionalities for each one of them.
To handle file operations - or to receive information of a file - this library provides an own File class implementation, which can also be passed to library implemented input or output stream classes.
This is a collection of very basic functionalities like a base Class which provides minimal reflection like class name. Also, you have the possibility with this collection to fetch this libraries version or even handle own versions for your project.
A Date class comes with this collection, which you can use to represent a date and doing operations on it.
This collection of classes provides some nice functionalities to support your project with some nice logical features, like state machines and observer pattern supporting classes.
Serialization is very important nowadays to persist data. This library offers a serializable interface, which can then be implemented in your project.
In addition to that there is already JSON serialization-based implementation for some public library classes.
This library uses a transitive JSON dependency, which is in line with our license model. Many thanks to Niels Lohmann for writing this nice little library.
To handle XML files this library has an own XML parser implementation, which uses modern C++ features, such as shared pointers.
For logging functionality you might need for your project there is a Logger class coming with this library, which is also able to handle different log level.
With this first implemented milestone of event handling this library provides functionalities for creating and firing events.
This library provides some basic exceptions which can be used in your project to create awareness of certain error behaviour.
A key value file offers the possibility to store simple information pairs in a file. This library provides parsing functionalities for .kv files.
You can find a detailed documentation on Lynar Studios Website: lynarstudios.com
This software is licensed and uses MIT-license. You can find a LICENSE.MIT file inside the project's root directory.
To build this library you'd need a recent version of cmake and your OS specific compiler collection, like gcc, MSVC or AppleClang installed.
Inside project's root directory create the following folder:
cmake_build_release
Open your OS specific command line window and navigate to this new folder and run the following command to configure the project and generate a native build system:
cmake ../
Inside cmake_build_release folder you will now find cmake generated files. To compile the library now, just run:
cmake --build . --config Release
If you would like to add this library to your cmake project - to the CMakeLists.txt file - make sure that you add the libraries' include directory:
include_directories(${CMAKE_CURRENT_LIST_DIR}/path/to/this/library/include)
Then link the library binary file inside your CMakeLists.txt file:
target_link_libraries(... "path/to/this/library/../libls_std_YYYY.MAJOR.MINOR.dll")
This project contains unit tests to accomplish test coverage.
To run those unit tests you have to adjust TestHelper class by adding your personal test folder path to getTestFolderLocation method.
There you have to adjust location variable based on the operating system you're using.