Compiler module reference - nim-lang/Nim GitHub Wiki

This wiki page was written quickly and may contain information which is out of date or needs to be worded better.

Module

aliases.nim - Alias Analysis

Used for term-rewriting macros. Buggy for this purpose because it has been rewritten with something completely different in mind. Analysis is both value and type based. Looks for areas

ast.nim

Tree structure

astalgo

contains helpers and debug procedures, which work on symbols, types, and node.

babel.cmd

helper for compilers babel support

bitsets

Helpers for code generator. Set representation as an array of bits

nimsets.nim -

The complement to bitsets. Set representation as an AST

Canonicalizer

Will be the future. Used to make the C code generator generate code in a much more deterministic fashion.

ccgcalls

C code generator calls. Generates a call expression in C, objective c, and C++ syntax. What needs to be done is that we often need to translate the result type into a hidden parameter.

cggexpr

C code generation for expressions. Divide between stmts and expr mostly historical

ccgmerge

A merger for C files which is used for the symbol files feature.

ccgstmts

Code generation for statements. See ccgexprs. NOt for for loops, b/c they are eliminated.

ccthreadvars

Thread variable emulation.

ccgtypes

complex, b/c deals with types. The PNode's are not cyclic. You can recurse them without any recursion checks. Type generation for the c backend, as well as run time type generation.

ccgutils

Misc. utilities for C generation code. Contains hash string. Has to be same as system hash string, generate hashes at compile time. Also contains getUniqueType, to be deprecated in place of the canonicalization module.

cgen.nim

Main file for the C code generation. Includes things like DLL generation, foreign function interface, dispatches to. Cgendata is the main structure.

cgmeth.nim

code generation for methods. Performs AST to AST transformations. Analysis away method look up.

commands.nim

Command line argument processing.

condsyms

conditional symbols

crc.nim

cyclic redundancy check algorithm. Used by symbol files, recom

depends.nim

Pass which computes dependancies between modules. Able to generate a dot file which can be used.

docgen.nim

Old documentation generator, which doesn't use the semantic pass. Doesn't know about symbols and identifiers.

docgen2.nim

New documenation generator

effects.nim -

evalffi.nim -

evals.nim

old evaluation engine, not used anymore

exccomp

external compiler, describes how the c compiler is invoked.

filter_template

hashbang filter

filters

helper for common stuff which source code filter.

syntaxes.nim -

guards -

Growing module. Flow sensitive analysis, mainly for values. Used for not nil checking

hlo -

High level optimizer. Part of the term-rewriting macro engine.

idents.nim -

PIdents. Hash identifiers into a single global hash table

idgen -

ID generator. Used to create persistant IDs for the symbol files mechanism

imports.nim -

The module which has the helpers which deal with the module import mechanism.

jsgen -

Javascript code generator

lambdalifting -

Pass which changes closures into pairs of function pointers and environments

lexer -

the lexer

lists -

Linked list implementation

llstream -

low level stream which contains some features which the compiler needs.

lookups.nim -

helpers for symbol lookup. Quite involved due to templates, overloading, etc.

lowerings -

Quite new module which implements common AST to AST helpers.

magicsyms -

compilerproc symbol is used by code generator whic inse

modules.nim -

Module handling

message.nim -

Messages, warnings, hints.

nimconf -

configuration file handling

nimeval -

the upcoming virtual machine to evaluate code.

nimlexbase -

Old lexbase. Buffer handling fo rthe lexer.

nimrod.nim -

Main nimrod file which produces the nimrod executable.

options -

Contains commandline options and checks.

parampatterns -

Related to overloading based on AST

parseaux -

auxileries for the parser. Contains verbosity handling.

sempass2 -

additional semantic checking.

patterns -

related to term rewriting macros

pbraces -

start of braces parser

platform.nim -

contains information for cross compiling (data type information)

pragmas.nim -

Contains all the pragmas that the compiler support. Use a set approach. Contains one big procedure which parses all the possible pragmas.

pretty.nim -

Prettifier. Used for case consistancy

procfind -

used to find the header of a procedure. Used to determine if

renderer -

able to give a string representation in the AST.

rodread -

Reader of rod files, the symbol file mechanism. It also does module dependency tracking to decide whether a rod file can be used or whether the module needs to be recompiled

rodutils -

utilities for above

ropes -

Used throughout the code generator

seterate.nim -

Implements saturated arithmatic for integers.

sem.nim -

Main file for the semantic checker

semcall -

semantic checking for calls

semdata -

contains the main data structures for semantic checking.

semdestruct -

semantic checking for destructors.

semexprs -

semantic checking for expressions.

semfold -

semantic checking for constant folding. Needed in the semantic pass, since things like bounds checking etc rely on such data.

semgnrc -

pass which implements symbol lookups for generics.

seminst -

instantiation of generics

macrosanity -

generates semantic ast checking for macros

semmagic -

magics that need special treatment after overloading resolution.

semparallel -

semantic checking for the upcoming parallel statement

sempass2 -

Effect tracking

service.nim -

IDE Tool stuff

sigmatch -

very important module. Overloading resolution procedures.

suggest.nim -

helper for IDE tools

syntaxes -

dispatching for what parser or sourcecodefilter to invoke.

transf -

old transformation pass. Prepass before the code generator. Mostly deals with for loops into while loops

trees.nim -

Helper for ast (should get rid of)

treetab -

hashtable which works with trees

types -

helper for types

typesrenderer -

new. Used for the documentation generator so we get names

vm.nim -

new virtual machine for compile time evaluation