👢 Cross platform dependency manager - using bash and cmake
Shell Other
Latest commit d34d04a Jan 12, 2017 @codeon-nat codeon-nat Fix bug when repository entry is a full path
and it gets symlinked. Improve cmake example.
Permalink
Failed to load latest commit information.
bin
dox
src
tests
tutorial
xcode-demo
.gitignore
LICENSE
Makefile
README.md
RELEASENOTES.md
TODO.md
install.sh
mulle-bootstrap
mulle-bootstrap.sublime-project
mulle-mingw-cmake.sh
mulle-mingw-cpp.sh
mulle-mingw-dumpdef.bat
mulle-mingw-dumpdef.sh
mulle-mingw-make.sh

README.md

mulle-bootstrap, cross platform dependency manager using bash

Last version

... for Linux, OS X, FreeBSD, Windows

... for C, C++, Objective-C

... certainly not a "minimal" or "lightweight" project with ca. 10000 lines of shell script code

Why you may want it

  • You program in C, C++ or in Objective-C, mulle-bootstrap is written for you
  • If you need to link against a library, that clashes with an installed library, mulle-bootstrap could break this quandary
  • If you feel that apt-get install pollutes your system with too many libraries, mulle-bootstrap may be the solution
  • If you don't like developing in virtual machines, mulle-bootstrap may tickle your fancy
  • If you like to decompose huge projects into reusable libraries, mulle-bootstrap may enable you to do so
  • If you do cross-platform development, mulle-bootstrap may be your best bet for a dependency manager

Core principles

  • Nothing gets installed outside of the project folder
  • mulle-bootstrap manages your dependencies, it does not manage your project
  • It should be adaptable to a wide ranges of project styles. Almost anything can be done with configuration settings or additional shell scripts.
  • It should be scrutable. If things go wrong, it should be easy to figure out what the problem is. It has extensive logging and tracing support built in.
  • It should run everywhere. mulle-bootstrap is a collection of shell scripts. If your system can run the bash, it can run mulle-bootstrap.

What it does technically

  • fetches git repositories. In times of need, it can also checkout svn.
  • builds cmake, xcodebuild and configure projects and installs their output into a "dependencies" folder.
  • installs brew binaries and libraries into an "addictions" folder (on participating platforms)
  • alerts to the presence of shell scripts in fetched dependencies

A first use

So you need a bunch of third party projects to build your own project ? No problem. Use mulle-bootstrap init to do the initial setup of a .bootstrap folder in your project directory. Then put the git repository URLs in a file called ./bootstrap/repositories:

mkdir .bootstrap
echo "# a comment
https://github.com/madler/zlib.git
https://github.com/coapp-packages/expat.git" > .bootstrap/repositories
mulle-bootstrap

mulle-bootstrap will check them out into a common directory .repos.

After cloning mulle-bootstrap looks for a .bootstrap folder in the freshly checked out repositories. They might have dependencies too, if they do, those dependencies are added and also fetched.

Everything should now be in place so mulle-bootstrap that can now build the dependencies with cmake. It will place the headers and the produced libraries into the dependencies/lib and dependencies/include folders.

Tell me more

If you want to hack on mulle-bootstrap, I'd recommend to get Sublime Text and install the linter plugin to use Shellcheck. It simplifies shell scripting by an order of magnitude.

GitHub and Mulle kybernetiK

The development is done on Mulle kybernetiK. Releases and bug-tracking are on GitHub.