[gentoo-dev] [PATCH] tree-sitter-grammar.eclass: Init

[Matthew Smith]

Hi,

Please review tree-sitter-grammar.eclass - a new eclass for building
tree-sitter grammars provided by the tree-sitter developers.

The grammars are shipped as one or two source files and with no build
system.  Upstream uses Gyp to build the grammars as a NodeJS module,
but they are useful standalone to other applications such as text
editors.

Some new packages utilising the eclass can be viewed on GitHub:
https://github.com/gentoo/gentoo/pull/22611

Thanks,
Matthew

---
  eclass/tree-sitter-grammar.eclass | 94 +++++++++++++++++++++++++++++++
  1 file changed, 94 insertions(+)
  create mode 100644 eclass/tree-sitter-grammar.eclass

diff --git a/eclass/tree-sitter-grammar.eclass 
b/eclass/tree-sitter-grammar.eclass
new file mode 100644
index 00000000000..a107b0b1908
--- /dev/null
+++ b/eclass/tree-sitter-grammar.eclass
@@ -0,0 +1,94 @@
+# Copyright 1999-2021 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+# @ECLASS: tree-sitter-grammar.eclass
+# @MAINTAINER:
+# Matthew Smith <matt@×××××××××.uk>
+# Nick Sarnie <sarnex@g.o>
+# @AUTHOR:
+# Matthew Smith <matt@×××××××××.uk>
+# @SUPPORTED_EAPIS: 8
+# @BLURB: Common functions and variables for Tree Sitter grammars
+
+if [[ -z ${_TREE_SITTER_GRAMMAR_ECLASS} ]]; then
+_TREE_SITTER_GRAMMAR_ECLASS=1
+
+case ${EAPI} in
+       8) ;;
+       *) die "EAPI=${EAPI:-0} is not supported" ;;
+esac
+
+inherit toolchain-funcs
+
+SRC_URI="https://github.com/tree-sitter/${PN}/archive/${TS_PV:-v${PV}}.tar.gz 
-> ${P}.tar.gz"
+S="${WORKDIR}"/${PN}-${TS_PV:-${PV}}/src
+
+# Needed for tree_sitter/parser.h
+DEPEND="dev-libs/tree-sitter"
+
+EXPORT_FUNCTIONS src_compile src_install
+
+# @FUNCTION: get_tsg_abi_ver
+# @DESCRIPTION:
+# This internal function determines the ABI version of a grammar 
library based
+# on the package version.
+get_tsg_abi_ver() {
+       if ver_test -gt 0.21; then
+               die "Grammar too new; unknown ABI version"
+       elif ver_test -ge 0.19.0; then
+               echo 13
+       else
+               die "Grammar too old; unknown ABI version"
+       fi
+}
+
+# @FUNCTION: tree-sitter-grammar_src_compile
+# @DESCRIPTION:
+# Compiles the Tree Sitter parser as a shared library.
+tree-sitter-grammar_src_compile() {
+       debug-print-function $FUNCNAME $*
+
+       # Grammars always contain parser.c, and sometimes a scanner.c,
+       # or scanner.cc.
+
+       $(tc-getCC) ${CFLAGS} \
+                               ${CPPFLAGS} \
+                               -fPIC \
+                               -c "${S}"/parser.c \
+                               -o "${WORKDIR}"/parser.o || die
+
+       local link=$(tc-getCC)
+
+       if [[ -f "${S}/scanner.c" ]]; then
+               $(tc-getCC) ${CFLAGS} \
+                                       ${CPPFLAGS} \
+                                       -fPIC \
+                                       -c "${S}"/scanner.c \
+                                       -o "${WORKDIR}"/scanner.o || die
+       elif [[ -f "${S}/scanner.cc" ]]; then
+               $(tc-getCXX) ${CXXFLAGS} \
+                                        ${CPPFLAGS} \
+                                        -fPIC \
+                                        -c "${S}"/scanner.cc \
+                                        -o "${WORKDIR}"/scanner.o || die
+               link=$(tc-getCXX)
+       fi
+
+       local soname=lib${PN}.so.$(get_tsg_abi_ver)
+       ${link} ${LDFLAGS} \
+                       -shared \
+                       "${WORKDIR}"/*.o \
+                       -Wl,-soname ${soname} \
+                       -o "${WORKDIR}"/${soname} || die
+}
+
+# @FUNCTION: tree-sitter-grammar_src_install
+# @DESCRIPTION:
+# Installs the Tree Sitter parser library.
+tree-sitter-grammar_src_install() {
+       debug-print-function $FUNCNAME $*
+
+       dolib.so "${WORKDIR}"/lib${PN}.so.$(get_tsg_abi_ver)
+       dosym lib${PN}.so.$(get_tsg_abi_ver) /usr/$(get_libdir)/lib${PN}.so
+}
+fi
--
2.33.0