New implementation of Tonel and FileTree reader/writer needed.

[dalehenrich]

Now that FileSystemGS is ported to GemStone, the Tonel and FileTree reader/writers should be rewritten ... Currently separate Cypress and Tonel projects are used to create the Rowan definitions and write from Rowan definitions to disk, but the algorithms used are not doing direct translations ...

Also want to take this opportunity to use the diffs when writing out packages so that only the changes are written (avoid the monolithic directory deletes)...

Issues #317, #253, #229, #122 would be addressed as part of this effort.

This will be a fairly intrusive implementation and when merged will require a bump of the major version -- the Rowan APIs won't necessarily change, but the Tonel and Cypress projects will no longer be included in Rowan, so the overall API will change ...

• topaz writer
  • write Rowan/Tonel/Ston/Cypress/Filetree project set
  • write with classes in proper symbol dictionary
  • write based upon configurations (split Globals .gs file from Rowan implementation)
  • non-config based package list api
  • initialization doits
• tonel writer
  • write Rowan/Tonel/Ston/Cypress/Filetree project set
  • write only changed classes and packages
  • write to alternate root directory (using a config for alternate location)
  • preserve non-standard/non-platform class definition attributes (merge unrecognized from before into after) -- see Issue Tonel reader needs to preserve non-standard/non-platform definition attributes #483 for resolution
• tonel reader
  • read an empty class extension file and produce an empty class extension definition
• filetree writer
  • write only changed classes, methods and packages
  • write to alternate root directory (using a config for alternate location)
  • read filetree test repositories -- see Issue Filetree reader needs to be validated agains the filetree test repositories #484 for resolution
• filetree reader
  • read an empty class extension directory or empty instance/class directories and produce an empty class extension definition

[dalehenrich]

current version of script that generates 3 .gs files (app, globals, userglobals) for the 6 projects in base Rowan (at the moment):

| repositoryRootPath projectSetDefinition projectSetModification visitor |
repositoryRootPath := FileLocator dbfScratchDir / 'rowanBootstrap'.
repositoryRootPath ensureCreateDirectory.

projectSetDefinition := RwProjectSetDefinition new.
Rowan image loadedProjects do: [:lp | projectSetDefinition addProject: lp asDefinition ].

projectSetModification := projectSetDefinition compareAgainstBase: RwProjectSetDefinition new.
visitor := RwGsModificationTopazWriterVisitor new
	repositoryRootPath: repositoryRootPath;
	yourself.
false 
	ifTrue: [ visitor topazFilename: 'rowan_bootstrap' ]
	ifFalse: [
		| fileNameConfigsMap |
		fileNameConfigsMap := Dictionary new
			at: 'rowan_bootstrap_app' 
				put: (Dictionary new 
						at: 'Rowan' put: {{'Kernel'}. {}};
						at: 'FileSystemGs' put: nil;
						at: 'Cypress' put: nil;
						at: 'STON' put: nil;
						at: 'Tonel' put: nil;
						yourself);
			at: 'rowan_bootstrap_globals' 
				put: (Dictionary new 
						at: 'Rowan' put: {{'Globals'}. {}};
						at: 'FileSystemGs' put: {{'Default'}. {}};
						at: 'Cypress' put: {{'Default'}. {}};
						at: 'STON' put: {{'Bootstrap'}. {}};
						at: 'Tonel' put: {{'Bootstrap'}. {}};
						yourself);
			at: 'rowan_bootstrap_user_globals' 
				put: (Dictionary new 
						at: 'Rowan' put: {{'UserGlobals'}. {}};
						at: 'FileSystemGs' put: nil;
						at: 'Cypress' put: nil;
						at: 'STON' put: nil;
						at: 'Tonel' put: nil;
						yourself);
			yourself.
		visitor topazFilenameConfigsMap: fileNameConfigsMap].
visitor visit: projectSetModification.
visitor export.

... split globals out so that the script can in theory be used as part of the upgrade step .. although it currently includes all of the classes for Tonel, Cypress, STON, and FileSystem ... and technically only the extension methods are needed -- a bit more packaging is needed to fill that bill ... also need to add a test or two for the config-based file outs

[dalehenrich]

implementation of new filetree/tonel reader/writer is functionally complete ... reader code has already been integrated into the Rowan bootstrap process for 3.5.0 ... ready to integrate writer code into project list write/commiot code (Issue #481)