Get best of the week

C ++世界中的Jinja2，第三部分。“现在你在柯南”

图片自上一部分发布以来已经过去了一年半，实现了很多功能，发布了多个版本，但这将不再讨论。库生命周期中的几天前发生了一个重要事件：它已添加到主要的柯南存储库（conan-center-index）中。关于这是如何发生的，必须执行的操作，以及在此处添加您的库通常需要执行的操作，我们将在此基础上进行讨论。


JFrog尽力而为


图片首先，简要介绍一下什么是柯南（又名柯南，又名conan.io）和柯南中心索引。Conan是一个面向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


在本文中，Status Quo的歌曲“ You in the now now”中的歌词被用作字幕

More articles:


All Articles