"

 COPYRIGHT (c) 1993 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libbasic3' }"

ClassChange subclass:#ClassDefinitionChange

	instanceVariableNames:'objectType superClassName classType indexedType otherParameters

		instanceVariableNames classVariableNames

		classInstanceVariableNames poolDictionaries category private

		definitionSelector owningClassName'

	classVariableNames:''

	poolDictionaries:''

	category:'System-Changes'

!

!ClassDefinitionChange class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1993 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    instances represent class definition-changes. 

    They are typically held in a ChangeSet.

    [author:]

        Claus Gittinger

"

! !

!ClassDefinitionChange class methodsFor:'others'!

version_CVS

    ^ '$Header: /cvs/stx/stx/libbasic3/ClassDefinitionChange.st,v 1.76 2013-03-30 01:54:34 cg Exp $'

! !

!ClassDefinitionChange methodsFor:'accessing'!

basicSuperClassName 

    ^ superClassName

!

category

    category isNil ifTrue:[

        self setupFromSource.

    ].

    ^ category

    "Modified: / 11-10-2006 / 14:12:01 / cg"

!

category:something

    category := something.

!

classInstanceVariableNames

    ^ classInstanceVariableNames

!

classInstanceVariableNames:something

    classInstanceVariableNames := something.

!

classVariableNames

    ^ classVariableNames

!

classVariableNames:something

    classVariableNames := something.

!

delta

    | class |

    class := self changeClass.

    class ifNil:[^#+].

    ^(self class isSource: self source sameSourceAs: class definitionWithoutPackage "definition")

        ifTrue:[#=]

        ifFalse:[#~]

    "Modified: / 31-08-2011 / 09:26:48 / cg"

!

deltaDetail

    "Returns a delta to the current state as a ChangeDelta object"

    | class mySource imageSource myTree imageTree same |

    class := self changeClass.

    class isNil ifTrue:[^ ChangeDeltaInformation added ].

    class isLoaded ifFalse:[^ ChangeDeltaInformation different ].

    mySource := self source.

    imageSource := class definitionWithoutPackage "definition".

    same := (mySource = imageSource).

    same ifFalse:[

        same := (self class isSource: mySource sameSourceAs: imageSource ).

        same ifFalse:[

            "/ care for formatting (tabs, indentation etc.)

            myTree := RBParser parseExpression:mySource.

            imageTree := RBParser parseExpression:imageSource.

            same := (myTree = imageTree).

            same ifFalse:[

                "/ some classDefinition strings contain sn

                "/ instVarName string like 'foo bar ' instead of 'foo bar' (i.e. added a space)...

                ((myTree receiver = imageTree receiver)

                    and:[ (myTree selector = imageTree selector)

                    and:[ ('*ubclass:instanceVariableNames:classVariableNames:poolDictionaries:category:' match: myTree selector)

                    and:[ (myTree arguments at:1) = (imageTree arguments at:1)  

                    and:[ (2 to:5) conform:[:i |

                            ((myTree arguments at:i) isLiteral

                            and:[ (imageTree arguments at:i) isLiteral

                            and:[ (myTree arguments at:i) value asString withoutSeparators

                                  = (imageTree arguments at:i) value asString withoutSeparators ]]) ]   

                ]]]])

                    ifTrue:[

                        same := true

                    ]

            ].

        ]

    ].

    ^ same 

        ifTrue:[ ChangeDeltaInformation identical ]

        ifFalse:[ ChangeDeltaInformation different ]

    "Created: / 31-08-2011 / 10:26:42 / cg"

    "Modified: / 24-01-2012 / 22:13:23 / Jan Vrany <jan.vrany@fit.cvut.cz>"

!

imageSource

    "return the source for the in-image version of the method"

    | cls |

    cls := self changeClass.

    cls isNil ifTrue:[ ^ nil ].

    ^ cls definitionWithoutPackage

!

instanceVariableNames

    ^ instanceVariableNames

!

instanceVariableNames:something

    instanceVariableNames := something.

!

localClassName

    "for private classes, this returns the name relative to its owner;

     for non-private ones, this is the regular name.

     Notice that className always returns the full name (incl. any owner prefix)"

    self isPrivateClassDefinitionChange ifFalse:[^ self className].

    (className startsWith:(owningClassName,'::')) ifTrue:[

        ^ className copyFrom:(owningClassName size + 2 + 1).

    ] ifFalse:[

        "/ should not happen

        ^ self className

    ]

!

nameSpaceName

    objectType == #variable ifTrue:[

        ^ nil

    ].

    ^ self cutNameSpaceOf:(self nameSpaceOverride ? super nameSpaceName)

    "Modified: / 07-09-2011 / 20:47:14 / cg"

!

nameSpaceName: aNameSpaceName classType: aClassType otherParameters:otherParametersArg

    "this instance setup message is used when reading from a VW-xml change file.

     Support for this is not yet complete."

    |indexedType imports|

    nameSpaceOverride := aNameSpaceName.

    classType := aClassType.

    otherParameters := Dictionary new addAll:otherParametersArg; yourself.

    superClassName := otherParameters at:#superclass: ifAbsent:nil.

    self assert:(superClassName notNil).

    superClassName notNil ifTrue:[

        superClassName := superClassName pathString.

    ].

    indexedType := otherParameters at:#indexedType: ifAbsent:nil.

    private := otherParameters at:#private: ifAbsent:nil.

    instanceVariableNames := otherParameters at:#instanceVariableNames: ifAbsent:nil.

    classInstanceVariableNames := otherParameters at:#classInstanceVariableNames: ifAbsent:nil.

    imports := otherParameters at:#imports: ifAbsent:nil.

    category := otherParameters at:#category: ifAbsent:nil.

    "Modified: / 15-06-2010 / 14:50:35 / cg"

!

objectType

    "return the value of the instance variable 'objectType' (automatically generated)"

    ^ objectType

!

objectType:something

    "set the value of the instance variable 'objectType' (automatically generated)"

    objectType := something.

!

poolDictionaries

    poolDictionaries isNil ifTrue:[

        self setupFromSource.

    ].

    ^ poolDictionaries

    "Modified: / 13-06-2012 / 12:23:41 / cg"

!

poolDictionaries:something

    poolDictionaries := something.

!

private:aBoolean

    private := aBoolean.

    "Created: / 30-08-2010 / 13:56:11 / cg"

!

source

    "return the source of the change"

    |src ns|

    (src := source) isNil ifTrue:[

        src := self definitionString

    ].

"/ ouch - already done in definitionString !!!!!!

"/    (ns := self nameSpaceOverride) notNil ifTrue:[

"/        (className startsWith:(ns,'::')) ifFalse:[

"/            ^ '"{ NameSpace: ' , ns , ' }"' , 

"/                Character cr, Character cr , 

"/                src string

"/        ].

"/    ].

    ^ src

    "Modified: / 10-08-2012 / 11:53:54 / cg"

!

superClassName 

    |nm|

    nm := superClassName.

    nm isNil ifTrue:[^ 'nil'].

    "/ convert VW namespace syntax

    (nm includes:$.) ifTrue:[

        ^ nm copyReplaceAll:$. withAll:'::'.

    ].

    ^ nm

!

superClassName:aString

    superClassName := aString.

    self assert:(aString notNil).

    self invalidateSource.

!

superClassNameWithoutMyNamespace

    |nm|

    superClassName isNil ifTrue:[^ 'nil'].

    nm := self cutMyNameSpaceOf:superClassName.

    (nm includes:$.) ifTrue:[

        ^ nm copyReplaceAll:$. withAll:'::'.

    ].

    ^ nm

    "Modified: / 03-03-2007 / 13:09:07 / cg"

!

superClassNameWithoutNamespace

    |nm|

    nm := self cutNameSpaceOf:superClassName.

    (nm includes:$.) ifTrue:[

        ^ nm copyReplaceAll:$. withAll:'::'.

    ].

    ^ nm

! !

!ClassDefinitionChange methodsFor:'applying'!

apply

    |changeClass|

    superClassName isNil ifTrue:[

        self setupFromSource

        superClassName isNil ifTrue:[

            self error:'Should not happen'

        ].

    ].

    (Smalltalk classNamed:superClassName) isNil ifTrue:[

        Class undeclared:superClassName

    ].

    Parser evaluate:self source.       

    package notNil ifTrue:[

        changeClass := self changeClass.

        changeClass notNil ifTrue:[

            changeClass setPackage:package.

        ].

    ].

    "

      (ClassDefinitionChange className: #TestB source: 'TestA subclass: #TestB

          instanceVariableNames:''''

          classVariableNames:''''

          poolDictionaries:''''

          category:''* remove me *''')

          apply

    "

    "Modified: / 08-11-2010 / 16:10:16 / Jan Vrany <jan.vrany@fit.cvut.cz>"

    "Modified: / 06-10-2011 / 17:01:58 / cg"

! !

!ClassDefinitionChange methodsFor:'comparing'!

isForSameAs:changeB

    "return true, if the given change represents a change for the same

     thingy as the receiver (i.e. same method, same definition etc.)."

    changeB isClassDefinitionChange ifFalse:[^ false].   

    ^ className = changeB className

!

sameAs:changeB

    "return true, if the given change represents the same change as the receiver."

    (self isForSameAs:changeB) ifFalse:[^ false].

    ^ self sameSourceAs:changeB

! !

!ClassDefinitionChange methodsFor:'converting'!

asAntiChange

    ^ClassRemoveChange className: self className

    "Created: / 02-11-2009 / 11:11:29 / Jan Vrany <jan.vrany@fit.cvut.cz>"

! !

!ClassDefinitionChange methodsFor:'printing & storing'!

definitionString

    |ns classNameUsed superClassNameUsed selPart|

    ns := self nameSpaceOverride.

    objectType == #variable ifTrue:[

        ^ String streamContents:[:stream |

            ns notNil ifTrue:[

                stream nextPutAll:((ns asCollectionOfSubstringsSeparatedBy:$.) asStringWith:'::')

            ] ifFalse:[

                self halt:'can this happen ?'.

                stream nextPutAll:'Smalltalk'

            ].

            stream 

                nextPutAll:' addClassVarName:';

                nextPutAll:className asString storeString

          ].

    ].

    superClassNameUsed := self superClassName.

    "/ careful with private classes: the definition MUST give the

    "/ local name as argument, not the full name

    classNameUsed := self localClassName.

    selPart := (self definitionSelector ? #'subclass:instanceVariableNames:classVariableNames:poolDictionaries:category:')

                    keywords first.         

    ^ String streamContents:[:stream |

        stream 

            nextPutAll:superClassNameUsed;

            nextPutAll:' ',selPart;

            nextPutAll: classNameUsed asSymbol storeString;

            cr;

            spaces:4;

            nextPutAll:'instanceVariableNames: ';

            nextPutAll:(instanceVariableNames ? '') storeString;

            cr;

            spaces:4;

            nextPutAll:'classVariableNames: ';

            nextPutAll:(classVariableNames ? '') storeString;

            cr;

            spaces:4;

            nextPutAll:'poolDictionaries: ';

            nextPutAll:(poolDictionaries ? '') storeString;

            cr.

        private == true ifTrue:[

            stream 

                spaces:4;

                nextPutAll:'privateIn: ';

                nextPutAll:(self owningClassName)

        ] ifFalse:[

            stream 

                spaces:4;

                nextPutAll:'category: ';

                nextPutAll:(category ? '') storeString

        ].

      ]

    "Modified: / 13-06-2012 / 13:01:58 / cg"

!

definitionStringInNamespace: ns

    | classNameUsed superClassNameUsed |

    objectType == #variable ifTrue:[

        ^ String streamContents:[:stream |

            ns notNil ifTrue:[

                stream 

                    nextPutAll:((ns asCollectionOfSubstringsSeparatedBy:$.) asStringWith:'::')

            ] ifFalse:[

                self halt:'can this happen ?'.

                stream 

                    nextPutAll:'Smalltalk'

            ].

            stream 

                nextPutAll:' addClassVarName:';

                nextPutAll:className asString storeString

          ].

    ].

    superClassNameUsed := self superClassName.

    classNameUsed := self classNameWithoutNamespace.

    ^ String streamContents:[:stream |

        self isPrivateClassDefinitionChange ifFalse:[

            stream 

                nextPutAll:(superClassNameUsed ? 'nil');

                nextPutAll:' subclass:';

                nextPutAll: classNameUsed asSymbol storeString

                ;

                cr;

                tab;

                nextPutAll:'instanceVariableNames:';

                nextPutAll:(instanceVariableNames ? '') storeString;

                cr;

                tab;

                nextPutAll:'classVariableNames:';

                nextPutAll:(classVariableNames ? '') storeString;

                cr;