Skip to content
The decentralized package manager for C++ and friends 🏝️
Branch: master
Clone or download
Latest commit e5fb602 Mar 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Added a basic ISSUE and PULL REQUEST template Aug 4, 2017
buckaroo-cli feat: implements cache first option for remoterefs fetching Mar 13, 2019
buckaroo-tests
buckaroo fix tests Mar 13, 2019
www
.gitignore
.travis.yml * Tweaks release condition Dec 6, 2018
CLA.md
CODE_OF_CONDUCT.md * Adds various meta-files Jan 4, 2019
CONTRIBUTING.md * Adds various meta-files Jan 4, 2019
LICENSE Create LICENSE Feb 9, 2019
README.md
appveyor.yml Update appveyor.yml Jan 31, 2019
buckaroo.sln
buckaroo_bash_completion.bash * Begins work on Bash completion Dec 20, 2018
warp-bundle-linux.sh
warp-bundle-macos.sh * Reduces the size of the final bundle Feb 27, 2019
warp-bundle-windows.ps1 feature/appveyor-releases (#240) Jan 8, 2019

README.md

Buckaroo

Buckaroo

The decentralized package manager for C++ and friends.

Why Buckaroo?

Package managers like Yarn and Cargo have shown how productive developers can be when they can easily integrate a large ecosystem of projects. Buckaroo fills this gap for C++.

The Buckaroo workflow looks like this:

# Create your project file
$ buckaroo init

# Install dependencies
$ buckaroo add github.com/buckaroo-pm/boost-thread@branch=master

# Run your code
$ buck run :my-app

We have an FAQ.

Package Registries

Pull dependencies directly from GitHub, BitBucket, GitLab, hosted Git and HTTP. How?

Package Registries

IDE Integrations

Support for major IDEs and tools. Integration guides can be found in the docs.

IDE Integrations

Features

C++ has unique requirements, so Buckaroo is a highly sophisticated piece of software.

  • Pull dependencies directly from GitHub, BitBucket, GitLab, hosted Git and HTTP
  • Fully reproducible builds and dependency resolution
  • Completely decentralized - there is no central server or publishing process
  • Allows any build configuration (even on a package-by-package basis)
  • Private and public dependencies to avoid "dependency hell"
  • Multiple libraries per package, so tools like Lerna are unnecessary
  • Pull individual packages out of mono-repos
  • Full support for semantic versioning (but only when you want it!)
  • Live at head! Move fast by depending directly on Git branches, but in a controlled way
  • Blazing fast resolution using clever heuristics
  • Version equivalency checks to reduce dependency conflicts
  • TOML configuration files for convenient editing by computers and humans
  • Works offline (with a populated cache)
  • Enable Upgrade Bot to keep everything up-to-date with a single click

Get Started

Please refer to the Wiki for installation instructions! ✌️

Quick Install

Buckaroo is shipped as a self-contained executable, so all you need to do is download the bundle from the releases page.

Linux
$ wget https://github.com/LoopPerfect/buckaroo/releases/download/v2.2.0/buckaroo-linux -O buckaroo
$ chmod +x ./buckaroo
$ ./buckaroo
macOS

With Homebrew:

$ brew install loopperfect/lp/buckaroo

Or without Homebrew:

$ wget https://github.com/LoopPerfect/buckaroo/releases/download/v2.2.0/buckaroo-macos -O buckaroo
$ chmod +x ./buckaroo
$ ./buckaroo
Windows

Download buckaroo.exe from the release page.

How Buckaroo Works

The Buckaroo model is very simple. Packages live in source-control, and a manifest file is used to describe dependencies. This points to further manifests to create a dependency graph. Buckaroo works directly over Git and HTTP.

Buckaroo

Head over to the Wiki for more detailed information.

Attribution

SVG graphics in diagrams are made by Freepik from www.flaticon.com and are licensed by Creative Commons BY 3.0.

You can’t perform that action at this time.