ndtypes 0.2.0dev4

data/ext/ruby_ndtypes/ndtypes/configure.ac

@@ -0,0 +1,161 @@
+
+AC_PREREQ([2.67])
+AC_INIT(ndtypes, 0.2.0dev3, skrah@bytereef.org, ndtypes, https://github.com/plures/)
+AC_CONFIG_HEADER(config.h)
+AC_CONFIG_FILES([
+  Makefile
+  libndtypes/Makefile libndtypes/tests/Makefile libndtypes/ndtypes.h
+  libndtypes/compat/Makefile
+  libndtypes/serialize/Makefile
+])
+
+# System and machine type (only used for Darwin):
+AC_MSG_CHECKING(system as reported by uname -s)
+ac_sys_system=`uname -s`
+AC_MSG_RESULT($ac_sys_system)
+
+LIBSTATIC=libndtypes.a
+case $ac_sys_system in
+    darwin*|Darwin*)
+        LIBRARY_PATH="DYLD_LIBRARY_PATH"
+        LIBNAME="libndtypes.dylib"
+        LIBSONAME="libndtypes.0.dylib"
+        LIBSHARED="libndtypes.0.2.0dev3.dylib"
+        CONFIGURE_LDFLAGS="-dynamiclib -install_name @rpath/$LIBSONAME -compatibility_version 0.2 -current_version 0.2.0"
+        ;;
+    *)
+        LIBRARY_PATH="LD_LIBRARY_PATH"
+        LIBNAME="libndtypes.so"
+        LIBSONAME="libndtypes.so.0"
+        LIBSHARED="libndtypes.so.0.2.0dev3"
+        CONFIGURE_LDFLAGS="-shared -Wl,-soname,$LIBSONAME"
+        ;;
+esac
+
+AC_SUBST(LIBSTATIC)
+AC_SUBST(LIBRARY_PATH)
+AC_SUBST(LIBNAME)
+AC_SUBST(LIBSONAME)
+AC_SUBST(LIBSHARED)
+
+
+# Apparently purely informational for this particular build:
+AC_CANONICAL_HOST
+AC_SUBST(build)
+AC_SUBST(host)
+
+# Language and compiler:
+AC_LANG_C
+saved_cflags=$CFLAGS
+AC_PROG_CC
+CFLAGS=$saved_cflags
+
+# ar and ranlib:
+AC_CHECK_TOOL(AR, ar, ar)
+AC_PROG_RANLIB
+AC_SUBST(RANLIB)
+
+
+# Checks for header files:
+AC_HEADER_STDC
+
+# Install program:
+AC_PROG_INSTALL
+AC_SUBST(INSTALL)
+
+# Endianness:
+AC_C_BIGENDIAN
+
+if test "$ac_cv_c_bigendian" = "yes"; then
+  NDT_SYS_BIG_ENDIAN=1
+else
+  NDT_SYS_BIG_ENDIAN=0
+fi
+
+AC_SUBST(NDT_SYS_BIG_ENDIAN)
+
+# Exact memcheck:
+AC_MSG_CHECKING([for --with-valgrind])
+AC_ARG_WITH([valgrind],
+  AS_HELP_STRING([--with-valgrind], [enable exact memcheck]),,
+  with_valgrind=no)
+AC_MSG_RESULT([$with_valgrind])
+if test "$with_valgrind" != no; then
+    AC_CHECK_HEADER([valgrind/memcheck.h],
+      [AC_DEFINE([WITH_VALGRIND], 1, [required for exact memcheck])],
+      [AC_MSG_ERROR([exact memcheck requested but headers not available])]
+    )
+fi
+
+# Without documentation:
+AC_MSG_CHECKING([for --with-docs])
+AC_ARG_WITH([docs],
+  AS_HELP_STRING([--with-docs], [install documentation - enabled by default]),,
+  with_docs=yes)
+AC_MSG_RESULT([$with_docs])
+if test "$with_docs" = yes; then
+   NDT_INSTALL_DOCS="install_docs"
+else
+   NDT_INSTALL_DOCS=""
+fi
+
+AC_SUBST(NDT_INSTALL_DOCS)
+
+# Compiler dependent settings:
+NDT_WARN=
+NDT_OPT="-O2 -g"
+case $CC in
+    *gcc*)
+        NDT_WARN="-Wall -Wextra -std=c11 -pedantic"
+        NDT_OPT="-O2 -g"
+        NDT_COV_CFLAGS="-O0 -g -fno-inline -fprofile-arcs -ftest-coverage"
+        NDT_COV_LDFLAGS="-fprofile-arcs"
+        ;;
+    *icc*)
+        AR=xiar
+        NDT_WARN="-Wall"
+        NDT_OPT="-O2 -g"
+        NDT_COV_CFLAGS=""
+        NDT_COV_LDFLAGS=""
+        ;;
+    *clang*)
+        NDT_WARN="-Wall -Wextra -std=c11 -pedantic"
+        NDT_OPT="-O2 -g"
+        NDT_COV_CFLAGS="-O0 -g -fno-inline -fprofile-arcs -ftest-coverage"
+        NDT_COV_LDFLAGS="-fprofile-arcs"
+        ;;
+esac
+
+
+# Substitute variables and generate output:
+if test -z "$LD"; then
+    LD="$CC"
+fi
+AC_SUBST(LD)
+AC_SUBST(AR)
+AC_SUBST(NDT_WARN)
+AC_SUBST(NDT_OPT)
+
+
+if test -z "$CFLAGS"; then
+    CONFIGURE_CFLAGS="-I.. $NDT_WARN $NDT_OPT"
+    CONFIGURE_COV_CFLAGS="-I.. $NDT_WARN $NDT_COV_CFLAGS"
+else
+    CONFIGURE_CFLAGS="-I.. $NDT_WARN $NDT_OPT $CFLAGS"
+    CONFIGURE_COV_CFLAGS="-I.. $NDT_WARN $NDT_COV_CFLAGS $CFLAGS"
+fi
+
+CONFIGURE_COV_LDFLAGS="$CONFIGURE_LDFLAGS $NDT_COV_LDFLAGS"
+if test -n "$LDFLAGS"; then
+    CONFIGURE_LDFLAGS="$CONFIGURE_LDFLAGS $LDFLAGS"
+    CONFIGURE_COV_LDFLAGS="$CONFIGURE_COV_LDFLAGS $LDFLAGS"
+fi
+
+AC_SUBST(CONFIGURE_CFLAGS)
+AC_SUBST(CONFIGURE_LDFLAGS)
+
+AC_SUBST(CONFIGURE_COV_CFLAGS)
+AC_SUBST(CONFIGURE_COV_LDFLAGS)
+
+AC_OUTPUT
+

data/ext/ruby_ndtypes/ndtypes/doc/Makefile

@@ -0,0 +1,14 @@
+# Makefile for Sphinx documentation.
+SPHINXBUILD = sphinx-build
+BUILDDIR = build
+
+default: html
+
+html:
+	sphinx-build -b html -d build/doctrees . build/html
+
+doctest:
+	sphinx-build -b doctest -d build/doctrees . build/html
+
+clean:
+	rm -rf $(BUILDDIR)/*

data/ext/ruby_ndtypes/ndtypes/doc/_static/copybutton.js

@@ -0,0 +1,66 @@
+// Copyright 2014 PSF. Licensed under the PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
+// File originates from the cpython source found in Doc/tools/sphinxext/static/copybutton.js
+
+$(document).ready(function() {
+    /* Add a [>>>] button on the top-right corner of code samples to hide
+     * the >>> and ... prompts and the output and thus make the code
+     * copyable. */
+    var div = $('.highlight-py .highlight,' +
+                '.highlight-default .highlight,' +
+                '.highlight-py3 .highlight')
+    var pre = div.find('pre');
+
+    // get the styles from the current theme
+    pre.parent().parent().css('position', 'relative');
+    var hide_text = 'Hide the prompts and output';
+    var show_text = 'Show the prompts and output';
+    var border_width = pre.css('border-top-width');
+    var border_style = pre.css('border-top-style');
+    var border_color = pre.css('border-top-color');
+    var button_styles = {
+        'cursor':'pointer', 'position': 'absolute', 'top': '0', 'right': '0',
+        'border-color': border_color, 'border-style': border_style,
+        'border-width': border_width, 'color': border_color, 'text-size': '75%',
+        'font-family': 'monospace', 'padding-left': '0.2em', 'padding-right': '0.2em',
+        'border-radius': '0 3px 0 0'
+    }
+
+    // create and add the button to all the code blocks that contain >>>
+    div.each(function(index) {
+        var jthis = $(this);
+        if (jthis.find('.gp').length > 0) {
+            var button = $('<span class="copybutton">&gt;&gt;&gt;</span>');
+            button.css(button_styles)
+            button.attr('title', hide_text);
+            button.data('hidden', 'false');
+            jthis.prepend(button);
+        }
+        // tracebacks (.gt) contain bare text elements that need to be
+        // wrapped in a span to work with .nextUntil() (see later)
+        jthis.find('pre:has(.gt)').contents().filter(function() {
+            return ((this.nodeType == 3) && (this.data.trim().length > 0));
+        }).wrap('<span>');
+    });
+
+    // define the behavior of the button when it's clicked
+    $('.copybutton').click(function(e){
+        e.preventDefault();
+        var button = $(this);
+        if (button.data('hidden') === 'false') {
+            // hide the code output
+            button.parent().find('.go, .gp, .gt').hide();
+            button.next('pre').find('.gt').nextUntil('.gp, .go').css('visibility', 'hidden');
+            button.css('text-decoration', 'line-through');
+            button.attr('title', show_text);
+            button.data('hidden', 'true');
+        } else {
+            // show the code output
+            button.parent().find('.go, .gp, .gt').show();
+            button.next('pre').find('.gt').nextUntil('.gp, .go').css('visibility', 'visible');
+            button.css('text-decoration', 'none');
+            button.attr('title', hide_text);
+            button.data('hidden', 'false');
+        }
+    });
+});
+

data/ext/ruby_ndtypes/ndtypes/doc/conf.py

@@ -0,0 +1,26 @@
+import sys, os, docutils
+
+
+extensions = ['sphinx.ext.intersphinx', 'sphinx.ext.doctest']
+
+source_suffix = '.rst'
+master_doc = 'index'
+project = 'ndtypes'
+copyright = '2017-2018, Plures Project'
+version = 'v0.2.0dev3'
+release = 'v0.2.0dev3'
+exclude_patterns = ['doc', 'build']
+pygments_style = 'sphinx'
+html_static_path = ['_static']
+
+primary_domain = 'py'
+add_function_parentheses = False
+
+
+def setup(app):
+    app.add_crossref_type('topic', 'topic', 'single: %s',
+                          docutils.nodes.strong)
+    app.add_javascript("copybutton.js")
+
+
+

data/ext/ruby_ndtypes/ndtypes/doc/grammar/grammar.rst

@@ -0,0 +1,27 @@
+.. meta::
+   :robots: index,follow
+   :description: libndtypes datashape documentation
+
+.. sectionauthor:: Stefan Krah <skrah at bytereef.org>
+
+
+Grammar
+=======
+
+Lexing
+------
+
+The latest version of the lexer can be found here:
+
+`lexer.l <https://github.com/plures/ndtypes/blob/master/libndtypes/lexer.l>`_ 
+
+
+Parsing
+-------
+
+The latest version of the grammar can be found here:
+
+`grammar.y <https://github.com/plures/ndtypes/blob/master/libndtypes/grammar.y>`_ 
+
+
+

data/ext/ruby_ndtypes/ndtypes/doc/index.rst

@@ -0,0 +1,56 @@
+.. meta::
+   :robots: index, follow
+   :description: libndtypes documentation
+   :keywords: datashape, libndtypes, C, Python, array computing
+
+.. sectionauthor:: Stefan Krah <skrah at bytereef.org>
+
+
+ndtypes
+=======
+
+ndtypes is a package for typing raw memory blocks using a close variant
+of the datashape type language.
+
+
+Libndtypes
+----------
+
+C library.
+
+.. toctree::
+   :maxdepth: 1
+
+   libndtypes/index.rst
+
+
+Ndtypes
+-------
+
+Python bindings for libndtypes.
+
+
+.. toctree::
+   :maxdepth: 1
+
+   ndtypes/index.rst
+
+
+Grammar
+-------
+
+Type grammar.
+
+.. toctree::
+   :maxdepth: 1
+
+   grammar/grammar.rst
+
+
+Releases
+--------
+
+.. toctree::
+   :maxdepth: 1
+
+   releases/index.rst

data/ext/ruby_ndtypes/ndtypes/doc/libndtypes/context.rst

@@ -0,0 +1,131 @@
+.. meta::
+   :robots: index,follow
+   :description: libndtypes documentation
+
+.. sectionauthor:: Stefan Krah <skrah at bytereef.org>
+
+
+Context
+=======
+
+The context is used to facilitate error handling. The context struct itself
+should not be considered public and is subject to change.
+
+
+Constants
+---------
+
+The *err* field of the context is set to one of the following enum values:
+
+.. code-block:: c
+
+   #include <ndtypes.h>
+
+   enum ndt_error {
+     NDT_Success,
+     NDT_ValueError,
+     NDT_TypeError,
+     NDT_InvalidArgumentError,
+     NDT_NotImplementedError,
+     NDT_LexError,
+     NDT_ParseError,
+     NDT_OSError,
+     NDT_RuntimeError,
+     NDT_MemoryError
+   };
+
+
+Static contexts
+---------------
+
+.. code-block:: c
+
+    NDT_STATIC_CONTEXT(ctx);
+
+This creates a static context, usually a local variable in a function.
+Error messages may be dynamically allocated, so :func:`ndt_context_del`
+must be called on static contexts, too.
+
+
+Functions
+---------
+
+.. topic:: ndt_context_new
+.. topic:: ndt_context_del
+
+.. code-block:: c
+
+   ndt_context_t *ndt_context_new(void);
+   void ndt_context_del(ndt_context_t *ctx);
+
+
+Create an initialized context or delete a context.  It is safe to call
+:func:`ndt_context_del` on both dynamic and static contexts.
+
+
+.. topic:: ndt_err_format
+
+.. code-block:: c
+
+   void ndt_err_format(ndt_context_t *ctx, enum ndt_error err, const char *fmt, ...);
+
+Set a context's error constant and error message.  *fmt* may contain the same
+format specifiers as :func:`printf`.
+
+
+.. topic:: ndt_err_occurred
+
+.. code-block:: c
+
+   int ndt_err_occurred(const ndt_context_t *ctx);
+
+Check if an error has occurred.
+
+
+.. topic:: ndt_err_clear
+
+.. code-block:: c
+
+    void ndt_err_clear(ndt_context_t *ctx);
+
+Clear an error.
+
+
+.. topic:: ndt_memory_error
+
+.. code-block:: c
+
+   void *ndt_memory_error(ndt_context_t *ctx);
+
+Convenience function.  Set :c:macro:`NDT_MemoryError` and return :c:macro:`NULL`;
+
+
+.. topic:: ndt_err_as_string
+
+.. code-block:: c
+
+   const char *ndt_err_as_string(enum ndt_error err);
+
+Get the string representation of an error constant.
+
+
+.. topic:: ndt_context_msg
+
+.. code-block:: c
+
+   const char *ndt_context_msg(ndt_context_t *ctx);
+
+Get the current error string.  It is safe to call this function if no
+error has occurred, in which case the string is :c:macro:`Success`.
+
+
+.. topic:: ndt_err_fprint
+
+.. code-block:: c
+
+   ndt_err_fprint(FILE *fp, ndt_context_t *ctx);
+
+Print an error to *fp*.  Mostly useful for debugging.
+
+
+