Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cxxpods/cxxpods
Toolchains, tools and dependencies, all in one place, made easy
https://github.com/cxxpods/cxxpods
build build-automation build-system c cmake cpp cross-compiler make package-manager toolchains
Last synced: 3 months ago
JSON representation
Toolchains, tools and dependencies, all in one place, made easy
- Host: GitHub
- URL: https://github.com/cxxpods/cxxpods
- Owner: cxxpods
- License: mit
- Created: 2018-06-28T18:05:26.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-07T20:32:27.000Z (about 2 years ago)
- Last Synced: 2024-10-30T20:21:14.048Z (3 months ago)
- Topics: build, build-automation, build-system, c, cmake, cpp, cross-compiler, make, package-manager, toolchains
- Language: JavaScript
- Homepage:
- Size: 12.6 MB
- Stars: 7
- Watchers: 4
- Forks: 2
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CXXPODS
Documentation can be found [here: documentation](https://cxxpods.readthedocs.io/en/latest/00_Overview.html)
## Overview
CXXPods is a command line tool that allows for both simple c/c++ and very complex multi-platform, cross-compiling dependency managerment.
Think of it as a highly customizable (obviously because it needs to support complex native code) NPM or Maven like package management solution that deals in source artifacts instead of compiled or binary artifacts.
It comes as an amalgamation of other attempts including awesome projects like mason, hunter & conan.
In order to be as comprehensive as possible, there is a single enforced guideline, your project must you CMake.
## Install
### Linux, macOS
On linux or macOS you can run the following snippet to install a binary version of cxxpods, no need to install node, npm or anything else. It will be installed to `/usr/local/bin`
```bash
curl -s https://raw.githubusercontent.com/cxxpods/cxxpods/master/scripts/client-install.sh | bash
```
### NPM (Windows, Linux, macOS)
You can also install via [npm](http://nodejs.org) if you have [node](http://nodejs.org) and npm installed.
```bash
npm i -g cxxpods
```
## Quickstart
It takes a few simple steps.
- Create a cxxpods.yml file in the root of your project
```yaml
name: cxxpods-example
dependencies:
opencv: 3.4.1
```
- Then run configure
```bash
cxxpods project configure
```
- In your root `CMakeLists.txt` *BEFORE* your `project` declaration
add something like the following:
```cmake
cmake_minimum_required(VERSION 3.10)
# INSERT THIS LINE
include(${CMAKE_CURRENT_LIST_DIR}/.cxxpods/cxxpods.cmake)
project(cxxpods_example)
```
## Cross-Compiling "Toolchains"
Create your standard cmake toolchain file and
use it as follows:
```yaml
name: cxxpods-example
profiles: [Debug,Release]
toolchains:
"aarch64-linux-gnu": cmake/aarch64.cmake
# file would be at this relative location from the project root
dependencies:
protobuf: 3.1.0
opencv: 3.4.1
```
In order to use with `non-cmake` dependencies and scripts
add the following to the top of your toolchain file:
```cmake
include(${CMAKE_CURRENT_LIST_DIR}/.cxxpods/cxxpods.toolchain.cmake)
```
and add the following to the bottom of your toolchain file
```cmake
cxxpods_toolchain_export()
```