Presentation about Conan.io project on C++ Meetup occurred in Florianópolis/Brazil.

1. Meetup C/C++ Floripa
Conan.io
@uilianries

2. Hello!
Uilian Ries
C++ Developer
Work at Khomp
@uilianries
2

3. 1.
POPULAR C ++
PROJECTS
Because you need good libraries

4. “
4
BOOST POCO GTEST
ABSEILOPEN CV QT
LIBPNGOPENSSLZLIB

5. ALL OF THEM NEED TO BE BUILT
▪ Download the source. Build on your machine
▫ It may take several minutes, or even hours
▫ There may be external dependencies
▫ You need to know how to build
▪ Install by system package manager
▫ The version may not be as expected
▫ There may be a patch applied
5

6. 2.
PACKAGE MANAGERS
How to avoid externals in your project

7. POPULAR PACKAGE MANAGERS
7

8. 8
https://youtu.be/fX2W3nNjJIo?t=41m44s

9. 9
CPPAN BUCKAROO
CGET CPM
HUNTER CONAN
C++ UNIVERSE

10. 3.
CONAN
The Barbarian arrived to save

11. ▪ FOSS
▪ MIT License
▪ Decentralized, GIT style
▪ Handles from source/binaries
▪ Generators for CMake, VS, XCode, qmake …
▪ Developed in Python
▪ +70 contributors
▪ 1K2 stars (Github)
11

12. 12
PIP IS ALL YOU NEED TO INSTALL

13. 4.
CONAN IN ACTION
Talk is cheap. Show me the code.

14. CONAN IN ACTION
▪ Digest MD5 using Poco project
▪ Check an email address by Boot Regex
▪ Build using CMake
14

15. 15
// example.cpp
#include "Poco/MD5Engine.h"
#include <boost/regex.hpp>
#include <string>
#include <iostream>
int main(){
Poco::MD5Engine md5;
md5.update("Hello World");
std::string md5string = Poco::DigestEngine::digestToHex(md5.digest());
std::cout<< "MD5= " << md5string << "n";
std::string s = "correct@email.com", s2="bademail";
boost::regex expr{"b[a-zA-Z0-9._%-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,4}b"};
std::cout << std::boolalpha << boost::regex_match(s, expr) << 'n';
std::cout << std::boolalpha << boost::regex_match(s2, expr) << 'n';
}

16. 16
# conanfile.txt
[requires]
Poco/1.8.0.1@pocoproject/stable
Boost/1.64.0@conan/stable
[generators]
cmake

17. 17
# CMakeLists.txt
cmake_minimum_required(VERSION 2.8)
project(example CXX)
include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)
conan_basic_setup()
add_executable(example example.cpp)
target_link_libraries(example ${CONAN_LIBS})

18. $ mkdir build && cd build
$ conan install ..
$ cmake ..
$ cmake --build .
$ bin/example
18
HOW TO BUILD

19. 19
RUNNING CONAN

20. 20
class ExampleConan(ConanFile):
name = "example"
version = "0.1.0"
settings = "os", "compiler", "build_type", "arch"
generators = "cmake"
exports_sources = "*"
requires = "Poco/1.8.0.1@pocoproject/stable", "Boost/1.64.0@conan/stable"
def build(self):
cmake = CMake(self)
cmake.configure()
cmake.build()
# Or, using explicit way:
self.run('cmake %s/src %s' % (self.source_folder, cmake.command_line))
self.run("cmake --build . %s" % cmake.build_config)

21. $ conan create uilian/testing
21
HOW TO BUILD

22. 5.
CONAN IN A
NUTSHELL
How the barbarian works.

23. UNDERSTANDING THE BARBARIAN
▪ Package naming
▪ System setup
▪ Package distribution
▪ Local cache
23

24. PACKAGE NAMING
name/version@user/channel
▪ Examples
▫ Poco/1.8.0@lasote/stable
▫ Boost/1.65.1@memsharded/testing
▫ zlib/1.2.11@conan/stable
24

25. SYSTEM SETUP
▪ Based on profiles
Conan settings + Host configuration = Profile
25

26. SYSTEM SETUP
26

27. PACKAGE DISTRIBUTION
▪ Git flavor
▪ Support multiple remotes
▪ Central repository - Bintray
▪ Easy to run a local server instance
▪ Artifactory can be used together
27

28. PACKAGE DISTRIBUTION
28
conanfile.txt
Conan cache
conan.corp.org:9300
localhost
bintray.com/conan

29. PACKAGE DISTRIBUTION
29

30. LOCAL CACHE
▪ Packages are based on:
▫ Settings
▫ Options
▫ Requires
30

31. LOCAL CACHE
31
Boost/1.64.0@bincrafters/stable
Package_ID: b2a2dd150fed04abc97d11c09f340db88855c686
[options]
shared: True
[settings]
arch: x86_64
build_type: Release
compiler: gcc
compiler.libcxx: libstdc++
compiler.version: 6.3
os: Linux
[requires]
Boost.Core/1.64.0@bincrafters/stable:5ab84d6acfe1f23

32. LOCAL CACHE
32
Conan package =1 recipe, N binary packages
localhost
conanfile.txt
amd64
Boost/1.64.0@bincrafters/stable
configN
i386

33. LOCAL CACHE
33

34. 6.
BONUS
How a recipe looks like.

35. from conans import ConanFile, CMake
class HelloConan(ConanFile):
name = "Hello"
version = "0.1"
settings = "os", "compiler", "build_type", "arch"
options = {"shared": [True, False]}
default_options = "shared=False"
exports_sources = "src/*"
def build(self):
cmake = CMake(self)
cmake.configure()
cmake.build()
def package(self):
self.copy("*.h", dst="include", src="src")
self.copy("*.so", dst="lib", keep_path=False)
self.copy("*.a", dst="lib", keep_path=False)
def package_info(self):
self.cpp_info.libs = ["hello"]

36. CONAN CREATE

37. 7.
COMMUNITY
Sharing data is the first step toward
community.

38. BINTRAY AS DOWNLOAD CENTER
▪ JFrog’s solution
▪ Conan Transit: 936 recipes
▪ Conan Center: 21 recipes
38

39. 39

40. BINCRAFTERS
▪ https://github.com/bincrafters/community
▪ Packaging OSS Software
▪ ~20 members and growing
▪ +200 recipes, including:
▫ Modular Boost, Abseil, Azure, ...
▪ Thanks to @solvingj
40

41. REFERENCES
▪ https://github.com/conan-io/conan
▪ https://github.com/bincrafters
▪ https://conan.io
▪ https://docs.conan.io
▪ https://github.com/memsharded/four-c-example
▪ CppCon 2016: Conan, a C and C++ package manager for developers
▪ https://bintray.com/conan
▪ Programming C++ With The 4 Cs: Clang, Cmake, Clion And Conan
41

42. THANKS!
Questions ?
You can find me on:
@uilianries - twitter, github
cpplang.slack.com - channel #conan or #bincrafters
uilianries@gmail.com
42