From c76504f2b71c37b9520748b670fb64e24ef914ba Mon Sep 17 00:00:00 2001
From: =?utf8?q?Alexis=20Laferri=C3=A8re?= <alexis.laf@xymus.net>
Date: Thu, 19 Mar 2015 11:04:12 -0400
Subject: [PATCH] contrib: intro header_keeper, a cog in the toolchains to
 generate FFI bindings
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

Signed-off-by: Alexis Laferrière <alexis.laf@xymus.net>
---
 contrib/header_keeper/Makefile              |    7 ++++
 contrib/header_keeper/src/header_keeper.nit |   57 +++++++++++++++++++++++++++
 2 files changed, 64 insertions(+)
 create mode 100644 contrib/header_keeper/Makefile
 create mode 100644 contrib/header_keeper/src/header_keeper.nit

diff --git a/contrib/header_keeper/Makefile b/contrib/header_keeper/Makefile
new file mode 100644
index 0000000..76d36c6
--- /dev/null
+++ b/contrib/header_keeper/Makefile
@@ -0,0 +1,7 @@
+bin/header_keeper:
+	mkdir -p bin
+	../../bin/nitc --dir bin src/header_keeper.nit
+
+tests: bin/header_keeper
+	gcc -E /usr/include/SDL/SDL_image.h | bin/header_keeper SDL_image.h
+	gcc -E /usr/include/GLES2/gl2.h | bin/header_keeper gl2.h
diff --git a/contrib/header_keeper/src/header_keeper.nit b/contrib/header_keeper/src/header_keeper.nit
new file mode 100644
index 0000000..adf6b77
--- /dev/null
+++ b/contrib/header_keeper/src/header_keeper.nit
@@ -0,0 +1,57 @@
+# This file is part of NIT (http://www.nitlanguage.org).
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Filters preprocessed C-like header files to remove included files
+#
+# This tool is used in the process of parsing header files to extract
+# information on the declared services (the functions and structures).
+# This information is then used to generate bindings for Nit code
+# to access these services.
+#
+# The C preprocessor extends macros, inline files marked with `#include`,
+# and more. This tool acts after the C preprocessor, in a way to keep
+# everything but the included files. It searches for line pragmas
+# to identify the source of each line. The result is printed to stdout.
+#
+# Typical usage on the output of `gcc -E` (it would be the same with `clang`):
+#
+# ~~~sh
+# gcc -E /usr/include/SDL/SDL_image.h | header_keeper SDL_image.h > preprocessed_header.h
+# ~~~
+#
+# This module can also be used as a library.
+# The main service is the method `header_keeper`.
+module header_keeper
+
+# Filters the preprocessed `input` to keep only files from `target` and write to the `output`
+fun header_keeper(input: Reader, output: Writer, target: String)
+do
+	var in_target = false
+	while not input.eof do
+		var line = input.read_line
+		if not line.is_empty and line[0] == '#' then
+			in_target = line.has(target)
+			continue
+		end
+
+		if in_target then output.write line + "\n"
+	end
+end
+
+if args.length != 1 then
+	print "Usage: header_keeper header_name.h"
+	exit 1
+end
+
+header_keeper(sys.stdin, sys.stdout, args.first)
-- 
1.7.9.5