mulle-core

🌋 Almagamated library of mulle-core + mulle-concurrent + mulle-c

This is an almagamation of the mulle-core, mulle-concurrent, mulle-c projects that need not be forced linked. See the constituting projects for documentation, bug reports, pull requests.

mulle-core is tested to build on the following platforms and compiler matrix:

OS	Compiler	Flags	Note
Ubuntu	GCC
Ubuntu	GCC		Out of source build
Ubuntu	GCC	-O3
Ubuntu	Clang
Ubuntu	Clang	Debug
Windows	MSVC Win32
Windows	MSVC Win64
Windows	GCC
macOS	Clang
macOS	GCC

The advantages of using mulle-core over the individual projects are:

• compiles faster than two dozens of individual projects
• you only need to link against one library file
• #include statements may remain unchanged or simplify to #include <mulle-core/mulle-core.h>

Constituents

Constituent	Description
mulle-allocator	🔄 Flexible C memory allocation scheme
mulle-buffer	↗️ A growable C char array and also a stream - on stack and heap
mulle-c11	🔀 Cross-platform C compiler glue (and some cpp conveniences)
mulle-container-debug	🛄 Debugging support for mulle-container
mulle-container	🛄 Arrays, hashtables and a queue
mulle-data	#️⃣ A collection of hash functions
mulle-http	🈚 http URL parser
mulle-rbtree	🍫 mulle-rbtree organizes data in a red/black tree
mulle-regex	📣 Unicode regex library
mulle-slug	🐌 Creates URL slugs
mulle-storage	🛅 Memory management for tree nodes
mulle-unicode	🈚 Unicode ctype like library
mulle-url	🈷️ Support for URL parsing
mulle-utf	🔤 UTF8-16-32 analysis and manipulation library
mulle-vararg	⏪ Access variable arguments in struct layout fashion in C
mintomic	For more information, see the documentation or the accompanying blog post, Introducing Mintomic.
mulle-aba	🚮 A lock-free, cross-platform solution to the ABA problem
mulle-concurrent	📶 A lock- and wait-free hashtable (and an array too), written in C
mulle-fifo	🐍 mulle-fifo fixed sized producer/consumer FIFOs holding void *
mulle-linkedlist	🔂 mulle-linkedlist a wait and lock-free linked list
mulle-multififo	🐛 mulle-multififo multi-producer/multi-consumer FIFO holding void *
mulle-thread	🔠 Cross-platform thread/mutex/tss/atomic operations in C
dlfcn-win32	===========
mulle-dlfcn	♿️ Shared library helper
mulle-fprintf	🔢 mulle-fprintf marries mulle-sprintf to stdio.h
mulle-mmap	🇧🇿 Memory mapped file access
mulle-sprintf	🔢 An extensible sprintf function supporting stdarg and mulle-vararg
mulle-stacktrace	👣 Stracktrace support for various OS
mulle-time	🕕 Simple time types with arithmetic on timespec and timeval

Add another constituent to the amalgamation

mulle-sde dependency add --amalgamated \
                         --fetchoptions "clibmode=copy" \
                         --address src/mulle-container-debug \
                         clib:mulle-c/mulle-container-debug

Then edit mulle-core.h and add the envelope header to the others.

Add

There are various methods how to get mulle-core into your project. One common denominator is that you will #include <mulle-core/mulle-core.h> in your sources and link with -lmulle-core.

Add as a dependency with mulle-sde

Use mulle-sde to add mulle-core to your project:

mulle-sde add github:mulle-core/mulle-core

This library does not include mulle-atinit and mulle-atexit and mulle-testallocator. If you add these libraries, it is important that mulle-core is added before them.

Add as subproject with cmake and git

git submodule add https://github.com/mulle-core/mulle-core.git stash/mulle-core
git submodule update --init --recursive

Add this to your CMakeLists.txt:

add_subdirectory( stash/mulle-core)
target_link_libraries( ${PROJECT_NAME} PRIVATE mulle-core)

Install

Use mulle-sde to build and install mulle-core and all dependencies:

mulle-sde install --prefix /usr/local \
   https://github.com/mulle-core/mulle-core/archive/latest.tar.gz

Legacy Installation

Download the latest tar or zip archive and unpack it.

Install mulle-core into /usr/local with cmake:

PREFIX_DIR="/usr/local"
cmake -B build                               \
      -DMULLE_SDK_PATH="${PREFIX_DIR}"       \
      -DCMAKE_INSTALL_PREFIX="${PREFIX_DIR}" \
      -DCMAKE_PREFIX_PATH="${PREFIX_DIR}"    \
      -DCMAKE_BUILD_TYPE=Release &&
cmake --build build --config Release &&
cmake --install build --config Release

Author

Nat! for Mulle kybernetiK