You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
471 lines
16 KiB
471 lines
16 KiB
# Copyright (c) 2014-present PlatformIO <contact@platformio.org>
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
import glob
|
|
import json
|
|
import os
|
|
import re
|
|
from hashlib import sha1
|
|
|
|
import click
|
|
|
|
from platformio import fs
|
|
from platformio.compat import PY2, WINDOWS, hashlib_encode_data, string_types
|
|
from platformio.project import exception
|
|
from platformio.project.options import ProjectOptions
|
|
|
|
try:
|
|
import ConfigParser as ConfigParser
|
|
except ImportError:
|
|
import configparser as ConfigParser
|
|
|
|
CONFIG_HEADER = """
|
|
; PlatformIO Project Configuration File
|
|
;
|
|
; Build options: build flags, source filter
|
|
; Upload options: custom upload port, speed and extra flags
|
|
; Library options: dependencies, extra library storages
|
|
; Advanced options: extra scripting
|
|
;
|
|
; Please visit documentation for the other options and examples
|
|
; https://docs.platformio.org/page/projectconf.html
|
|
"""
|
|
|
|
|
|
MISSING = object()
|
|
|
|
|
|
class ProjectConfigBase(object):
|
|
|
|
INLINE_COMMENT_RE = re.compile(r"\s+;.*$")
|
|
VARTPL_RE = re.compile(r"\$\{([^\.\}]+)\.([^\}]+)\}")
|
|
|
|
expand_interpolations = True
|
|
warnings = []
|
|
|
|
_parser = None
|
|
_parsed = []
|
|
|
|
@staticmethod
|
|
def parse_multi_values(items):
|
|
result = []
|
|
if not items:
|
|
return result
|
|
if not isinstance(items, (list, tuple)):
|
|
items = items.split("\n" if "\n" in items else ", ")
|
|
for item in items:
|
|
item = item.strip()
|
|
# comment
|
|
if not item or item.startswith((";", "#")):
|
|
continue
|
|
if ";" in item:
|
|
item = ProjectConfigBase.INLINE_COMMENT_RE.sub("", item).strip()
|
|
result.append(item)
|
|
return result
|
|
|
|
@staticmethod
|
|
def get_default_path():
|
|
from platformio import app # pylint: disable=import-outside-toplevel
|
|
|
|
return app.get_session_var("custom_project_conf") or os.path.join(
|
|
os.getcwd(), "platformio.ini"
|
|
)
|
|
|
|
def __init__(self, path=None, parse_extra=True, expand_interpolations=True):
|
|
path = self.get_default_path() if path is None else path
|
|
self.path = path
|
|
self.expand_interpolations = expand_interpolations
|
|
self.warnings = []
|
|
self._parsed = []
|
|
self._parser = (
|
|
ConfigParser.ConfigParser()
|
|
if PY2
|
|
else ConfigParser.ConfigParser(inline_comment_prefixes=("#", ";"))
|
|
)
|
|
if path and os.path.isfile(path):
|
|
self.read(path, parse_extra)
|
|
|
|
self._maintain_renaimed_options()
|
|
|
|
def __getattr__(self, name):
|
|
return getattr(self._parser, name)
|
|
|
|
def read(self, path, parse_extra=True):
|
|
if path in self._parsed:
|
|
return
|
|
self._parsed.append(path)
|
|
try:
|
|
self._parser.read(path)
|
|
except ConfigParser.Error as e:
|
|
raise exception.InvalidProjectConfError(path, str(e))
|
|
|
|
if not parse_extra:
|
|
return
|
|
|
|
# load extra configs
|
|
for pattern in self.get("platformio", "extra_configs", []):
|
|
if pattern.startswith("~"):
|
|
pattern = fs.expanduser(pattern)
|
|
for item in glob.glob(pattern):
|
|
self.read(item)
|
|
|
|
def _maintain_renaimed_options(self):
|
|
# legacy `lib_extra_dirs` in [platformio]
|
|
if self._parser.has_section("platformio") and self._parser.has_option(
|
|
"platformio", "lib_extra_dirs"
|
|
):
|
|
if not self._parser.has_section("env"):
|
|
self._parser.add_section("env")
|
|
self._parser.set(
|
|
"env",
|
|
"lib_extra_dirs",
|
|
self._parser.get("platformio", "lib_extra_dirs"),
|
|
)
|
|
self._parser.remove_option("platformio", "lib_extra_dirs")
|
|
self.warnings.append(
|
|
"`lib_extra_dirs` configuration option is deprecated in "
|
|
"section [platformio]! Please move it to global `env` section"
|
|
)
|
|
|
|
renamed_options = {}
|
|
for option in ProjectOptions.values():
|
|
if option.oldnames:
|
|
renamed_options.update({name: option.name for name in option.oldnames})
|
|
|
|
for section in self._parser.sections():
|
|
scope = section.split(":", 1)[0]
|
|
if scope not in ("platformio", "env"):
|
|
continue
|
|
for option in self._parser.options(section):
|
|
if option in renamed_options:
|
|
self.warnings.append(
|
|
"`%s` configuration option in section [%s] is "
|
|
"deprecated and will be removed in the next release! "
|
|
"Please use `%s` instead"
|
|
% (option, section, renamed_options[option])
|
|
)
|
|
# rename on-the-fly
|
|
self._parser.set(
|
|
section,
|
|
renamed_options[option],
|
|
self._parser.get(section, option),
|
|
)
|
|
self._parser.remove_option(section, option)
|
|
continue
|
|
|
|
# unknown
|
|
unknown_conditions = [
|
|
("%s.%s" % (scope, option)) not in ProjectOptions,
|
|
scope != "env" or not option.startswith(("custom_", "board_")),
|
|
]
|
|
if all(unknown_conditions):
|
|
self.warnings.append(
|
|
"Ignore unknown configuration option `%s` "
|
|
"in section [%s]" % (option, section)
|
|
)
|
|
return True
|
|
|
|
def walk_options(self, root_section):
|
|
extends_queue = (
|
|
["env", root_section] if root_section.startswith("env:") else [root_section]
|
|
)
|
|
extends_done = []
|
|
while extends_queue:
|
|
section = extends_queue.pop()
|
|
extends_done.append(section)
|
|
if not self._parser.has_section(section):
|
|
continue
|
|
for option in self._parser.options(section):
|
|
yield (section, option)
|
|
if self._parser.has_option(section, "extends"):
|
|
extends_queue.extend(
|
|
self.parse_multi_values(self._parser.get(section, "extends"))[::-1]
|
|
)
|
|
|
|
def options(self, section=None, env=None):
|
|
result = []
|
|
assert section or env
|
|
if not section:
|
|
section = "env:" + env
|
|
|
|
if not self.expand_interpolations:
|
|
return self._parser.options(section)
|
|
|
|
for _, option in self.walk_options(section):
|
|
if option not in result:
|
|
result.append(option)
|
|
|
|
# handle system environment variables
|
|
scope = section.split(":", 1)[0]
|
|
for option_meta in ProjectOptions.values():
|
|
if option_meta.scope != scope or option_meta.name in result:
|
|
continue
|
|
if option_meta.sysenvvar and option_meta.sysenvvar in os.environ:
|
|
result.append(option_meta.name)
|
|
|
|
return result
|
|
|
|
def has_option(self, section, option):
|
|
if self._parser.has_option(section, option):
|
|
return True
|
|
return option in self.options(section)
|
|
|
|
def items(self, section=None, env=None, as_dict=False):
|
|
assert section or env
|
|
if not section:
|
|
section = "env:" + env
|
|
if as_dict:
|
|
return {
|
|
option: self.get(section, option) for option in self.options(section)
|
|
}
|
|
return [(option, self.get(section, option)) for option in self.options(section)]
|
|
|
|
def set(self, section, option, value):
|
|
if value is None:
|
|
value = ""
|
|
if isinstance(value, (list, tuple)):
|
|
value = "\n".join(value)
|
|
elif isinstance(value, bool):
|
|
value = "yes" if value else "no"
|
|
elif isinstance(value, (int, float)):
|
|
value = str(value)
|
|
# start multi-line value from a new line
|
|
if "\n" in value and not value.startswith("\n"):
|
|
value = "\n" + value
|
|
self._parser.set(section, option, value)
|
|
|
|
def getraw( # pylint: disable=too-many-branches
|
|
self, section, option, default=MISSING
|
|
):
|
|
if not self.expand_interpolations:
|
|
return self._parser.get(section, option)
|
|
|
|
value = MISSING
|
|
for sec, opt in self.walk_options(section):
|
|
if opt == option:
|
|
value = self._parser.get(sec, option)
|
|
break
|
|
|
|
option_meta = ProjectOptions.get("%s.%s" % (section.split(":", 1)[0], option))
|
|
if not option_meta:
|
|
if value == MISSING:
|
|
value = (
|
|
default if default != MISSING else self._parser.get(section, option)
|
|
)
|
|
return self._expand_interpolations(value)
|
|
|
|
if option_meta.sysenvvar:
|
|
envvar_value = os.getenv(option_meta.sysenvvar)
|
|
if not envvar_value and option_meta.oldnames:
|
|
for oldoption in option_meta.oldnames:
|
|
envvar_value = os.getenv("PLATFORMIO_" + oldoption.upper())
|
|
if envvar_value:
|
|
break
|
|
if envvar_value and option_meta.multiple:
|
|
if value == MISSING:
|
|
value = ""
|
|
value += ("\n" if value else "") + envvar_value
|
|
elif envvar_value and value == MISSING:
|
|
value = envvar_value
|
|
|
|
if value == MISSING:
|
|
value = option_meta.default or default
|
|
if value == MISSING:
|
|
return None
|
|
|
|
return self._expand_interpolations(value)
|
|
|
|
def _expand_interpolations(self, value):
|
|
if (
|
|
not value
|
|
or not isinstance(value, string_types)
|
|
or not all(["${" in value, "}" in value])
|
|
):
|
|
return value
|
|
return self.VARTPL_RE.sub(self._re_interpolation_handler, value)
|
|
|
|
def _re_interpolation_handler(self, match):
|
|
section, option = match.group(1), match.group(2)
|
|
if section == "sysenv":
|
|
return os.getenv(option)
|
|
return self.getraw(section, option)
|
|
|
|
def get(self, section, option, default=MISSING):
|
|
value = None
|
|
try:
|
|
value = self.getraw(section, option, default)
|
|
except ConfigParser.Error as e:
|
|
raise exception.InvalidProjectConfError(self.path, str(e))
|
|
|
|
option_meta = ProjectOptions.get("%s.%s" % (section.split(":", 1)[0], option))
|
|
if not option_meta:
|
|
return value
|
|
|
|
if option_meta.multiple:
|
|
value = self.parse_multi_values(value or [])
|
|
try:
|
|
return self.cast_to(value, option_meta.type)
|
|
except click.BadParameter as e:
|
|
if not self.expand_interpolations:
|
|
return value
|
|
raise exception.ProjectOptionValueError(e.format_message(), option, section)
|
|
|
|
@staticmethod
|
|
def cast_to(value, to_type):
|
|
items = value
|
|
if not isinstance(value, (list, tuple)):
|
|
items = [value]
|
|
items = [
|
|
to_type(item) if isinstance(to_type, click.ParamType) else item
|
|
for item in items
|
|
]
|
|
return items if isinstance(value, (list, tuple)) else items[0]
|
|
|
|
def envs(self):
|
|
return [s[4:] for s in self._parser.sections() if s.startswith("env:")]
|
|
|
|
def default_envs(self):
|
|
return self.get("platformio", "default_envs", [])
|
|
|
|
def validate(self, envs=None, silent=False):
|
|
if not os.path.isfile(self.path):
|
|
raise exception.NotPlatformIOProjectError(self.path)
|
|
# check envs
|
|
known = set(self.envs())
|
|
if not known:
|
|
raise exception.ProjectEnvsNotAvailableError()
|
|
unknown = set(list(envs or []) + self.default_envs()) - known
|
|
if unknown:
|
|
raise exception.UnknownEnvNamesError(", ".join(unknown), ", ".join(known))
|
|
if not silent:
|
|
for warning in self.warnings:
|
|
click.secho("Warning! %s" % warning, fg="yellow")
|
|
return True
|
|
|
|
|
|
class ProjectConfigDirsMixin(object):
|
|
def _get_core_dir(self, exists=False):
|
|
default = ProjectOptions["platformio.core_dir"].default
|
|
core_dir = self.get("platformio", "core_dir")
|
|
win_core_dir = None
|
|
if WINDOWS and core_dir == default:
|
|
win_core_dir = os.path.splitdrive(core_dir)[0] + "\\.platformio"
|
|
if os.path.isdir(win_core_dir):
|
|
core_dir = win_core_dir
|
|
|
|
if exists and not os.path.isdir(core_dir):
|
|
try:
|
|
os.makedirs(core_dir)
|
|
except OSError as e:
|
|
if win_core_dir:
|
|
os.makedirs(win_core_dir)
|
|
core_dir = win_core_dir
|
|
else:
|
|
raise e
|
|
|
|
return core_dir
|
|
|
|
def get_optional_dir(self, name, exists=False):
|
|
if not ProjectOptions.get("platformio.%s_dir" % name):
|
|
raise ValueError("Unknown optional directory -> " + name)
|
|
|
|
if name == "core":
|
|
result = self._get_core_dir(exists)
|
|
else:
|
|
result = self.get("platformio", name + "_dir")
|
|
|
|
if result is None:
|
|
return None
|
|
|
|
project_dir = os.getcwd()
|
|
|
|
# patterns
|
|
if "$PROJECT_HASH" in result:
|
|
result = result.replace(
|
|
"$PROJECT_HASH",
|
|
"%s-%s"
|
|
% (
|
|
os.path.basename(project_dir),
|
|
sha1(hashlib_encode_data(project_dir)).hexdigest()[:10],
|
|
),
|
|
)
|
|
|
|
if "$PROJECT_DIR" in result:
|
|
result = result.replace("$PROJECT_DIR", project_dir)
|
|
if "$PROJECT_CORE_DIR" in result:
|
|
result = result.replace("$PROJECT_CORE_DIR", self.get_optional_dir("core"))
|
|
if "$PROJECT_WORKSPACE_DIR" in result:
|
|
result = result.replace(
|
|
"$PROJECT_WORKSPACE_DIR", self.get_optional_dir("workspace")
|
|
)
|
|
|
|
if result.startswith("~"):
|
|
result = fs.expanduser(result)
|
|
|
|
result = os.path.realpath(result)
|
|
|
|
if exists and not os.path.isdir(result):
|
|
os.makedirs(result)
|
|
|
|
return result
|
|
|
|
|
|
class ProjectConfig(ProjectConfigBase, ProjectConfigDirsMixin):
|
|
|
|
_instances = {}
|
|
|
|
@staticmethod
|
|
def get_instance(path=None):
|
|
path = ProjectConfig.get_default_path() if path is None else path
|
|
mtime = os.path.getmtime(path) if os.path.isfile(path) else 0
|
|
instance = ProjectConfig._instances.get(path)
|
|
if instance and instance["mtime"] != mtime:
|
|
instance = None
|
|
if not instance:
|
|
instance = {"mtime": mtime, "config": ProjectConfig(path)}
|
|
ProjectConfig._instances[path] = instance
|
|
return instance["config"]
|
|
|
|
def __repr__(self):
|
|
return "<ProjectConfig %s>" % (self.path or "in-memory")
|
|
|
|
def as_tuple(self):
|
|
return [(s, self.items(s)) for s in self.sections()]
|
|
|
|
def to_json(self):
|
|
return json.dumps(self.as_tuple())
|
|
|
|
def update(self, data, clear=False):
|
|
assert isinstance(data, list)
|
|
if clear:
|
|
self._parser = ConfigParser.ConfigParser()
|
|
for section, options in data:
|
|
if not self._parser.has_section(section):
|
|
self._parser.add_section(section)
|
|
for option, value in options:
|
|
self.set(section, option, value)
|
|
|
|
def save(self, path=None):
|
|
path = path or self.path
|
|
if path in self._instances:
|
|
del self._instances[path]
|
|
with open(path or self.path, "w+") as fp:
|
|
fp.write(CONFIG_HEADER.strip() + "\n\n")
|
|
self._parser.write(fp)
|
|
fp.seek(0)
|
|
contents = fp.read()
|
|
fp.seek(0)
|
|
fp.truncate()
|
|
fp.write(contents.strip() + "\n")
|
|
return True
|
|
|