src/BuildSystem/ToolManager.pm

#____________________________________________________________________ 
# File: ToolManager.pm
#____________________________________________________________________ 
#  
# Author: Shaun Ashby <Shaun.Ashby@cern.ch>
# Update: 2003-11-12 15:04:16+0100
# Revision: $Id: ToolManager.pm,v 1.1.2.31 2004/11/23 13:17:16 sashby Exp $ 
#
# Copyright: 2003 (C) Shaun Ashby
#
#--------------------------------------------------------------------
package BuildSystem::ToolManager;
require 5.004;

use Exporter;
use BuildSystem::ToolCache;
use BuildSystem::ToolParser;
use Utilities::AddDir;
use URL::URLhandler;
use Utilities::Verbose;

@ISA=qw(BuildSystem::ToolCache Utilities::Verbose);
@EXPORT_OK=qw( );
#
#
sub new
   ###############################################################
   # new                                                         #
   ###############################################################
   # modified : Wed Nov 12 10:34:10 2003 / SFA                   #
   # params   :                                                  #
   #          :                                                  #
   # function :                                                  #
   #          :                                                  #
   ###############################################################
   {
   my $proto=shift;
   my $class=ref($proto) || $proto;
   my $self=$class->SUPER::new();    # Inherit from ToolCache
   my $projectarea=shift;

   bless $self,$class;
   
   $self->{arch}=shift;
   $self->{topdir}=$projectarea->location();
   $self->{configdir}=$self->{topdir}."/".$projectarea->configurationdir();
   $self->{cache}=$projectarea->cache();    # Download tool cache
   $self->{toolfiledir}=$self->{topdir}."/.SCRAM/InstalledTools";
   $self->{datastore}=$self->{topdir}."/.SCRAM";
   $self->{archstore}=$self->{topdir}."/.SCRAM/".$ENV{SCRAM_ARCH};
   
   # Make sure our tool download dir exists:
   AddDir::adddir($self->{toolfiledir});
   AddDir::adddir($self->{archstore});
   
   # Set the tool cache file to read/write:
   $self->name($projectarea->toolcachename());

   # Check for the downloaded tools cache:
   if (exists($self->{cache}))
      {
      $self->{urlhandler}=URL::URLhandler->new($self->{cache});
      }
   
   return $self;
   }

sub clone()
   {
   my $self=shift;
   my $projectarea=shift;
   
   # Change cache settings to reflect the new location:
   $self->{topdir}=$projectarea->location();

   $self->{configdir}=$self->{topdir}."/".$projectarea->configurationdir();
   $self->{toolfiledir}=$self->{topdir}."/.SCRAM/InstalledTools";
   $self->{datastore}=$self->{topdir}."/.SCRAM";
   $self->{archstore}=$self->{topdir}."/.SCRAM/".$ENV{SCRAM_ARCH};

   # Change the cache name:
   $self->name($projectarea->toolcachename());
   $self->cloned_tm(1);
   
   return $self;
   }

sub arch_change_after_copy()
   {
   my $self=shift;
   my ($newarch, $cachename)=@_;
   # Make changes to arch-specific settings when copying tool manager
   # object to another arch during setup:
   $self->{arch} = $newarch;
   $self->{archstore} = $self->{topdir}."/.SCRAM/".$newarch;
   # Change the name of the cache to reflect new (arch-specific) location:
   $self->name($cachename);
   }

sub interactive()
   {
   my $self=shift;
   # Interactive mode on/off:
   @_ ? $self->{interactive} = shift
      : ((defined $self->{interactive}) ? $self->{interactive} : 0);
   }

sub setupalltools()
   {
   my $self = shift;
   my ($arealocation,$setupopt) = @_;
   my (@localtools);
   my $selected;
   
   # Get the selected tool list. Handle the case where there might not be
   # any selected tools: //FIXME: need to handle case where there are no
   # selected tools (not very often but a possibility):
   my $sel = $self->selected();
   
   if (defined ($sel))
      {
      $selected = [ keys %{$sel} ];
      }
   
   # Setup option "setupopt" directs the setup: 1 is for booting from
   # scratch, 0 is when just doing "scram setup" (in this case we don't
   # want to pick up everything from any scram-managed projects):
   if ($setupopt == 1) # We're booting from scratch
      {
      # Check to see if there are any SCRAM-managed projects in our local requirements:
      my $scramprojects = $::scram->_loadscramdb();
      
      # Look for a match in the scram db:
      foreach my $S (@$selected)
         {
         if (exists ($scramprojects->{$S}))
            {
            # Now check the version required exists in
            # list of scram projects with this name:
            while (my ($pdata,$plocation) = each %{$scramprojects->{$S}})
               {
               # Split the $pdata string to get the real name and the version:
               my ($pname,$pversion) = split(":",$pdata);
               if ($pversion eq $self->defaultversion($S))
                  {
                  # Get the tool manager for the scram project:
                  my $sa=$::scram->scramfunctions()->scramprojectdb()->getarea($pname,$pversion);
                  # Load the tool cache:
                  if ( -r $sa->toolcachename())
                     {
                     use Cache::CacheUtilities;
                     my $satoolmanager=&Cache::CacheUtilities::read($sa->toolcachename());
                     # Copy needed content from toolmanager for scram-managed project:
                     $self->inheritcontent($satoolmanager);
                     }
                  }
               }
            # Also add this scram-managed project to list of tools to set up:
            push(@localtools,$S);
            }
         else
            {
            # Store other tools in ReqDoc in separate array. We will set up these tools later:
            push(@localtools,$S);
            }
         }
      
      # Set up extra tools required in this project, in addition to
      # any scram-managed projects
      foreach my $localtool (@localtools)
         {
         # First check to see if it's already set up (i.e., was contained
         # in list of requirements for scram project):
         if (! $self->definedtool($localtool))
            {
            $self->toolsetup($arealocation,$localtool,$self->defaultversion($localtool));
            $self->addtoselected($localtool);
            }
         else
            {
            print $localtool," already set up.","\n",if ($ENV{SCRAM_DEBUG});
            }
         }
      }
   else
      {
      # Just loop over all tools and setup again:
      foreach my $localtool (@{$selected})
         {
         $self->toolsetup($arealocation,$localtool,$self->defaultversion($localtool));   
         }
      }
   
   print "\n";
   }

sub coresetup()
   {
   my $self=shift;
   my ($toolname, $toolversion, $toolfile) = @_;
   my ($toolcheck, $toolparser);
   
   print "\n";
   print $::bold."Setting up ",$toolname," version ",$toolversion,":  ".$::normal,"\n";
   
   # New ToolParser object for this tool if there isn't one already.
   # Look in array of raw tools to see if this tool has a ToolParser object:
   $toolcheck=0;
   
   map
      {
      if ($_->toolname() eq $toolname) {$toolcheck = 1; $toolparser = $_;}
      } $self->rawtools();
   
   # Tool not known so we create a new ToolParser object and parse it:
   if ($toolcheck != 1)
      {
      $toolparser = BuildSystem::ToolParser->new();
      # We only want to store the stuff relevant for one particular version:
      $toolparser->parse($toolname, $toolversion, $toolfile);
      # Store the ToolParser object in the cache:
      $self->store($toolparser);
      }
   
   # Next, set up the tool:
   my $store = $toolparser->processrawtool($self->interactive());
   # Make sure that we have this tool in the list of selected tools (just in case this tool was
   # set up by hand afterwards):
   $self->addtoselected($toolname);
   # Store the ToolData object in the cache:
   $self->storeincache($toolparser->toolname(),$store);
   return $self;
   }

sub toolsetup()
   {
   my $self=shift;
   my ($arealocation, $toolname, $toolversion, $toolurl) = @_;
   my ($urlcache, $url, $filename, $tfname);
   my $toolfile;
   
   $toolname =~ tr[A-Z][a-z];
   $toolversion ||= $self->defaultversion($toolname);
   $urlcache=URL::URLcache->new($arealocation."/.SCRAM/cache"); # Download tool cache
   
   # Check for the downloaded tools cache:
   if (defined($urlcache))
      {
      $self->{urlhandler}=URL::URLhandler->new($urlcache);
      }
   
   $url = $self->toolurls()->{$toolname};
   $filename = $self->{toolfiledir}."/".$toolname;
   
   # First, check to see if there was a tool URL given. If so, we might need to read
   # from http or from a file: type URL:
   if (my ($proto, $urlv) = ($toolurl =~ /(.*):(.*)/))
      {      
      # See what kind of URL (file:, http:, cvs:, svn:, .. ):
      if ($proto eq 'file')
         {
         # If the tool url is a file and the file exists,
         # copy it to .SCRAM/InstalledTools and set the
         # filename accordingly:
         if ( -f $urlv)
            {
            use File::Copy;
            copy($urlv, $filename);
            $toolfile=$filename;
            }
         else
            {
            $::scram->scramerror("Unable to set up $toolname from URL $toolurl-- $urlv does not exist!");                   
            }
         }
      elsif ($proto eq 'http')
         {
         print "SCRAM: downloading $toolname from $toolurl","\n";
         # Download from WWW first:
         use LWP::Simple qw(&getstore);
         my $http_response_val = &getstore($toolurl, $filename);

         # Check the HTTP status. If doc not found, exit:
         if ($http_response_val != 200)
            {
            my ($server,$doc) = ($urlv =~ m|//(.*?)/(.*)|);         
            $::scram->scramerror("Unable to set up $toolname: $doc not found on $server!");
            }
         else
            {
            $toolfile=$filename;
            }
         }
      elsif ($proto eq 'cvs')
         {
         print "SCRAM: downloading $toolname from $urlv using protocol $proto.","\n";
         print "[ not yet supported ]","\n";
         exit(0);
         }
      elsif ($proto eq 'svn')
         {
         print "SCRAM: downloading $toolname from $urlv using protocol $proto.","\n";
         print "[ not yet supported ]","\n";
         exit(0);
         }
      else
         {
         $::scram->scramerror("Unable to download $urlv! Unknown protocol \"$proto\". Bye.");
         }
      }
   else
      {
      # Copy the downloaded tool file to InstalledTools directory:
      if ( ! -f $filename )
         {
         $self->verbose("Attempting Download of $url");
         # Get file from download cache:
         ($url,$filename)=$self->{urlhandler}->get($url);
         use File::Copy;
         $tfname=$self->{toolfiledir}."/".$toolname;
         copy($filename, $tfname);
         $toolfile=$tfname;
         }
      else
         {
         # File already exists in the .SCRAM/InstallTools directory:
         $toolfile=$filename;
         }
      }
   
   # Run the core setup routine:
   $self->coresetup($toolname, $toolversion, $toolfile);
   return $self;
   }

sub setupself()
   {
   my $self=shift;
   my ($location)=@_;
   # Process the file "Self" in local config directory. This is used to
   # set all the paths/runtime settings for this project:
   my $filename=$location."/config/Self";

   if ( -f $filename )
      {
      print "\n";
      print $::bold."Setting up SELF:".$::normal,"\n";
      # Self file exists so process it:
      $selfparser = BuildSystem::ToolParser->new();
      $selfparser->parse('self','SELF',$filename);

      # Next, set up the tool:
      $store = $selfparser->processrawtool($self->interactive());
      
      # If we are in a developer area, also add RELEASETOP paths:
      if (exists($ENV{RELEASETOP}))
         {
         print "\nAdding RELEASE area settings to self....OK","\n", if ($ENV{SCRAM_DEBUG});
         $store->addreleasetoself();
         }
      
      # Store the ToolData object in the cache:
      $self->storeincache($selfparser->toolname(),$store);
      print "\n";
      }
   else
      {
      print "\n";
      print "SCRAM: No file config/Self...nothing to do.";
      print "\n";
      return;
      }
   }

sub defaultversion()
   {
   my $self = shift;
   my ($tool) = @_;
   # Return default versions as taken from configuration:
   return (%{$self->defaultversions()}->{$tool});
   }

sub storeincache()
   {
   my $self=shift;
   my ($toolname,$dataobject)=@_;

   # Store ToolData object (for a set-up tool) in cache:
   if (ref($dataobject) eq 'BuildSystem::ToolData')
      {
      $self->{SETUP}->{$toolname} = $dataobject;
      }
   else
      {
      $::scram->scramerror("ToolManager: BuildSystem::ToolData object reference expected.")
      }
   }

sub tools()
   {
   my $self = shift;
   my @tools;
   
   map
      {
      if ($_ ne "self")
         {
         push(@tools, $_);
         }
      } keys %{$self->{SETUP}};
   
   # Return list of set-up tools:
   return @tools;
   }

sub toolsdata()
   {
   my $self = shift;
   my $tooldata = [];
   my $rawsel = $self->selected();
   
   foreach my $tool ( sort { %{$rawsel}->{$a}
                             <=> %{$rawsel}->{$b}}
                      keys %{$rawsel} )
      {
      # Return tool data objects of all set-up tools, skipping the tool "self":
      if ($_ ne "self")
         {
         # Keep only tools that have really been set up:
         if (exists $self->{SETUP}->{$tool})
            {
            push(@tooldata,$self->{SETUP}->{$tool});
            }
         }
      }
   
   # Return the array of tools, in order that they appear in RequirementsDoc:
   return @tooldata;
   }

sub definedtool()
   {
   my $self=shift;
   my ($tool)=@_;
   
   # Check to see if tool X is an external tool:
   grep ($_ eq $tool, keys %{$self->{SETUP}}) ? return 1
      : return 0;
   }

sub checkifsetup()
   {
   my $self=shift;
   my ($tool)=@_;
   # Return the ToolData object if the tool has been set up:
   (exists $self->{SETUP}->{$tool}) ? return ($self->{SETUP}->{$tool})
      : return undef;
   }

sub cloned_tm()
   {
   my $self=shift;
   # Has this area already been cloned and brought in-line with current location:
   @_ ? $self->{CLONED} = $_[0]
      : $self->{CLONED};
   }

sub remove_tool()
   {
   my $self=shift;
   my ($toolname)=@_;
   my $tools = $self->{SETUP};
   my $newtlist = {};
   
   while (my ($tool, $tooldata) = each %$tools)
      {
      if ($tool ne $toolname)
         {
         $newtlist->{$tool} = $tooldata;
         }
      else
         {
         print "Deleting $toolname from cache.","\n";
         }
      }
   
   $self->{SETUP} = $newtlist;

   # Now remove from the RAW tool list:
   $self->cleanup_raw($toolname);
   
   print "ToolManager: Updating tool cache.","\n";
   $self->writecache();
   }

sub scram_projects()
   {
   my $self=shift;
   my $scram_projects={};

   foreach my $t ($self->tools())
      {
      # Get the ToolData object:
      my $td=$self->{SETUP}->{$t};
      $scram_projects->{$t}=$td->variable_data(uc($t)."_BASE"), if ($td->scram_project());
      }
   
   return $scram_projects;
   }

1;
Revision:	1.2
Committed:	Fri Dec 10 13:41:37 2004 UTC (20 years, 4 months ago) by sashby
Content type:	text/plain
Branch:	MAIN
CVS Tags:	V1_0_0
Changes since 1.1:	+511 -0 lines
Log Message:	Merged V1_0 branch to HEAD
#	User	Rev	Content
1	sashby	1.2	#____________________________________________________________________
2			# File: ToolManager.pm
3			#____________________________________________________________________
4			#
5			# Author: Shaun Ashby <Shaun.Ashby@cern.ch>
6			# Update: 2003-11-12 15:04:16+0100
7			# Revision: $Id: ToolManager.pm,v 1.1.2.31 2004/11/23 13:17:16 sashby Exp $
8			#
9			# Copyright: 2003 (C) Shaun Ashby
10			#
11			#--------------------------------------------------------------------
12			package BuildSystem::ToolManager;
13			require 5.004;
14
15			use Exporter;
16			use BuildSystem::ToolCache;
17			use BuildSystem::ToolParser;
18			use Utilities::AddDir;
19			use URL::URLhandler;
20			use Utilities::Verbose;
21
22			@ISA=qw(BuildSystem::ToolCache Utilities::Verbose);
23			@EXPORT_OK=qw( );
24			#
25			#
26			sub new
27			###############################################################
28			# new #
29			###############################################################
30			# modified : Wed Nov 12 10:34:10 2003 / SFA #
31			# params : #
32			# : #
33			# function : #
34			# : #
35			###############################################################
36			{
37			my $proto=shift;
38			my $class=ref($proto) \|\| $proto;
39			my $self=$class->SUPER::new(); # Inherit from ToolCache
40			my $projectarea=shift;
41
42			bless $self,$class;
43
44			$self->{arch}=shift;
45			$self->{topdir}=$projectarea->location();
46			$self->{configdir}=$self->{topdir}."/".$projectarea->configurationdir();
47			$self->{cache}=$projectarea->cache(); # Download tool cache
48			$self->{toolfiledir}=$self->{topdir}."/.SCRAM/InstalledTools";
49			$self->{datastore}=$self->{topdir}."/.SCRAM";
50			$self->{archstore}=$self->{topdir}."/.SCRAM/".$ENV{SCRAM_ARCH};
51
52			# Make sure our tool download dir exists:
53			AddDir::adddir($self->{toolfiledir});
54			AddDir::adddir($self->{archstore});
55
56			# Set the tool cache file to read/write:
57			$self->name($projectarea->toolcachename());
58
59			# Check for the downloaded tools cache:
60			if (exists($self->{cache}))
61			{
62			$self->{urlhandler}=URL::URLhandler->new($self->{cache});
63			}
64
65			return $self;
66			}
67
68			sub clone()
69			{
70			my $self=shift;
71			my $projectarea=shift;
72
73			# Change cache settings to reflect the new location:
74			$self->{topdir}=$projectarea->location();
75
76			$self->{configdir}=$self->{topdir}."/".$projectarea->configurationdir();
77			$self->{toolfiledir}=$self->{topdir}."/.SCRAM/InstalledTools";
78			$self->{datastore}=$self->{topdir}."/.SCRAM";
79			$self->{archstore}=$self->{topdir}."/.SCRAM/".$ENV{SCRAM_ARCH};
80
81			# Change the cache name:
82			$self->name($projectarea->toolcachename());
83			$self->cloned_tm(1);
84
85			return $self;
86			}
87
88			sub arch_change_after_copy()
89			{
90			my $self=shift;
91			my ($newarch, $cachename)=@_;
92			# Make changes to arch-specific settings when copying tool manager
93			# object to another arch during setup:
94			$self->{arch} = $newarch;
95			$self->{archstore} = $self->{topdir}."/.SCRAM/".$newarch;
96			# Change the name of the cache to reflect new (arch-specific) location:
97			$self->name($cachename);
98			}
99
100			sub interactive()
101			{
102			my $self=shift;
103			# Interactive mode on/off:
104			@_ ? $self->{interactive} = shift
105			: ((defined $self->{interactive}) ? $self->{interactive} : 0);
106			}
107
108			sub setupalltools()
109			{
110			my $self = shift;
111			my ($arealocation,$setupopt) = @_;
112			my (@localtools);
113			my $selected;
114
115			# Get the selected tool list. Handle the case where there might not be
116			# any selected tools: //FIXME: need to handle case where there are no
117			# selected tools (not very often but a possibility):
118			my $sel = $self->selected();
119
120			if (defined ($sel))
121			{
122			$selected = [ keys %{$sel} ];
123			}
124
125			# Setup option "setupopt" directs the setup: 1 is for booting from
126			# scratch, 0 is when just doing "scram setup" (in this case we don't
127			# want to pick up everything from any scram-managed projects):
128			if ($setupopt == 1) # We're booting from scratch
129			{
130			# Check to see if there are any SCRAM-managed projects in our local requirements:
131			my $scramprojects = $::scram->_loadscramdb();
132
133			# Look for a match in the scram db:
134			foreach my $S (@$selected)
135			{
136			if (exists ($scramprojects->{$S}))
137			{
138			# Now check the version required exists in
139			# list of scram projects with this name:
140			while (my ($pdata,$plocation) = each %{$scramprojects->{$S}})
141			{
142			# Split the $pdata string to get the real name and the version:
143			my ($pname,$pversion) = split(":",$pdata);
144			if ($pversion eq $self->defaultversion($S))
145			{
146			# Get the tool manager for the scram project:
147			my $sa=$::scram->scramfunctions()->scramprojectdb()->getarea($pname,$pversion);
148			# Load the tool cache:
149			if ( -r $sa->toolcachename())
150			{
151			use Cache::CacheUtilities;
152			my $satoolmanager=&Cache::CacheUtilities::read($sa->toolcachename());
153			# Copy needed content from toolmanager for scram-managed project:
154			$self->inheritcontent($satoolmanager);
155			}
156			}
157			}
158			# Also add this scram-managed project to list of tools to set up:
159			push(@localtools,$S);
160			}
161			else
162			{
163			# Store other tools in ReqDoc in separate array. We will set up these tools later:
164			push(@localtools,$S);
165			}
166			}
167
168			# Set up extra tools required in this project, in addition to
169			# any scram-managed projects
170			foreach my $localtool (@localtools)
171			{
172			# First check to see if it's already set up (i.e., was contained
173			# in list of requirements for scram project):
174			if (! $self->definedtool($localtool))
175			{
176			$self->toolsetup($arealocation,$localtool,$self->defaultversion($localtool));
177			$self->addtoselected($localtool);
178			}
179			else
180			{
181			print $localtool," already set up.","\n",if ($ENV{SCRAM_DEBUG});
182			}
183			}
184			}
185			else
186			{
187			# Just loop over all tools and setup again:
188			foreach my $localtool (@{$selected})
189			{
190			$self->toolsetup($arealocation,$localtool,$self->defaultversion($localtool));
191			}
192			}
193
194			print "\n";
195			}
196
197			sub coresetup()
198			{
199			my $self=shift;
200			my ($toolname, $toolversion, $toolfile) = @_;
201			my ($toolcheck, $toolparser);
202
203			print "\n";
204			print $::bold."Setting up ",$toolname," version ",$toolversion,": ".$::normal,"\n";
205
206			# New ToolParser object for this tool if there isn't one already.
207			# Look in array of raw tools to see if this tool has a ToolParser object:
208			$toolcheck=0;
209
210			map
211			{
212			if ($_->toolname() eq $toolname) {$toolcheck = 1; $toolparser = $_;}
213			} $self->rawtools();
214
215			# Tool not known so we create a new ToolParser object and parse it:
216			if ($toolcheck != 1)
217			{
218			$toolparser = BuildSystem::ToolParser->new();
219			# We only want to store the stuff relevant for one particular version:
220			$toolparser->parse($toolname, $toolversion, $toolfile);
221			# Store the ToolParser object in the cache:
222			$self->store($toolparser);
223			}
224
225			# Next, set up the tool:
226			my $store = $toolparser->processrawtool($self->interactive());
227			# Make sure that we have this tool in the list of selected tools (just in case this tool was
228			# set up by hand afterwards):
229			$self->addtoselected($toolname);
230			# Store the ToolData object in the cache:
231			$self->storeincache($toolparser->toolname(),$store);
232			return $self;
233			}
234
235			sub toolsetup()
236			{
237			my $self=shift;
238			my ($arealocation, $toolname, $toolversion, $toolurl) = @_;
239			my ($urlcache, $url, $filename, $tfname);
240			my $toolfile;
241
242			$toolname =~ tr[A-Z][a-z];
243			$toolversion \|\|= $self->defaultversion($toolname);
244			$urlcache=URL::URLcache->new($arealocation."/.SCRAM/cache"); # Download tool cache
245
246			# Check for the downloaded tools cache:
247			if (defined($urlcache))
248			{
249			$self->{urlhandler}=URL::URLhandler->new($urlcache);
250			}
251
252			$url = $self->toolurls()->{$toolname};
253			$filename = $self->{toolfiledir}."/".$toolname;
254
255			# First, check to see if there was a tool URL given. If so, we might need to read
256			# from http or from a file: type URL:
257			if (my ($proto, $urlv) = ($toolurl =~ /(.):(.)/))
258			{
259			# See what kind of URL (file:, http:, cvs:, svn:, .. ):
260			if ($proto eq 'file')
261			{
262			# If the tool url is a file and the file exists,
263			# copy it to .SCRAM/InstalledTools and set the
264			# filename accordingly:
265			if ( -f $urlv)
266			{
267			use File::Copy;
268			copy($urlv, $filename);
269			$toolfile=$filename;
270			}
271			else
272			{
273			$::scram->scramerror("Unable to set up $toolname from URL $toolurl-- $urlv does not exist!");
274			}
275			}
276			elsif ($proto eq 'http')
277			{
278			print "SCRAM: downloading $toolname from $toolurl","\n";
279			# Download from WWW first:
280			use LWP::Simple qw(&getstore);
281			my $http_response_val = &getstore($toolurl, $filename);
282
283			# Check the HTTP status. If doc not found, exit:
284			if ($http_response_val != 200)
285			{
286			my ($server,$doc) = ($urlv =~ m\|//(.?)/(.)\|);
287			$::scram->scramerror("Unable to set up $toolname: $doc not found on $server!");
288			}
289			else
290			{
291			$toolfile=$filename;
292			}
293			}
294			elsif ($proto eq 'cvs')
295			{
296			print "SCRAM: downloading $toolname from $urlv using protocol $proto.","\n";
297			print "[ not yet supported ]","\n";
298			exit(0);
299			}
300			elsif ($proto eq 'svn')
301			{
302			print "SCRAM: downloading $toolname from $urlv using protocol $proto.","\n";
303			print "[ not yet supported ]","\n";
304			exit(0);
305			}
306			else
307			{
308			$::scram->scramerror("Unable to download $urlv! Unknown protocol \"$proto\". Bye.");
309			}
310			}
311			else
312			{
313			# Copy the downloaded tool file to InstalledTools directory:
314			if ( ! -f $filename )
315			{
316			$self->verbose("Attempting Download of $url");
317			# Get file from download cache:
318			($url,$filename)=$self->{urlhandler}->get($url);
319			use File::Copy;
320			$tfname=$self->{toolfiledir}."/".$toolname;
321			copy($filename, $tfname);
322			$toolfile=$tfname;
323			}
324			else
325			{
326			# File already exists in the .SCRAM/InstallTools directory:
327			$toolfile=$filename;
328			}
329			}
330
331			# Run the core setup routine:
332			$self->coresetup($toolname, $toolversion, $toolfile);
333			return $self;
334			}
335
336			sub setupself()
337			{
338			my $self=shift;
339			my ($location)=@_;
340			# Process the file "Self" in local config directory. This is used to
341			# set all the paths/runtime settings for this project:
342			my $filename=$location."/config/Self";
343
344			if ( -f $filename )
345			{
346			print "\n";
347			print $::bold."Setting up SELF:".$::normal,"\n";
348			# Self file exists so process it:
349			$selfparser = BuildSystem::ToolParser->new();
350			$selfparser->parse('self','SELF',$filename);
351
352			# Next, set up the tool:
353			$store = $selfparser->processrawtool($self->interactive());
354
355			# If we are in a developer area, also add RELEASETOP paths:
356			if (exists($ENV{RELEASETOP}))
357			{
358			print "\nAdding RELEASE area settings to self....OK","\n", if ($ENV{SCRAM_DEBUG});
359			$store->addreleasetoself();
360			}
361
362			# Store the ToolData object in the cache:
363			$self->storeincache($selfparser->toolname(),$store);
364			print "\n";
365			}
366			else
367			{
368			print "\n";
369			print "SCRAM: No file config/Self...nothing to do.";
370			print "\n";
371			return;
372			}
373			}
374
375			sub defaultversion()
376			{
377			my $self = shift;
378			my ($tool) = @_;
379			# Return default versions as taken from configuration:
380			return (%{$self->defaultversions()}->{$tool});
381			}
382
383			sub storeincache()
384			{
385			my $self=shift;
386			my ($toolname,$dataobject)=@_;
387
388			# Store ToolData object (for a set-up tool) in cache:
389			if (ref($dataobject) eq 'BuildSystem::ToolData')
390			{
391			$self->{SETUP}->{$toolname} = $dataobject;
392			}
393			else
394			{
395			$::scram->scramerror("ToolManager: BuildSystem::ToolData object reference expected.")
396			}
397			}
398
399			sub tools()
400			{
401			my $self = shift;
402			my @tools;
403
404			map
405			{
406			if ($_ ne "self")
407			{
408			push(@tools, $_);
409			}
410			} keys %{$self->{SETUP}};
411
412			# Return list of set-up tools:
413			return @tools;
414			}
415
416			sub toolsdata()
417			{
418			my $self = shift;
419			my $tooldata = [];
420			my $rawsel = $self->selected();
421
422			foreach my $tool ( sort { %{$rawsel}->{$a}
423			<=> %{$rawsel}->{$b}}
424			keys %{$rawsel} )
425			{
426			# Return tool data objects of all set-up tools, skipping the tool "self":
427			if ($_ ne "self")
428			{
429			# Keep only tools that have really been set up:
430			if (exists $self->{SETUP}->{$tool})
431			{
432			push(@tooldata,$self->{SETUP}->{$tool});
433			}
434			}
435			}
436
437			# Return the array of tools, in order that they appear in RequirementsDoc:
438			return @tooldata;
439			}
440
441			sub definedtool()
442			{
443			my $self=shift;
444			my ($tool)=@_;
445
446			# Check to see if tool X is an external tool:
447			grep ($_ eq $tool, keys %{$self->{SETUP}}) ? return 1
448			: return 0;
449			}
450
451			sub checkifsetup()
452			{
453			my $self=shift;
454			my ($tool)=@_;
455			# Return the ToolData object if the tool has been set up:
456			(exists $self->{SETUP}->{$tool}) ? return ($self->{SETUP}->{$tool})
457			: return undef;
458			}
459
460			sub cloned_tm()
461			{
462			my $self=shift;
463			# Has this area already been cloned and brought in-line with current location:
464			@_ ? $self->{CLONED} = $_[0]
465			: $self->{CLONED};
466			}
467
468			sub remove_tool()
469			{
470			my $self=shift;
471			my ($toolname)=@_;
472			my $tools = $self->{SETUP};
473			my $newtlist = {};
474
475			while (my ($tool, $tooldata) = each %$tools)
476			{
477			if ($tool ne $toolname)
478			{
479			$newtlist->{$tool} = $tooldata;
480			}
481			else
482			{
483			print "Deleting $toolname from cache.","\n";
484			}
485			}
486
487			$self->{SETUP} = $newtlist;
488
489			# Now remove from the RAW tool list:
490			$self->cleanup_raw($toolname);
491
492			print "ToolManager: Updating tool cache.","\n";
493			$self->writecache();
494			}
495
496			sub scram_projects()
497			{
498			my $self=shift;
499			my $scram_projects={};
500
501			foreach my $t ($self->tools())
502			{
503			# Get the ToolData object:
504			my $td=$self->{SETUP}->{$t};
505			$scram_projects->{$t}=$td->variable_data(uc($t)."_BASE"), if ($td->scram_project());
506			}
507
508			return $scram_projects;
509			}
510
511			1;