Скачать Stroika - Скачать исходный код Stroika

Stroika

Данные веб-сайта

v2.1.15)

Скачать

Stroika v3 - современный C ++ сделал легко

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

Фрагменты кода / примеры

String Class облегчает Unicode

String a = u8" abc " ;
String b = u32 " abc " ;
CallFunction (a+b);
// trim whitespace, and convert to u16string for some legacy API
std::u16string uuu = (a+b).Trim ().As<u16string>();
// tokenize
String t{ " ABC DEF G " };
Assert (t.Tokenize ()[1] == "DEF");

_f строки, формат C ++ 20, работает с типами Stroika и проще в использовании

 // most Stroika types automatically support formattable<>
DbgTrace ( " v = {} " _f, v);   // to a tracelog file, or debugger
cerr << " v = {} " _f (v) << endl;   // OR iostreams (unicode mapped automatically)

Итерабильный - простые в использовании функциональных API на всех итерациях, аналогично C# linq

 // nb: String is an Iterable<Character>, 
// despite internally representing the characters very differently
bool IsAllWhitespace (String s) const
{
  return not s. Find ([] (Character c) -> bool { return not c. IsWhitespace (); });
}

Iterable< int > c { 1 , 2 , 2 , 5 , 9 , 4 , 5 , 6 };
EXPECT_TRUE (c.Distinct ().SetEquals ({ 1 , 2 , 4 , 5 , 6 , 9 }));

Iterable< int > c { 3 , 4 , 7 };
// Map iterates over 'c' and produces the template argument container
// automatically by appending the result of each lambda application
EXPECT_EQ ((c.Map<vector<String>> ([] ( int i) { return " {} " _f (i); }), vector<String>{ " 3 " , " 4 " , " 7 " }));

Контейнеры

Корова (копия на записи часто значительно повышает производительность для большинства распространенных случаев)
API, определяемые шаблоном доступа, например, Stack = push/pop, последовательность = Array-Like Access, map = {for: to} и т. Д.

Репрезентативная прозрачность

Stroika предоставляет богатый набор контейнеров -архипов и импляций структуры данных.

 extern void f (Set< int >);
// use the default Set<> representation - the best for type 'int'
Set< int > s{ 1 , 2 , 3 };
f (s);  // data not actually copied - Stroika containers use 'copy-on-write (COW)'
s = Concrete::SortedSet_SkipList< int >{s}; // Use a skiplist to represent the set
f (s);  // call f the same way regardless of data structure used for implementation
// set equality not order dependent (regardless of data structure)
Assert (s == { 2 , 3 , 1 });

См. Пример контейнеров для получения более подробной информации

Потоки и ObjectVarianTMapper

MyClass someObject = ...;
VariantValue v = mapper.FromObject (someObject);   // Map object to a VariantValue

// Serialize using any serialization writer defined in 
// Stroika::Foundation::DataExchange::Variant (we selected JSON)
Streams::MemoryStream:: Ptr <byte> tmpStream = Streams::MemoryStream::New<byte> ();
Variant::JSON::Writer{}.Write (v, tmpStream);

// You can persist these to file if you wish
{
    using namespace IO ::FileSystem ;
    FileOutputStream:: Ptr tmpFileStream =
        FileOutputStream::New ( WellKnownLocations::GetTemporary () / " t.txt " );
    Variant::JSON::Writer{}. Write (v, tmpFileStream);
}

См. Пример сериализации для получения более подробной информации

Встроить веб -сервицы в вашем приложении

Route{ " variables/(.+) " _RegEx,
      // explicit message handler
      [ this ] (Message& m, const String& varName) {
          WriteResponse (m. rwResponse (), kVariables_ , kMapper . FromObject ( fWSImpl_ -> Variables_GET (varName)));
      }},
  Route{HTTP::MethodsRegEx:: kPost , " plus " _RegEx,
      // automatically map high level functions via ObjectVariantMapper
      ObjectRequestHandler::Factory{ kBinaryOpObjRequestOptions_ ,
                                    [ this ] (Number arg1, Number arg2) { return fWSImpl_ -> plus (arg1, arg2); }}},

Смотрите образец веб -сервисов для получения более подробной информации.

Потоки абстракции

Сделает сжатие, шифрование, ввождение, сеть, обработка данных, все это сочетается друг с другом, кажется,

 // @todo INCOMPLETE - BAD EXAMPLE---
const OpenSSL::DerivedKey kDerivedKey =
     OpenSSL::EVP_BytesToKey{ OpenSSL::CipherAlgorithms::kAES_256_CBC (), OpenSSL::DigestAlgorithms:: kMD5 , " password " };
const Memory::BLOB srcText =
  Memory::BLOB::FromHex ( " 2d ... " ); // ...
// EncodeAES takes a stream, and produces a stream
// which can be chained with the gzip Transformer, which takes a stream, and produces a
Compression::GZip::Compress::New ().Transform (EncodeAES ( kDerivedKey , srcText.As<Streams::InputStream:: Ptr <byte>> (), AESOptions::e256_CBC))

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

Стилистически, Stroika отличается от стандартной библиотеки C ++, Boost и многих других библиотек C ++, тем, что она (относительно) охватывает объектно-ориентированные абстракции по общей общей шаблонам (см. Stroika-repach-to-Performance.md). Абстракция иерархий типа лучше подходит для того, как люди разумны, а шаблоны и концепции - хотя и мощные - могут быть неясными и неясными намерениями программиста. Кроме того, Stroika подчеркивает отделение интерфейса от реализации: тщательно документирование интерфейса в заголовках и разделение реализации на другие файлы.

Stroika состоит из 2 слоев: фундамент, который предоставляет классы блока здания, применимые к большинству приложений, и серию доменных структур, которые обеспечивают богатую коллекцию кода в разных областях.

alt text

Рамки зависят от фундамента; Фонд -модули часто зависят друг от друга; Но код слоя фундамента не содержит зависимости за пределами фундамента (за исключением стандартной библиотеки C ++, а также различные библиотеки третьей частично -компоненты, при необходимости, включенные или упоминаемые, как OpenSSL).

Быстрый старт

Не хочу читать - просто хочу кодировать. Шаг за шагом

Quick-start.md

Качество

Почти все публичные интерфейсы и методы хорошо документированы; Реализации ясны и хорошо прокомментированы.
Тщательно интегрированные утверждения (включая утверждения безопасности потоков) помогают документировать и обеспечить соблюдение моделей использования (без затрат на производительность в сборках).
Каждый выпуск тестируется с помощью Valgrind (Memcheck), Google Sanitizers (TSAN, UBSAN, утечка и ASAN), GitHub CodeQL и различными платформами и компиляторами, а также большим количеством тестов регрессии (включая большинство примеров документации), чтобы обеспечить правильность библиотеки.
Примеры приложений помогают показывать общие варианты использования (например, создание веб-сервера в ваше приложение для доставки контента и API в веб-сервисе).
Быстрое начните с использованием предварительно построенных контейнеров Docker (для Windows и Linux).

Фонд Stroika предоставляет

Классы кэша (различные стратегии кэширования/заметки непосредственно поддерживаются).
Классы персонажей (простые в использовании - особенно с классом Unicode - Strings, с функциональными отображками стиля и утилитой ToString () для большинства объектов Stroika).
Классы контейнеров (сбор, очередь, картирование, последовательность, набор и многое другое, каждый с богатым разнообразием реализаций бэкэнд).
DataExchange (VariantValue, богатый сбор данных по формату данных Serializer/Deserializers - как JSON, XML, объект/из/из сопоставления сериализации и многое другое).
Классы шаблонов выполнения (внешний процесс бегуна, шаблоны синхронизации, блокировка очереди, пулы потоков и многое другое).
Сетевая поддержка (гнездовые обертки высокого уровня, извлечение веб -клиентов).
Простая, элегантная библиотека потоков, с адаптерами для криптографии, сжатия, текстовых преобразований и т. Д.
Бесплатная интеграция (объектно -ориентированные обертки, уважающие правила безопасности и адаптеров Строики) со многими важными библиотеками, включая: Boost, Libcurl, LZMA SDK, OpenSSL, SQLite, Xerces, Zlib (например, поток сжатия - используя, например, Zlib).
И еще ...

Stroika Frameworks предоставляет

измерение сети
SSDP/UPNP
мониторинг производительности системы
Текстовое редактирование/текстовый процессор
веб -сервер
веб -сервисы
И еще ...

Компромиссы

Самая большая сила Строики - это также самая большая слабость:

Есть меньшие, более сфокусированные библиотеки, которые делают многие вещи, которые делает Строка. Одиночная цель - это форма модульности (хорошего) и позволяет легко внедрить/интеграцию. Но библиотеки, которые делают что -то из любой сложности, должны создавать свою собственную инфраструктуру для широкого спектра проблем строительных блоков (например, у Xerces есть свои собственные классы потока, классы даты Pistache и т. Д.). И если у вас есть две такие библиотеки, они вряд ли будут взаимодействовать, кажется, и их классы поддержки (для таких вещей, как дата и потоки выше), безусловно, не будут.
Stroika использует подход к созданию своей функциональности в слоях, используя другие компоненты (например, потоки и контейнеры) в нижних слоях (а также стандартизированные библиотеки C ++). Это немного увеличивает стоимость принятия Строики для чего -то маленького (потому что вытягивание одной вещи во многих вещах), но затем выплачивает дивиденды, используя ее для выполнения второй или третьей задачи.

Версии (основные ветви)

Stroika v3 в активной разработке ( не стабильной ) и требует C ++ 20 или более поздней.
Stroika v2.1 является стабильной (в обслуживании) и требует C ++ 17 или более поздней версии. Версия 2.1 также условно поддерживает многие функции C ++ 20 (например, трехсторонний соблюдение и т. Д., Если таковые имеются).
Stroika v2.0 очень стабилен и требует C ++ 14 или более поздней версии. Stroika v2.0 используется для питания широкого спектра открытых и коммерческих приложений.

Компиляторы / платформы регулярно протестируются / поддерживаются

Linux, macOS, Windows
Stroika v3
TBD, но пока выглядит как VS2K22 (17,9) или позже в Windows, Xcode 15 (.2) или более позднее на macOS, и G ++ 11 или более поздней версии, и Clang ++ 15 или более поздней версии.
Stroika v2.1
Протестировано на x86, ARM (+M1), GCC 8 Thru GCC 12, Clang 6 Thru Clang 14, Visual Studio.net 2017, Visual Studio.net 2019 и Visual Studio.net 2022, Xcode 13, 14, 15.
Stroika v2.0
Протестировано на x86, ARM, GCC 5 через GCC 8, Clang 3 Thru Clang 6, Xcode 8 Tru 9.