wizard/BProject.py

   1 #!/usr/bin/env python
   2 # encoding: utf-8
   3 #
   4 # This file is part of BeRTOS.
   5 #
   6 # Bertos is free software; you can redistribute it and/or modify
   7 # it under the terms of the GNU General Public License as published by
   8 # the Free Software Foundation; either version 2 of the License, or
   9 # (at your option) any later version.
  10 #
  11 # This program is distributed in the hope that it will be useful,
  12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 # GNU General Public License for more details.
  15 #
  16 # You should have received a copy of the GNU General Public License
  17 # along with this program; if not, write to the Free Software
  18 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  19 #
  20 # As a special exception, you may use this file as part of a free software
  21 # library without restriction.  Specifically, if other files instantiate
  22 # templates or use macros or inline functions from this file, or you compile
  23 # this file and link it with other files to produce an executable, this
  24 # file does not by itself cause the resulting executable to be covered by
  25 # the GNU General Public License.  This exception does not however
  26 # invalidate any other reasons why the executable file might be covered by
  27 # the GNU General Public License.
  28 #
  29 # Copyright 2008 Develer S.r.l. (http://www.develer.com/)
  30 #
  31 # $Id$
  32 #
  33 # Author: Lorenzo Berni <duplo@develer.com>
  34 #
  35
  36 import os
  37 import fnmatch
  38 import copy
  39 import pickle
  40
  41 import DefineException
  42
  43 from LoadException import VersionException, ToolchainException
  44
  45 import const
  46
  47 from bertos_utils import (
  48                             # Utility functions
  49                             isBertosDir, getTagSet, setEnabledModules, getInfos,
  50                             loadConfigurationInfos, loadDefineLists, loadModuleDefinition,
  51                             getCommentList, updateConfigurationValues,
  52
  53                             # Custom exceptions
  54                             ParseError, SupportedException
  55                         )
  56
  57 class BProject(object):
  58     """
  59     Simple class for store and retrieve project informations.
  60     """
  61
  62     def __init__(self, project_file="", info_dict={}):
  63         self.infos = {}
  64         self._cached_queries = {}
  65         if project_file:
  66             self.loadBertosProject(project_file, info_dict)
  67
  68     def loadBertosProject(self, project_file, info_dict):
  69         project_dir = os.path.dirname(project_file)
  70         project_data = pickle.loads(open(project_file, "r").read())
  71         # If PROJECT_NAME is not defined it use the directory name as PROJECT_NAME
  72         # NOTE: this can throw an Exception if the user has changed the directory containing the project
  73         self.infos["PROJECT_NAME"] = project_data.get("PROJECT_NAME", os.path.basename(project_dir))
  74         self.infos["PROJECT_PATH"] = os.path.dirname(project_file)
  75         # Check for the Wizard version
  76         wizard_version = project_data.get("WIZARD_VERSION", 0)
  77         # Ignore the SOURCES_PATH inside the project file
  78         project_data["SOURCES_PATH"] = project_dir
  79         if "SOURCES_PATH" in info_dict:
  80             project_data["SOURCES_PATH"] = info_dict["SOURCES_PATH"]
  81         if os.path.exists(project_data["SOURCES_PATH"]):
  82             self.infos["SOURCES_PATH"] = project_data["SOURCES_PATH"]
  83         else:
  84             raise VersionException(self)
  85         if not isBertosDir(project_dir):
  86             version_file = open(os.path.join(const.DATA_DIR, "vtemplates/VERSION"), "r").read()
  87             open(os.path.join(project_dir, "VERSION"), "w").write(version_file.replace("$version", "").strip())
  88         self.loadSourceTree()
  89         cpu_name = project_data["CPU_NAME"]
  90         self.infos["CPU_NAME"] = cpu_name
  91         cpu_info = self.loadCpuInfos()
  92         for cpu in cpu_info:
  93             if cpu["CPU_NAME"] == cpu_name:
  94                 self.infos["CPU_INFOS"] = cpu
  95                 break
  96         tag_list = getTagSet(cpu_info)
  97         # Create, fill and store the dict with the tags
  98         tag_dict = {}
  99         for element in tag_list:
 100             tag_dict[element] = False
 101         infos = self.info("CPU_INFOS")
 102         for tag in tag_dict:
 103             if tag in infos["CPU_TAGS"] + [infos["CPU_NAME"], infos["TOOLCHAIN"]]:
 104                 tag_dict[tag] = True
 105             else:
 106                 tag_dict[tag] = False
 107         self.infos["ALL_CPU_TAGS"] = tag_dict
 108         if "TOOLCHAIN" in info_dict:
 109             project_data["TOOLCHAIN"] = info_dict["TOOLCHAIN"]
 110         if os.path.exists(project_data["TOOLCHAIN"]["path"]):
 111             self.infos["TOOLCHAIN"] = project_data["TOOLCHAIN"]
 112         else:
 113             raise ToolchainException(self)
 114         self.infos["SELECTED_FREQ"] = project_data["SELECTED_FREQ"]
 115         self.infos["OUTPUT"] = project_data["OUTPUT"]
 116         self.loadModuleData(True)
 117         setEnabledModules(self, project_data["ENABLED_MODULES"])
 118
 119     def loadProjectPresets(self, preset_directory):
 120         """
 121         Load the default presets (into the const.PREDEFINED_BOARDS_DIR).
 122         """
 123         # NOTE: this method does nothing (for now).
 124         preset_path = os.path.join(self.infos["SOURCES_PATH"], const.PREDEFINED_BOARDS_DIR)
 125
 126     def loadModuleData(self, edit=False):
 127         module_info_dict = {}
 128         list_info_dict = {}
 129         configuration_info_dict = {}
 130         file_dict = {}
 131         for filename, path in self.findDefinitions("*.h") + self.findDefinitions("*.c") + self.findDefinitions("*.s") + self.findDefinitions("*.S"):
 132             comment_list = getCommentList(open(path + "/" + filename, "r").read())
 133             if len(comment_list) > 0:
 134                 module_info = {}
 135                 configuration_info = {}
 136                 try:
 137                     to_be_parsed, module_dict = loadModuleDefinition(comment_list[0])
 138                 except ParseError, err:
 139                     raise DefineException.ModuleDefineException(path, err.line_number, err.line)
 140                 for module, information in module_dict.items():
 141                     if "depends" not in information:
 142                         information["depends"] = ()
 143                     information["depends"] += (filename.split(".")[0],)
 144                     information["category"] = os.path.basename(path)
 145                     if "configuration" in information and len(information["configuration"]):
 146                         configuration = module_dict[module]["configuration"]
 147                         try:
 148                             configuration_info[configuration] = loadConfigurationInfos(self.infos["SOURCES_PATH"] + "/" + configuration)
 149                         except ParseError, err:
 150                             raise DefineException.ConfigurationDefineException(self.infos["SOURCES_PATH"] + "/" + configuration, err.line_number, err.line)
 151                         if edit:
 152                             try:
 153                                 path = self.infos["PROJECT_NAME"]
 154                                 directory = self.infos["PROJECT_PATH"]
 155                                 user_configuration = loadConfigurationInfos(directory + "/" + configuration.replace("bertos", path))
 156                                 configuration_info[configuration] = updateConfigurationValues(configuration_info[configuration], user_configuration)
 157                             except ParseError, err:
 158                                 raise DefineException.ConfigurationDefineException(directory + "/" + configuration.replace("bertos", path))
 159                 module_info_dict.update(module_dict)
 160                 configuration_info_dict.update(configuration_info)
 161                 if to_be_parsed:
 162                     try:
 163                         list_dict = loadDefineLists(comment_list[1:])
 164                         list_info_dict.update(list_dict)
 165                     except ParseError, err:
 166                         raise DefineException.EnumDefineException(path, err.line_number, err.line)
 167         # NOTE: These lines probably should be removed
 168         for filename, path in self.findDefinitions("*_" + self.infos["CPU_INFOS"]["TOOLCHAIN"] + ".h"):
 169             comment_list = getCommentList(open(path + "/" + filename, "r").read())
 170             list_info_dict.update(loadDefineLists(comment_list))
 171         # end of lines to be removed
 172         for tag in self.infos["CPU_INFOS"]["CPU_TAGS"]:
 173             for filename, path in self.findDefinitions("*_" + tag + ".h"):
 174                 comment_list = getCommentList(open(path + "/" + filename, "r").read())
 175                 list_info_dict.update(loadDefineLists(comment_list))
 176         self.infos["MODULES"] = module_info_dict
 177         self.infos["LISTS"] = list_info_dict
 178         self.infos["CONFIGURATIONS"] = configuration_info_dict
 179         self.infos["FILES"] = file_dict
 180
 181     def loadCpuInfos(self):
 182         cpuInfos = []
 183         for definition in self.findDefinitions(const.CPU_DEFINITION):
 184             cpuInfos.append(getInfos(definition))
 185         return cpuInfos
 186
 187     def reloadCpuInfo(self):
 188         for cpu_info in self.loadCpuInfos():
 189             if cpu_info["CPU_NAME"] == self.infos["CPU_NAME"]:
 190                 self.infos["CPU_INFOS"] = cpu_info
 191
 192     def setInfo(self, key, value):
 193         """
 194         Store the given value with the name key.
 195         """
 196         self.infos[key] = value
 197
 198     def info(self, key, default=None):
 199         """
 200         Retrieve the value associated with the name key.
 201         """
 202         if key in self.infos:
 203             return copy.deepcopy(self.infos[key])
 204         return default
 205
 206     def loadSourceTree(self):
 207         # Index only the SOURCES_PATH/bertos content
 208         bertos_sources_dir = os.path.join(self.info("SOURCES_PATH"), 'bertos')
 209         file_dict = {}
 210         if os.path.exists(bertos_sources_dir):
 211             for element in os.walk(bertos_sources_dir):
 212                 for f in element[2]:
 213                     file_dict[f] = file_dict.get(f, []) + [element[0]]
 214         self.infos["FILE_DICT"] = file_dict
 215
 216     def searchFiles(self, filename):
 217         file_dict = self.infos["FILE_DICT"]
 218         return [(filename, dirname) for dirname in file_dict.get(filename, [])]
 219
 220     def findDefinitions(self, ftype):
 221         # Maintain a cache for every scanned SOURCES_PATH
 222         definitions_dict = self._cached_queries.get(self.infos["SOURCES_PATH"], {})
 223         definitions = definitions_dict.get(ftype, None)
 224         if definitions is not None:
 225             return definitions
 226         file_dict = self.infos["FILE_DICT"]
 227         definitions = []
 228         for filename in file_dict:
 229             if fnmatch.fnmatch(filename, ftype):
 230                 definitions += [(filename, dirname) for dirname in file_dict.get(filename, [])]
 231
 232         # If no cache for the current SOURCES_PATH create an empty one
 233         if not definitions_dict:
 234             self._cached_queries[self.infos["SOURCES_PATH"]] = {}
 235         # Fill the empty cache with the result
 236         self._cached_queries[self.infos["SOURCES_PATH"]][ftype] = definitions
 237         return definitions
 238
 239     def __repr__(self):
 240         return repr(self.infos)