xtd
Modern C++17/20 framework to create console (CLI), forms (GUI like WinForms) and tunit (unit tests like Microsoft Unit Testing Framework) applications on Windows, macOS, Linux, iOS and android (*).
(*) See portability for more information.
Continuous Integration build status
TEMPORARILY DISABLED.
We are actively looking for a solution.
Features
- Free and open-source (MIT License);
- a collection of native C++ classes libraries, to complete std;
- API close to the .net API with a modern C++ approach and full integration with the std standard;
- written in efficient, modern C++17 / C++20 with RAII programming idiom;
- and highly portable and available on many different platforms;
For more information see
Examples
The classic first application 'Hello World'.
Console (CLI)
hello_world_console.cpp
#include <xtd/xtd>
using namespace xtd;
int main() {
console::background_color(console_color::blue);
console::foreground_color(console_color::white);
console::write_line("Hello, World!");
}
CMakeLists.txt
cmake_minimum_required(VERSION 3.3)
project(hello_world_console)
find_package(xtd REQUIRED)
add_sources(hello_world_console.cpp)
target_type(CONSOLE_APPLICATION)
Build and run
Open "Command Prompt" or "Terminal". Navigate to the folder that contains the project and type the following:
xtdc run
Output
Hello, World!
Forms (GUI like WinForms)
hello_world_forms.cpp
#include <xtd/xtd>
using namespace xtd::forms;
class main_form : public form {
public:
main_form() {
text("Hello world (message_box)");
button1.location({10, 10});
button1.parent(*this);
button1.text("&Click me");
button1.click += [] {
message_box::show("Hello, World!");
};
}
private:
button button1;
};
int main() {
application::run(main_form());
}
CMakeLists.txt
cmake_minimum_required(VERSION 3.3)
project(hello_world_forms)
find_package(xtd REQUIRED)
add_sources(hello_world_forms.cpp)
target_type(GUI_APPLICATION)
Build and run
Open "Command Prompt" or "Terminal". Navigate to the folder that contains the project and type the following:
xtdc run
Output
Windows
macOS
Linux Gnome
tunit (Unit tests like Microsoft Unit Testing Framework)
hello_world_test.cpp
#include <xtd/xtd>
#include <string>
using namespace std;
using namespace xtd::tunit;
namespace unit_tests {
class test_class_(hello_world_test) {
public:
void test_method_(create_string_from_literal) {
string s = "Hello, World!";
valid::are_equal(13, s.size());
assert::are_equal("Hello, World!", s);
}
void test_method_(create_string_from_chars) {
string s = {'H', 'e', 'l', 'l', 'o', ',', ' ', 'W', 'o', 'r', 'l', 'd', '!'};
valid::are_equal(13, s.size());
string_assert::starts_with("Hello,", s);
string_assert::ends_with(" World!", s);
}
};
}
int main() {
return console_unit_test().run();
}
CMakeLists.txt
cmake_minimum_required(VERSION 3.3)
project(hello_world_test)
find_package(xtd REQUIRED)
add_sources(hello_world_test.cpp)
target_type(TEST_APPLICATION)
Build and run
Open "Command Prompt" or "Terminal". Navigate to the folder that contains the project and type the following:
xtdc run
Output
Start 2 tests from 1 test case
Run tests:
SUCCEED hello_world_test.create_string_from_literal (0 ms total)
SUCCEED hello_world_test.create_string_from_chars (0 ms total)
Test results:
SUCCEED 2 tests.
End 2 tests from 1 test case ran. (0 ms total)
Getting Started
- Installation provides download and install documentation.
- Portability provides information about C++, libraries dependency, Operating System supported, Compilers and Development Environment tools.
- Tutorials provides xtd tutorials.
- Examples provides some examples.
Development status
- Development status provides information about classes and libraries development status.
- Translation status provides information about translations status.
- Roadmap provides xtd roadmap.
- Release notes provides release notes information.
This project is an open source project. The developers who participate do so on their own time. It is therefore difficult to fix realese dates.
But you can follow the evolution of the development. We keep the status up to date.
Contributing
The authors file lists contributors together with contact information. If you make a contribution, please add yourself to the list.
Your contributions are welcome.
- First read Code of conduct and the design guidelines to make sure your contribution follows the rules.
- Fork the project and use a pull request for adding your contribution.
- If you face any problems feel free to open an issue at the issues tracker, If you feel like there is a missing feature, please raise a ticket on Github. Pull request are also welcome.
Your feedback is important for the evolution of the project.
Gallery
xtdc-gui - Create a new project (on macOS)
![[BUG] xtd.tunit - Invalid links in xtd/examples/xtd.tunit.examples/README.md](https://avatars.githubusercontent.com/u/4800120?v=4)
![[BUG] Problems of installing xtd in Arch linux and distributions that are based on it](https://avatars.githubusercontent.com/u/77543518?v=4)
![[QUESTION] Cmake Error install(error installing..)](https://avatars.githubusercontent.com/u/79837660?v=4)
list error in TXT file:
![[BUG] xtd.tools - xtdc fails to generate new project by path only](https://avatars.githubusercontent.com/u/49657842?v=4)
![[BUG] can not build](https://avatars.githubusercontent.com/u/45621970?v=4)
![[BUG] When resizing xtdc-gui, the graphics get messed up](https://avatars.githubusercontent.com/u/42293979?v=4)
![[BUG] xtd-gui doesn't launch on Linux](https://avatars.githubusercontent.com/u/20720267?v=4)
86.8k Dec 29, 2022
2 Feb 10, 2022
2 Dec 23, 2021
237 Dec 18, 2022
34 Oct 1, 2022
24 Dec 18, 2022
3 Jun 17, 2022
1 Oct 17, 2021
135 Jan 2, 2023
1.7k Dec 30, 2022
18 Dec 7, 2022
2k Jan 1, 2023
439 Dec 31, 2022
0 Apr 1, 2022
1 Oct 31, 2021
2 Nov 15, 2021
1 Nov 28, 2021
274 Jan 2, 2023