#acupoftea - accounting.gulfstore-gcc.com

System	:	Linux server1.ontime-gulf.com 4.18.0-553.5.1.el8_10.x86_64 #1 SMP Wed Jun 5 09:12:13 EDT 2024 x86_64
Software	:	Apache
Server	:	162.0.230.206
Domains	:	40 Domain
Permission	:	[ drwxr-xr-x ]
	:	/ usr / lib64 / python3.6 / distutils / command /

216.73.216.5

Home

File build_clib.py

"""distutils.command.build_clib

Implements the Distutils 'build_clib' command, to build a C/C++ library
that is included in the module distribution and needed by an extension
module."""

# XXX this module has *lots* of code ripped-off quite transparently from
# build_ext.py -- not surprisingly really, as the work required to build
# a static library from a collection of C source files is not really all
# that different from what's required to build a shared object file from
# a collection of C source files.  Nevertheless, I haven't done the
# necessary refactoring to account for the overlap in code between the
# two modules, mainly because a number of subtle details changed in the
# cut 'n paste.  Sigh.

import os
from distutils.core import Command
from distutils.errors import *
from distutils.sysconfig import customize_compiler
from distutils import log

def show_compilers():
    from distutils.ccompiler import show_compilers
    show_compilers()

class build_clib(Command):

description = "build C/C++ libraries used by Python extensions"

user_options = [
        ('build-clib=', 'b',
         "directory to build C/C++ libraries to"),
        ('build-temp=', 't',
         "directory to put temporary build by-products"),
        ('debug', 'g',
         "compile with debugging information"),
        ('force', 'f',
         "forcibly build everything (ignore file timestamps)"),
        ('compiler=', 'c',
         "specify the compiler type"),
        ]

boolean_options = ['debug', 'force']

help_options = [
        ('help-compiler', None,
         "list available compilers", show_compilers),
        ]

def initialize_options(self):
        self.build_clib = None
        self.build_temp = None

# List of libraries to build
        self.libraries = None

# Compilation options for all libraries
        self.include_dirs = None
        self.define = None
        self.undef = None
        self.debug = None
        self.force = 0
        self.compiler = None

def finalize_options(self):
        # This might be confusing: both build-clib and build-temp default
        # to build-temp as defined by the "build" command.  This is because
        # I think that C libraries are really just temporary build
        # by-products, at least from the point of view of building Python
        # extensions -- but I want to keep my options open.
        self.set_undefined_options('build',
                                   ('build_temp', 'build_clib'),
                                   ('build_temp', 'build_temp'),
                                   ('compiler', 'compiler'),
                                   ('debug', 'debug'),
                                   ('force', 'force'))

self.libraries = self.distribution.libraries
        if self.libraries:
            self.check_library_list(self.libraries)

if self.include_dirs is None:
            self.include_dirs = self.distribution.include_dirs or []
        if isinstance(self.include_dirs, str):
            self.include_dirs = self.include_dirs.split(os.pathsep)

# XXX same as for build_ext -- what about 'self.define' and
        # 'self.undef' ?

def run(self):
        if not self.libraries:
            return

# Yech -- this is cut 'n pasted from build_ext.py!
        from distutils.ccompiler import new_compiler
        self.compiler = new_compiler(compiler=self.compiler,
                                     dry_run=self.dry_run,
                                     force=self.force)
        customize_compiler(self.compiler)

if self.include_dirs is not None:
            self.compiler.set_include_dirs(self.include_dirs)
        if self.define is not None:
            # 'define' option is a list of (name,value) tuples
            for (name,value) in self.define:
                self.compiler.define_macro(name, value)
        if self.undef is not None:
            for macro in self.undef:
                self.compiler.undefine_macro(macro)

self.build_libraries(self.libraries)

def check_library_list(self, libraries):
        """Ensure that the list of libraries is valid.

`library` is presumably provided as a command option 'libraries'.
        This method checks that it is a list of 2-tuples, where the tuples
        are (library_name, build_info_dict).

Raise DistutilsSetupError if the structure is invalid anywhere;
        just returns otherwise.
        """
        if not isinstance(libraries, list):
            raise DistutilsSetupError(
                  "'libraries' option must be a list of tuples")

for lib in libraries:
            if not isinstance(lib, tuple) and len(lib) != 2:
                raise DistutilsSetupError(
                      "each element of 'libraries' must a 2-tuple")

name, build_info = lib

if not isinstance(name, str):
                raise DistutilsSetupError(
                      "first element of each tuple in 'libraries' "
                      "must be a string (the library name)")

if '/' in name or (os.sep != '/' and os.sep in name):
                raise DistutilsSetupError("bad library name '%s': "
                       "may not contain directory separators" % lib[0])

if not isinstance(build_info, dict):
                raise DistutilsSetupError(
                      "second element of each tuple in 'libraries' "
                      "must be a dictionary (build info)")

def get_library_names(self):
        # Assume the library list is valid -- 'check_library_list()' is
        # called from 'finalize_options()', so it should be!
        if not self.libraries:
            return None

lib_names = []
        for (lib_name, build_info) in self.libraries:
            lib_names.append(lib_name)
        return lib_names

def get_source_files(self):
        self.check_library_list(self.libraries)
        filenames = []
        for (lib_name, build_info) in self.libraries:
            sources = build_info.get('sources')
            if sources is None or not isinstance(sources, (list, tuple)):
                raise DistutilsSetupError(
                       "in 'libraries' option (library '%s'), "
                       "'sources' must be present and must be "
                       "a list of source filenames" % lib_name)

filenames.extend(sources)
        return filenames

def build_libraries(self, libraries):
        for (lib_name, build_info) in libraries:
            sources = build_info.get('sources')
            if sources is None or not isinstance(sources, (list, tuple)):
                raise DistutilsSetupError(
                       "in 'libraries' option (library '%s'), "
                       "'sources' must be present and must be "
                       "a list of source filenames" % lib_name)
            sources = list(sources)

log.info("building '%s' library", lib_name)

# First, compile the source code to object files in the library
            # directory.  (This should probably change to putting object
            # files in a temporary build directory.)
            macros = build_info.get('macros')
            include_dirs = build_info.get('include_dirs')
            objects = self.compiler.compile(sources,
                                            output_dir=self.build_temp,
                                            macros=macros,
                                            include_dirs=include_dirs,
                                            debug=self.debug)

# Now "link" the object files together into a static library.
            # (On Unix at least, this isn't really linking -- it just
            # builds an archive.  Whatever.)
            self.compiler.create_static_lib(objects, lib_name,
                                            output_dir=self.build_clib,
                                            debug=self.debug)

Name	Type	Size	Permission	Last Modified	Actions
.	DIR	-	drwxr-xr-x	2025-08-28 10:58:23
..	DIR	-	drwxr-xr-x	2025-08-28 10:58:23
__pycache__	DIR	-	drwxr-xr-x	2025-08-28 10:58:23
__init__.py	text/plain	799 B	-rw-r--r--	2018-12-23 09:37:14
bdist.py	text/plain	5.43 KB	-rw-r--r--	2018-12-23 09:37:14
bdist_dumb.py	text/plain	4.8 KB	-rw-r--r--	2018-12-23 09:37:14
bdist_msi.py	text/x-script.python	34.41 KB	-rw-r--r--	2018-12-23 09:37:14
bdist_rpm.py	text/plain	21.16 KB	-rw-r--r--	2018-12-23 09:37:14
bdist_wininst.py	text/plain	15.2 KB	-rw-r--r--	2025-08-26 08:58:55
build.py	text/plain	5.61 KB	-rw-r--r--	2018-12-23 09:37:14
build_clib.py	text/plain	7.83 KB	-rw-r--r--	2018-12-23 09:37:14
build_ext.py	text/plain	30.75 KB	-rw-r--r--	2018-12-23 09:37:14
build_py.py	text/plain	16.76 KB	-rw-r--r--	2018-12-23 09:37:14
build_scripts.py	text/plain	6.09 KB	-rw-r--r--	2018-12-23 09:37:14
check.py	text/plain	5.37 KB	-rw-r--r--	2018-12-23 09:37:14
clean.py	text/plain	2.71 KB	-rw-r--r--	2018-12-23 09:37:14
command_template	text/plain	633 B	-rw-r--r--	2018-12-23 09:37:14
config.py	text/plain	12.78 KB	-rw-r--r--	2018-12-23 09:37:14
install.py	text/plain	26.63 KB	-rw-r--r--	2025-08-26 08:58:55
install_data.py	text/plain	2.76 KB	-rw-r--r--	2018-12-23 09:37:14
install_egg_info.py	text/plain	2.54 KB	-rw-r--r--	2018-12-23 09:37:14
install_headers.py	text/plain	1.27 KB	-rw-r--r--	2018-12-23 09:37:14
install_lib.py	text/plain	8.2 KB	-rw-r--r--	2018-12-23 09:37:14
install_scripts.py	text/plain	1.97 KB	-rw-r--r--	2018-12-23 09:37:14
register.py	text/plain	11.44 KB	-rw-r--r--	2018-12-23 09:37:14
sdist.py	text/plain	17.41 KB	-rw-r--r--	2018-12-23 09:37:14
upload.py	text/plain	7.49 KB	-rw-r--r--	2025-08-26 08:58:55

~ ACUPOFTEA - accounting.gulfstore-gcc.com