जिनजा 2 सी ++ दुनिया में, भाग तीन। "अब आप कॉनन में हैं"

पिछले भाग के प्रकाशन के डेढ़ साल से अधिक समय बीत चुके हैं, सुविधाओं का एक बड़ा गुच्छा लागू किया गया था, कई रिलीज़ किए गए थे, लेकिन इस पर चर्चा नहीं की जाएगी। पुस्तकालय के जीवन में कुछ दिनों पहले एक महत्वपूर्ण घटना घटी थी: इसे मुख्य कॉनन रिपॉजिटरी (कॉनन-सेंटर-इंडेक्स) में जोड़ा गया था । यह कैसे हुआ, इसके लिए क्या किया जाना चाहिए था, और आम तौर पर वहां अपने पुस्तकालय को जोड़ने के लिए क्या किया जाना चाहिए, और हम कट के तहत बात करेंगे।

JFrog सबसे अच्छा वे कर सकते हैं

शुरू करने के लिए, कॉनन (उर्फ कॉनन, उर्फ ​​कॉनन.आईओ) और कॉनन-सेंटर-इंडेक्स के बारे में कुछ शब्द। कॉनन एक C ++ - उन्मुख पैकेज और निर्भरता प्रबंधक है (एक और, लेकिन तेजी से लोकप्रियता में बढ़ रहा है)। यह स्थापित करने, कॉन्फ़िगर करने और कई निस्संदेह फायदे के लिए काफी सरल है:

1. यह किसी विशेष बिल्ड सिस्टम, कंपाइलर या ऑपरेटिंग सिस्टम से बंधा नहीं है;
2. एक वितरित भंडार प्रणाली का उपयोग कर सकते हैं;
3. आर्टिफ़ैक्ट का उपयोग करके आप स्थानीय (निजी) प्रोजेक्ट / टीम रिपॉजिटरी को तैनात कर सकते हैं;
4. यह बाइनरी (पहले से ही इकट्ठे) फॉर्म में निर्भरता के वितरण का समर्थन करता है और एक विशिष्ट प्रोफ़ाइल के लिए स्रोत से स्थानीय रूप से उनकी विधानसभा;
5. कॉन्फ़िगर करने और उपयोग करने के लिए अपेक्षाकृत आसान है।

वास्तव में, कॉनन के साथ, आप बस उन निर्भरताओं को सूचीबद्ध करते हैं जिन्हें आपकी परियोजना की आवश्यकता होती है, फिर वह खुद सब कुछ करता है। और, बशर्ते कि परियोजना के लिए सभी सेटिंग्स (कॉनन प्रोफाइल) को सही ढंग से निर्दिष्ट किया गया है, तो आप बस अनलोड, संकलित और कॉन्फ़िगर किए गए पुस्तकालयों के साथ जाते हैं। जादू! लेकिन इसके लिए, पुस्तकालय बनाता है और उनकी साइट पर व्यंजनों के लिए व्यंजनों को कहीं झूठ होना चाहिए। कहीं आप उन्हें पा सकते हैं। वे स्पष्ट रूप से रिपॉजिटरी में हैं। व्यक्तिगत (या टीम) का एक आधिकारिक और अंतहीन सेट।

, . bincrafters — , . bincrafters ( ) : .

, conan.io conan-center-index. — -, . (, — ) pull request . — ( , ) . : jinja2cpp/1.1.0

Nothing to do all day but stay in bed

- , conan.io , , , . . , , — , conan-, . . , bincrafters : https://github.com/bincrafters/templates.

, . , bintray ( ) — . : 130. conan-index ( ) 130 . , Jinja2C++. :

• (Windows/Linux)
• (x86/x64)
• ( MSVC — , gcc — ABI )
• (debug/release)
• (shared/static)

, , , CI . appveyor, travis, Github Actions , — -, , . ? ? ? … .

Errors flying over your head

№1: , , ( ) — , .
№2: , , .
№3: , -, .

, . , , CI , : "Debug CI build", CI .

, . , - , . — . , . , , ( conan-index bincrafters). , , , , , . , - ( ), . - , issue.

: Jinja2C++ GitHub Actions 30- Linux, 48- Windows, 16 appveyor 5 . : conan-center-index .

If you want to survive, get out of bed!

, . ? :

1. , . windows, linux, . CI . .
2. (, . .) . conan index . .
3. Early Access Programm conan index, . , . issue . : https://github.com/conan-io/conan-center-index/issues/4
4. . . , - . , , , , , ( — ). .
5. conan-center-index. PR conan.io team.

conan-center-index , : https://github.com/conan-io/conan-center-index/wiki , , - .

You've got your orders better shoot on sight

, . github-, , . , Jinja2C++. — . :

.
+-- recipes
|   +-- jinja2cpp
|       +-- config.yml
|       +-- 1.1.0
|           +-- CMakeLists.txt
|           +-- conanfile.py
|           +-- conandata.yml
|           +-- test_package
|               +-- CMakeLists.txt
|               +-- conanfile.py

:

config.yml

— , :

---
versions:
  "1.1.0":
    folder: 1.1.0 

, , , all, config.yml — ( — ).

1.1.0

, . . . . (conanfile.py), (conandata.yml) test_package, — . , , .

1.1.0/conanfile.py

. — , .

1.1.0/conandata.yml

. , . . , master' . conan-center-index . :

sources:
  "1.1.0":
    url: https://github.com/jinja2cpp/Jinja2Cpp/archive/1.1.0.tar.gz
    sha256: 3d321a144f3774702d3a6252e3a6370cdaff9c96d8761d850bb79cdb45b372c5

- .

1.1.0/CMakeFile.txt

, . , conan', CMake- :

cmake_minimum_required(VERSION 3.4.3)
project(cmake_wrapper)

include(conanbuildinfo.cmake)
conan_basic_setup()

unset (BUILD_SHARED_LIBS CACHE)
if (NOT CMAKE_BUILD_TYPE)
    set (CMAKE_BUILD_TYPE ${JINJA2CPP_CONAN_BUILD_TYPE})
endif ()

add_subdirectory(source_subfolder)

? cmake- (conanbuildinfo.cmake), , . , , , , PIC . ( ) CMake- , conan , . — -. , - . — , msbuild.exe.

1.1.0/test_package

. (conanfile.py) (CMakeLists.txt) (main.cpp), - . , "Hello World!".

1.1.0/test_package/conanfile.py

. , -. :

from conans import ConanFile, CMake, tools
import os

class Jinja2CppTestPackage(ConanFile):
    settings = "os", "arch", "compiler", "build_type"
    generators = "cmake", "cmake_find_package"

    def build(self):
        cmake = CMake(self)
        compiler = self.settings.get_safe("compiler")
        if compiler == 'Visual Studio':
            runtime = self.settings.get_safe("compiler.runtime")
            cmake.definitions["MSVC_RUNTIME_TYPE"] = '/' + runtime

        cmake.configure()
        cmake.build()

    def test(self):
        if not tools.cross_building(self.settings):
            ext = ".exe" if self.settings.os == "Windows" else ""
            bin_path = os.path.join("bin", "jinja2cpp-test-package" + ext)
            self.run(bin_path, run_environment=True)

, . — ( build) ( test). — . , MSVC. — . , . CMake — cmake cmake_find_package. — .

1.1.0/test_package/CMakeLists.txt

:

cmake_minimum_required(VERSION 2.8.0)
project(Jinja2CppTestPackage)

set(CMAKE_CXX_STANDARD 14)

include (${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)
conan_basic_setup()

find_package(jinja2cpp REQUIRED)

if (CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
    if (CMAKE_BUILD_TYPE MATCHES "Debug" AND MSVC_RUNTIME_TYPE)
        set (MSVC_RUNTIME_TYPE "${MSVC_RUNTIME_TYPE}d")
    endif ()

    set (CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} ${MSVC_RUNTIME_TYPE}")
    set (CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} ${MSVC_RUNTIME_TYPE}")
    set (CMAKE_CXX_FLAGS_RELWITHDEBINFO "${CMAKE_CXX_FLAGS_RELWITHDEBINFO} ${MSVC_RUNTIME_TYPE}")
    set (CMAKE_EXE_LINKER_FLAGS_RELWITHDEBINFO "/PROFILE")

    message (STATUS "Build type: ${CMAKE_BUILD_TYPE}")
    message (STATUS "USE MSVC RUNTIME: ${MSVC_RUNTIME_TYPE}")

endif()

add_executable(jinja2cpp-test-package main.cpp)
target_link_libraries(jinja2cpp-test-package PRIVATE jinja2cpp::jinja2cpp)

cmake, , conanbuildinfo.cmake, cmake_find_package — find', conan- . : — case-sensitive, (, ) . .

, , , .

1.1.0/test_package/main.cpp

, , conan- :

#include <jinja2cpp/template.h>
#include <iostream>

int main()
{
    std::string source = R"(
{{ ("Hello", 'world') | join }}!!!
{{ ("Hello", 'world') | join(', ') }}!!!
{{ ("Hello", 'world') | join(d = '; ') }}!!!
{{ ("Hello", 'world') | join(d = '; ') | lower }}!!!)";

    jinja2::Template tpl;
    tpl.Load(source);

    std::string result = tpl.RenderAsString(jinja2::ValuesMap()).value();
    std::cout << result << "\n";
} 

! smoke-, . — "!", !

Your finger's on the keyboard

, . , , . — -, PEP8. — , , , . :

import os
from conans import ConanFile, CMake, tools
from conans.errors import ConanInvalidConfiguration

class Jinja2cppConan(ConanFile):
# global settings and metainfo

    def config_options(self):
#...

    def configure(self):
#...

    def source(self):
#...

    def build(self):
#...

    def package(self):
#...

    def package_info(self):
#...

conan. :

• config_options —
• configure —
• source —
• build —
• package — ( install, )
• package_info — ,

, . Jinja2C++, CMake-, .

    name = "jinja2cpp"
    license = "MIT"
    homepage = "https://jinja2cpp.dev/"
    url = "https://github.com/conan-io/conan-center-index"
    description = "Jinja2 C++ (and for C++) almost full-conformance template engine implementation"
    topics = ("conan", "cpp14", "cpp17", "jinja2", "string templates", "templates engine")
    exports_sources = ["CMakeLists.txt"]
    generators = "cmake", "cmake_find_package"
    settings = "os", "compiler", "build_type", "arch"
    options = {
        "shared": [True, False], "fPIC": [True, False]
    }
    default_options = {'shared': False, "fPIC": True}
    requires = (
        "variant-lite/1.2.2",
        "expected-lite/0.3.0",
        "optional-lite/3.2.0",
        "string-view-lite/1.3.0",
        "boost/1.72.0",
        "fmt/6.1.2",
        "rapidjson/1.1.0"
    )

    _source_subfolder = "source_subfolder"
    _build_subfolder = "build_subfolder"
    _cpp_std = 14

(name, license, homepage, url, description, topics), (generators, settings, options, default_options), (requires) , (_source_subfloder, _build_subfolder _cpp_std).

, conan-center-index:

• , community, ( author);
• url conan-center-index;
• — homepage;
• static, shared-. -fPIC. hook-;
• — ( ), , conan-center-index.

config_options

, :

    def config_options(self):
        if self.settings.os == "Windows":
            del self.options.fPIC

Windows fPIC — . .

config

. , . .

    def configure(self):
        if self.options.shared:
            del self.options.fPIC

        cppstd = self.settings.get_safe("compiler.cppstd")
        if cppstd:
            cppstd_pattern = re.compile(r'^(gnu)?(?P<cppstd>\d+)$')
            m = cppstd_pattern.match(cppstd)
            cppstd_profile = int(m.group("cppstd"))
            if cppstd_profile < 14:
                raise ConanInvalidConfiguration("Minimum C++ Standard required is 14 (provided '{}')".format(cppstd))
            else:
                self._cpp_std = cppstd_profile

— shared- fPIC , (14). - , . : ConanInvalidConfiguration — . , , .

source

:

    def source(self):
        tools.get(**self.conan_data["sources"][self.version])
        extracted_dir = "Jinja2Cpp-" + self.version
        os.rename(extracted_dir, self._source_subfolder)

"" .

build

. , . . CMake :

    def build(self):
        cmake = CMake(self)
        cmake.definitions["JINJA2CPP_BUILD_TESTS"] = False
        cmake.definitions["JINJA2CPP_STRICT_WARNINGS"] = False
        cmake.definitions["JINJA2CPP_BUILD_SHARED"] = self.options.shared
        cmake.definitions["JINJA2CPP_DEPS_MODE"] = "conan-build"
        cmake.definitions["JINJA2CPP_CXX_STANDARD"] = self._cpp_std
        # Conan cmake generator omits the build_type flag for MSVC multiconfiguration CMake,
        # but provide build-type-specific runtime type flag. For now, Jinja2C++ build scripts
        # need to know the build type is being built in order to setup internal flags correctly
        cmake.definitions["JINJA2CPP_CONAN_BUILD_TYPE"] = self.settings.build_type
        compiler = self.settings.get_safe("compiler")
        if compiler == 'Visual Studio':
            # Runtime type configuration for Jinja2C++ should be strictly '/MT' or '/MD'
            runtime = self.settings.get_safe("compiler.runtime")            
            if runtime == 'MTd':
                runtime = 'MT'
            if runtime == 'MDd':
                runtime = 'MD'
            cmake.definitions["JINJA2CPP_MSVC_RUNTIME_TYPE"] = '/' + runtime

        cmake.configure(build_folder=self._build_subfolder)
        cmake.build()

, , cmake' . CMake- , Jinja2C++, .

package

, . , :

    def package(self):
        self.copy("LICENSE", dst="licenses", src=self._source_subfolder)
        self.copy("*.h", dst="include", src=os.path.join(self._source_subfolder, "include"))
        self.copy("*.hpp", dst="include", src=os.path.join(self._source_subfolder, "include"))
        self.copy("*.lib", dst="lib", keep_path=False)
        self.copy("*.dll", dst="bin", keep_path=False)
        self.copy("*.so", dst="lib", keep_path=False)
        self.copy("*.so.*", dst="lib", keep_path=False)
        self.copy("*.dylib", dst="lib", keep_path=False)
        self.copy("*.a", dst="lib", keep_path=False)

— install-. , — . , , :

• . .
• .cmake- ( ) . .

— , , install'.

package_info

, : , , , . . , , . :

    def package_info(self):
        self.cpp_info.libs = ["jinja2cpp"]

. define' , .

The sergeant calls (stand up and fight!)

— . . . , ( PR): . , :

> conan create . jinja2cpp/1.1.0@

( jinja2cpp/1.1.0 — )

, . conan- . . . , , . … .

, ( ) . Windows-, Linux-. Windows — shared . Linux… Linux — . - -, conan . : https://hub.docker.com/u/conanio GitHub Actions.

:

[settings]
arch=x86_64
arch_build=x86_64
build_type=Release
compiler=Visual Studio
compiler.runtime=MD
compiler.version=15
os=Windows
os_build=Windows
[options]
jinja2cpp:shared=False
[env]

[build_requires]

. :

> conan create . jinja2cpp/1.1.0@ -p profile_md.txt

profile_md.txt — .

: ( — , , ) . , , . , pull request' conan-center-index . , , , . — conan'. , , Visual Studio . , , .

You'll be the hero of the neighbourhood

, conan-center-index , , , , , . , , C++ . conan — , , . , , , . , — .

:

conan-center-index
Issue EAP
Jinja2C++
conan-center

लेख के पाठ में, स्टेटस क्वो के गीत "यू फ़ॉर आर्मी नाउ" की पंक्तियों को उपशीर्षक के रूप में इस्तेमाल किया गया था