scons_gd/scons/SConstruct
2022-10-15 16:06:26 +02:00

221 lines
7.1 KiB
Python

#
# SConstruct file to build scons packages during development.
#
# See the README.rst file for an overview of how SCons is built and tested.
import os.path
import sys
import textwrap
from time import strftime
copyright_years = strftime('2001 - %Y')
# This gets inserted into the man pages to reflect the month of release.
month_year = strftime('%B %Y')
#
# MIT License
#
# Copyright The SCons Foundation
#
# Permission is hereby granted, free of charge, to any person obtaining
# a copy of this software and associated documentation files (the
# "Software"), to deal in the Software without restriction, including
# without limitation the rights to use, copy, modify, merge, publish,
# distribute, sublicense, and/or sell copies of the Software, and to
# permit persons to whom the Software is furnished to do so, subject to
# the following conditions:
#
# The above copyright notice and this permission notice shall be included
# in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
# KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
# WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
#
project = 'scons'
default_version = '4.4.1'
copyright = "Copyright (c) %s The SCons Foundation" % copyright_years
#
# We let the presence or absence of various utilities determine whether
# or not we bother to build certain pieces of things. This should allow
# people to still do SCons packaging work even if they don't have all
# of the utilities installed
#
print("git :%s" % git)
print("gzip :%s" % gzip)
print("unzip :%s" % unzip)
print("zip :%s" % zip_path)
#
# Adding some paths to sys.path, this is mainly needed
# for the doc toolchain.
#
addpaths = [os.path.abspath(os.path.join(os.getcwd(), 'bin')),
os.path.abspath(os.path.join(os.getcwd(), 'testing/framework'))]
for a in addpaths:
if a not in sys.path:
sys.path.append(a)
# Use site_scons logic to process command line arguments
command_line = BuildCommandLine(default_version)
command_line.process_command_line_vars()
Default('.', command_line.build_dir)
# Just make copies, don't symlink them.
SetOption('duplicate', 'copy')
packaging_flavors = [
('tar-gz', "The normal .tar.gz file for end-user installation."),
('local-tar-gz', "A .tar.gz file for dropping into other software " +
"for local use."),
('zip', "The normal .zip file for end-user installation."),
('local-zip', "A .zip file for dropping into other software " +
"for local use."),
('src-tar-gz', "A .tar.gz file containing all the source " +
"(including tests and documentation)."),
('src-zip', "A .zip file containing all the source " +
"(including tests and documentation)."),
]
test_tar_gz_dir = os.path.join(command_line.build_dir, "test-tar-gz")
test_src_tar_gz_dir = os.path.join(command_line.build_dir, "test-src-tar-gz")
test_local_tar_gz_dir = os.path.join(command_line.build_dir, "test-local-tar-gz")
test_zip_dir = os.path.join(command_line.build_dir, "test-zip")
test_src_zip_dir = os.path.join(command_line.build_dir, "test-src-zip")
test_local_zip_dir = os.path.join(command_line.build_dir, "test-local-zip")
unpack_tar_gz_dir = os.path.join(command_line.build_dir, "unpack-tar-gz")
unpack_zip_dir = os.path.join(command_line.build_dir, "unpack-zip")
if is_windows():
tar_hflag = ''
# python_project_subinst_dir = os.path.join("Lib", "site-packages", project)
# project_script_subinst_dir = 'Scripts'
else:
tar_hflag = 'h'
# python_project_subinst_dir = os.path.join("lib", project)
# project_script_subinst_dir = 'bin'
indent_fmt = ' %-26s '
Help("""\
The following aliases build packages of various types, and unpack the
contents into build/test-$PACKAGE subdirectories, which can be used by the
runtest.py -p option to run tests against what's been actually packaged:
""")
aliases = sorted(packaging_flavors + [('doc', 'The SCons documentation.')])
for alias, help_text in aliases:
tw = textwrap.TextWrapper(
width=78,
initial_indent=indent_fmt % alias,
subsequent_indent=indent_fmt % '' + ' ',
)
Help(tw.fill(help_text) + '\n')
Help("""
The following command-line variables can be set:
""")
for variable, help_text in command_line.command_line_variables:
tw = textwrap.TextWrapper(
width=78,
initial_indent=indent_fmt % variable,
subsequent_indent=indent_fmt % '' + ' ',
)
Help(tw.fill(help_text) + '\n')
revaction = SCons_revision
revbuilder = Builder(action=Action(SCons_revision,
varlist=['COPYRIGHT', 'VERSION']))
env = Environment(
ENV=command_line.ENV,
BUILD=command_line.build_id,
BUILDDIR=command_line.build_dir,
BUILDSYS=command_line.build_system,
COPYRIGHT_YEARS=copyright_years,
COPYRIGHT=copyright,
DATE=command_line.date,
DEB_DATE=deb_date,
DEVELOPER=command_line.developer,
DISTDIR=os.path.join(command_line.build_dir, 'dist'),
MONTH_YEAR=month_year,
REVISION=command_line.revision,
VERSION=command_line.version,
TAR_HFLAG=tar_hflag,
ZIP=zip_path,
ZIPFLAGS='-r',
UNZIP=unzip,
UNZIPFLAGS='-o -d $UNPACK_ZIP_DIR',
# ZCAT=zcat,
# ZIPID=zipit,
TEST_SRC_TAR_GZ_DIR=test_src_tar_gz_dir,
TEST_SRC_ZIP_DIR=test_src_zip_dir,
TEST_TAR_GZ_DIR=test_tar_gz_dir,
TEST_ZIP_DIR=test_zip_dir,
UNPACK_TAR_GZ_DIR=unpack_tar_gz_dir,
UNPACK_ZIP_DIR=unpack_zip_dir,
BUILDERS={'SCons_revision': revbuilder,
'SOElim': soelimbuilder},
PYTHON='"%s"' % sys.executable,
PYTHONFLAGS='-tt',
)
Version_values = [Value(command_line.version), Value(command_line.build_id)]
installed_local_files = create_local_packages(env)
update_init_file(env)
#
#
#
#
# Documentation.
#
Export('command_line', 'env', 'whereis', 'revaction')
SConscript('doc/SConscript')
# Copy manpage's into base dir for inclusion in pypi packages
man_pages = env.Install("#/", Glob("#/build/doc/man/*.1"))
# Build packages for pypi
wheel = env.Command('$DISTDIR/SCons-${VERSION}-py3-none-any.whl', ['setup.cfg', 'setup.py', 'SCons/__init__.py']+man_pages,
'$PYTHON setup.py bdist_wheel')
zip_file = env.Command('$DISTDIR/SCons-${VERSION}.zip', ['setup.cfg', 'setup.py', 'SCons/__init__.py']+man_pages,
'$PYTHON setup.py sdist --format=zip')
tgz_file = env.Command('$DISTDIR/SCons-${VERSION}.tar.gz', ['setup.cfg', 'setup.py', 'SCons/__init__.py']+man_pages,
'$PYTHON setup.py sdist --format=gztar')
# Now set depends so the above run in a particular order
env.Depends(tgz_file, [zip_file, wheel])
# NOTE: Commenting this out as the manpages are expected to be in the base directory when manually
# running setup.py from the base of the repo.
# NOTE: This used by distro package maintainers.
# env.AddPostAction(tgz_file, Delete(man_pages))
# TODO add auto copyright date to README.rst, LICENSE
# TODO build API DOCS