Add an example C project

Author: trflynn89

examples/build/Makefile

@@ -10,10 +10,12 @@ VERSION = 1.0.0
 include /usr/local/src/fly/api.mk
 
 # Main targets.
+$(eval $(call ADD_TARGET, libfly_c_example, c, BIN))
 $(eval $(call ADD_TARGET, libfly_cpp_example, cpp, BIN))
 $(eval $(call ADD_TARGET, libfly_jar_example, jar/src/main/java, JAR))
 
 # Test targets.
+$(eval $(call ADD_TARGET, libfly_c_example_tests, c/test, TEST))
 $(eval $(call ADD_TARGET, libfly_cpp_example_tests, cpp/test, TEST))
 
 # Import the build system.

examples/build/README.md

@@ -17,10 +17,15 @@ and extract the downloaded `.tar.gz` in the root system directory:
 
 ## Example
 
-The usage example contains a main `Makefile` which imports the libfly build
-system from its installed location. It has a single binary target with one
-source directory, defined in `files.mk`.
+The usage example contains a main `Makefile` which imports the libfly build system from its
+installed location. It contains the following example targets:
 
-To build:
+1. libfly_c_example - A binary created from a C project.
+2. libfly_c_example_tests - An example unit test of the C project.
+3. libfly_cpp_example - A binary created from a C++ project.
+4. libfly_cpp_example_tests - An example unit test of the C++ project.
+5. libfly_jar_example - An executable JAR file created from a Java project.
+
+To build all of the above:
 
     make -C libfly/examples/build

examples/build/c/files.mk

@@ -0,0 +1,5 @@
+SRC_DIRS_$(d) := \
+    c/some_lib
+
+SRC_$(d) := \
+    $(d)/main.c

examples/build/c/main.c

@@ -0,0 +1,9 @@
+#include "c/some_lib/some_lib.h"
+
+#include <stdio.h>
+
+int main()
+{
+    printf("%d\n", some_value());
+    return 0;
+}

examples/build/c/some_lib/some_lib.c

@@ -0,0 +1,6 @@
+#include "c/some_lib/some_lib.h"
+
+int some_value()
+{
+    return 12389;
+}

examples/build/c/some_lib/some_lib.h

@@ -0,0 +1,3 @@
+#pragma once
+
+int some_value();

examples/build/c/test/files.mk

@@ -0,0 +1,5 @@
+SRC_DIRS_$(d) := \
+    c/some_lib
+
+SRC_$(d) := \
+    $(d)/some_lib.c

examples/build/c/test/some_lib.c

@@ -0,0 +1,12 @@
+#include "c/some_lib/some_lib.h"
+
+#include <assert.h>
+#include <stdio.h>
+
+int main()
+{
+    assert(some_value() == 12389);
+
+    printf("Passed!\n");
+    return 0;
+}