"

 COPYRIGHT (c) 1994 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.

"

StandardSystemView subclass:#ProjectView

	instanceVariableNames:'myProject toggle'

	classVariableNames:'ActiveProjectView'

	poolDictionaries:''

	category:'Interface-Smalltalk'

!

!ProjectView class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1994 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

"

    ProjectViews basically offer two functionalities:

      - keep a group of windows in order to organize the desktop

        (I am not sure, if this is really a useful feature, now that we

         have modern windowManagers which have multiple desktops as well).

        All views as created while a project is active are remembered

        and can be hidden/shown altogether.

        (this has nothing to do with windowGroups)

        Also, it is possible to close down all those windows (by destroying the project).

      - keep defaults for various system activities:

                - the fileOut directory (i.e. where the SystemBrowser creates fileOut sources)

                - keep the source module/package

                    thats the default offered when classes are checkedIn the very first time

                - keep a default package-identifier assigned when classes/methods are created/modified.

                    thats mostly useful to browse all classes/methods that have been touched

                    in a projects context

                - keep a per-project changeList

      - allow opening a browser on all classes/methods which were created or modified

        while a project was active.

      - allow opening a browser on this projects changeList (which contains the subset of changes

         which were done while this project was active)

      - allow removal of all classes/methods which have the current projects packageIdentifier

    [author:]

        Claus Gittinger

    [see also:]

        Project

        Namespace

        CVSSourceCodemanager

"

! !

!ProjectView class methodsFor:'instance creation'!

for:aProject

    "create & open a new projectView on some project"

    |newView|

    newView := super new.

    newView setProject:aProject.

    ^ newView

    "

     ProjectView for:(Project new)

    "

    "Modified: 14.2.1997 / 13:46:07 / cg"

! !

!ProjectView methodsFor:'initialization'!

addToCurrentProject

    "add this view to the current projects set of views.

     Ignored here - ProjectViews are global."

    ^ self

    "Modified: 14.2.1997 / 13:35:58 / cg"

!

initialize

    super initialize.

    "/

    "/ create the toggle ...

    "/

    toggle := Toggle in:self.

    toggle borderWidth:0.

    toggle pressAction:[self showProject].

    toggle releaseAction:[self hideProject].

    "/

    "/ and give it a menu

    "/

    self initializeMenu

    "Created: 25.11.1995 / 18:06:32 / cg"

    "Modified: 10.12.1995 / 00:04:12 / cg"

!

initializeMenu

    |labels selectors m|

    labels := #(

                    'class documentation'

                    '-'

                    'show'

                    'hide'

                    '-'

                    'changes'

                    'browse'

                    'fileOut classes'

                    '-'

                    'fileOut directory ...'

                    'repository defaults ...'

                    'package name ...'

                    'default nameSpace ...'

"/                        '-'

"/                        'save project code'

"/                        'build'

                    '-'

                    'remove package code'

                    'remove project'

                    '-'

                    'rename ...'

               ).

     selectors := #(        

                    showClassDocumentation

                    nil

                    showProject

                    hideProject

                    nil

                    browseChanges

                    browsePackage

                    fileOutClasses

                    nil

                    projectDirectory

                    projectRepositoryAndModule

                    projectPackage

                    projectNameSpace

"/                        nil

"/                        saveProjectFiles

"/                        buildProject

                    nil

                    removePackage

                    destroy

                    nil

                    renameProject

                ).

    m := PopUpMenu

                labels:(resources array:labels)

                selectors:selectors

                receiver:self.

    SourceCodeManager isNil ifTrue:[

        m disableAll:#(#projectRepository #projectPackage).

    ].

    toggle middleButtonMenu:m

    "Created: 25.11.1995 / 18:06:32 / cg"

    "Modified: 14.2.1997 / 13:42:22 / cg"

! !

!ProjectView methodsFor:'menu actions'!

browseChanges

    "open a changeBrowser showing all changes made in this project

     (i.e. while this project was the active project)"

    |changes b|

    changes := myProject changeSet.

    changes size == 0 ifTrue:[

        self warn:(resources string:'no changes made in this project (yet)').

        ^ self

    ].

    b := ChangeSetBrowser openOn:(myProject changeSet).

    b label:(resources string:'Changes in %1' with:myProject name)

    "Modified: 14.2.1997 / 13:36:40 / cg"

!

browsePackage

    "launch browsers for all classes/methods which are defined in this package

     (i.e. whose packageIdentifier is the same as my Projects packageIdentifier)"

    self topView withWaitCursorDo:[

        |classes packageName methods methodList anyClasses anyMethods ignoredClasses|

        anyMethods := anyClasses := false.

        packageName := myProject packageName.

        classes := myProject classes.

        (classes notNil and:[classes notEmpty]) ifTrue:[

            anyClasses := true.

        ].

        methods := myProject individualMethods.

        methods notEmpty ifTrue:[

            anyMethods := true.

            SystemBrowser browseMethods:methods

                                  title:(resources string:'individual methods in package %1' with:packageName).

        ].

        anyClasses ifTrue:[

            SystemBrowser browseClasses:classes

                                  title:(resources string:'classes in package %1' with:packageName).

        ].

        (anyClasses or:[anyMethods]) ifFalse:[

            self information:(resources string:'no classes or methods in this project (yet)')

        ]

    ]

    "Created: 10.12.1995 / 00:08:58 / cg"

    "Modified: 12.12.1995 / 16:35:07 / cg"

!

browseProps

    "show the projects properties.

     This is not yet finished ...

     ... and will look better, once property inspector runs ..."

    myProject properties inspect

    "Modified: 14.2.1997 / 13:37:15 / cg"

!

buildProject

    "build the project; this is not yet finished ...

     ... and will eventually create all sources, makefile and

     build what is to be built: either a classLibrary or an application"

    self topView withWaitCursorDo:[

        |dir|

        self saveProjectFiles.

        (self confirm:'make object files in: ' ,  dir , ' ?') ifTrue:[

            myProject buildProject.

        ]

    ].

    "Modified: 14.2.1997 / 13:38:06 / cg"

!

destroy

    "Let user confirm, then close all of my views, and get rid of the changeList.

     However, methods and classes are not restored to their

     previous state."

    (myProject views notNil

    and:[myProject views notEmpty]) ifTrue:[

        |box|

        box := YesNoBox new.

        box title:(resources string:'PROJECT_DESTROY') withCRs.

        box okText:(resources string:'yes').

        (box confirm) ifFalse:[^ self]

    ].

    self doDestroy

    "Modified: 14.2.1997 / 13:39:03 / cg"

!

doDestroy

    "close all of my views, and get rid of the changeList.

     However, methods and classes are not restored to their

     previous state.

     No confiramtion here."

    self hideProject.

    myProject := nil.

    super destroy

    "Modified: 14.2.1997 / 13:39:18 / cg"

!

fileOutClasses

    "fileout all classes belonging to that package.

     CAVEAT: individual methods are not yet supported."

    self topView withWaitCursorDo:[

        |classes packageName methods methodList anyClasses anyMethods ignoredClasses|

        anyMethods := anyClasses := false.

        packageName := myProject packageName.

        classes := myProject classes.

        (classes notNil and:[classes notEmpty]) ifTrue:[

            anyClasses := true.

        ].

        methods := myProject individualMethods.

        methods notEmpty ifTrue:[

            anyMethods := true.

            self warn:'individual methods are currently not handled'

        ].

        anyClasses ifTrue:[

            classes do:[:aClass |

                Transcript showCR:'fileOut: ' , aClass name , ' ...'.

                aClass fileOut

            ].

        ].

        (anyClasses or:[anyMethods]) ifFalse:[

            self information:(resources string:'no classes or methods in this project (yet)')

        ]

    ]

    "Created: 11.4.1996 / 19:29:50 / cg"

!

hideProject

    "hide all views belonging to that project and switch

     to the default project"

    myProject hideViews.

    ActiveProjectView := nil.

    toggle turnOff.

    Project setDefaultProject.

    "Modified: 14.2.1997 / 13:39:43 / cg"

!

projectDirectory

    "ask for the default directory, where fileOut will write

     its files. Will eventually also be the place, where makefiles

     and additional stuff is saved, for project building."

    |box d|

    box := FilenameEnterBox new.

    box directoriesOnly.

    box title:(resources string:'PROJECT_DIRECTPORY') withCRs.

    (d := myProject directory) notNil ifTrue:[

        box initialText:d

    ].

    box action:[:dirName |

        (OperatingSystem isDirectory:dirName) ifFalse:[

            (OperatingSystem isValidPath:dirName) ifTrue:[

                self warn:(resources string:'%1 is not a valid directory' with:dirName).

                ^ self

            ].

            (self confirm:(resources string:'%1 does not exist\\create ?' with:dirName) withCRs) ifTrue:[

                (OperatingSystem recursiveCreateDirectory:dirName) ifFalse:[

                    self warn:(resources string:'cannot create %1' with:dirName)

                ]

            ].

        ].

        "did it work ?"

        (OperatingSystem isDirectory:dirName) ifTrue:[

            myProject directory:dirName

        ].

    ].

    box showAtPointer

    "Modified: 14.2.1997 / 13:44:59 / cg"

!

projectNameSpace

    "ask for the default nameSpace, into which new classes

     are loaded while this project is active.

     Useful before filing in alien code, to make certain that loaded

     classes do not conflict with existing ones ..."

    self topView withWaitCursorDo:[

        |box allNameSpaces|

        allNameSpaces := Namespace allNamespaces collect:[:ns | ns name].

        box := ListSelectionBox title:(resources string:'default nameSpace:') withCRs.

        box list:(allNameSpaces asOrderedCollection sort).

        box action:[:nsName |

            |ns|

            myProject defaultNameSpace:ns

        ].

        box showAtPointer

    ]

    "Created: 9.12.1995 / 16:50:45 / cg"

!

projectPackage

    "ask for the package identifier of this project.

     New classes and methods get this identifier, to find them

     quickly later."

    self topView withWaitCursorDo:[

        |box p existingPackages allClasses|

        existingPackages := Set new.

        (allClasses := Smalltalk allClasses) do:[:aClass |

            |p|

            (p := aClass package) notNil ifTrue:[

                existingPackages add:(p asString)

            ].

            aClass methodDictionary do:[:aMethod |

                (p := aMethod package) notNil ifTrue:[

                    existingPackages add:(p asString)

                ]

            ].

            aClass class methodDictionary do:[:aMethod |

                (p := aMethod package) notNil ifTrue:[

                    existingPackages add:(p asString)

                ]

            ].

        ].

        box := ListSelectionBox title:(resources string:'PROJECT_PACKAGENAME') withCRs.

        box list:(existingPackages asOrderedCollection sort).

        (p := myProject packageName) notNil ifTrue:[

            box initialText:p

        ].

        box action:[:packageName |

            |someClass module directory|

            "/ (try) to extract the module & repository directory from someClass which

            "/ is already contained in that package

            Smalltalk allClasses 

                detect:[:cls | 

                                |info|

                                (cls package = packageName) ifTrue:[

                                    (info := cls packageSourceCodeInfo) notNil ifTrue:[

                                        module := info at:#module ifAbsent:nil.

                                        directory := info at:#directory ifAbsent:nil.

                                    ]

                                ].

                                module notNil and:[directory notNil].

                        ]

                ifNone:nil.

            module notNil ifTrue:[

                myProject repositoryModule:module

            ].

            directory notNil ifTrue:[

                myProject repositoryDirectory:directory

            ].

            myProject packageName:packageName.

        ].

        box showAtPointer

    ]