xref: /minix/external/bsd/llvm/dist/llvm/utils/wciia.py (revision 83133719) 
1#!/usr/bin/env python
2
3"""
4wciia - Whose Code Is It Anyway
5
6Determines code owner of the file/folder relative to the llvm source root.
7Code owner is determined from the content of the CODE_OWNERS.TXT
8by parsing the D: field
9
10usage:
11
12utils/wciia.py  path
13
14limitations:
15- must be run from llvm source root
16- very simplistic algorithm
17- only handles * as a wildcard
18- not very user friendly
19- does not handle the proposed F: field
20
21"""
22
23import os
24
25code_owners = {}
26
27def process_files_and_folders(owner):
28	filesfolders = owner['filesfolders']
29	# paths must be in ( ... ) so strip them
30	lpar = filesfolders.find('(')
31	rpar = filesfolders.rfind(')')
32	if rpar <= lpar:
33		# give up
34		return
35	paths = filesfolders[lpar+1:rpar]
36	# split paths
37	owner['paths'] = []
38	for path in paths.split():
39		owner['paths'].append(path)
40
41def process_code_owner(owner):
42	if 'filesfolders' in owner:
43		filesfolders = owner['filesfolders']
44	else:
45#		print "F: field missing, using D: field"
46		owner['filesfolders'] = owner['description']
47	process_files_and_folders(owner)
48	code_owners[owner['name']] = owner
49
50# process CODE_OWNERS.TXT first
51code_owners_file = open("CODE_OWNERS.TXT", "r").readlines()
52code_owner = {}
53for line in code_owners_file:
54    for word in line.split():
55	if word == "N:":
56		name = line[2:].strip()
57		if code_owner:
58			process_code_owner(code_owner)
59			code_owner = {}
60		# reset the values
61		code_owner['name'] = name
62	if word == "E:":
63		email = line[2:].strip()
64		code_owner['email'] = email
65	if word == "D:":
66		description = line[2:].strip()
67		code_owner['description'] = description
68	if word == "F:":
69		filesfolders = line[2:].strip()
70		code_owner['filesfolders'].append(filesfolders)
71
72def find_owners(fpath):
73	onames = []
74	lmatch = -1
75	#  very simplistic way of findning the best match
76	for name in code_owners:
77		owner = code_owners[name]
78		if 'paths' in owner:
79			for path in owner['paths']:
80#				print "searching (" + path + ")"
81				# try exact match
82				if fpath == path:
83					return name
84				# see if path ends with a *
85				rstar = path.rfind('*')
86				if rstar>0:
87					# try the longest match,
88					rpos = -1
89					if len(fpath) < len(path):
90						rpos = path.find(fpath)
91					if rpos == 0:
92						onames.append(name)
93	onames.append('Chris Lattner')
94	return onames
95
96# now lest try to find the owner of the file or folder
97import sys
98
99if len(sys.argv) < 2:
100	print "usage " + sys.argv[0] + " file_or_folder"
101	exit(-1)
102
103# the path we are checking
104path = str(sys.argv[1])
105
106# check if this is real path
107if not os.path.exists(path):
108	print "path (" + path + ") does not exist"
109	exit(-1)
110
111owners_name = find_owners(path)
112
113# be gramatically correct
114print "The owner(s) of the (" + path + ") is(are) : " + str(owners_name)
115
116exit(0)
117
118# bottom up walk of the current .
119# not yet used
120root = "."
121for dir,subdirList,fileList in os.walk( root , topdown=False ) :
122   print "dir :" , dir
123   for fname in fileList :
124      print "-" , fname
125   print
126