development

update started from.

This was a real adventure since I didn’t know anything about SCons, and
I can’t say that I’m fond of scons after it, but it does seem to work.
There were two obstacles.

First, the ConfigureJNI module doesn’t successfully configure the JNI on
my system because it was expecting to find `JAVA_HOME` in .., so I added
a little code to notice if it’s failing to find a place where `jni.h`
exists.  (And on my system I did `export
JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64` before running it, but your
pathnames will vary.)  There was a hardcoded pathname in SConscript,
presumably as an interim debugging measure, which I removed.  A
reasonable default to try on Debian-derived systems such as Ubuntu and
LinuxMint might be `/usr/lib/jvm/default-java`, but I didn’t implement
that.

Second, in SConscript, the JNI include directories were being stuck into
a `javaenv` SCons environment object, which was used to build the Java
classes providing the Java interfaces to Hammer, but not the C files
containing the native methods themselves.  Consequently the compiler
couldn’t find the JDK JNI headers when it tried to compile the C code
into a shared library.  It might make sense to use `javaenv` to compile
that shared library, but in case it doesn’t, I cloned the default
environment with an extra include directory.

I hope this is soon enough to be helpful!

includes like jni.h

In Python 2.x an unprefixed string literal produces a byte string.
In Python 3.x an unprefixed string literal produces a textual string.

To produce a byte string in both a b prefix is needed, e.g. b'foo'.
Since I believe Hammer works predominantly with byte strings I have used
b prefixes throughout.

This removes any doubts about what type of string is in use.

This allows the library to be built and tested with a non-default
version of CPython, e.g.

scons bindings=python python=python3.6
scons bindings=python python=python3.6 testpython

In Python 3.x

- int and long types are unified. The unified type is called int.
- the text string type (unicode) is renamed to str.
- the byte string type (str) is renamed to bytes.
- chr returns a text string (i.e. str)
- xrange is renamed to range.
- dict.has_key() is removed
-

These have no effect in Python 3.x, they are the default. Enabling them
in Python 2.x, enabling them in Python 2.x allows single source
compatiblity.

We wrap all remaining references to __attribute__ into a macro call to
H_GCC_ATTRIBUTE, to allow compilation with MSVC CL.EXE

Wrote __call metamethod for HParsedToken, so now returning proper Lua types out of tokens, though char is still an issue.

HCountedArray now looking slightly more table-shaped thanks to __call. Will need to do something similar for HParsedToken to return the appropriate Lua type based on its type tag.