2013-10-11 17:28:32 +00:00
|
|
|
from distutils.util import convert_path
|
|
|
|
from distutils import log
|
|
|
|
from distutils.errors import DistutilsOptionError
|
2014-08-12 08:44:01 +00:00
|
|
|
import distutils
|
|
|
|
import os
|
|
|
|
|
2016-02-23 06:06:55 +00:00
|
|
|
from setuptools.extern.six.moves import configparser
|
|
|
|
|
2014-08-12 08:44:01 +00:00
|
|
|
from setuptools import Command
|
|
|
|
|
2013-10-11 17:28:32 +00:00
|
|
|
|
|
|
|
__all__ = ['config_file', 'edit_config', 'option_base', 'setopt']
|
|
|
|
|
|
|
|
|
|
|
|
def config_file(kind="local"):
|
|
|
|
"""Get the filename of the distutils, local, global, or per-user config
|
|
|
|
|
|
|
|
`kind` must be one of "local", "global", or "user"
|
|
|
|
"""
|
2014-08-12 08:44:01 +00:00
|
|
|
if kind == 'local':
|
2013-10-11 17:28:32 +00:00
|
|
|
return 'setup.cfg'
|
2014-08-12 08:44:01 +00:00
|
|
|
if kind == 'global':
|
2013-10-11 17:28:32 +00:00
|
|
|
return os.path.join(
|
2014-08-12 08:44:01 +00:00
|
|
|
os.path.dirname(distutils.__file__), 'distutils.cfg'
|
2013-10-11 17:28:32 +00:00
|
|
|
)
|
2014-08-12 08:44:01 +00:00
|
|
|
if kind == 'user':
|
|
|
|
dot = os.name == 'posix' and '.' or ''
|
2013-10-11 17:28:32 +00:00
|
|
|
return os.path.expanduser(convert_path("~/%spydistutils.cfg" % dot))
|
|
|
|
raise ValueError(
|
|
|
|
"config_file() type must be 'local', 'global', or 'user'", kind
|
|
|
|
)
|
|
|
|
|
2014-08-12 08:44:01 +00:00
|
|
|
|
2013-10-11 17:28:32 +00:00
|
|
|
def edit_config(filename, settings, dry_run=False):
|
|
|
|
"""Edit a configuration file to include `settings`
|
|
|
|
|
|
|
|
`settings` is a dictionary of dictionaries or ``None`` values, keyed by
|
|
|
|
command/section name. A ``None`` value means to delete the entire section,
|
|
|
|
while a dictionary lists settings to be changed or deleted in that section.
|
|
|
|
A setting of ``None`` means to delete that setting.
|
|
|
|
"""
|
|
|
|
log.debug("Reading configuration from %s", filename)
|
2016-01-09 07:16:19 +00:00
|
|
|
opts = configparser.RawConfigParser()
|
2013-10-11 17:28:32 +00:00
|
|
|
opts.read([filename])
|
|
|
|
for section, options in settings.items():
|
|
|
|
if options is None:
|
|
|
|
log.info("Deleting section [%s] from %s", section, filename)
|
|
|
|
opts.remove_section(section)
|
|
|
|
else:
|
|
|
|
if not opts.has_section(section):
|
|
|
|
log.debug("Adding new section [%s] to %s", section, filename)
|
|
|
|
opts.add_section(section)
|
2014-08-12 08:44:01 +00:00
|
|
|
for option, value in options.items():
|
2013-10-11 17:28:32 +00:00
|
|
|
if value is None:
|
|
|
|
log.debug(
|
|
|
|
"Deleting %s.%s from %s",
|
|
|
|
section, option, filename
|
|
|
|
)
|
2014-08-12 08:44:01 +00:00
|
|
|
opts.remove_option(section, option)
|
2013-10-11 17:28:32 +00:00
|
|
|
if not opts.options(section):
|
|
|
|
log.info("Deleting empty [%s] section from %s",
|
2014-08-12 08:44:01 +00:00
|
|
|
section, filename)
|
2013-10-11 17:28:32 +00:00
|
|
|
opts.remove_section(section)
|
|
|
|
else:
|
|
|
|
log.debug(
|
|
|
|
"Setting %s.%s to %r in %s",
|
|
|
|
section, option, value, filename
|
|
|
|
)
|
2014-08-12 08:44:01 +00:00
|
|
|
opts.set(section, option, value)
|
2013-10-11 17:28:32 +00:00
|
|
|
|
|
|
|
log.info("Writing %s", filename)
|
|
|
|
if not dry_run:
|
|
|
|
with open(filename, 'w') as f:
|
|
|
|
opts.write(f)
|
|
|
|
|
2014-08-12 08:44:01 +00:00
|
|
|
|
2013-10-11 17:28:32 +00:00
|
|
|
class option_base(Command):
|
|
|
|
"""Abstract base class for commands that mess with config files"""
|
|
|
|
|
|
|
|
user_options = [
|
|
|
|
('global-config', 'g',
|
2014-08-12 08:44:01 +00:00
|
|
|
"save options to the site-wide distutils.cfg file"),
|
2013-10-11 17:28:32 +00:00
|
|
|
('user-config', 'u',
|
2014-08-12 08:44:01 +00:00
|
|
|
"save options to the current user's pydistutils.cfg file"),
|
2013-10-11 17:28:32 +00:00
|
|
|
('filename=', 'f',
|
2014-08-12 08:44:01 +00:00
|
|
|
"configuration file to use (default=setup.cfg)"),
|
2013-10-11 17:28:32 +00:00
|
|
|
]
|
|
|
|
|
|
|
|
boolean_options = [
|
|
|
|
'global-config', 'user-config',
|
|
|
|
]
|
|
|
|
|
|
|
|
def initialize_options(self):
|
|
|
|
self.global_config = None
|
|
|
|
self.user_config = None
|
|
|
|
self.filename = None
|
|
|
|
|
|
|
|
def finalize_options(self):
|
|
|
|
filenames = []
|
|
|
|
if self.global_config:
|
|
|
|
filenames.append(config_file('global'))
|
|
|
|
if self.user_config:
|
|
|
|
filenames.append(config_file('user'))
|
|
|
|
if self.filename is not None:
|
|
|
|
filenames.append(self.filename)
|
|
|
|
if not filenames:
|
|
|
|
filenames.append(config_file('local'))
|
2014-08-12 08:44:01 +00:00
|
|
|
if len(filenames) > 1:
|
2013-10-11 17:28:32 +00:00
|
|
|
raise DistutilsOptionError(
|
|
|
|
"Must specify only one configuration file option",
|
|
|
|
filenames
|
|
|
|
)
|
|
|
|
self.filename, = filenames
|
|
|
|
|
|
|
|
|
|
|
|
class setopt(option_base):
|
|
|
|
"""Save command-line options to a file"""
|
|
|
|
|
|
|
|
description = "set an option in setup.cfg or another config file"
|
|
|
|
|
|
|
|
user_options = [
|
|
|
|
('command=', 'c', 'command to set an option for'),
|
2014-08-12 08:44:01 +00:00
|
|
|
('option=', 'o', 'option to set'),
|
|
|
|
('set-value=', 's', 'value of the option'),
|
|
|
|
('remove', 'r', 'remove (unset) the value'),
|
2013-10-11 17:28:32 +00:00
|
|
|
] + option_base.user_options
|
|
|
|
|
|
|
|
boolean_options = option_base.boolean_options + ['remove']
|
|
|
|
|
|
|
|
def initialize_options(self):
|
|
|
|
option_base.initialize_options(self)
|
|
|
|
self.command = None
|
|
|
|
self.option = None
|
|
|
|
self.set_value = None
|
|
|
|
self.remove = None
|
|
|
|
|
|
|
|
def finalize_options(self):
|
|
|
|
option_base.finalize_options(self)
|
|
|
|
if self.command is None or self.option is None:
|
|
|
|
raise DistutilsOptionError("Must specify --command *and* --option")
|
|
|
|
if self.set_value is None and not self.remove:
|
|
|
|
raise DistutilsOptionError("Must specify --set-value or --remove")
|
|
|
|
|
|
|
|
def run(self):
|
|
|
|
edit_config(
|
|
|
|
self.filename, {
|
2014-08-12 08:44:01 +00:00
|
|
|
self.command: {self.option.replace('-', '_'): self.set_value}
|
2013-10-11 17:28:32 +00:00
|
|
|
},
|
|
|
|
self.dry_run
|
|
|
|
)
|