• R/O
  • SSH

libcpptools: Repository summary

This library contains code that extends and simplifies different operations
for C++ language based programs


Recent Commits RSS

Rev. Time Author Message
1c0694d5cc7a 2020-01-10 07:03:35 Sergey Gusarov tip Updated googletest to 1.8.1 release(currently not the lat...
a35ebe744411 2020-01-10 07:02:20 Sergey Gusarov Fixed tests with clang
bc940b7c65c7 2020-01-10 00:16:06 Sergey Gusarov Fixed ctools URL
676089b02ada 2020-01-10 00:14:27 Sergey Gusarov subrepo update
35cbc97bbe9e 2020-01-10 00:11:56 Sergey Gusarov New repo hosting on OSDN
b914b3ee4f11 2020-01-09 23:08:52 Sergey Gusarov README: Added short english description
e9b440edc404 2018-10-10 12:58:24 Sergey Gusarov Some PEP-8 fixes
d80e7665a8fd 2018-10-08 00:14:15 Sergey Gusarov Added SqlQueryException exception
0e42c6bc5086 2018-10-07 12:04:38 Sergey Gusarov subrepo update
5d2fcafc2500 2017-12-11 07:57:28 Sergey Gusarov mingw: Fixed dynamic linking

Recently edited Tags

Name Rev. Time Author
tip 1c0694d5cc7a 2020-01-10 07:03:35 Sergey Gusarov

Branches

Name Rev. Time Author Message
default 1c0694d5cc7a 2020-01-10 07:03:35 Sergey Gusarov Updated googletest to 1.8.1...
exception_ptr c2f9fc911bf0 2015-07-20 02:01:01 s.gusarov Saved exception_ptr wrapper...

README_RU.rst

Общие сведения

Библиотека для упрощения и расширения различных операций в программах на языке C++. Для выполнения низкоуровневых операций полагается полностью на libctools.

Макросы и определения экспортируемые библиотекой имеют префикс CPT. Все переменные, константы и функции располагаются в пространстве имён cpptools.

Состав

  • Поддержка улучшенной иерархии исключений, собирающих stacktrace;
  • Классы для упрощения работы с потоками;
  • Различные функции и классы для улучшения работы в C++ с enum'ами.

Планируется:

  • Расширенная поддержка исключений;
  • Аттрибуты классов.

Использование

libctools находится в интерфейсе этой библиотеки. Тем самым формируется иерархия утилит со сходным назначением, но выполненных на разных языках и в разной парадигме. Тем не менее, активное использование libctools не рекомендуется из-за нарушения парадигмы C++. Ситуация полностью аналогична присутствию заголовочных файлов libc в исходном коде на C++. Они не запрещены, а просто не рекомендуются. И многие программисты их используют от случая к случаю. Предлагается часть таких обращений к libc заменить на обращения к libctools.

Из libctools рекомендуется использовать:

  • Препроцессор и всё что с ним связано (там где возникает в этом потребность). И все изменения связанные с препроцессором вносить в ту библиотеку, тем самым оставляя эту библиотеку максимально свободной от препроцессорных определений;

  • Код связанный с обработкой различных системных ситуаций и обращению к операционной системе. Например:

    • Загрузка/выгрузка динамических библиотек;
    • Получение иерархии вызовов (stack trace);
    • Обработка аварийных ситуаций (posix signals, access violation).

    Современные операционные системы имеют, как правило, С-интерфейс. Поэтому без использования парадигм C на уровне сопряжения с кодом C++ не обойтись. Применение libctools в таких случаях позволяет реализовать повторное использование кода;

  • Механизмы и возможности временно отсутствующие в C++ коде (например, из-за недостатка времени на разработку), как fallback (запасное решение). Например, речь можно вести о развитой системе логирования и трассировки отладочных сообщений.

Как и libctools, эту библиотеку нужно инициализировать и финализировать (здесь обязательно). Для этого используются функции из cpptools.hpp .

Целевые конфигурации

Любые, на которых работают компиляторы C++11 и выше. В настоящее время (конец 2014) нет идеального компилятора, который умеет C++11 на 100%. И такая ситуация, по видимому, сохранится ещё на несколько лет. Плюс иногда нужно работать не с самыми свежими платформами. Поэтому для целей практики решено ввести ограничения на минимально-поддерживаемые версии компиляторов:

  • Microsoft Visual Studio 2010 (примечательна тем, что поддерживает Windows XP) и выше;
  • Gcc 4.7 и выше - TODO;
  • Clang 3.4 и выше - TODO.

Большая часть замечаний из аналогичной секции libctools применима и здесь.

Зависимости

См. аналогичную секцию libctools.

Сборка

Как и для libctools, существует 4 варианта использования библиотеки.

Дополнительно следует отметитить, что для бессборочного метода нужно указать пути для поиска заголовочных файлов include, build_info/include, libctools/include, libctools/build_info/include и линковать все модули из src, libctools/src и подкаталогов src и libctools/src (если таковые нужны).

Если при сборке определён идентификатор CPT_BOOST_SUPPORT, то библиотека будет поддерживать работу с boost. Поддержка boost в настоящее время находится в зачаточном состоянии. Библиотеку boost должен предоставлять внешний проект, который использует libcpptools.

Тестирование

Смотри подкаталог tests.

TODO

Сборка тестов с MS VC++2010

Show on old repository browser