Rename 'llvm_compiler.Compiler' to 'native_compiler.NativeCompiler'.

This class is intended to be the main entrypoint for client code that wants to compile native_ast
objects into actual runnable code. All LLVM/compiler details should be encapsulated by it.

Author: braxtonmckee

typed_python/compiler/native_compiler/native_ast_to_llvm_test.py

@@ -16,7 +16,7 @@
     Expression, Void, Int32, nullExpr, Function, FunctionBody,
     Teardown, const_int32_expr, CallTarget, NamedCallTarget
 )
-from typed_python.compiler.native_compiler.llvm_compiler import llvm
+import llvmlite.binding as llvm
 import typed_python.compiler.native_compiler.native_ast_to_llvm as native_ast_to_llvm
 import unittest
 

typed_python/compiler/native_compiler/llvm_compiler.py renamed to typed_python/compiler/native_compiler/native_compiler.py

@@ -83,7 +83,15 @@ def create_execution_engine(inlineThreshold):
     return engine, pass_manager
 
 
-class Compiler:
+class NativeCompiler:
+    """"Engine for compiling bundles of native_ast.Function objects into NativeFunctionPointers.
+
+    This class is responsible for
+        * telling clients what named functions have been defined and what their types are.
+        * compiling functions into a runnable form using llvm
+        * performing any runtime-based performance optimizations
+        * maintaining the compiler cache
+    """
     def __init__(self, inlineThreshold):
         self.engine, self.module_pass_manager = create_execution_engine(inlineThreshold)
         self.converter = native_ast_to_llvm.Converter()

typed_python/compiler/native_compiler/llvm_compiler_test.py renamed to typed_python/compiler/native_compiler/native_compiler_test.py

@@ -55,9 +55,9 @@ def test_global_variable_pointers():
 
     # we have to use the singleton here because the llvm context
     # is global.
-    llvmCompiler = Runtime.singleton().llvm_compiler
+    nativeCompiler = Runtime.singleton().native_compiler
 
-    loadedModule = llvmCompiler.buildModule(
+    loadedModule = nativeCompiler.buildModule(
         dict(
             _readGlobalVarFunc=readGlobalVarFunc,
             _returnGlobalVarPtrFunc=returnGlobalVarPtrFunc
@@ -109,9 +109,9 @@ def test_create_binary_shared_object():
         )
     )
 
-    llvmCompiler = Runtime.singleton().llvm_compiler
+    nativeCompiler = Runtime.singleton().native_compiler
 
-    bso = llvmCompiler.buildSharedObject(
+    bso = nativeCompiler.buildSharedObject(
         {'__test_f_2': f}
     )
 

typed_python/compiler/runtime.py

@@ -17,7 +17,7 @@
 import time
 import types
 import typed_python.compiler.python_to_native_converter as python_to_native_converter
-import typed_python.compiler.native_compiler.llvm_compiler as llvm_compiler
+import typed_python.compiler.native_compiler.native_compiler as native_compiler
 import typed_python
 from typed_python.compiler.runtime_lock import runtimeLock
 from typed_python.compiler.conversion_level import ConversionLevel
@@ -207,9 +207,9 @@ def __init__(self):
             )
         else:
             self.compilerCache = None
-        self.llvm_compiler = llvm_compiler.Compiler(inlineThreshold=100)
+        self.native_compiler = native_compiler.NativeCompiler(inlineThreshold=100)
         self.converter = python_to_native_converter.PythonToNativeConverter(
-            self.llvm_compiler,
+            self.native_compiler,
             self.compilerCache
         )
         self.lock = runtimeLock
@@ -223,9 +223,9 @@ def __init__(self):
                 else:
                     self.addEventVisitor(PrintNewFunctionVisitor(True))
             if self.verbosityLevel >= 4:
-                self.llvm_compiler.mark_converter_verbose()
+                self.native_compiler.mark_converter_verbose()
             if self.verbosityLevel >= 5:
-                self.llvm_compiler.mark_llvm_codegen_verbose()
+                self.native_compiler.mark_llvm_codegen_verbose()
         else:
             self.verbosityLevel = 0