def __init__(self, path, spec, api, extension_names=None, loader=None,
opener=None, local_files=False, omit_khrplatform=False,
header_template=HEADER_TEMPLATE, **options):
self.path = os.path.abspath(path)
self.spec = spec
for a in api:
if a not in self.spec.features:
raise ValueError(
'Unknown API "{0}" for specification "{1}"'
.format(a, self.spec.NAME)
)
self.api = api
self.extension_names = extension_names
self.has_loader = not loader.disabled
self.loader = loader
if self.loader is None:
self.loader = NullLoader
self.opener = opener
if self.opener is None:
self.opener = URLOpener.default()
self.local_files = local_files
self.omit_khrplatform = omit_khrplatform
self.options = options
self._header_template = header_template
def __init__(self, path, spec, api, extension_names=None, loader=None,
opener=None, local_files=False, omit_khrplatform=False,
header_template=HEADER_TEMPLATE):
self.path = os.path.abspath(path)
self.spec = spec
for a in api:
if a not in self.spec.features:
raise ValueError(
'Unknown API "{0}" for specification "{1}"'
.format(a, self.spec.NAME)
)
self.api = api
self.extension_names = extension_names
self.has_loader = not loader.disabled
self.loader = loader
if self.loader is None:
self.loader = NullLoader
self.opener = opener
if self.opener is None:
self.opener = URLOpener.default()
self.local_files = local_files
self.omit_khrplatform = omit_khrplatform
self._header_template = header_template
def __init__(self, path, opener=None):
self.path = os.path.abspath(path)
self.opener = opener
if self.opener is None:
self.opener = URLOpener.default()
self._allowed_chars = string.ascii_letters + string.digits
def __init__(self, path, opener=None):
self.path = os.path.abspath(path)
self.opener = opener
if self.opener is None:
self.opener = URLOpener.default()
self._allowed_chars = string.ascii_letters + string.digits
def from_url(cls, url, opener=None):
if opener is None:
opener = URLOpener.default()
with closing(opener.urlopen(url)) as f:
raw = f.read()
return cls(xml_fromstring(raw))
def from_url(cls, url, opener=None):
if opener is None:
opener = URLOpener.default()
with closing(opener.urlopen(url)) as f:
raw = f.read()
return cls(xml_fromstring(raw))
def __init__(self, path, opener=None, gen_info_factory=None):
self.path = os.path.abspath(path)
self.opener = opener
if self.opener is None:
self.opener = URLOpener.default()
self.gen_info_factory = gen_info_factory or GenerationInfo.create
def __init__(self, path, spec, api, loader=None, opener=None):
self.path = os.path.abspath(path)
self.spec = spec
for a in api:
if a not in self.spec.features:
raise ValueError(
'Unknown API "{0}" for specification "{1}"'
.format(a, self.spec.NAME)
)
self.api = api
self.loader = loader
if self.loader is None:
self.loader = NullLoader
self.opener = opener
if self.opener is None:
self.opener = URLOpener.default()
def main():
import os.path
import argparse
from argparse import ArgumentParser
opener = URLOpener()
def get_spec(value):
if value not in SPECS:
raise argparse.ArgumentTypeError('Unknown specification')
spec_cls = SPECS[value]
if os.path.exists(value + '.xml'):
logger.info('using local specification: \'%s.xml\'', value)
return spec_cls.from_file(value + '.xml')
logger.info('getting \'%s\' specification from SVN', value)
return spec_cls.from_svn(opener=opener)
def ext_file(value):
msg = 'Invalid extensions argument'
if os.path.exists(value):
msg = 'Invalid extensions file'
try:
with open(value, 'r') as f:
return f.read().split()
except IOError:
pass
else:
return [v.strip() for v in value.split(',') if v]
raise argparse.ArgumentTypeError(msg)
def version(value):
if value is None or len(value.strip()) == 0:
return None
v = value
if '.' not in v:
v = '{}.0'.format(v)
try:
return Version(*map(int, v.split('.')))
except ValueError:
pass
raise argparse.ArgumentTypeError('Invalid version: "{}"'.format(value))
def cmdapi(value):
try:
return dict((p[0], version(p[1])) for p in
(list(map(str.strip, e.split('='))) for e in
filter(bool, map(str.strip, value.split(',')))))
except IndexError:
pass
raise argparse.ArgumentTypeError(
'Invalid api-string: "{}"'.format(value)
)
description = __doc__
parser = ArgumentParser(description=description)
parser.add_argument('--profile', dest='profile',
choices=['core', 'compatibility'],
default='compatibility',
help='OpenGL profile (defaults to compatibility)')
parser.add_argument('--out-path', dest='out', required=True,
help='Output path for loader')
parser.add_argument('--api', dest='api', type=cmdapi,
help='API type/version pairs, like "gl=3.2,gles=", '
'no version means latest')
parser.add_argument('--generator', dest='generator', default='d',
choices=['c', 'c-debug', 'd', 'nim', 'pascal', 'volt'], required=True,
help='Language to generate the binding for')
parser.add_argument('--extensions', dest='extensions',
default=None, type=ext_file,
help='Path to extensions file or comma separated '
'list of extensions, if missing '
'all extensions are included')
parser.add_argument('--spec', dest='spec', default='gl',
choices=['gl', 'egl', 'glx', 'wgl'],
help='Name of the spec')
parser.add_argument('--no-loader', dest='no_loader', action='store_true')
parser.add_argument('--omit-khrplatform', dest='omit_khrplatform', action='store_true',
help='Omits inclusion of the khrplatform.h '
'file which is often unnecessary. '
'Only has an effect if used together '
'with c generators.')
parser.add_argument('--local-files', dest='local_files', action='store_true',
help='Forces every file directly into the output '
'directory. No src or include subdirectories '
'are generated. '
'Only has an effect if used together '
'with c generators.')
parser.add_argument('--quiet', dest='quiet', action='store_true')
ns = parser.parse_args()
if not ns.quiet:
logging.basicConfig(
format='[%(asctime)s][%(levelname)s\t][%(name)-7s\t]: %(message)s',
datefmt='%m/%d/%Y %H:%M:%S', level=logging.DEBUG
)
spec = get_spec(ns.spec)
if spec.NAME == 'gl':
spec.profile = ns.profile
api = ns.api
if api is None or len(api.keys()) == 0:
api = {spec.NAME: None}
generator_cls, loader_cls = glad.lang.get_generator(
ns.generator, spec.NAME.lower()
)
if loader_cls is None:
return parser.error('API/Spec not yet supported')
loader = loader_cls(api, disabled=ns.no_loader, local_files=ns.local_files)
logger.info('generating \'%s\' bindings', spec.NAME)
with generator_cls(
ns.out,
spec,
api,
ns.extensions,
loader=loader,
opener=opener,
local_files=ns.local_files,
omit_khrplatform=ns.omit_khrplatform
) as generator:
generator.generate()
logger.info('generating \'%s\' bindings - done', spec.NAME)
def main():
import os.path
import argparse
from argparse import ArgumentParser
opener = URLOpener()
def get_spec(value, reproducible=False):
if value not in SPECS:
raise argparse.ArgumentTypeError('Unknown specification')
spec_cls = SPECS[value]
if reproducible:
logger.info('reproducible build, using packaged specification: \'%s.xml\'', value)
try:
return spec_cls.from_file(glad.files.open_local(value + '.xml'))
except IOError:
raise ValueError('unable to open reproducible copy of {}.xml, '
'try dropping --reproducible'.format(value))
if os.path.exists(value + '.xml'):
logger.info('using local specification: \'%s.xml\'', value)
return spec_cls.from_file(value + '.xml')
logger.info('downloading latest \'%s\' specification', value)
return spec_cls.from_remote(opener=opener)
def ext_file(value):
msg = 'Invalid extensions argument'
if os.path.exists(value):
msg = 'Invalid extensions file'
try:
with open(value, 'r') as f:
return f.read().split()
except IOError:
pass
else:
return [v.strip() for v in value.split(',') if v]
raise argparse.ArgumentTypeError(msg)
def version(value):
if value is None or len(value.strip()) == 0:
return None
v = value
if '.' not in v:
v = '{}.0'.format(v)
try:
return Version(*map(int, v.split('.')))
except ValueError:
pass
raise argparse.ArgumentTypeError('Invalid version: "{}"'.format(value))
def cmdapi(value):
try:
return dict((p[0], version(p[1])) for p in
(list(map(str.strip, e.split('='))) for e in
filter(bool, map(str.strip, value.split(',')))))
except IndexError:
pass
raise argparse.ArgumentTypeError(
'Invalid api-string: "{}"'.format(value)
)
description = __doc__
parser = ArgumentParser(description=description)
parser.add_argument('--profile', dest='profile',
choices=['core', 'compatibility'],
default='compatibility',
help='OpenGL profile (defaults to compatibility)')
parser.add_argument('--out-path', dest='out', required=True,
help='Output path for loader')
parser.add_argument('--api', dest='api', type=cmdapi,
help='API type/version pairs, like "gl=3.2,gles=", '
'no version means latest')
parser.add_argument('--generator', dest='generator', default='d',
choices=['c', 'c-debug', 'd', 'nim', 'pascal', 'volt'], required=True,
help='Language to generate the binding for')
parser.add_argument('--extensions', dest='extensions',
default=None, type=ext_file,
help='Path to extensions file or comma separated '
'list of extensions, if missing '
'all extensions are included')
parser.add_argument('--spec', dest='spec', default='gl',
help='Name of the spec')
parser.add_argument('--reproducible', default=False, action='store_true',
help='Makes the build reproducible by not fetching '
'the latest specification from Khronos')
parser.add_argument('--no-loader', dest='no_loader', action='store_true')
parser.add_argument('--omit-khrplatform', dest='omit_khrplatform', action='store_true',
help='Omits inclusion of the khrplatform.h '
'file which is often unnecessary. '
'Only has an effect if used together '
'with c generators.')
parser.add_argument('--local-files', dest='local_files', action='store_true',
help='Forces every file directly into the output '
'directory. No src or include subdirectories '
'are generated. '
'Only has an effect if used together '
'with c generators.')
parser.add_argument('--quiet', dest='quiet', action='store_true')
ns = parser.parse_args()
if not ns.quiet:
logging.basicConfig(
format='[%(asctime)s][%(levelname)s\t][%(name)-7s\t]: %(message)s',
datefmt='%m/%d/%Y %H:%M:%S', level=logging.DEBUG
)
if ns.omit_khrplatform:
logger.warn('--omit-khrplatform enabled, with recent changes to the specification '
'this is not very well supported by Khronos anymore and may break your build.')
cli_apis = dict(ns.api) if ns.api else dict()
spec_names = set(ns.spec.split(','))
specs = list()
for spec_name in spec_names:
spec = get_spec(spec_name, reproducible=ns.reproducible)
specs.append((spec, pop_apis_for_spec(cli_apis, spec)))
if not len(cli_apis) == 0:
raise ValueError(
'Unknown APIs "{0}" for specifications "{1}".'.format(', '.join(cli_apis.keys()), ', '.join(spec_names))
)
for (spec, apis) in specs:
if spec.NAME == 'gl':
spec.profile = ns.profile
if apis is None or len(apis.keys()) == 0:
apis = {spec.NAME: None}
generator_cls, loader_cls = glad.lang.get_generator(
ns.generator, spec.NAME.lower()
)
if loader_cls is None:
return parser.error('API/Spec not yet supported')
loader = loader_cls(apis, disabled=ns.no_loader, local_files=ns.local_files)
logger.info('generating \'%s\' bindings: %r', spec.NAME, apis)
with generator_cls(
ns.out,
spec,
apis,
ns.extensions,
loader=loader,
opener=opener,
local_files=ns.local_files,
omit_khrplatform=ns.omit_khrplatform,
reproducible=ns.reproducible
) as generator:
generator.generate()
logger.info('generating \'%s\' bindings - done', spec.NAME)
def main(args=None):
from argparse import ArgumentParser
import sys
# Initialize logging as early as possible
if not '--quiet' in (args or sys.argv):
logging.basicConfig(
format='[%(asctime)s][%(levelname)s\t][%(name)-7s\t]: %(message)s',
datefmt='%d.%m.%Y %H:%M:%S',
level=logging.DEBUG)
logging_sink = LoggingSink(logger=logger)
description = __doc__
parser = ArgumentParser(description=description)
global_config = GlobalConfig()
global_config.init_parser(parser)
subparsers = parser.add_subparsers(dest='subparser_name',
description='Generator to use')
subparsers.default = 'c'
configs = dict()
generators = find_generators()
for lang, Generator in generators.items():
config = Generator.Config()
subparser = subparsers.add_parser(lang)
config.init_parser(subparser)
configs[lang] = config
ns = parser.parse_args(args=args)
global_config.update_from_object(ns, convert=False, ignore_additional=True)
config = configs[ns.subparser_name]
config.update_from_object(ns, convert=False, ignore_additional=True)
# This should never throw if Config.init_parser is working correctly
global_config.validate() # Done before, but doesn't hurt
config.validate()
if global_config['REPRODUCIBLE']:
opener = glad.files.StaticFileOpener()
gen_info_factory = lambda *a, **kw: GenerationInfo.create(
when='-', *a, **kw)
else:
opener = URLOpener()
gen_info_factory = GenerationInfo.create
specifications = load_specifications(
[value[0] for value in global_config['API'].values()], opener=opener)
generator = generators[ns.subparser_name](
global_config['OUT_PATH'],
opener=opener,
gen_info_factory=gen_info_factory)
invalid_extensions = set(global_config['EXTENSIONS'] or [])
for specification, apis in apis_by_specification(global_config['API'],
specifications):
for api in apis:
invalid_extensions = invalid_extensions.difference(
specification.extensions[api[0]])
if not len(invalid_extensions) == 0:
message = 'invalid extensions or extensions not present in one of the selected APIs: {}\n' \
.format(', '.join(invalid_extensions))
parser.exit(11, message)
def select(specification, api, info):
logging_sink.info('generating {}:{}/{}={}'.format(
api, info.profile, info.specification, info.version))
extensions = global_config['EXTENSIONS']
if extensions:
extensions = [
ext for ext in extensions
if specification.is_extension(api, ext)
]
return generator.select(specification,
api,
info.version,
info.profile,
extensions,
config,
sink=logging_sink)
for specification, apis in apis_by_specification(global_config['API'],
specifications):
feature_sets = list(
select(specification, api, info) for api, info in apis)
if global_config['MERGE']:
logging_sink.info('merging {}'.format(feature_sets))
feature_sets = [FeatureSet.merge(feature_sets, sink=logging_sink)]
logging_sink.info('merged into {}'.format(feature_sets[0]))
for feature_set in feature_sets:
logging_sink.info('generating feature set {}'.format(feature_set))
generator.generate(specification,
feature_set,
config,
sink=logging_sink)
