compiler/jv_tea_compiler.st
author Jan Vrany <jan.vrany@fit.cvut.cz>
Wed, 16 Sep 2015 05:29:43 +0100
changeset 11 6d39860d0fdb
parent 9 569bf5707c7e
child 14 fa42d3f1a578
permissions -rw-r--r--
First shot on #ifTrie:ifFalse: special form

"{ Package: 'jv:tea/compiler' }"

"{ NameSpace: Smalltalk }"

LibraryDefinition subclass:#jv_tea_compiler
	instanceVariableNames:''
	classVariableNames:''
	poolDictionaries:''
	category:'* Projects & Packages *'
!


!jv_tea_compiler class methodsFor:'description'!

excludedFromPreRequisites
    "list packages which are to be explicitely excluded from the automatic constructed
     prerequisites list. If empty, everything that is found along the inheritance of any of
     my classes is considered to be a prerequisite package."

    ^ #(
    )
!

mandatoryPreRequisites
    "list packages which are mandatory as a prerequisite.
     This are packages containing superclasses of my classes and classes which
     are extended by myself.
     They are mandatory, because we need these packages as a prerequisite for loading and compiling.
     This method is generated automatically,
     by searching along the inheritance chain of all of my classes."

    ^ #(
        #'stx:goodies/refactoryBrowser/parser'    "RBBlockNode - extended"
        #'stx:goodies/ring'    "RGAbstractContainer - superclass of TCompilationUnitDefinition"
        #'stx:goodies/sunit'    "TestAsserter - superclass of TCompilerExamples"
        #'stx:libbasic'    "Error - superclass of TCompilerError"
    )
!

referencedPreRequisites
    "list packages which are a prerequisite, because they contain
     classes which are referenced by my classes.
     We do not need these packages as a prerequisite for compiling or loading,
     however, a class from it may be referenced during execution and having it
     unloaded then may lead to a runtime doesNotUnderstand error, unless the caller
     includes explicit checks for the package being present.
     This method is generated automatically,
     by searching all classes (and their packages) which are referenced by my classes."

    ^ #(
        #'jv:llvm_s'    "LLVMConstant - referenced by TConstantBinding>>asLLVMValueInModule:"
        #'stx:libbasic3'    "ChangeSet - referenced by TSourceReader>>read:"
    )
!

subProjects
    "list packages which are known as subprojects.
     The generated makefile will enter those and make there as well.
     However: they are not forced to be loaded when a package is loaded;
     for those, redefine requiredPrerequisites."

    ^ #(
    )
! !

!jv_tea_compiler class methodsFor:'description - contents'!

classNamesAndAttributes
    "lists the classes which are to be included in the project.
     Each entry in the list may be: a single class-name (symbol),
     or an array-literal consisting of class name and attributes.
     Attributes are: #autoload or #<os> where os is one of win32, unix,..."

    ^ #(
        "<className> or (<className> attributes...) in load order"
        TBinding
        TClassDefinition
        TCompilationUnitDefinition
        TCompiler
        TCompilerContext
        TCompilerError
        (TCompilerExamples autoload)
        TEnvironmentProvider
        TFormatter
        TInlineAssemblyBeginToken
        TInlineAssemblyEndToken
        TInlineAssemblyNode
        TMetaDefinition
        TMethodDefinition
        TNamespaceDefinition
        TParser
        TProgramNodeVisitor
        TScanner
        TScope
        TSourceReader
        TSpecialFormNode
        TType
        TTypeNode
        TTypeSpecNode
        #'jv_tea_compiler'
        TBlockType
        TClassBinding
        TCompilerPass
        TEnvironment
        TFilesystemProvider
        TFunctionBinding
        TNamespaceBinding
        TSimpleType
        TSimpleTypeNode
        TValueBinding
        TBlockBinding
        TConstantBinding
        TLLVMCodeGenerator
        TMethodBinding
        TSemanticAnalyser
        TTypechecker
        TVariableBinding
        TArgumentBinding
        TLocalBinding
        (TMethodDefinitionTests autoload)
        (TParserTests autoload)
        (TSemanticAnalyserTests autoload)
        (TSourceReaderTests autoload)
        (TTypecheckerTests autoload)
    )
!

extensionMethodNames
    "list class/selector pairs of extensions.
     A correponding method with real names must be present in my concrete subclasses"

    ^ #(
        RBBlockNode returnTypeSpec
        RBBlockNode returnTypeSpec:
        RBMethodNode returnTypeSpec
        RBMethodNode returnTypeSpec:
        RBVariableNode typeSpec
        RBVariableNode typeSpec:
        RBBlockNode scope
        RBBlockNode scope:
        RBMethodNode scope
        RBMethodNode scope:
        RBProgramNode binding
        RBProgramNode binding:
        RBProgramNode scope
        RBReturnNode binding
        RBReturnNode binding:
        RGClassDefinition acceptVisitor:
        RGMetaclassDefinition acceptVisitor:
        RGMethodDefinition acceptVisitor:
        RBProgramNode isInlineAssembly
        RBToken isTInlineAssemblyBegin
        RBToken isTInlineAssemblyEnd
        RGDefinition isCompilationUnit
        RBProgramNode isSpecialFormNode
    )
! !

!jv_tea_compiler class methodsFor:'description - project information'!

companyName
    "Returns a company string which will appear in <lib>.rc.
     Under win32, this is placed into the dlls file-info"

    ^ 'My Company'
!

description
    "Returns a description string which will appear in nt.def / bc.def"

    ^ 'Class Library'
!

legalCopyright
    "Returns a copyright string which will appear in <lib>.rc.
     Under win32, this is placed into the dlls file-info"

    ^ 'My CopyRight or CopyLeft'
!

productName
    "Returns a product name which will appear in <lib>.rc.
     Under win32, this is placed into the dlls file-info.
     This method is usually redefined in a concrete application definition"

    ^ 'LibraryName'
! !

!jv_tea_compiler class methodsFor:'documentation'!

version_HG
    ^ '$Changeset: <not expanded> $'
! !