diff options
37 files changed, 3208 insertions, 0 deletions
diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..926df93 --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +*.pyc +/demo-build/ diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml new file mode 100644 index 0000000..2d637c6 --- /dev/null +++ b/.gitlab-ci.yml @@ -0,0 +1,37 @@ +# Copied in from Moubootaur Legends's Hercules .gitlab-ci.yml +stages: + - test + +variables: &base_vars + DEBIAN_COMMON_PACKAGES: make python3 + +.prerequisites: &prerequisites + before_script: + - echo "Building demo project $CI_BUILD_NAME" + - uname -a + - apt-get update + - apt-get install -y -qq $INSTALL_PACKAGES $DEBIAN_COMMON_PACKAGES + +# Compilers + variables: + <<: *base_vars + +re:debian-stable: + <<: *prerequisites + stage: test + image: debian:stable + variables: + <<: *base_vars + INSTALL_PACKAGES: gcc + script: + - ./test-everything.sh + +re:debian-testing: + <<: *prerequisites + stage: test + image: debian:testing + variables: + <<: *base_vars + INSTALL_PACKAGES: gcc + script: + - ./test-everything.sh diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 0000000..faabbc1 --- /dev/null +++ b/.travis.yml @@ -0,0 +1,17 @@ +sudo: false +language: python +python: + - "3.11" + - "pypy" +install: ":" +script: ./test-everything.sh + +notifications: + email: + on_success: changed + on_failure: always + irc: + channels: "libera.chat#themanaworld-irc" + on_success: always + on_failure: always + use_notice: true @@ -0,0 +1,11 @@ +Attoconf itself is released under the GNU General Public License (GPL). + +As a derivative work, this also applies to the 'configure' script shipped +with programs that use the attoconf library. This is a deliberate decision: +while 'configure' is program-specific options, many programs will want +similar options. + +However, the actual programs build using attoconf are not derivative works +and thus may be released under any license. + +The GPL is available in the file gpl-3.0.txt @@ -0,0 +1,8 @@ +Attoconf is a small and sensible replacement for GNU autoconf. + +Principles: +* Assume most build environments are sane, and ignore the rest. +* In the face of ambiguity, refuse the temptation to guess. +* Never automatically toggle features based on the build environment. +* Written in python3 for easy editing and wide portability. +* GPL, but this does not apply to the program being built. diff --git a/attoconf/__init__.py b/attoconf/__init__.py new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/attoconf/__init__.py diff --git a/attoconf/_version.py b/attoconf/_version.py new file mode 100644 index 0000000..d4930e4 --- /dev/null +++ b/attoconf/_version.py @@ -0,0 +1,18 @@ +# Implementation of Semantic Versioning +# This file should change in every single commit. + +# Incremented for releases with incompatible API changes. +# 0 is special, for initial releases with no real guarantees. +major = 0 + +# Incremented for releases with compatible API additions. +# This is the number that is usually incremented. +minor = 10 + +# Incremented if there is a bugfix release. +# Might not be contiguous. +patch = 0 + +# Reserved for distributors and forks. +# Contains arbitrary text, but no parentheses or newlines. +distributor = 'Vanilla' diff --git a/attoconf/classy.py b/attoconf/classy.py new file mode 100644 index 0000000..33c9c40 --- /dev/null +++ b/attoconf/classy.py @@ -0,0 +1,157 @@ +# Copyright 2013-2015 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +from .core import Project, Build + +class PolymorphicSlotMergerMetaclass(type): + + def __new__(meta, name, bases, dct): + if '__slots__' not in dct: + s = () + for b in bases: + s2 = b.__dict__.get('_merge_slots_', ()) + if isinstance(s2, str): + s2 = (s2,) + s += s2 + s += dct.get('_merge_slots_', ()) + dct['__slots__'] = s + else: + assert dct['__slots__'] == () + return type.__new__(meta, name, bases, dct) + + # TODO: remove *args for 1.0 + def __call__(cls, *args, **kwargs): + instance = type.__call__(cls, *args, **kwargs) + if 'package' in kwargs or not isinstance(instance, + __import__('attoconf.lib.install', fromlist=['Install']).Install): + instance._do_jiggle() + return instance + + +# TODO: remove this for 1.0 +def add_slots(cls): + return cls + +class ClassyProject(Project, metaclass=PolymorphicSlotMergerMetaclass): + ''' A more convenient, objectish, way of setting up a project. + ''' + __slots__ = () + _merge_slots_ = () + + def __init__(self, srcdir): + super(ClassyProject, self).__init__(srcdir) + + # TODO: remove this for 1.0 + def jiggle(self): + pass + + def _do_jiggle(self): + self.order.append(None) + self.general() + self.order.append(None) + self.paths() + self.order.append(None) + self.arches() + self.order.append(None) + self.vars() + self.order.append(None) + self.features() + self.order.append(None) + self.packages() + self.order.append(None) + + if 0: + self.tests() + self.order.append(None) + self.post() + self.order.append(None) + + def general(self): + ''' Registration hook for general options (usually unneeded). + ''' + self.add_help('General:', hidden=False) + self.add_alias('--help', ['--help=default'], + help='display standard help, then exit', hidden=False) + self.add_option('--help', init='none', + type=self.do_help, check=None, + help='just display some kind of help instead of configuring', hidden=False, + help_var='KIND') + self.help.add_option('--help=hidden', + help='display help you should never ever ever care about', + hidden=False) + + def paths(self): + ''' Registration hook for path-related options. + (--prefix, --bindir, etc) + + Probably only used by attoconf.lib.install. + ''' + + def arches(self): + ''' Registration hook for arch-related options. + (--build, --host, and sometimes --target) + + Typically this changes the prefix of the compiler. + ''' + + def vars(self): + ''' Environment variables (usually capital, don't start with a --). + + Usually there is one or two of these for every program needed. + ''' + self.add_help('Environment Variables:', hidden=False) + + def features(self): + ''' Customizations for this package (--enable-*). + ''' + self.add_help('Optional Features:', hidden=False) + # TODO add '--disable-option-checking' + self.help.add_option('--disable-FEATURE', + help='do not include FEATURE (same as --enable-FEATURE=no)', + hidden=False) + self.help.add_option('--enable-FEATURE', + help='include FEATURE (same as --enable-FEATURE=yes)', + hidden=False) + + def packages(self): + ''' Settings related to dependencies (--with-*). + ''' + self.add_help('Optional Packages:', hidden=False) + self.help.add_option('--with-PACKAGE', + help='use PACKAGE (same as --with-PACKAGE=yes)', + hidden=False) + self.help.add_option('--without-PACKAGE', + help='do not use PACKAGE (same as --with-PACKAGE=no)', + hidden=False) + + if 0: # not sure if really needed + def tests(self): + ''' Late tests, but still before post. + + ''' + + def post(self): + ''' Special hook for things that need to be done at the very end. + + attoconf.post.make + ''' + + # okay, no more registration hooks + def build(self, bindir): + return Build(self, bindir) diff --git a/attoconf/core.py b/attoconf/core.py new file mode 100644 index 0000000..efc952b --- /dev/null +++ b/attoconf/core.py @@ -0,0 +1,239 @@ +# Copyright 2013-2014 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +from collections import namedtuple, OrderedDict +import os +import sys + +from .help import Help + +# Nothing to see here. Move along. +Option = namedtuple('Option', ['type', 'init']) +class ArgumentError(Exception): pass + +def as_var(name): + return name.lstrip('-').replace('-', '_').upper() + +def trim_trailing_slashes(path): + p, s = os.path.split(path) + if not s: + return p + return path + +class Project(object): + ''' A Project is a directory and the list of options that can be set. + ''' + __slots__ = ( + 'srcdir', + 'aliases', + 'options', + 'help', + 'order', + 'checks', + ) + def __init__(self, srcdir): + ''' A Project is initially constructed from just the source directory + ''' + self.srcdir = trim_trailing_slashes(srcdir) + self.aliases = {} + self.options = {} + self.help = Help() + self.order = [] + self.checks = [] + + def add_help(self, text, hidden): + ''' Directly add a line of text to the help. + ''' + self.help.add_text(text, hidden) + + def add_alias(self, key, expansion, help, hidden): + ''' Add an alias. + + This is necessary for anything to appear without an =. + + The expansion is a list of other options, which may be aliases. + ''' + if key in self.aliases: + raise KeyError(key) + expansion = list(expansion) + self.aliases[key] = expansion + if help is None: + help = 'alias for ' + ' '.join(expansion) + self.help.add_option(key, help, hidden) + + def add_option(self, name, init, type, check, + help, hidden, + help_var=None, help_def=None): + ''' Add an actual option. + + This must be passed with a =. + + In the builder, the var will first be set to init. + + If the argument is passed, the type hook is called immediately + to validate the argument. + + The check hooks will be called at final time, + in the order they were added. + + Additionally, a line of help is added, with additional formatting. + ''' + if name in self.options: + raise KeyError(name) + var = as_var(name) + if check is not None: + assert type.__module__ == 'attoconf.types' + else: + # used by some tests ... should this be fixed there instead? + if help_var is None: + help_var = var + assert init is not None + init = type(init) + assert init is not None + self.options[name] = Option(init=init, type=type) + if check is not None: + self.order.append(var) + self.checks.append( + lambda bld: check(bld, **{help_var: bld.vars[var]})) + + if help_var is None: + help_var = var + + if help_def is None: + help_def = init + assert help_def is not None + help = '%s [%s]' % (help, help_def) + + if help_var != name: + help_opt = '%s=%s' % (name, help_var) + else: + help_opt = name + self.help.add_option(help_opt, help, hidden) + + def do_help(self, opt): + ''' Pseudo type-hook to be registered for --help (calls sys.exit). + ''' + if opt == 'none': + return opt + if opt == 'default': + hidden = False + elif opt == 'hidden': + hidden = True + else: + raise ValueError('Unknown value for opt: %r' % opt) + self.help.print(sys.stdout, hidden) + sys.exit() +# sneaky +Project.do_help.__module__ = 'attoconf.types' +#Project.do_help.__func__.__module__ = 'attoconf.types' + +class Build(object): + ''' A Build is a directory and set of options applied to a Project. + ''' + __slots__ = ( + 'builddir', + 'project', + 'vars', + '_seen_args', + ) + def __init__(self, project, builddir): + ''' A Build is initially constructed from a project and a build dir. + ''' + self.project = project + self.builddir = trim_trailing_slashes(builddir) + self.vars = {as_var(k): o.init + for (k, o) in project.options.items()} + self._seen_args = OrderedDict() + + def apply_arg(self, arg): + ''' Parse a single argument, expanding aliases. + ''' + alias = self.project.aliases.get(arg) + if alias is not None: + for e in alias: + # TODO: catch recursive aliases + # or should they be caught earlier? + self.apply_arg(e) + return + + if '=' not in arg: + if arg in self.project.options: + raise ArgumentError('Option %s requires an argument' % arg) + elif arg.startswith('-'): + raise ArgumentError('Unknown option %s' % arg) + else: + raise ArgumentError('Unknown environment variable %s' % arg) + + k, a = arg.split('=', 1) + if k in self._seen_args: + del self._seen_args[k] + self._seen_args[k] = a + opt = self.project.options.get(k) + if opt is None: + raise sys.exit('Unknown option %s' % k) + self.vars[as_var(k)] = opt.type(a) + + def finish(self): + ''' With the current set of variables, run all the checks + and presumably produce some sort of output. + ''' + for check in self.project.checks: + check(self) + status_file = os.path.join(self.builddir, 'config.status') + # open fd to control +x mode + status_fd = os.open(status_file, os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o777) + with os.fdopen(status_fd, 'w') as status: + print('Generating config.status') + status.write('#!%s\n' % sys.executable) + status.write('import os\n') + status.write('import sys\n') + status.write('old_build_dir = os.path.dirname(sys.argv[0])\n') + status.write('configure = os.path.join(old_build_dir, %r, "configure")\n' + % self.relative_source()) + seen_args = ['='.join(kv) for kv in self._seen_args.items()] + status.write('os.execvp(configure, [configure] + %r + sys.argv[1:])\n' + % seen_args) + + def configure(self, args, env): + ''' First apply variables from the environment, + then call apply_arg() a bunch of times, then finish(). + ''' + for k in self.project.options: + if k != as_var(k): + continue + val = env.get(k) + if val is not None: + self._seen_args[k] = val + opt = self.project.options[k] + self.vars[as_var(k)] = opt.type(val) + + for arg in args: + self.apply_arg(arg) + + self.finish() + + def relative_source(self): + ''' Return a relative path from the build tree to the source tree. + ''' + srcdir = self.project.srcdir + builddir = self.builddir + if os.path.isabs(srcdir) or os.path.isabs(builddir): + return os.path.realpath(srcdir) + return os.path.relpath(os.path.realpath(srcdir), + os.path.realpath(builddir)) diff --git a/attoconf/help.py b/attoconf/help.py new file mode 100644 index 0000000..a2379a6 --- /dev/null +++ b/attoconf/help.py @@ -0,0 +1,164 @@ +# Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +def put_line_in_width(file, line, width, indent): + ''' Print a line with wrapping. + ''' + line = line.rstrip(' ') + if len(line) <= width or ' ' not in line.lstrip(' '): + # this is not just an optimization + file.writelines([line, '\n']) + return + line += ' ' + indents = indent * ' ' + + initial_spaces = len(line) - len(line.lstrip(' ')) + while line.lstrip(): + space = line.rfind(' ', initial_spaces, width + 1) + if space == -1: + space = line.find(' ', initial_spaces) + if space == -1: + space = len(line) + file.writelines([line[:space], '\n']) + line = indents + line[space+1:].lstrip(' ') + initial_spaces = indent + + +class HelpSection(object): + ''' A help section contains some header lines and some related options. + ''' + __slots__ = ( + 'headers', + 'options', + ) + def __init__(self): + ''' Create an empty help section. + ''' + self.headers = [] + self.options = [] + + def add_text(self, text, hidden): + ''' Add a header line. + ''' + self.headers.append((hidden, text)) + + def add_option(self, name, text, hidden): + ''' Add an option with its description. + ''' + self.options.append((hidden, name, text)) + + def print(self, file, hidden, width): + ''' Format (some of) the help text prettily. + ''' + if self.options: + for oh, name, ht in self.options: + if oh <= hidden: + break + else: + return False + + # options longer than this will be split into multiple lines + split_width = width / 4 - 2 + # longest option + longest_opt = 0 + for oh, name, ht in self.options: + if oh > hidden: + continue + l = len(name) + 2 + if l > split_width: + continue + if l > longest_opt: + longest_opt = l + if longest_opt == 0: + longest_opt = int(split_width) + + for oh, ht in self.headers: + if oh > hidden: + continue + put_line_in_width(file, ht, width, 0) + + for oh, name, ht in self.options: + if oh > hidden: + continue + # no, it's not really that simple + if len(name) > longest_opt: + file.writelines([' ', name, '\n']) + name = '' + line = ' %-*s%s' % (longest_opt, name, ht) + put_line_in_width(file, line, width, longest_opt + 2) + + return True + + +def detect_terminal_width(fd, DEFAULT_WIDTH=float('inf')): + ''' Detect the width of a terminal. + ''' + import os + import shutil + + if isinstance(fd, int): + try: + return os.get_terminal_size(fd) + except OSError(...): + return DEFAULT_WIDTH + else: + return shutil.get_terminal_size(fallback=(DEFAULT_WIDTH, 24)).columns + + +class Help(object): + ''' Help collects the set of flavor text and option descriptions + related to arguments. + ''' + __slots__ = ( + 'sections', + ) + def __init__(self): + ''' Help does not take any arguments during construction. + ''' + self.sections = [] + + def add_text(self, help, hidden): + ''' Add a header line. + + This creates a new section if the last line wasn't a header. + ''' + if not self.sections or self.sections[-1].options: + self.sections.append(HelpSection()) + self.sections[-1].add_text(help, hidden) + + def add_option(self, name, help, hidden): + ''' Add an option with its description to the current section. + + This creates a new section only if it is first. + ''' + if not self.sections: + self.sections.append(HelpSection()) + self.sections[-1].add_option(name, help, hidden) + + def print(self, file, hidden, width=0): + ''' Print all the help at the given level of hidden-ness. + ''' + if width == 0: + width = detect_terminal_width(file) + if width < 20: + width = 80 + + for s in self.sections: + if s.print(file, hidden, width): + file.write('\n') diff --git a/attoconf/lib/__init__.py b/attoconf/lib/__init__.py new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/attoconf/lib/__init__.py diff --git a/attoconf/lib/arches.py b/attoconf/lib/arches.py new file mode 100644 index 0000000..67a84bd --- /dev/null +++ b/attoconf/lib/arches.py @@ -0,0 +1,60 @@ +# Copyright 2013-2014 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +from ..classy import ClassyProject +from ..types import triple, maybe + + +def build(build, BUILD): + pass + +def host(build, HOST): + if not HOST: + BUILD = build.vars['BUILD'] + build.vars['HOST'] = BUILD + +def target(build, TARGET): + if not TARGET: + HOST = build.vars['HOST'] + build.vars['TARGET'] = HOST + +class Arches2(ClassyProject): + __slots__ = () + + def arches(self): + super(Arches2, self).arches() + self.add_help('System types:', hidden=False) + self.add_option('--build', init='', + type=maybe(triple), check=build, + help='configure for building on BUILD', hidden=False, + help_def='native') + self.add_option('--host', init='', + type=maybe(triple), check=host, + help='cross-compile to build programs to run on HOST', + hidden=False, help_def='BUILD') + +# TODO figure out the mro implications when I use this +class Arches3(Arches2): + __slots__ = () + def arches(self): + super(Arches3, self).arches() + self.add_option('--target', init='', + type=maybe(triple), check=target, + help='configure for building compilers for TARGET', + hidden=False, help_def='HOST') diff --git a/attoconf/lib/c.py b/attoconf/lib/c.py new file mode 100644 index 0000000..98d88df --- /dev/null +++ b/attoconf/lib/c.py @@ -0,0 +1,281 @@ +# Copyright 2013-2014 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import errno +import os +import subprocess + +from .arches import Arches2 +from ..types import ShellList + +class TestError(Exception): + pass + +def do_exec(build, args): + p = subprocess.Popen(args.list, cwd=build.builddir, + stdin=subprocess.PIPE, stdout=subprocess.PIPE, + stderr=subprocess.STDOUT) + out, _ = p.communicate() + retcode = p.wait() + return retcode, out + + +class TempFile: + ''' context manager that optionally creates and then removes a file + ''' + __slots__ = ('filename') + + def __init__(self, filename, content): + self.filename = filename + if content is not None: + with open(filename, 'x') as of: + of.write(content) + else: + # TODO: raise OSError(errno.EEXIST) if file already exists + pass + + def __enter__(self): + pass + + def __exit__(self, type, value, traceback): + try: + os.remove(self.filename) + except OSError as e: + if e.errno != errno.ENOENT: + raise + + +def try_compile_c(build, body, CFLAGS=[], CPPFLAGS=[]): + CC = build.vars['CC'] + CFLAGS = build.vars['CFLAGS'] + CFLAGS + CPPFLAGS = build.vars['CPPFLAGS'] + CPPFLAGS + in_ = 'atto-test.c' + ins = [in_] + out = 'atto-test.o' + + args = CC + CFLAGS + CPPFLAGS + ['-c', '-o', out, in_] + with TempFile(in_, body), TempFile(out, None): + status, error = do_exec(build, args) + if status: + raise TestError(error) + +def try_compile_link_c(build, body, CFLAGS=[], CPPFLAGS=[], LDFLAGS=[], LIBS=[]): + CC = build.vars['CC'] + CFLAGS = build.vars['CFLAGS'] + CFLAGS + CPPFLAGS = build.vars['CPPFLAGS'] + CPPFLAGS + LDFLAGS = build.vars['LDFLAGS'] + LDFLAGS + LIBS = build.vars['LIBS'] + LIBS + in_ = 'atto-test.c' + ins = [in_] + out = 'atto-test' + + args = CC + CFLAGS + CPPFLAGS + LDFLAGS + ins + LIBS + ['-o', out] + with TempFile(in_, body), TempFile(out, None): + status, error = do_exec(build, args) + if status: + raise TestError(error) + +def try_compile_cxx(build, body, CXXFLAGS=[], CPPFLAGS=[]): + CXX = build.vars['CXX'] + CXXFLAGS = build.vars['CXXFLAGS'] + CXXFLAGS + CPPFLAGS = build.vars['CPPFLAGS'] + CPPFLAGS + in_ = 'atto-test.cxx' + out = 'atto-test.o' + + args = CXX + CXXFLAGS + CPPFLAGS + ['-c', '-o', out, in_] + with TempFile(in_, body), TempFile(out, None): + status, error = do_exec(build, args) + if status: + raise TestError(error) + +def try_compile_link_cxx(build, body, CXXFLAGS=[], CPPFLAGS=[], LDFLAGS=[], LIBS=[]): + CXX = build.vars['CXX'] + CXXFLAGS = build.vars['CXXFLAGS'] + CXXFLAGS + CPPFLAGS = build.vars['CPPFLAGS'] + CPPFLAGS + LDFLAGS = build.vars['LDFLAGS'] + LDFLAGS + LIBS = build.vars['LIBS'] + LIBS + in_ = 'atto-test.cxx' + ins = [in_] + out = 'atto-test' + + args = CXX + CXXFLAGS + CPPFLAGS + LDFLAGS + ins + LIBS + ['-o', out] + with TempFile(in_, body), TempFile(out, None): + status, error = do_exec(build, args) + if status: + raise TestError(error) + +if 0: + def try_linkonly_c(build, ins, LDFLAGS=[], LIBS=[]): + CC = build.vars['CC'] + LDFLAGS = build.vars['LDFLAGS'] + LDFLAGS + LIBS = build.vars['LIBS'] + LIBS + out = 'atto-test' + + args = CC + LDFLAGS + ins + LIBS + ['-o', out] + with TempFile(out, None): + status, error = do_exec(build, args) + if status: + raise TestError(error) + +def try_compile_link2_c(build, body, CFLAGS=[], CPPFLAGS=[], LDFLAGS=[], LIBS=[]): + CC = build.vars['CC'] + CFLAGS = build.vars['CFLAGS'] + CFLAGS + CPPFLAGS = build.vars['CPPFLAGS'] + CPPFLAGS + LDFLAGS = build.vars['LDFLAGS'] + LDFLAGS + LIBS = build.vars['LIBS'] + LIBS + in_ = 'atto-test.c' + ins = [in_] + mid = 'atto-test.o' + mids = [mid] + out = 'atto-test' + + args1 = CC + CFLAGS + CPPFLAGS + ['-c', '-o', mid, in_] + args2 = CC + LDFLAGS + mids + LIBS + ['-o', out] + with TempFile(mid, None): + with TempFile(in_, body): + status, error = do_exec(build, args1) + if status: + raise TestError(error) + + with TempFile(out, None): + status, error = do_exec(build, args2) + if status: + raise TestError(error) + +if 0: + def try_linkonly_cxx(build, ins, LDFLAGS=[], LIBS=[]): + CXX = build.vars['CXX'] + LDFLAGS = build.vars['LDFLAGS'] + LDFLAGS + LIBS = build.vars['LIBS'] + LIBS + out = 'atto-test' + + args = CXX + LDFLAGS + ins + LIBS + ['-o', out] + with TempFile(out, None): + status, error = do_exec(build, args) + if status: + raise TestError(error) + +def try_compile_link2_cxx(build, body, CXXFLAGS=[], CPPFLAGS=[], LDFLAGS=[], LIBS=[]): + CXX = build.vars['CXX'] + CXXFLAGS = build.vars['CXXFLAGS'] + CXXFLAGS + CPPFLAGS = build.vars['CPPFLAGS'] + CPPFLAGS + LDFLAGS = build.vars['LDFLAGS'] + LDFLAGS + LIBS = build.vars['LIBS'] + LIBS + in_ = 'atto-test.cxx' + ins = [in_] + mid = 'atto-test.o' + mids = [mid] + out = 'atto-test' + + args1 = CXX + CXXFLAGS + CPPFLAGS + ['-c', '-o', mid, in_] + args2 = CXX + LDFLAGS + mids + LIBS + ['-o', out] + with TempFile(mid, None): + with TempFile(in_, body): + status, error = do_exec(build, args1) + if status: + raise TestError(error) + + with TempFile(out, None): + status, error = do_exec(build, args2) + if status: + raise TestError(error) + + +def ldflags(build, LDFLAGS): + pass + +def libs(build, LIBS): + # compatibility + build.vars['LDLIBS'] = LIBS + +def cppflags(build, CPPFLAGS): + pass + +def cc(build, CC): + if CC.list == []: + HOST = build.vars['HOST'] + if HOST: + build.vars['CC'].list = [HOST + '-gcc'] + else: + build.vars['CC'].list = ['gcc'] + +def cflags(build, CFLAGS): + try_compile_c(build, 'int main() {}\n') + try_compile_link_c(build, 'int main() {}\n') + try_compile_link2_c(build, 'int main() {}\n') + +def cxx(build, CXX): + if CXX.list == []: + HOST = build.vars['HOST'] + if HOST: + build.vars['CXX'].list = [HOST + '-g++'] + else: + build.vars['CXX'].list = ['g++'] + +def cxxflags(build, CXXFLAGS): + try_compile_cxx(build, 'int main() {}\n') + try_compile_link_cxx(build, 'int main() {}\n') + try_compile_link2_cxx(build, 'int main() {}\n') + +class Link(Arches2): + __slots__ = () + def vars(self): + super(Link, self).vars() + self.add_option('LDFLAGS', init=[], + type=ShellList, check=ldflags, + help='linker flags, e.g. -L<lib dir> if you have libraries in a nonstandard directory <lib dir>', + hidden=False) + self.add_option('LIBS', init=[], + type=ShellList, check=libs, + help='libraries to pass to the linker, e.g. -l<library>', + hidden=False) + self.order.append('LDLIBS') #TODO remove for 1.0 + +class Preprocess(Arches2): + __slots__ = () + def vars(self): + super(Preprocess, self).vars() + self.add_option('CPPFLAGS', init=[], + type=ShellList, check=cppflags, + help='C/C++/Objective C preprocessor flags, e.g. -I<include dir> if you have headers in a nonstandard directory <include dir>', + hidden=False) + +class C(Link, Preprocess): + __slots__ = () + def vars(self): + super(C, self).vars() + self.add_option('CC', init=[], + type=ShellList, check=cc, + help='C compiler command', hidden=False, + help_def='HOST-gcc') + self.add_option('CFLAGS', init=['-O2', '-g'], + type=ShellList, check=cflags, + help='C compiler flags', hidden=False) + +class Cxx(Link, Preprocess): + __slots__ = () + def vars(self): + super(Cxx, self).vars() + self.add_option('CXX', init=[], + type=ShellList, check=cxx, + help='C++ compiler command', hidden=False, + help_def='HOST-g++') + self.add_option('CXXFLAGS', init=['-O2', '-g'], + type=ShellList, check=cxxflags, + help='C++ compiler flags', hidden=False) diff --git a/attoconf/lib/config_hash.py b/attoconf/lib/config_hash.py new file mode 100644 index 0000000..b3cb423 --- /dev/null +++ b/attoconf/lib/config_hash.py @@ -0,0 +1,48 @@ +# Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +from hashlib import md5 +import os + +from ..classy import ClassyProject + + +def calc_hash(build): + hash = md5() + for var, val in sorted(build.vars.items()): + hash.update(('%s = %s\n' % (var, val)).encode(encoding = 'UTF-8', errors = 'strict')) + return hash.hexdigest() + + +def add_config_hash(build): + print('Generating a hash of config options ...') + build.vars['CONFIG_HASH'] = calc_hash(build) + + +class ConfigHash(ClassyProject): + ''' Post hook add the build hash. + + This should be run before any other post hooks. + ''' + __slots__ = () + + def post(self): + self.order.insert(0, 'CONFIG_HASH') + self.checks.append(add_config_hash) + super(ConfigHash, self).post() diff --git a/attoconf/lib/install.py b/attoconf/lib/install.py new file mode 100644 index 0000000..04b5c5a --- /dev/null +++ b/attoconf/lib/install.py @@ -0,0 +1,271 @@ +# Copyright 2013-2014 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import os + +from ..classy import ClassyProject +from ..types import shell_word, filepath, quoted_string, maybe + + +def package(build, PACKAGE): + pass + +def package_name(build, NAME): + pass + +def prefix(build, PREFIX): + pass + +def exec_prefix(build, EPREFIX): + if not EPREFIX: + PREFIX = build.vars['PREFIX'] + build.vars['EXEC_PREFIX'] = PREFIX + build.vars['EPREFIX'] = build.vars['EXEC_PREFIX'] + +def bindir(build, DIR): + if not DIR: + EPREFIX = build.vars['EPREFIX'] + build.vars['BINDIR'] = os.path.join(EPREFIX, 'bin') + +def sbindir(build, DIR): + if not DIR: + EPREFIX = build.vars['EPREFIX'] + build.vars['SBINDIR'] = os.path.join(EPREFIX, 'sbin') + +def libexecdir(build, DIR): + if not DIR: + EPREFIX = build.vars['EPREFIX'] + build.vars['LIBEXECDIR'] = os.path.join(EPREFIX, 'libexec') + +def sysconfdir(build, DIR): + if not DIR: + PREFIX = build.vars['PREFIX'] + build.vars['SYSCONFDIR'] = os.path.join(PREFIX, 'etc') + +def sharedstatedir(build, DIR): + if not DIR: + PREFIX = build.vars['PREFIX'] + build.vars['SHAREDSTATEDIR'] = os.path.join(PREFIX, 'com') + +def localstatedir(build, DIR): + if not DIR: + PREFIX = build.vars['PREFIX'] + build.vars['LOCALSTATEDIR'] = os.path.join(PREFIX, 'var') + +def libdir(build, DIR): + if not DIR: + EPREFIX = build.vars['EPREFIX'] + build.vars['LIBDIR'] = os.path.join(EPREFIX, 'lib') + +def includedir(build, DIR): + if not DIR: + PREFIX = build.vars['PREFIX'] + build.vars['INCLUDEDIR'] = os.path.join(PREFIX, 'include') + +def oldincludedir(build, DIR): + pass + +def datarootdir(build, DIR): + if not DIR: + PREFIX = build.vars['PREFIX'] + build.vars['DATAROOTDIR'] = os.path.join(PREFIX, 'share') + +def datadir(build, DIR): + if not DIR: + DATAROOTDIR = build.vars['DATAROOTDIR'] + build.vars['DATADIR'] = DATAROOTDIR + +def packagedatadir(build, DIR): + if not DIR: + DATADIR = build.vars['DATADIR'] + PACKAGE = build.vars['PACKAGE'] + build.vars['PACKAGEDATADIR'] = os.path.join(DATADIR, PACKAGE) + +def infodir(build, DIR): + if not DIR: + DATAROOTDIR = build.vars['DATAROOTDIR'] + build.vars['INFODIR'] = os.path.join(DATAROOTDIR, 'info') + +def localedir(build, DIR): + if not DIR: + DATAROOTDIR = build.vars['DATAROOTDIR'] + build.vars['LOCALEDIR'] = os.path.join(DATAROOTDIR, 'locale') + +def mandir(build, DIR): + if not DIR: + DATAROOTDIR = build.vars['DATAROOTDIR'] + build.vars['MANDIR'] = os.path.join(DATAROOTDIR, 'man') + +def docdir(build, DIR): + if not DIR: + DATAROOTDIR = build.vars['DATAROOTDIR'] + PACKAGE = build.vars['PACKAGE'] + build.vars['DOCDIR'] = os.path.join(DATAROOTDIR, 'doc', PACKAGE) + +def htmldir(build, DIR): + if not DIR: + DOCDIR = build.vars['DOCDIR'] + build.vars['HTMLDIR'] = DOCDIR + +def dvidir(build, DIR): + if not DIR: + DOCDIR = build.vars['DOCDIR'] + build.vars['DVIDIR'] = DOCDIR + +def pdfdir(build, DIR): + if not DIR: + DOCDIR = build.vars['DOCDIR'] + build.vars['PDFDIR'] = DOCDIR + +def psdir(build, DIR): + if not DIR: + DOCDIR = build.vars['DOCDIR'] + build.vars['PSDIR'] = DOCDIR + + +class Install(ClassyProject): + __slots__ = () + _merge_slots_ = ('package', 'package_name') + + # Compatibility with configure written for attoconf < 0.7 + # In attoconf 1.0, the positional srcdir argument will go away, + # the None default and the .set_package function will be removed. + # (Note: when bisecting, always force checkout attoconf!) + def __init__(self, srcdir, package=None, package_name=None, **kwargs): + super(Install, self).__init__(srcdir=srcdir, **kwargs) + self.set_package(package, package_name) + + def set_package(self, package, package_name): + if package is not None: + assert self.package is None + self.package = package + self.package_name = package_name + if package is not None: + self._do_jiggle() + + def general(self): + super(Install, self).general() + self.add_option('--package', init=self.package, + type=shell_word, check=package, + help='Short name of this package (don\'t change!)', + hidden=True) + self.add_option('--package-name', init=self.package_name, + type=quoted_string, check=package_name, + help='Long name of this package (don\'t change)', + hidden=True, + help_var='NAME') + + def paths(self): + super(Install, self).paths() + + self.add_help('Installation directories:', hidden=False) + self.add_option('--prefix', init='/usr/local', + type=filepath, check=prefix, + help='install architecture-independent files in PREFIX', + hidden=False) + self.add_option('--exec-prefix', init='', + type=maybe(filepath), check=exec_prefix, + help='install architecture-dependent files in EPREFIX', + hidden=False, + help_var='EPREFIX', help_def='PREFIX') + self.order.append('EPREFIX') # TODO remove for 1.0 + self.order.append(None) + + self.add_help('Fine tuning of the installation directories:', + hidden=False) + self.add_option('--bindir', init='', + type=maybe(filepath), check=bindir, + help='user executables', hidden=False, + help_var='DIR', help_def='EPREFIX/bin') + self.add_option('--sbindir', init='', + type=maybe(filepath), check=sbindir, + help='system admin executables', hidden=False, + help_var='DIR', help_def='EPREFIX/sbin') + self.add_option('--libexecdir', init='', + type=maybe(filepath), check=libexecdir, + help='program executables', hidden=False, + help_var='DIR', help_def='EPREFIX/libexec') + self.add_option('--sysconfdir', init='', + type=maybe(filepath), check=sysconfdir, + help='read-only single-machine data', hidden=False, + help_var='DIR', help_def='PREFIX/etc') + self.add_option('--sharedstatedir', init='', + type=maybe(filepath), check=sharedstatedir, + help='modifiable architecture-independent data', hidden=False, + help_var='DIR', help_def='PREFIX/com') + self.add_option('--localstatedir', init='', + type=maybe(filepath), check=localstatedir, + help='modifiable single-machine data', hidden=False, + help_var='DIR', help_def='PREFIX/var') + self.add_option('--libdir', init='', + type=maybe(filepath), check=libdir, + help='object code libraries', hidden=False, + help_var='DIR', help_def='EPREFIX/lib') + self.add_option('--includedir', init='', + type=maybe(filepath), check=includedir, + help='C header files', hidden=False, + help_var='DIR', help_def='PREFIX/include') + self.add_option('--oldincludedir', init='/usr/include', + type=filepath, check=oldincludedir, + help='C header files for non-gcc', hidden=False, + help_var='DIR') + self.add_option('--datarootdir', init='', + type=maybe(filepath), check=datarootdir, + help='read-only arch.-independent data root', hidden=False, + help_var='DIR', help_def='PREFIX/share') + self.add_option('--datadir', init='', + type=maybe(filepath), check=datadir, + help='read-only architecture-independent data', hidden=False, + help_var='DIR', help_def='DATAROOTDIR') + self.add_option('--packagedatadir', init='', + type=maybe(filepath), check=packagedatadir, + help='data specific to this package (please set datadir instead)', hidden=False, + help_var='DIR', help_def='DATADIR/PACKAGE') + self.add_option('--infodir', init='', + type=maybe(filepath), check=infodir, + help='info documentation', hidden=False, + help_var='DIR', help_def='DATAROOTDIR/info') + self.add_option('--localedir', init='', + type=maybe(filepath), check=localedir, + help='locale-dependent data', hidden=False, + help_var='DIR', help_def='DATAROOTDIR/locale') + self.add_option('--mandir', init='', + type=maybe(filepath), check=mandir, + help='man documentation', hidden=False, + help_var='DIR', help_def='DATAROOTDIR/man') + self.add_option('--docdir', init='', + type=maybe(filepath), check=docdir, + help='documentation root', hidden=False, + help_var='DIR', help_def='DATAROOTDIR/doc/PACKAGE') + self.add_option('--htmldir', init='', + type=maybe(filepath), check=htmldir, + help='html documentation', hidden=False, + help_var='DIR', help_def='DOCDIR') + self.add_option('--dvidir', init='', + type=maybe(filepath), check=dvidir, + help='dvi documentation', hidden=False, + help_var='DIR', help_def='DOCDIR') + self.add_option('--pdfdir', init='', + type=maybe(filepath), check=pdfdir, + help='pdf documentation', hidden=False, + help_var='DIR', help_def='DOCDIR') + self.add_option('--psdir', init='', + type=maybe(filepath), check=psdir, + help='ps documentation', hidden=False, + help_var='DIR', help_def='DOCDIR') diff --git a/attoconf/lib/lex.py b/attoconf/lib/lex.py new file mode 100644 index 0000000..27c2a7e --- /dev/null +++ b/attoconf/lib/lex.py @@ -0,0 +1,34 @@ +# Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +from ..classy import ClassyProject +from ..types import ShellList + +def flex(build, FLEX): + # TODO actually test it + pass + +class Flex(ClassyProject): + __slots__ = () + def vars(self): + super(Flex, self).vars() + self.add_option('FLEX', init=['flex'], + type=ShellList, check=flex, + help='Lexical analyzer command', + hidden=False) diff --git a/attoconf/lib/make.py b/attoconf/lib/make.py new file mode 100644 index 0000000..ca70f34 --- /dev/null +++ b/attoconf/lib/make.py @@ -0,0 +1,87 @@ +# Copyright 2013-2014 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import os +import sys + +from ..classy import ClassyProject +from ..version import full_version + +blacklist = frozenset(''.join(chr(i) for i in range(0x20)) + '#$') +def validate(s): + return s == s.strip() and not frozenset(s) & blacklist + + +class MakeHook(object): + __slots__ = ('infile', 'outfile') + def __init__(self, infile, outfile): + self.infile = infile + self.outfile = outfile + + def __call__(self, build): + if self.outfile is None: + # if there are multiple backends + print('Skipping generation of a makefile') + return + with open(os.path.join(build.builddir, self.outfile), 'w') as out: + print('Generating a makefile ...') + out.write('# This part was generated by %s\n' % full_version) + build.vars['SRC_DIR'] = build.relative_source() + for var in build.project.order: + if var is None: + out.write('\n') + continue + val = build.vars[var] + out.write('%s = %s\n' % (var, val)) + if self.infile is not None: + out.write('# The rest was copied from %s\n' % self.infile) + infile = os.path.join(build.project.srcdir, self.infile) + with open(infile) as in_: + for line in in_: + assert line.endswith('\n') + out.write(line) + + +class Make(ClassyProject): + ''' Post hook to generate a Makefile from Makefile.in + ''' + __slots__ = () + _merge_slots_ = ('make_in', 'make_out') + + # compatibility with attoconf < 0.7 + def __init__(self, srcdir, + make_infile='Makefile.in', + make_outfile='Makefile', + **kwargs): + super(Make, self).__init__(srcdir=srcdir, **kwargs) + self.set_make_infile(make_infile) + self.set_make_outfile(make_outfile) # relative to build dir + + def set_make_infile(self, ipath): + self.make_in = ipath + + def set_make_outfile(self, opath): + self.make_out = opath + + def post(self): + super(Make, self).post() + if 'SRC_DIR' in self.order: + sys.exit('ERROR: Incompatible generator hooks!') + self.order.insert(0, 'SRC_DIR') + self.checks.append(MakeHook(self.make_in, self.make_out)) diff --git a/attoconf/lib/pkg_config.py b/attoconf/lib/pkg_config.py new file mode 100644 index 0000000..5bc846b --- /dev/null +++ b/attoconf/lib/pkg_config.py @@ -0,0 +1,97 @@ +# Copyright 2015 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import os +import sys + +from ..classy import ClassyProject +from ..types import enum, ShellList + +from .c import do_exec, TestError, C, Cxx + + +yesno = enum('yes', 'no') + +def run_pkg_config(build, *args): + PKG_CONFIG = build.vars['PKG_CONFIG'] + status, output = do_exec(build, PKG_CONFIG + list(args)) + if status: + raise TestError(output) + return output.strip() + +def check_pkg_config(build, PKG_CONFIG): + version = run_pkg_config(build, '--version') + print('Found pkg-config: %s' % version) + +def package_check(build, package, **var): + assert len(var) == 1 + _package, enabled = var.popitem() + enabled = enabled == 'yes' + modversion = run_pkg_config(build, '--modversion', package) + print("Found dependency '%s': %s" % (package, modversion)) + cppflags = run_pkg_config(build, '--cflags-only-I', package) + cflags = run_pkg_config(build, '--cflags-only-other', package) + ldflags = run_pkg_config(build, '--libs-only-L', '--libs-only-other', package) + libs = run_pkg_config(build, '--libs-only-l', package) + + build.vars['CPPFLAGS'] += cppflags + if 'CFLAGS' in build.vars: + build.vars['CFLAGS'] += cflags + if 'CXXFLAGS' in build.vars: + build.vars['CXXFLAGS'] += cflags + build.vars['LDFLAGS'] += ldflags + build.vars['LIBS'] += libs + +class PkgConfig(ClassyProject): + ''' Fill CFLAGS etc by pkg-config for dependencies. + ''' + __slots__ = () + _merge_slots_ = ('required_packages', 'optional_packages') + + def __init__(self, required_packages, optional_packages, **kwargs): + assert isinstance(self, (C, Cxx)) + super(PkgConfig, self).__init__(**kwargs) + self.required_packages = required_packages + self.optional_packages = optional_packages + + def vars(self): + super(PkgConfig, self).vars() + self.add_option('PKG_CONFIG', init=['pkg-config'], + type=ShellList, check=check_pkg_config, + help='Tool to find dependencies', hidden=False) + + def packages(self): + super(PkgConfig, self).packages() + for package in self.required_packages: + self._pkg_config_add_package(package, True) + for package in self.optional_packages: + self._pkg_config_add_package(package, False) + + def _pkg_config_add_package(self, package, hidden): + positive = '--with-' + package + negative = '--without-' + package + #check = package_required_check if hidden else package_optional_check + check = lambda build, **kwargs: package_check(build, package, **kwargs) + level = 'required' if hidden else 'optional' + help = "Build with %s dependency '%s'" % (level, package) + self.add_option(positive, type=yesno, hidden=hidden, init='yes', check=check, help=help) + # TODO: instead reveal one of the aliases and hide the main + # this requires messing with help slightly + self.add_alias(positive, [positive + '=yes'], help=None, hidden=True) + self.add_alias(negative, [positive + '=no'], help=None, hidden=True) diff --git a/attoconf/lib/templates.py b/attoconf/lib/templates.py new file mode 100644 index 0000000..7c26133 --- /dev/null +++ b/attoconf/lib/templates.py @@ -0,0 +1,77 @@ +# Copyright 2013-2014 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import os +import sys + +from ..classy import ClassyProject + + +class TemplateHook(object): + __slots__ = ('outfiles') + def __init__(self, outfiles): + self.outfiles = outfiles + + def __call__(self, build): + build.vars['SRC_DIR'] = build.relative_source() + unseen = set(build.project.order) + if None in unseen: + unseen.remove(None) + for outfile in self.outfiles: + infile = outfile + '.in' + print('Generating %s from %s' % (outfile, infile)) + # by replacing all instances of @VARIABLE@ with the value + + slurpee = open(os.path.join(build.project.srcdir, infile)).read() + for var in build.project.order: + if var is None: + continue + val = build.vars[var] + key = '@' + var + '@' + if key not in slurpee: + continue + if var in unseen: + unseen.remove(var) + slurpee = slurpee.replace(key, str(val)) + with open(os.path.join(build.builddir, outfile), 'w') as out: + out.write(slurpee) + if unseen: + print('WARNING: variables not used:') + print(' ' + '\n '.join(unseen)) + # lone @s may legitimately appear in the makefile. + # paired @s, which would be a forgotten subst, will be obvious. + + +class Templates(ClassyProject): + ''' Post hook to generate output files from *.in templates + ''' + __slots__ = () + _merge_slots_ = ('template_files') + + # this class didn't exist in attoconf < 0.7, no need for compatibility + def __init__(self, template_files, **kwargs): + super(Templates, self).__init__(**kwargs) + self.template_files = template_files + + def post(self): + super(Templates, self).post() + if 'SRC_DIR' in self.order: + sys.exit('ERROR: Incompatible generator hooks!') + self.order.insert(0, 'SRC_DIR') + self.checks.append(TemplateHook(self.template_files)) diff --git a/attoconf/lib/yacc.py b/attoconf/lib/yacc.py new file mode 100644 index 0000000..c3fd1de --- /dev/null +++ b/attoconf/lib/yacc.py @@ -0,0 +1,34 @@ +# Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +from ..classy import ClassyProject +from ..types import ShellList + +def bison(build, BISON): + # TODO actually test it + pass + +class Bison(ClassyProject): + __slots__ = () + def vars(self): + super(Bison, self).vars() + self.add_option('BISON', init=['bison'], + type=ShellList, check=bison, + help='Lexical analyzer command', + hidden=False) diff --git a/attoconf/tests/__init__.py b/attoconf/tests/__init__.py new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/attoconf/tests/__init__.py diff --git a/attoconf/tests/test_core.py b/attoconf/tests/test_core.py new file mode 100644 index 0000000..93aeaaf --- /dev/null +++ b/attoconf/tests/test_core.py @@ -0,0 +1,139 @@ +# Copyright 2013-2014 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import unittest + +from attoconf.core import Project, Build +from attoconf.types import uint, shell_word, shell_partial_word, maybe + +import os +from io import StringIO +import sys + +class ReplacingStdout(object): + __slots__ = ('old', 'new') + def __init__(self, new): + self.old = None + self.new = new + def __enter__(self): + self.old = sys.stdout + sys.stdout = self.new + def __exit__(self, type, value, traceback): + sys.stdout = self.old + del self.old + +class TestProject(unittest.TestCase): + def test_help(self): + proj = Project('foo') + proj.add_help('General:', False) + proj.add_alias('--help', ['--help=default'], + help='display standard help, then exit', hidden=False) + proj.add_option('--help', init='none', + type=proj.do_help, check=None, + help='display some subset of help', hidden=False, + help_var='TYPE') + proj.help.add_option('--help=hidden', + help='display help you should never ever ever care about', + hidden=True) + proj.add_option('--foo', init='asdf', + type=shell_word, check=None, + help='set frob target', hidden=False) + proj.add_option('--bar', init='', + type=maybe(shell_word), check=None, + help='set frob source', hidden=False, + help_def='FOO') + + build = Build(proj, 'bar') + + out = StringIO() + with ReplacingStdout(out): + with self.assertRaises(SystemExit): + build.apply_arg('--help') + self.assertEqual(out.getvalue(), ''' +General: + --help display standard help, then exit + --help=TYPE display some subset of help [none] + --foo=FOO set frob target [asdf] + --bar=BAR set frob source [FOO] + +'''[1:]) + + out = StringIO() + with ReplacingStdout(out): + with self.assertRaises(SystemExit): + build.apply_arg('--help=hidden') + self.assertEqual(out.getvalue(), ''' +General: + --help display standard help, then exit + --help=TYPE display some subset of help [none] + --help=hidden display help you should never ever ever care about + --foo=FOO set frob target [asdf] + --bar=BAR set frob source [FOO] + +'''[1:]) + + def test_path(self): + proj = Project('foo/') + build = Build(proj, 'bar/') + self.assertEqual(build.project.srcdir, 'foo') + self.assertEqual(build.builddir, 'bar') + self.assertEqual(build.relative_source(), '../foo') + + def test_configure(self): + def check_foo(bld, FOO): + self.assertEqual(FOO, 'B') + def check_bar(bld, BAR): + self.assertEqual(BAR, 1) + def check_qux(bld, QUX): + self.assertEqual(QUX, '') + def check_var(bld, VAR): + self.assertEqual(VAR, 'value') + + proj = Project('.') + proj.add_alias('--alias', ['--foo=A', '--bar=1', '--foo=B'], + help=None, hidden=False) + proj.add_option('--foo', init='X', + type=shell_word, check=check_foo, + help='help for string foo', hidden=False) + proj.add_option('--bar', init=0, + type=uint, check=check_bar, + help='help for int bar', hidden=False) + proj.add_option('--qux', init='', + type=maybe(uint), check=check_qux, + help='help for int qux', hidden=False, + help_def='auto') + proj.add_option('VAR', init='', + type=shell_partial_word, check=check_var, + help='help for string VAR', hidden=False) + + build = Build(proj, '.') + build.configure(['--alias'], + { + 'VAR': 'value', + 'QUX': 'a', + '--qux': 'b', + }) + os.remove('config.status') + self.assertEqual(build.vars, + { + 'FOO': 'B', + 'BAR': 1, + 'QUX': '', + 'VAR': 'value', + }) diff --git a/attoconf/tests/test_help.py b/attoconf/tests/test_help.py new file mode 100644 index 0000000..60a9e49 --- /dev/null +++ b/attoconf/tests/test_help.py @@ -0,0 +1,195 @@ +# Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import unittest + +from attoconf.help import Help, HelpSection, put_line_in_width + +from io import StringIO + +class TestHelpSection(unittest.TestCase): + def test_basic(self): + sec = HelpSection() + sec.add_text('foo', False) + sec.add_option('--foo', 'FOO', True) + sec.add_text('bar', True) + sec.add_option('--bar', 'BAR', False) + self.assertEqual(sec.headers, [(False, 'foo'), (True, 'bar')]) + self.assertEqual(sec.options, [(True, '--foo', 'FOO'), (False, '--bar', 'BAR')]) + + out = StringIO() + sec.print(out, False, float('inf')) + self.assertEqual(out.getvalue(), '''foo + --bar BAR +''') + + out = StringIO() + sec.print(out, True, float('inf')) + self.assertEqual(out.getvalue(), '''foo +bar + --foo FOO + --bar BAR +''') + + def test_width(self): + out = StringIO() + put_line_in_width(out, 'foo bar baz', float('inf'), 0) + self.assertEqual(out.getvalue(), 'foo bar baz\n') + + out = StringIO() + put_line_in_width(out, 'foo bar baz', 10, 0) + self.assertEqual(out.getvalue(), 'foo bar\nbaz\n') + + out = StringIO() + put_line_in_width(out, 'foo bar baz', 10, 2) + self.assertEqual(out.getvalue(), 'foo bar\n baz\n') + + out = StringIO() + put_line_in_width(out, ' foo bar baz', 10, 0) + self.assertEqual(out.getvalue(), ' foo bar\nbaz\n') + + out = StringIO() + put_line_in_width(out, ' foo bar baz', 10, 0) + self.assertEqual(out.getvalue(), ' foo\nbar baz\n') + + out = StringIO() + put_line_in_width(out, ' foo bar baz', 10, 3) + self.assertEqual(out.getvalue(), ' foo\n bar baz\n') + + out = StringIO() + put_line_in_width(out, ' foo bar baz', 10, 4) + self.assertEqual(out.getvalue(), ' foo\n bar\n baz\n') + + out = StringIO() + put_line_in_width(out, 'really-long-string', float('inf'), 0) + self.assertEqual(out.getvalue(), 'really-long-string\n') + + out = StringIO() + put_line_in_width(out, ' really-long-string', float('inf'), 0) + self.assertEqual(out.getvalue(), ' really-long-string\n') + + out = StringIO() + put_line_in_width(out, 'really-long-string', 10, 0) + self.assertEqual(out.getvalue(), 'really-long-string\n') + + out = StringIO() + put_line_in_width(out, ' really-long-string', 10, 0) + self.assertEqual(out.getvalue(), ' really-long-string\n') + + out = StringIO() + put_line_in_width(out, 'short really-long-string', float('inf'), 0) + self.assertEqual(out.getvalue(), 'short really-long-string\n') + + out = StringIO() + put_line_in_width(out, ' short really-long-string', float('inf'), 0) + self.assertEqual(out.getvalue(), ' short really-long-string\n') + + out = StringIO() + put_line_in_width(out, 'short really-long-string', 10, 0) + self.assertEqual(out.getvalue(), 'short\nreally-long-string\n') + + out = StringIO() + put_line_in_width(out, ' short really-long-string', 10, 0) + self.assertEqual(out.getvalue(), ' short\nreally-long-string\n') + + out = StringIO() + put_line_in_width(out, 'short really-long-string', 10, 1) + self.assertEqual(out.getvalue(), 'short\n really-long-string\n') + + out = StringIO() + put_line_in_width(out, ' short really-long-string', 10, 1) + self.assertEqual(out.getvalue(), ' short\n really-long-string\n') + + def test_print(self): + sec = HelpSection() + sec.add_option('--abcdefghijklmnopqrstuvwxyz', + 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', False) + + out = StringIO() + sec.print(out, False, 80) + self.assertEqual(out.getvalue(), ''' + --abcdefghijklmnopqrstuvwxyz + ABCDEFGHIJKLMNOPQRSTUVWXYZ +'''[1:]) + + sec.add_option('--foo', 'FOO', False) + sec.add_option('--frob', 'FROB', False) + + out = StringIO() + sec.print(out, False, 80) + self.assertEqual(out.getvalue(), ''' + --abcdefghijklmnopqrstuvwxyz + ABCDEFGHIJKLMNOPQRSTUVWXYZ + --foo FOO + --frob FROB +'''[1:]) + + out = StringIO() + sec.print(out, False, float('inf')) + self.assertEqual(out.getvalue(), ''' + --abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ + --foo FOO + --frob FROB +'''[1:]) + + +class TestHelp(unittest.TestCase): + def test_print(self): + help = Help() + help.add_option('--invisible', 'You can\'t see this', True) + help.add_text('General:', False) + help.add_option('--help', 'show this', False) + help.add_option('--version', 'show that', True) + help.add_text('Other stuff:', False) + help.add_text('with long header:', True) + help.add_option('--foo-lets-make-it-long-just-because', 'I\'m bored', False) + help.add_text('Visibility:', False) + help.add_option('--sneaky', 'This may be surprising. It also works as a demonstration of multi-line wrapping, just because.', True) + + out = StringIO() + help.print(out, True, 80) + self.assertEqual(out.getvalue(), ''' + --invisible You can't see this + +General: + --help show this + --version show that + +Other stuff: +with long header: + --foo-lets-make-it-long-just-because + I'm bored + +Visibility: + --sneaky This may be surprising. It also works as a demonstration of + multi-line wrapping, just because. + +'''[1:]) + + out = StringIO() + help.print(out, False, 80) + self.assertEqual(out.getvalue(), ''' +General: + --help show this + +Other stuff: + --foo-lets-make-it-long-just-because + I'm bored + +'''[1:]) diff --git a/attoconf/tests/test_types.py b/attoconf/tests/test_types.py new file mode 100644 index 0000000..14926ef --- /dev/null +++ b/attoconf/tests/test_types.py @@ -0,0 +1,62 @@ +# Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import unittest + +from attoconf.types import enum, ShellList + +class TestEnum(unittest.TestCase): + def test_stuff(self): + foobar = enum('foo', 'bar') + foobar('foo') + foobar('bar') + with self.assertRaisesRegex(ValueError, "'baz' not in {foo, bar}"): + foobar('baz') + +class TestShell(unittest.TestCase): + def test_str(self): + sh0 = ShellList('\\ ') + self.assertEqual("' '", str(sh0)) + self.assertEqual([' '], sh0.list) + sh1 = ShellList(' foo ') + self.assertEqual('foo', str(sh1)) + self.assertEqual(['foo'], sh1.list) + sh2 = ShellList(' "foo bar " baz') + self.assertEqual("'foo bar ' baz", str(sh2)) + self.assertEqual(['foo bar ', 'baz'], sh2.list) + sh3 = ShellList(""" "foo\\ bar\\"" 'baz\\ qux' ''\\''' frob\\ it """) + self.assertEqual("""'foo\\ bar"' 'baz\\ qux' ''"'"'' 'frob it'""", str(sh3)) + self.assertEqual(['foo\\ bar"', 'baz\\ qux', "'", 'frob it'], sh3.list) + + def test_list(self): + sh1 = ShellList(['foo']) + self.assertEqual('foo', str(sh1)) + sh2 = ShellList(['foo bar ', 'baz']) + self.assertEqual("'foo bar ' baz", str(sh2)) + sh3 = ShellList(['foo\\ bar"', 'baz\\ qux', "'", 'frob it']) + self.assertEqual('\'foo\\ bar"\' \'baz\\ qux\' \'\'"\'"\'\' \'frob it\'', str(sh3)) + + def test_add(self): + sh0 = ShellList('') + self.assertEqual(str(sh0 + sh0), '') + self.assertEqual((sh0 + sh0).list, []) + sh1 = ShellList(['foo bar', 'baz']) + self.assertEqual(str(sh0 + sh1), "'foo bar' baz") + self.assertEqual((sh0 + sh1).list, sh1.list) + self.assertEqual(str(sh1 + sh1), "'foo bar' baz 'foo bar' baz") diff --git a/attoconf/tests/test_version.py b/attoconf/tests/test_version.py new file mode 100644 index 0000000..9967283 --- /dev/null +++ b/attoconf/tests/test_version.py @@ -0,0 +1,95 @@ +# Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import unittest + +from attoconf.version import require_version, full_version, part_version + +class TestVersion(unittest.TestCase): + def test_parse(self): + # don't do this + name, version, dist = full_version.split(' ', 2) + self.assertEqual(name, 'attoconf') + self.assertEqual(version, part_version) + major, minor, patch = [int(x) for x in version.split('.')] + assert dist.startswith('(') + assert dist.endswith(')') + dist = dist[1:-1] + assert '(' not in dist + assert ')' not in dist + assert '\n' not in dist + from attoconf._version import distributor + self.assertEqual(dist, distributor) + + def test_check(self): + from attoconf._version import major, minor, patch + with self.assertRaises(SystemExit): + require_version(major - 1, minor - 1, patch - 1) + with self.assertRaises(SystemExit): + require_version(major - 1, minor - 1, patch + 0) + with self.assertRaises(SystemExit): + require_version(major - 1, minor - 1, patch + 1) + with self.assertRaises(SystemExit): + require_version(major - 1, minor + 0, patch - 1) + with self.assertRaises(SystemExit): + require_version(major - 1, minor + 0, patch + 0) + with self.assertRaises(SystemExit): + require_version(major - 1, minor + 0, patch + 1) + with self.assertRaises(SystemExit): + require_version(major - 1, minor + 1, patch - 1) + with self.assertRaises(SystemExit): + require_version(major - 1, minor + 1, patch + 0) + with self.assertRaises(SystemExit): + require_version(major - 1, minor + 1, patch + 1) + if 1: + require_version(major + 0, minor - 1, patch - 1) + if 1: + require_version(major + 0, minor - 1, patch + 0) + if 1: + require_version(major + 0, minor - 1, patch + 1) + if 1: + require_version(major + 0, minor + 0, patch - 1) + if 1: + require_version(major + 0, minor + 0, patch + 0) + with self.assertRaises(SystemExit): + require_version(major + 0, minor + 0, patch + 1) + with self.assertRaises(SystemExit): + require_version(major + 0, minor + 1, patch - 1) + with self.assertRaises(SystemExit): + require_version(major + 0, minor + 1, patch + 0) + with self.assertRaises(SystemExit): + require_version(major + 0, minor + 1, patch + 1) + with self.assertRaises(SystemExit): + require_version(major + 1, minor - 1, patch - 1) + with self.assertRaises(SystemExit): + require_version(major + 1, minor - 1, patch + 0) + with self.assertRaises(SystemExit): + require_version(major + 1, minor - 1, patch + 1) + with self.assertRaises(SystemExit): + require_version(major + 1, minor + 0, patch - 1) + with self.assertRaises(SystemExit): + require_version(major + 1, minor + 0, patch + 0) + with self.assertRaises(SystemExit): + require_version(major + 1, minor + 0, patch + 1) + with self.assertRaises(SystemExit): + require_version(major + 1, minor + 1, patch - 1) + with self.assertRaises(SystemExit): + require_version(major + 1, minor + 1, patch + 0) + with self.assertRaises(SystemExit): + require_version(major + 1, minor + 1, patch + 1) diff --git a/attoconf/types.py b/attoconf/types.py new file mode 100644 index 0000000..e1af528 --- /dev/null +++ b/attoconf/types.py @@ -0,0 +1,129 @@ +# Copyright 2013-2014 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import os +from pipes import quote as shell_quote +from shlex import split as shell_split + +from .core import trim_trailing_slashes + + +class IntRange(object): + def __init__(self, min, max): + self.min = min + self.max = max + + def __call__(self, s): + i = int(s) + if self.min <= i <= self.max: + return i + raise ValueError('%d is out of range' % i) + +sint = IntRange(float('-inf'), float('inf')) +uint = IntRange(0, float('inf')) + + +class enum(object): + __slots__ = ('args',) + + def __init__(self, *args): + self.args = args + + def __call__(self, s): + if s in self.args: + return s + raise ValueError('%r not in {%s}' % (s, ', '.join(self.args))) + + +class maybe(object): + __slots__ = ('inferior') + + def __init__(self, inferior): + self.inferior = inferior + + def __call__(self, s): + if not s: + return s + return (self.inferior)(s) + + +class ShellList(object): + ''' An argument type representing a sequence of 0 or more arguments + ''' + __slots__ = ('list',) + def __init__(self, arg): + if isinstance(arg, str): + self.list = shell_split(arg) + elif isinstance(arg, list): + self.list = arg[:] + elif isinstance(arg, ShellList): + self.list = arg.list[:] + else: + raise TypeError('arg is an instance of %s' % type(arg).__name__) + + def __str__(self): + return ' '.join(shell_quote(a) for a in self.list) + + def __add__(self, other): + if isinstance(other, str): + other = shell_split(other) + elif isinstance(other, ShellList): + other = other.list + elif not isinstance(other, list): + raise TypeError('arg is an instance of %s' % type(arg).__name__) + return ShellList(self.list + other) + + +def shell_word(s): + if s != shell_quote(s): + raise ValueError('not a word: %r' % s) + return s + + +def shell_partial_word(s): + if s == '': + return s + return shell_word(s) + + +def quoted_string(s): + return shell_quote(s) + + +def filepath(s): + s = trim_trailing_slashes(s) + # must be absolute *and* canonical, except joinable + a = os.path.abspath(s) + if a == '/': + # filepaths often directly cat a subpath + # @me@/whatever is invalid if @me@ == / + a = '/.' + if s != a: + raise ValueError('Not an absolute, canonical (except joinable) pathname: %r != %r' % (s, a)) + return s + + +def triple(s): + # Triples do not, in fact, follow a regular pattern. + # Some have only two segments, some appear to have four ... + # Also, sometimes a wrong thing is used as a triple. + # All we *really* care about is generating the tool names. + if s.startswith('-') or s.endswith('-') or '-' not in s[1:-1]: + raise ValueError('Probably not a triple') + return s diff --git a/attoconf/version.py b/attoconf/version.py new file mode 100644 index 0000000..96db3e5 --- /dev/null +++ b/attoconf/version.py @@ -0,0 +1,66 @@ +# Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + + + +import sys + +from . import _version + +if sys.version_info[0] != 3 or sys.version_info[1] < 6: + sys.exit('Unsupported Python version: %s\nattoconf requires Python 3.6+' % sys.version) + +def require_version(major, minor, patch=0): + ''' Check that this is the right version of attoconf, or die trying. + ''' + if major != _version.major: + # Once I release attoconf 1.0, I *probably* won't ever + # do another major upgrade - that would be difficult to package. + sys.exit( +''' +This configure script requires a different major version of attoconf. +Major version changes are rare, and software written against the one +version is likely to need changes to work with the other version. + +Current version: %s +Minimum required version: %d.%d.%d +''' % (full_version, major, minor, patch)) + if minor > _version.minor: + # In the interest of good style, it sometimes *should* be rewritten. + sys.exit( +''' +This configure script requires a newer minor version of attoconf. +Minor version changes are common, and software written against the one +minor version will work with all later minor versions. + +Current version: %s +Minimum required version: %d.%d.%d +''' % (full_version, major, minor, patch)) + if minor == _version.minor and patch > _version.patch: + sys.exit( +''' +This configure script requires a newer patch version of attoconf. +Patch versions are usually not released unless there is a bug in a minor +version, but it is possible that someone is using experimental features. +If there is one, upgrade to the latest minor version instead. + +Current version: %s +Minimum required version: %d.%d.%d +''' % (full_version, major, minor, patch)) + +part_version = '%d.%d.%d' % (_version.major, _version.minor, _version.patch) +full_version = 'attoconf %s (%s)' % (part_version, _version.distributor) diff --git a/demo-project/Makefile.in b/demo-project/Makefile.in new file mode 100644 index 0000000..8f3f4f0 --- /dev/null +++ b/demo-project/Makefile.in @@ -0,0 +1,9 @@ +vpath %.c ${SRC_DIR} +vpath %.h ${SRC_DIR} + +hello: main.o hello.o +main.o: main.c hello.h +hello.o: hello.c hello.h + +clean: + rm -f hello main.o hello.o diff --git a/demo-project/attoconf b/demo-project/attoconf new file mode 120000 index 0000000..a0b3fcf --- /dev/null +++ b/demo-project/attoconf @@ -0,0 +1 @@ +../attoconf/
\ No newline at end of file diff --git a/demo-project/configure b/demo-project/configure new file mode 100755 index 0000000..61a2c2e --- /dev/null +++ b/demo-project/configure @@ -0,0 +1,74 @@ +#!/usr/bin/env python3 + +# Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +# +# This file is part of attoconf. +# +# attoconf is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# attoconf is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with attoconf. If not, see <http://www.gnu.org/licenses/>. + +import os +import sys + +from attoconf.version import require_version +require_version(0, 6) + +from attoconf.classy import add_slots +from attoconf.lib.c import C +from attoconf.lib.install import Install +from attoconf.lib.config_hash import ConfigHash +from attoconf.lib.make import Make + +@add_slots +class Configuration(C, Install, ConfigHash, Make): + # usually you'll only have vars, features, and packages + # the rest should only be inherited + def __init__(self, srcdir): + super(Configuration, self).__init__(srcdir) + + def general(self): + super(Configuration, self).general() + + def paths(self): + super(Configuration, self).paths() + + def arches(self): + super(Configuration, self).arches() + + def vars(self): + super(Configuration, self).vars() + + def features(self): + super(Configuration, self).features() + + def packages(self): + super(Configuration, self).packages() + + if 0: + def tests(self): + super(Configuration, self).tests() + + def post(self): + super(Configuration, self).post() + + +def main(): + proj = Configuration(os.path.dirname(sys.argv[0])) + proj.set_package('attoconf-demo', 'Demo project for attoconf') + proj.jiggle() + build = proj.build('.') + build.configure(sys.argv[1:], os.environ) + + +if __name__ == '__main__': + main() diff --git a/demo-project/header.c b/demo-project/header.c new file mode 100644 index 0000000..f231086 --- /dev/null +++ b/demo-project/header.c @@ -0,0 +1,16 @@ +// Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +// +// This file is part of attoconf. +// +// attoconf is free software: you can redistribute it and/or modify +// it under the terms of the GNU General Public License as published by +// the Free Software Foundation, either version 3 of the License, or +// (at your option) any later version. +// +// attoconf is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// GNU General Public License for more details. +// +// You should have received a copy of the GNU General Public License +// along with attoconf. If not, see <http://www.gnu.org/licenses/>. diff --git a/demo-project/hello.c b/demo-project/hello.c new file mode 100644 index 0000000..b018dc3 --- /dev/null +++ b/demo-project/hello.c @@ -0,0 +1,25 @@ +// Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +// +// This file is part of attoconf. +// +// attoconf is free software: you can redistribute it and/or modify +// it under the terms of the GNU General Public License as published by +// the Free Software Foundation, either version 3 of the License, or +// (at your option) any later version. +// +// attoconf is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// GNU General Public License for more details. +// +// You should have received a copy of the GNU General Public License +// along with attoconf. If not, see <http://www.gnu.org/licenses/>. + +#include "hello.h" + +#include <stdio.h> + +void hello(void) +{ + puts("Hello, World!"); +} diff --git a/demo-project/hello.h b/demo-project/hello.h new file mode 100644 index 0000000..899b9cc --- /dev/null +++ b/demo-project/hello.h @@ -0,0 +1,22 @@ +#ifndef HELLO_H +#define HELLO_H +// Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +// +// This file is part of attoconf. +// +// attoconf is free software: you can redistribute it and/or modify +// it under the terms of the GNU General Public License as published by +// the Free Software Foundation, either version 3 of the License, or +// (at your option) any later version. +// +// attoconf is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// GNU General Public License for more details. +// +// You should have received a copy of the GNU General Public License +// along with attoconf. If not, see <http://www.gnu.org/licenses/>. + +void hello(void); + +#endif // HELLO_H diff --git a/demo-project/main.c b/demo-project/main.c new file mode 100644 index 0000000..2d363e2 --- /dev/null +++ b/demo-project/main.c @@ -0,0 +1,24 @@ +// Copyright 2013 Ben Longbons <b.r.longbons@gmail.com> +// +// This file is part of attoconf. +// +// attoconf is free software: you can redistribute it and/or modify +// it under the terms of the GNU General Public License as published by +// the Free Software Foundation, either version 3 of the License, or +// (at your option) any later version. +// +// attoconf is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// GNU General Public License for more details. +// +// You should have received a copy of the GNU General Public License +// along with attoconf. If not, see <http://www.gnu.org/licenses/>. + +#include "hello.h" + +int main() +{ + hello(); + return 0; +} diff --git a/gpl-3.0.txt b/gpl-3.0.txt new file mode 100644 index 0000000..94a9ed0 --- /dev/null +++ b/gpl-3.0.txt @@ -0,0 +1,674 @@ + GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU General Public License is a free, copyleft license for +software and other kinds of works. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Use with the GNU Affero General Public License. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU Affero General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + <one line to give the program's name and a brief idea of what it does.> + Copyright (C) <year> <name of author> + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see <http://www.gnu.org/licenses/>. + +Also add information on how to contact you by electronic and paper mail. + + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + <program> Copyright (C) <year> <name of author> + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU GPL, see +<http://www.gnu.org/licenses/>. + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +<http://www.gnu.org/philosophy/why-not-lgpl.html>. diff --git a/setup.py b/setup.py new file mode 100755 index 0000000..db30276 --- /dev/null +++ b/setup.py @@ -0,0 +1,25 @@ +#!/usr/bin/env python3 + +from distutils.core import setup + +from attoconf.version import part_version + +setup( + name='attoconf', + version=part_version, + description='A small and sensible replacement for GNU autoconf', + author='Ben Longbons', + author_email='b.r.longbons@gmail.com', + url='http://github.com/o11c/attoconf', + packages=[ + 'attoconf', + 'attoconf.lib', + ], + classifiers=[ + 'Development Status :: 3 - Alpha', + 'Intended Audience :: Developers', + 'License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)', + 'Programming Language :: Python :: 2 :: Only', + 'Topic :: Software Development :: Build Tools', + ], +) diff --git a/test-everything.sh b/test-everything.sh new file mode 100755 index 0000000..c45ad00 --- /dev/null +++ b/test-everything.sh @@ -0,0 +1,10 @@ +#!/bin/sh -e +python3 -m unittest discover "$@" + +mkdir -p demo-build +cd demo-build +../demo-project/configure +make +./hello +cd .. +rm -r demo-build |