"
jv:libgdbs - GNU Debugger Interface Library
Copyright (C) 2015-now Jan Vrany

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License. 

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
"
"{ Package: 'jv:libgdbs' }"

"{ NameSpace: Smalltalk }"

GDBObject subclass:#GDBDebuggerObject
	instanceVariableNames:'debugger'
	classVariableNames:''
	poolDictionaries:''
	category:'GDB-Core'
!

!GDBDebuggerObject class methodsFor:'documentation'!

copyright
"
jv:libgdbs - GNU Debugger Interface Library
Copyright (C) 2015-now Jan Vrany

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License. 

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
"
! !

!GDBDebuggerObject class methodsFor:'testing'!

isAbstract
    ^ self == GDBDebuggerObject
! !

!GDBDebuggerObject methodsFor:'accessing'!

debugger
    ^ debugger
! !

!GDBDebuggerObject methodsFor:'initialization & release'!

setDebugger: aGDBDebugger
    self assert: (debugger isNil or:[ aGDBDebugger isNil or:[debugger == aGDBDebugger]]).
    debugger := aGDBDebugger

    "Created: / 07-09-2014 / 21:17:43 / Jan Vrany <jan.vrany@fit.cvut.cz>"
    "Modified: / 07-02-2019 / 15:15:49 / Jan Vrany <jan.vrany@fit.cvut.cz>"
! !

!GDBDebuggerObject methodsFor:'private'!

ensureIsValid
    self isValid ifFalse:[
        (GDBInvalidObjectError newException)
            parameter:self;
            messageText:'Object is no longer valid';
            raise.
    ].

    "Created: / 04-02-2018 / 21:27:49 / Jan Vrany <jan.vrany@fit.cvut.cz>"
!

updateFrom: anotherObject
    "Update receiver  from `anotherObject`. This can be (is) used to update
     existing objects from 'new' ones in order to preseve identity of objects."

    | names ignored |

    self assert: self class == anotherObject class.
    self assert: (debugger == anotherObject debugger or:[anotherObject debugger isNil]).

    names := self class allInstVarNames.
    ignored := self updateFromIgnoredInstvarNames collect:[ :name | names indexOf: name ].
    1 to: self class instSize do:[:index | 
        (ignored includes: index) ifFalse:[
            self instVarAt: index put: (anotherObject instVarAt: index).
        ]. 
    ].

    "Created: / 25-02-2019 / 15:04:13 / Jan Vrany <jan.vrany@fit.cvut.cz>"
    "Modified: / 25-02-2019 / 17:37:48 / Jan Vrany <jan.vrany@fit.cvut.cz>"
!

updateFromIgnoredInstvarNames
    "Return an array of instvar names to be ignored (skipped) when
     updating old object with 'new' one. See #updateFrom:.

     When overriding, *always* concatenate with super, i.e.,

        updateFromIgnoredInstvarNames
            ^ super updateFromIgnoredInstvarNames , #(some instvar)

    "
    ^ #(debugger)

    "Created: / 25-02-2019 / 15:06:44 / Jan Vrany <jan.vrany@fit.cvut.cz>"
    "Modified: / 25-02-2019 / 16:27:38 / Jan Vrany <jan.vrany@fit.cvut.cz>"
! !

!GDBDebuggerObject methodsFor:'testing'!

isValid
    "Return `true`, if the object is still `valid`, false otherwise. For example,
     a `GDBFrame` instance may become invalid when the frame is unwound and no
     longer exist."

    ^ self subclassResponsibility

    "Created: / 04-02-2018 / 21:24:20 / Jan Vrany <jan.vrany@fit.cvut.cz>"
! !

!GDBDebuggerObject class methodsFor:'documentation'!

version_HG

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