Jinja2Cpp
1.3.2
การใช้งาน C ++ การใช้งานเครื่องยนต์เทมเพลต Jinja2 Python ไลบรารีนี้นำการสนับสนุนของคุณลักษณะเทมเพลต Jinja2 ที่ทรงพลังในโลก C ++ รายงานหน้า HTML แบบไดนามิกและการสร้างซอร์สโค้ด
คุณสมบัติหลักของ jinja2c ++:
set for , if , filter , do , with )ตัวอย่างเช่นรหัสง่าย ๆ นี้:
# 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();สร้างสตริงผลลัพธ์:
Helloworld!!!
Hello, world!!!
Hello; world!!!
hello; world!!!
หากต้องการใช้ Jinja2c ++ ในโครงการของคุณคุณต้อง:
การใช้ Jinja2c ++ ในรหัสนั้นค่อนข้างง่าย:
jinja2::Template tpl;tpl.Load( " {{ 'Hello World' }}!!! " );std::cout << tpl.RenderAsString({}).value() << std::endl;และได้รับ:
Hello World!!!
นั่นคือทั้งหมด!
ตัวอย่างรายละเอียดเพิ่มเติมและคุณสมบัติคำอธิบายสามารถพบได้ในเอกสารประกอบ: https://jinja2cpp.github.io/docs/usage
ปัจจุบัน Jinja2c ++ รองรับคุณสมบัติจำนวน จำกัด ของคุณสมบัติ Jinja2 โดยวิธีการที่ Jinja2c ++ มีการวางแผนว่าจะเป็นข้อกำหนด Jinja2 ที่สอดคล้องกันอย่างเต็มที่ การสนับสนุนในปัจจุบันถูก จำกัด ไว้ที่:
ข้อมูลทั้งหมดเกี่ยวกับการสนับสนุนข้อกำหนด Jinja2 และตารางความเข้ากันได้สามารถดูได้ที่นี่: https://jinja2cpp.github.io/docs/j2_compatibility.html
การรวบรวม JINJA2C ++ ทดสอบบนคอมไพเลอร์ต่อไปนี้ (ด้วยคุณสมบัติที่เปิดใช้งาน C ++ 14 และ C ++ 17):
หมายเหตุ: การสนับสนุนเวอร์ชัน GCC> = 9.x หรือรุ่น Clang> = 8.0 ขึ้นอยู่กับเวอร์ชันของไลบรารี Boost ที่มีให้
| ผู้ประกอบการ | สถานะ |
|---|---|
| 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 Clang 5, 6, 7, 8, 9, 10, 11, 12 C ++ 14/C ++ 17/C ++ 20 |
Jinja2c ++ มีการพึ่งพาภายนอกหลายประการ:
boost Library (อย่างน้อยเวอร์ชัน 1.65)nonstd::expected-lite https://github.com/martinmoene/expected-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/fmtตัวอย่างของการสร้างสคริปต์และการกำหนดค่าการสร้างที่แตกต่างกันสามารถพบได้ที่นี่: https://github.com/jinja2cpp/examples-build
ในกรณีที่ง่ายที่สุดในการรวบรวม jinja2c ++ ที่คุณต้องการ:
> 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
"Path to Install Folder" นี่คือเส้นทางไปยังโฟลเดอร์ที่คุณต้องการติดตั้ง jinja2c ++ lib
> cmake --build . --target install
ในกรณีนี้ Jinja2c ++ จะถูกสร้างขึ้นด้วยการพึ่งพาภายในและติดตั้งตามลำดับ แต่ jinja2c ++ รองรับการสร้างด้วย deps ที่จัดเตรียมไว้ภายนอก
Jinja2c ++ สามารถใช้เป็นแพ็คเกจ Conan.io ในกรณีนี้คุณควรทำตามขั้นตอนต่อไปนี้:
jinja2cpp/1.2.1 ) ลงใน conanfile.txt, conanfile.py หรือ cmakelists.txt ตัวอย่างเช่นด้วยการใช้การรวมของ conan-cmake มันสามารถเขียนได้ด้วยวิธีนี้: 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 )
คุณสามารถกำหนด (ผ่านตัวเลือก CMAKE บรรทัดคำสั่งผ่านคำสั่ง) ธงบิลด์ต่อไปนี้:
internal ในโหมดนี้ jinja2c ++ บิลด์สคริปต์ใช้การพึ่งพาการพึ่งพา (รวม boost ) จัดส่งเป็นโครงการย่อย ไม่จำเป็นต้องจัดเตรียมไว้ภายนอกexternal-boost ในโหมดนี้สคริปต์ Jinja2c ++ Build ใช้ boost เฉพาะการขึ้นอยู่กับการพึ่งพาจากภายนอก การพึ่งพาอื่น ๆ ทั้งหมดมาจากโครงการย่อยexternal ในโหมดนี้ควรมีการพึ่งพาทั้งหมดภายนอก เส้นทางที่จะ boost , nonstd-* libs, ฯลฯ ควรระบุผ่านตัวแปร cmake มาตรฐาน (เช่น CMAKE_PREFIX_PATH หรือ libname_dir)conan-build สำหรับการสร้าง JINJA2C ++ ผ่านสูตร Conan JINJA2C ++ พยายามใช้รุ่นมาตรฐานของ std::variant , std::string_view และ std::optional ถ้าเป็นไปได้
ขอบคุณ @flexferrum สำหรับการสร้างห้องสมุดนี้สำหรับการเป็นหนึ่งในจิตใจที่สว่างที่สุดในชุมชนวิศวกรรมซอฟต์แวร์ พักผ่อนอย่างสงบเพื่อน
ขอบคุณ @Manu343726 สำหรับการปรับปรุงสคริปต์ CMake การล่าแมลงและการแก้ไขและบรรจุภัณฑ์ Conan.io
ขอบคุณ @martinmoene สำหรับไลบรารี XXX-Lite ที่ใช้งานได้อย่างสมบูรณ์แบบ
ขอบคุณ @vitaut สำหรับไลบรารีการจัดรูปแบบข้อความที่น่าทึ่ง
ขอบคุณ @martinus สำหรับการใช้งานแผนที่แฮชอย่างรวดเร็ว
batchsliceformattojsonstriptagscenterxmlattrraw / endraw'a' * 5 จะผลิต 'aaaaa' )meta / endmeta Tags)-fPIC Flag เพิ่มไปยังการกำหนดค่า Linux Build block หลักหากเด็กไม่ได้แทนที่บล็อกนี้variant , string_view และ optional มาตรฐานdefault เพิ่มลงในตัวกรอง map (#48)GenericList (#66)Valuefilter เพิ่มลงในตัวแยกวิเคราะห์เทมเพลต (#44)escape เพิ่มลงในตัวแยกวิเคราะห์เทมเพลต (#140)capitalize การสนับสนุนตัวกรองที่เพิ่มลงในตัวแยกวิเคราะห์เทมเพลต (#137)set หลายรุ่นเพิ่มลงในตัวแยกวิเคราะห์ (#45)loop.depth และ loop.depth0 เพิ่มการสนับสนุนTemplateEnv*context พิเศษพารามิเตอร์| ) ความสำคัญของโอเปอเรเตอร์ (#47)endblockinclude และ for แท็กJINJA2CPP_MSVC_RUNTIME_TYPE cmake cmakeinclude import และ from ข้อความที่นำมาใช้ ตอนนี้เป็นไปได้ที่จะรวมเทมเพลตอื่น ๆ และใช้มาโครจากเทมเพลตอื่น ๆwith คำสั่งที่นำไปใช้do งบที่ใช้งานRenderAsString จะส่งคืน nonstd::expected จะแทนที่จะเป็น std::string ปกติimport extends และ include การสร้างข้อผิดพลาดหากแยกวิเคราะห์โดยไม่ต้องตั้งค่า TemplateEnvexternal โดยค่าเริ่มต้นapplymacro ซึ่งอนุญาตให้ใช้แมโครโดยพลการเป็นตัวกรอง
