Jinja2Cpp
1.3.2
C ++ Implementierung der Jinja2 Python Template Engine. Diese Bibliothek unterstützt leistungsstarke Jinja2 -Vorlagenfunktionen in die C ++ - weltweit, berichtet dynamische HTML -Seiten und Quellcodegenerierung.
Hauptmerkmale von Jinja2c ++:
with set for if , filter , do ).Zum Beispiel dieser einfache Code:
# include < jinja2cpp/template.h >
std::string source = R"(
{{ ("Hello", 'world') | join }}!!!
{{ ("Hello", 'world') | join(', ') }}!!!
{{ ("Hello", 'world') | join(d = '; ') }}!!!
{{ ("Hello", 'world') | join(d = '; ') | lower }}!!!
)" ;
Template tpl;
tpl.Load(source);
std::string result = tpl.RenderAsString({}).value();erzeugt die Ergebniszeichenfolge:
Helloworld!!!
Hello, world!!!
Hello; world!!!
hello; world!!!
Um Jinja2c ++ in Ihrem Projekt zu verwenden, müssen Sie:
Die Verwendung von Jinja2c ++ im Code ist ziemlich einfach:
jinja2::Template tpl;tpl.Load( " {{ 'Hello World' }}!!! " );std::cout << tpl.RenderAsString({}).value() << std::endl;und bekommen:
Hello World!!!
Das ist alles!
Detailliertere Beispiele und Funktionen Beschreibung finden Sie in der Dokumentation: https://jinja2cpp.github.io/docs/usage
Derzeit unterstützt Jinja2c ++ die begrenzte Anzahl von Jinja2 -Funktionen. Übrigens ist Jinja2c ++ ein vollständig Jinja2-Spezifikations-Konformant. Die aktuelle Unterstützung ist beschränkt auf:
Vollständige Informationen zu Jinja2 Spezifikationsunterstützung und Kompatibilitätstabelle finden Sie hier: https://jinja2cpp.github.io/docs/j2_compatibility.html.
Zusammenstellung von Jinja2c ++, die auf den folgenden Compilern getestet wurden (mit C ++ 14 und C ++ 17 -fähigen Funktionen):
Hinweis: Die Unterstützung der GCC -Version> = 9.x oder Clang Version> = 8.0 hängt von der Version der bereitgestellten Boost -Bibliothek ab.
| Compiler | Status |
|---|---|
| MSVC 2015 (x86, x64), Mingw 7 (x64), Mingw 8 (x64) | |
| X-Code 9, 10, 11 | |
| MSVC 2017 (x86, x64), MSVC 2019 (x86, x64), C ++ 14/C ++ 17 | |
| G ++ 5, 6, 7, 8, 9, 10, 11 Klang 5, 6, 7, 8, 9, 10, 11, 12 C ++ 14/c ++ 17/c ++ 20 |
Jinja2c ++ hat mehrere externe Abhängigkeiten:
boost Library (mindestens Version 1.65)nonstd::expected-lite https://github.com/martinmoene/exward-litenonstd::variant-lite https://github.com/martinmoene/variant-litenonstd::optional-lite https://github.com/martinmoene/optional-litenonstd::string-view-lite https://github.com/martinmoene/string-view-litefmtlib::fmt https://github.com/fmtlib/fmtBeispiele für Build-Skripte und verschiedene Build-Konfigurationen finden Sie hier: https://github.com/jinja2cpp/examples-build
Im einfachsten Fall müssen Sie Jinja2c ++ kompilieren: Sie benötigen:
> git clone https://github.com/flexferrum/Jinja2Cpp.git
> cd Jinja2Cpp
> mkdir build
> cd build
> cmake .. -DCMAKE_INSTALL_PREFIX=<path to install folder>
> cmake --build . --target all
"Pfad zum Installieren von Ordner" hier ist ein Pfad zum Ordner, in dem Sie Jinja2c ++ lib installieren möchten.
> cmake --build . --target install
In diesem Fall wird Jinja2c ++ mit intern aufgeschlossenen Abhängigkeiten gebaut und installiert. Jinja2c ++ unterstützt jedoch Builds mit extern bereitgestellten DEPs.
Jinja2c ++ kann als Conan.io -Paket verwendet werden. In diesem Fall sollten Sie die folgenden Schritte ausführen:
jinja2cpp/1.2.1 oder cmakelists Zum Beispiel könnte es mit der Verwendung der conan-cmake Integration auf diese Weise geschrieben werden: cmake_minimum_required ( VERSION 3.24)
project (Jinja2CppSampleConan CXX)
list ( APPEND CMAKE_MODULE_PATH ${CMAKE_BINARY_DIR} )
list ( APPEND CMAKE_PREFIX_PATH ${CMAKE_BINARY_DIR} )
add_definitions ( "-std=c++14" )
if ( NOT EXISTS " ${CMAKE_BINARY_DIR} /conan.cmake" )
message ( STATUS "Downloading conan.cmake from https://github.com/conan-io/cmake-conan" )
file (DOWNLOAD "https://raw.githubusercontent.com/conan-io/cmake-conan/0.18.1/conan.cmake"
" ${CMAKE_BINARY_DIR} /conan.cmake"
TLS_VERIFY ON )
endif ()
include ( ${CMAKE_BINARY_DIR} /conan.cmake)
conan_cmake_autodetect(settings)
conan_cmake_run(REQUIRES
jinja2cpp/1.1.0
gtest/1.14.0
BASIC_SETUP
${CONAN_SETTINGS}
OPTIONS
jinja2cpp/*:shared= False
gtest/*:shared= False
BUILD missing)
set (TARGET_NAME jinja2cpp_build_test)
add_executable ( ${TARGET_NAME} main.cpp)
target_link_libraries ( ${TARGET_NAME} ${CONAN_LIBS} )
set_target_properties ( ${TARGET_NAME} PROPERTIES
CXX_STANDARD 14
CXX_STANDARD_REQUIRED ON )
Sie können (über -d -Befehlszeilen -CMake -Option) definieren. Die folgenden Build -Flags:
internal diesem Modus ist Jinja2c ++ Build -Skript in diesem Modus Abhängigkeiten (include boost ) als Unterprojekt verwendet. Es muss extern nichts zur Verfügung gestellt werden.external-boost in diesem Modus Jinja2c ++ Build Skript verwendet nur boost als extern bereitgestellte Abhängigkeit. Alle anderen Abhängigkeiten stammen aus Unterprojekten.external alle Abhängigkeiten sollten extern bereitgestellt werden. Pfade zum boost , nonstd-* libs usw. sollte über Standard-CMake-Variablen angegeben werden (wie CMAKE_PREFIX_PATH oder libname_dir)conan-build Spezialmodus zum Bau von Jinja2c ++ über Conan-Rezept. Jinja2c ++ versucht Standardversionen von std::variant , std::string_view und std::optional , wenn möglich.
Vielen Dank an @Flexferrum für die Erstellung dieser Bibliothek, für die einer der klügsten Köpfe in der Software -Engineering -Community. Ruhe in Frieden, Freund.
Vielen Dank an @Manu343726 für CMake -Skripte Verbesserung, Fehlerjagd und Reparatur und Conan.io -Verpackung.
Vielen Dank an @Martinmoene für die perfekt implementierten XXX-Lite-Bibliotheken.
Vielen Dank an @vitaut für die erstaunliche Textformatierungsbibliothek.
Vielen Dank an @Martinus für die Implementierung von Fast Hash Maps.
batch hinzugefügtslice hinzugefügtformat hinzugefügttojson Filter hinzugefügtstriptags -Filter hinzugefügtcenter hinzugefügtxmlattr -Filter hinzugefügtraw / endraw -Tags hinzugefügt'a' * 5 produziert 'aaaaa' ))meta / endmeta -Tags) hinzugefügt-fPIC Flag zur Linux -Build -Konfiguration hinzugefügt block , wenn das Kind diesen Block nicht überschreibtvariant , string_view und optionaldefault zum map (#48) hinzugefügtGenericList -Typ verwendet werden (Nr. 66)Valuefilter -Tag -Unterstützung, die dem Vorlage Parser hinzugefügt wurden (#44)escape -Filterunterstützung, der dem Vorlage Parser hinzugefügt wurde (#140)capitalize den Filterunterstützung, der dem Vorlage -Parser hinzugefügt wurde (#137)set -Tags, das dem Parser hinzugefügt wurde (#45)loop.depth und loop.depth0 Variablen unterstützen hinzugefügtTemplateEnv implementiert*context akzeptieren| ) Bediener Vorrang (#47)endblock -Tag festgelegtinclude und for TagsJINJA2CPP_MSVC_RUNTIME_TYPE cmake -Variable definiertinclude , import und from implementierten Anweisungen. Jetzt ist es möglich, andere Vorlagen einzubeziehen und Makros aus anderen Vorlagen zu verwenden.with implementierter Erklärungdo -Erklärung implementiertRenderAsString -Methode gibt jetzt nonstd::expected anstelle von normalem std::string zurückinclude extends import TemplateEnvexternal Abhängigkeitsverwaltungsmodus konfiguriertapplymacro -Filter hinzugefügt, mit dem das Anwendung beliebiger Makro als Filter angewendet wird
