Fatal: Facebook Template Library

Fatal is a library for fast prototyping of software in C++11 and up.

It provides a broad range of template meta-programming tools for reflection and metadata manipulation.

The goal is to abstract the complexity of template meta-programming and make its benefits available to a wider audience other than hard-core library writers.

Examples

Demonstration applications can be found under the demo/ directory.

Philosophy

Fatal moves fast, therefore it uses the latest and greatest in C++ standards. It aims to adopt new standard features as soon as they're officially out, as long as they provide benefits like performance, productivity and usability improvements.

Requirements

There are no external dependencies in order to use Fatal as a library.

In order to build and run Fatal's benchmarks, unit tests and demos, you'll need:

• Folly: Facebook Open-source LibrarY (https://github.com/facebook/folly/)
• GTest: Google C++ Testing Framework (https://code.google.com/p/googletest/)
• GLog: Google Logging Library for C++ (https://code.google.com/p/google-glog/)
• GFlags: Google Commandline Flags Module for C++ (https://code.google.com/p/gflags/)
• a compliant C++11 compiler. Currently tested under GCC 4.8, GCC 4.9 and Clang 3.4.

In order to build and run Fatal's demos, you'll need:

• Folly: Facebook Open-source LibrarY (https://github.com/facebook/folly/)
• a compliant C++14 compiler. Currently tested under GCC 4.9 and Clang 3.4.

Building Fatal

Fatal is a header only library, therefore no building is required.

Building Fatal Benchmarks and Unit Tests

Provided that the dependencies are properly installed:

$ clang++ -Wall -std=c++11 -I path/to/fatal/basedir \
  -o path/to/output/binary path/to/test/or/benchmark.cpp

or

$ g++ -Wall -std=c++11 -I path/to/fatal/basedir \
  -o path/to/output/binary path/to/test/or/benchmark.cpp

Building Fatal Demos

Provided that the dependencies are properly installed:

$ clang++ -Wall -std=c++1y -I path/to/fatal/basedir \
  -o path/to/output/binary path/to/demo.cpp

or

$ g++ -Wall -std=c++1y -I path/to/fatal/basedir \
  -o path/to/output/binary path/to/demo.cpp

Installing Fatal

There's no need to install Fatal, as long as you add its base directory to the include directories list.

For GCC and Clang, it suffices to either:

• use the -I path/to/fatal/basedir flag
• set the environment variable CPLUS_INCLUDE_PATH=path/to/fatal/basedir

Full documentation

Extensive documentation with examples can be found inline in the source header files.

Join the Fatal community

• Website: https://github.com/facebook/fatal/
• Facebook Page: https://www.facebook.com/libfatal See the CONTRIBUTING file for how to help out.

License

Fatal is BSD-licensed. We also provide an additional patent grant.