ViewVC Help

View File | Revision Log | Show Annotations | Root Listing

root/cvsroot/COMP/SCRAM/src/Scram/ScramFunctions.pm

Comparing COMP/SCRAM/src/Scram/ScramFunctions.pm (file contents):
Revision 1.3 by williamc, Wed Aug 30 09:31:31 2000 UTC vs.
Revision 1.24 by sashby, Wed Feb 2 18:57:02 2005 UTC

#	Line 18 | Line 18
18		# areatoolbox(ConfigArea) : return the toolbox of the specified area
19		# setuptoolsinarea($area[,$toolname[,$toolversion[,toolfile]) : setup
20		# arch()                : get/set the architecture string
21	+	# scramobjectinterface(Class)  : print out the interface of a scram class
22	+	# webget(area,url)      : get the url into the cache of the specified area
23	+	# getversion()          : return the current scram version
24	+	# spawnversion(version,@args) : spawn the scram version with the given args
25	+	# classverbose(classstring,setting) : Set the class verbosity level
26	+	# toolruntime(ConfigArea): Get a runtime object withthe settings from
27	+	#                          the specified toolbox
28
29		package Scram::ScramFunctions;
30		use URL::URLcache;
31		use Utilities::Verbose;
32	+	use Utilities::IndexedFileStore;
33	+
34		require 5.004;
35
36		@ISA=qw(Utilities::Verbose);
37
38	<	sub new {
38	>	sub new
39	>	{
40	>	my $class=shift;
41	>	$self={};
42	>	bless $self, $class;
43	>	# -- default settings
44	>	$self->{cachedir}=$ENV{HOME}."/.scramrc/globalcache";
45	>	$self->{scramprojectsdbdir}=$ENV{SCRAM_LOOKUPDB};
46	>	($self->{scram_top})=( $ENV{SCRAM_HOME}=~/(.*)\//) ;
47	>
48	>	return $self;
49	>	}
50	>
51	>	sub classverbose {
52	>	my $self=shift;
53		my $class=shift;
54	<	$self={};
55	<	bless $self, $class;
56	<	# -- default settings
34	<	$self->{cachedir}=$ENV{HOME}."/.SCRAM/globalcache";
35	<	$self->{scramprojectsdbdir}=$ENV{SCRAM_LOOKUPDB};
36	<	return $self;
54	>	my $val=shift;
55	>
56	>	$ENV{"VERBOSE_".$class}=$val;
57		}
58
59		sub project {
#	Line 57 | Line 77 | sub project {
77
78		# -- download all tool description files
79		my $req=$self->arearequirements($area);
80	+	$area->toolboxversion($req->{configversion});
81	+
82		if ( defined $req ) {
83		$req->download($self->areatoolbox($area));
84		}
#	Line 64 | Line 86 | sub project {
86		return $area;
87		}
88
89	<	sub setuptoolsinarea {
90	<	my $self=shift;
91	<	my $area=shift;
92	<
93	<	# -- initialise
94	<	$self->_allprojectinitsearcher();
95	<
96	<	# -- create a new toolbox object
97	<	my $toolbox=$self->areatoolbox($area);
98	<	$toolbox->searcher($self->_projsearcher());
89	>	sub setuptoolsinarea
90	>	{
91	>	my $self=shift;
92	>	my $area=shift;
93	>
94	>	# -- initialise
95	>	print "Initialising setup procedure......","\n";
96	>	$self->_allprojectinitsearcher();
97	>
98	>	# -- create a new toolbox object
99	>	my $toolbox=$self->areatoolbox($area);
100	>	$toolbox->searcher($self->_allprojectinitsearcher());
101	>
102	>	if ( @_ )
103	>	{
104	>	# -- specific tool specified
105	>	if ( my $rv=$toolbox->toolsetup(@_) )
106	>	{
107	>	if ( $rv eq 1 )
108	>	{
109	>	print "Unknown tool $toolname @ARGV\n";
110	>	exit 1;
111	>	}
112	>	}
113	>	}
114	>	else
115	>	{
116	>	# -- setup all tools specified in the requirements doc
117	>	print "Going to set up all tools....","\n\n";
118	>	my $reqs=$self->arearequirements($area);
119	>	$self->verbose("Setup ToolBox from Requirements doc ($reqs)");
120	>	# reqs is a BuildSystem::Requirements object:
121	>	$reqs->setup($toolbox);
122	>	}
123	>	}
124	>
125	>	sub updatetoolsinarea
126	>	{
127	>	my $self=shift;
128	>	my $area=shift;
129	>
130	>
131	>	my $toolbox=$self->areatoolbox($area);
132	>
133	>	print "Going to refresh the setup of tools....","\n\n";
134	>	my $currenttag = $area->toolboxversion();
135	>
136	>	# Get rid of the current cache:
137	>	my $cachename = $area->cache()->location();
138	>	system("mv","$cachename","$cachename".".$currenttag");
139	>	# Create a new one:
140	>	$area->_newcache();
141	>	my $reqs=$self->arearequirements($area);
142	>	$reqs->download();
143	>	$reqs->setup($toolbox);
144	>	print "Previous configuration tag : ",$currenttag,"\n";
145	>	$area->toolboxversion($reqs->{configversion});
146	>	print "Current configuration tag  : ",$area->toolboxversion(),"\n\n";
147	>	$area->save();
148	>	}
149	>
150	>	sub satellite
151	>	{
152	>	#
153	>	# Modified to suit new structure
154	>	#
155	>	my $self=shift;
156	>	my $name=shift;
157	>	my $version=shift;
158	>	my $installarea=shift; # Where to install (-dir option in project cmd);
159	>	my $areaname=undef;    # Name of the area (comes from -name option in project cmd);
160	>
161	>	use Utilities::AddDir;
162	>
163	>	if ( @_ )
164	>	{
165	>	$areaname=shift;
166	>	}
167	>
168	>	# Get location from SCRAMDB:
169	>	my $relarea=$self->_lookupareaindb($name,$version);
170	>
171	>	if ( ! defined $relarea )
172	>	{
173	>	$self->error("Unable to Find Project $name $version");
174	>	}
175	>
176	>	# Create a satellite area:
177	>	my $area=$relarea->satellite($installarea,$areaname);
178	>	$area->archname($self->arch());
179	>
180	>	# Copy the admin dir (and with it, the ToolCache):
181	>	$relarea->copywithskip($area->location(),'ProjectCache.db');
182	>
183	>	# Also, we need to copy .SCRAM/cache from the release area. This eliminates the need
184	>	# to download tools again from CVS:
185	>	$relarea->copyurlcache($area->location());
186	>
187	>	# Copy configuration directory contents:
188	>	if ( ! -d $area->location()."/".$area->configurationdir() )
189	>	{
190	>	AddDir::copydir($relarea->location()."/".$relarea->configurationdir(),
191	>	$area->location()."/".$area->configurationdir() );
192	>	}
193	>
194	>	# Make sourcecode dir:
195	>	if ( ! -d $area->location()."/".$area->sourcedir() )
196	>	{
197	>	AddDir::adddir($area->location()."/".$area->sourcedir());
198	>	}
199	>
200	>	# Copy RequirementsDoc:
201	>	if ( ! -f $area->requirementsdoc() )
202	>	{
203	>	use File::Copy;
204	>	copy( $relarea->requirementsdoc() , $area->requirementsdoc());
205	>	}
206
207	<	if ( @_ ) {
208	<	# -- specific tool specified
80	<	if ( my $rv=$toolbox->toolsetup(@_) ) {
81	<	if ( $rv eq 1 ) {
82	<	print "Unknown tool $toolname @ARGV\n";
83	<	exit 1;
84	<	}
85	<	}
86	<	}
87	<	else {
88	<	# -- setup all tools specified in the requirements doc
89	<	my $reqs=$self->arearequirements($area);
90	<	$self->verbose("Setup ToolBox from Requirements doc ($reqs)");
91	<	$reqs->setup($toolbox);
92	<	}
93	<	}
207	>	return $area;
208	>	}
209
210	<	sub satellite {
210	>	sub toolruntime {
211		my $self=shift;
212	<	my $name=shift;
213	<	my $version=shift;
214	<	my $installarea=shift;
100	<
101	<	my $areaname="";
102	<	if ( @_ ) {
103	<	$areaname=shift;
104	<	}
105	<
106	<	# -- look up scram database for location
107	<	my $relarea=$self->_lookupareaindb($name,$version);
108	<	if ( ! defined $relarea ) {
109	<	$self->error("Unable to Find Project $name $version");
110	<	}
111	<
112	<	# -- create satellite
113	<	my $area=$relarea->satellite($installarea,$areaname);
114	<	$area->archname($self->arch());
115	<
116	<	# -- copy setup info - deprecated by toolbox copy method
117	<	#$relarea->copysetup($area->location());
118	<
119	<	# -- copy toolbox
120	<	my $rtb=$self->areatoolbox($relarea);
121	<	my $tb=$self->areatoolbox($area);
122	<	$rtb->copytools($tb);
123	<
124	<	# -- copy configuration directory
125	<	if ( ! -d $area->location()."/".$area->configurationdir() ) {
126	<	use Utilities::AddDir;
127	<	AddDir::copydir($relarea->location()."/".$relarea->configurationdir(),
128	<	$area->location()."/".$area->configurationdir() );
129	<	}
130	<
131	<	# -- copy RequirementsDoc
132	<	if ( ! -f $area->requirementsdoc() ) {
133	<	use File::Copy;
134	<	copy( $relarea->requirementsdoc() , $area->requirementsdoc());
135	<	}
212	>	my $area=shift;
213	>	my $ld_lib_path="";
214	>	my $bin_path="";
215
216	<	return $area;
216	>	my $name=$area->location();
217	>
218	>	if ( ! defined $self->{toolruntime}{$name} )
219	>	{
220	>	require Runtime;
221	>	my $toolbox=$self->areatoolbox($area);
222	>	$self->{toolruntime}{$name}=Runtime->new();
223	>
224	>	# Test for SCRAM_ARCH/lib order:
225	>	if ( -d $area->location()."/".$self->arch())
226	>	{
227	>	$ld_lib_path = $area->location()."/".$self->arch()."/lib"
228	>	unless ( ! -d $area->location()."/".$self->arch()."/lib");
229	>	$bin_path = $area->location()."/".$self->arch()."/bin"
230	>	unless ( ! -d $area->location()."/".$self->arch()."/bin");
231	>	}
232	>	# Other way around:
233	>	elsif ( -d  $area->location()."/lib/".$self->arch())
234	>	{
235	>	$ld_lib_path = $area->location()."/lib/".$self->arch()
236	>	unless ( ! -d $area->location()."/lib/".$self->arch());
237	>	$bin_path = $area->location()."/bin/".$self->arch()
238	>	unless ( ! -d $area->location()."/bin/".$self->arch());
239	>	}
240	>	else
241	>	# Assume no arch so just use lib and bin:
242	>	{
243	>	$ld_lib_path = $area->location()."/lib";
244	>	$bin_path = $area->location()."/bin";
245	>	}
246	>
247	>	# -- Now set the scram area specific runtimes accordingly:
248	>	$self->{toolruntime}{$name}->addvar("LD_LIBRARY_PATH",$ld_lib_path,"path");
249	>	$self->{toolruntime}{$name}->addvar("PATH",$bin_path,"path");
250	>
251	>	# Check for a linked area:
252	>	if ( defined $area->linkarea() )
253	>	{
254	>	my $relarea=$area->linkarea();
255	>	# Now do the checks for the release area:
256	>	if ( -d $relarea->location()."/".$self->arch())
257	>	{
258	>	$ld_lib_path = $relarea->location()."/".$self->arch()."/lib"
259	>	unless ( ! -d $relarea->location()."/".$self->arch()."/lib");
260	>	$bin_path = $relarea->location()."/".$self->arch()."/bin"
261	>	unless ( ! -d $relarea->location()."/".$self->arch()."/bin");
262	>	}
263	>	# Other way around:
264	>	elsif ( -d  $relarea->location()."/lib/".$self->arch())
265	>	{
266	>	$ld_lib_path = $relarea->location()."/lib/".$self->arch()
267	>	unless ( ! -d $relarea->location()."/lib/".$self->arch());
268	>	$bin_path = $relarea->location()."/bin/".$self->arch()
269	>	unless ( ! -d $relarea->location()."/bin/".$self->arch());
270	>	}
271	>	else
272	>	# Assume no arch so just use lib and bin:
273	>	{
274	>	$ld_lib_path = $relarea->location()."/lib";
275	>	$bin_path = $relarea->location()."/bin";
276	>	}
277	>	# Add the release paths:
278	>	$self->{toolruntime}{$name}->addvar("LD_LIBRARY_PATH",$ld_lib_path,"path");
279	>	$self->{toolruntime}{$name}->addvar("PATH",$bin_path,"path");
280	>	}
281	>
282	>	# -- get the runtime environment from all the tools
283	>	my $tool;
284	>	foreach $toolname ( $toolbox->tools() )
285	>	{
286	>	$tool=$toolbox->gettool($toolname);
287	>	if ( defined $tool )
288	>	{
289	>	# -- get runtime paths
290	>	foreach $f ( $tool->listtype("runtime_path"))
291	>	{
292	>	foreach $val ( $tool->getfeature($f) )
293	>	{
294	>	$self->{toolruntime}{$name}->addvar($f,$val,"path");
295	>	}
296	>	}
297	>	# -- get runtime vars
298	>	foreach $f ( $tool->listtype("runtime"))
299	>	{
300	>	foreach $val ( $tool->getfeature($f) )
301	>	{
302	>	$self->{toolruntime}{$name}->addvar($f,$val);
303	>	}
304	>	}
305	>	}
306	>	}
307	>
308	>	# -- Get the project level environment
309	>	my $runtimefile=$area->location()."/".$area->configurationdir()."/Runtime";
310	>
311	>	if ( -f $runtimefile )
312	>	{
313	>	$self->{toolruntime}{$name}->file($runtimefile);
314	>	}
315	>	}
316	>	return $self->{toolruntime}{$name};
317	>	}
318	>
319	>	sub webget {
320	>	my $self=shift;
321	>	my $area=shift;
322	>	my $url=shift;
323	>
324	>	require URL::URLhandler;
325	>	my $handler=URL::URLhandler->new($area->cache());
326	>	return ($handler->download($url));
327		}
328
329		sub addareatoDB {
330		my $self=shift;
331	+	my $flag=shift;
332		my $area=shift;
333		my $tagname=shift;
334		my $version=shift;
#	Line 150 | Line 340 | sub addareatoDB {
340		if ( (! defined $tagname)  || ( $tagname eq "") ) {
341		$tagname=$area->name();
342		}
153	–
343		# -- Add to the DB
344	<	$self->scramprojectdb()->addarea($tagname,$version,$area);
344	>	$self->scramprojectdb()->addarea($flag,$tagname,$version,$area);
345		}
346
347	+
348	+	sub removeareafromDB
349	+	{
350	+	###############################################################
351	+	# removearefromDB()                                           #
352	+	###############################################################
353	+	# modified : Thu Jun 14 10:46:22 2001 / SFA                   #
354	+	# params   : projectname, projectversion                      #
355	+	#          :                                                  #
356	+	#          :                                                  #
357	+	#          :                                                  #
358	+	# function : Remove project <projectname> from DB file.       #
359	+	#          :                                                  #
360	+	#          :                                                  #
361	+	###############################################################
362	+	my $self=shift;
363	+	my $flag=shift;
364	+	my $projname=shift;
365	+	my $version=shift;
366	+
367	+	# -- Remove from the DB:
368	+	$self->scramprojectdb()->removearea($flag,$projname,$version);
369	+	}
370	+
371	+
372	+	sub spawnversion
373	+	{
374	+	###############################################################
375	+	# spawnversion                                                #
376	+	###############################################################
377	+	# modified : Fri Aug 10 15:42:08 2001 / SFA                   #
378	+	# params   :                                                  #
379	+	#          :                                                  #
380	+	#          :                                                  #
381	+	#          :                                                  #
382	+	# function : Check for version of scram to run, and run it.   #
383	+	#          :                                                  #
384	+	#          :                                                  #
385	+	###############################################################
386	+
387	+	my $self=shift;
388	+	my $version=shift;
389	+	my $rv=0;
390	+
391	+	my $thisversion=$self->getversion();
392	+
393	+	if ( defined $version )
394	+	{
395	+	if ( $version ne $thisversion )
396	+	{
397	+	# first try to use the correct version
398	+	if ( -d $self->{scram_top}."/".$version )
399	+	{
400	+	$ENV{SCRAM_HOME}=$self->{scram_top}."/".$version;
401	+	$ENV{SCRAM_TOOL_HOME}="$ENV{SCRAM_HOME}/src";
402	+	$self->verbose("Spawning SCRAM version $version");
403	+	my $rv=system($ENV{SCRAM_HOME}."/src/main/scram.pl", @_)/256;
404	+	exit $rv;
405	+	}
406	+	else
407	+	{
408	+	# if not then simply warn. Send output to STDERR:
409	+	if ( -t STDERR )
410	+	{
411	+	print STDERR "******* Warning : scram version inconsistent ********\n";
412	+	print STDERR "This version: $thisversion; Required version: $version\n";
413	+	print STDERR "*****************************************************\n";
414	+	print STDERR "\n";
415	+	}
416	+	}
417	+	}
418	+	}
419	+	else
420	+	{
421	+	$self->error("Undefined value for version requested");
422	+	$rv=1;
423	+	}
424	+	return $rv;
425	+	}
426	+
427		sub globalcache {
428		my $self=shift;
429		if ( @_ ) {
#	Line 180 | Line 449 | sub scramprojectdb {
449		}
450		return $self->{scramprojectsdb};
451		}
452	+
453	+	sub getversion {
454	+	my $self=shift;
455	+
456	+	my $thisversion;
457	+	($thisversion=$ENV{SCRAM_HOME})=~s/(.*)\///;
458	+	my $scram_top=$1;
459	+	my $scram_version=$thisversion;
460	+	# deal with links
461	+	my $version=readlink $ENV{SCRAM_HOME};
462	+	if ( defined $version)  {
463	+	$scram_version=$version;
464	+	}
465	+	return $scram_version;
466	+	}
467
468		sub areatoolbox {
469		my $self=shift;
#	Line 189 | Line 473 | sub areatoolbox {
473		if ( ! defined $self->{toolboxes}{$name} ) {
474		# -- create a new toolbox object
475		require BuildSystem::ToolBox;
476	<	$self->{toolboxes}{$name}=BuildSystem::ToolBox->new($area);
476	>	$self->{toolboxes}{$name}=BuildSystem::ToolBox->new($area,
477	>	$self->arch());
478		$self->{toolboxes}{$name}->verbosity($self->verbosity());
479		}
480		return $self->{toolboxes}{$name};
481		}
482
483	+	sub areatoolmanager
484	+	{
485	+	my $self=shift;
486	+	my $area=shift;
487	+
488	+	my $name=$area->location();
489	+
490	+	if ( ! defined $self->{toolmanagers}{$name} )
491	+	{
492	+	use BuildSystem::ToolManager;
493	+	$self->{toolmanagers}{$name}=ToolManager->new($area,$self->arch());
494	+	}
495	+
496	+	return $self->{toolmanagers}{$name};
497	+	}
498	+
499		sub arearequirements {
500		my $self=shift;
501		my $area=shift;
#	Line 228 | Line 529 | sub arch {
529		:$self->{arch};
530		}
531
532	+	sub scramobjectinterface {
533	+	my $self=shift;
534	+	my $class=shift;
535	+
536	+	my $file;
537	+	($file=$class."\.pm")=~s/::/\//g;
538	+	$file=$ENV{SCRAM_TOOL_HOME}."/".$file;
539	+
540	+	if ( ! -f $file ) {
541	+	$self->error("Unable to find $class in ".$ENV{SCRAM_TOOL_HOME});
542	+	}
543	+	print "--------------------- $class ------------------\n";
544	+	my $fh=FileHandle->new();
545	+	$fh->open("<$file");
546	+	while ( <$fh> ) {
547	+	if ( $_=~/#\s*Interface/g ) {
548	+	$intregion=1;
549	+	next;
550	+	}
551	+	if ( $intregion ) { # if we are in the interface documentation
552	+	if ( ( $_!~/^#/ ) || ( $_=~/^#\s?-{40}/ ) ) { #moving out of Int doc
553	+	$intregion=0;
554	+	next;
555	+	}
556	+	print $_;
557	+	if ( $_=~/^#\s*(.*)\((.*)\)?:(.*)/ ) {
558	+	$interface=$1;
559	+	$args=$2;
560	+	$rest=$3;
561	+	next if ($interface eq "");
562	+	push @interfaces,$interface;
563	+	$interfaceargs{$interface}=$args;
564	+	}
565	+	}
566	+	}
567	+	print "\n";
568	+	undef $fh;
569	+	}
570	+
571		# -------------- Support Routines ------------------------------
572
573
#	Line 238 | Line 578 | sub _allprojectinitsearcher {
578		$search->addproject($$proj[0],$$proj[1]);
579		}
580		}
581	+	return $self->{projsearcher};
582		}
583
584		sub _projsearcher {

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines