Newer
Older
#!/usr/bin/python3
# flatdeb — build Flatpak runtimes from Debian packages
#
# Copyright © 2016-2017 Simon McVittie
# Copyright © 2017 Collabora Ltd.
#
# Partially derived from vectis, copyright © 2015-2017 Simon McVittie
#
# SPDX-License-Identifier: MIT
#
# 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.
"""
Create Flatpak runtimes from Debian packages.
"""
import argparse
import json
import shutil
from tempfile import TemporaryDirectory
import yaml
from gi.repository import GLib
try:
import typing
except ImportError:
pass
else:
typing # silence "unused" warnings
# TODO: When flatdeb is packaged/released, replace this with the released
# version in packages/releases
VERSION = None
if VERSION is None:
_git_version = subprocess.check_output([
'sh', '-c',
'cd "$(dirname "$1")" && '
'git describe '
'--always '
'--dirty '
'--first-parent '
'--long '
'--tags '
'--match="v[0-9]*" '
'2>/dev/null || :',
'sh',
sys.argv[0],
])[1:].decode('utf-8').strip()
VERSION = _git_version
_DEBOS_BASE_RECIPE = os.path.join(
os.path.dirname(__file__), 'flatdeb', 'debos-base.yaml')
_DEBOS_RUNTIMES_RECIPE = os.path.join(
os.path.dirname(__file__), 'flatdeb', 'debos-runtimes.yaml')
class AptSource:
def __init__(
self,
kind,
uri,
suite,
components=('main',),
trusted=False
):
self.kind = kind
self.uri = uri
self.suite = suite
self.components = components
self.trusted = trusted
@classmethod
def multiple_from_string(
cls,
line,
):
line = line.strip()
tokens = line.split()
if tokens[0] in ('deb', 'deb-src'):
return (cls.from_string(line),)
elif tokens[0] == 'both':
return (
cls.from_string('deb' + line[4:]),
cls.from_string('deb-src' + line[4:]),
)
else:
raise ValueError(
'apt sources must start with "deb ", "deb-src " or "both "')
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
@classmethod
def from_string(
cls,
line,
):
tokens = line.split()
trusted = False
if len(tokens) < 4:
raise ValueError(
'apt sources must be specified in the form '
'"deb http://URL SUITE COMPONENT [COMPONENT...]"')
if tokens[0] not in ('deb', 'deb-src'):
raise ValueError(
'apt sources must start with "deb " or "deb-src "')
if tokens[1] == '[trusted=yes]':
trusted = True
tokens = [tokens[0]] + tokens[2:]
elif tokens[1].startswith('['):
raise ValueError(
'The only apt source option supported is [trusted=yes]')
return cls(
kind=tokens[0],
uri=tokens[1],
suite=tokens[2],
components=tokens[3:],
trusted=trusted,
)
def __str__(self):
if self.trusted:
maybe_options = ' [trusted=yes]'
else:
maybe_options = ''
return '%s%s %s %s %s' % (
self.kind,
maybe_options,
self.uri,
self.suite,
' '.join(self.components),
)
__multiarch_tuple_cache = {} # type: typing.Dict[str, str]
def __init__(self):
#: The Debian suite to use
self.apt_suite = 'stretch'
#: The Flatpak branch to use for the runtime, or None for apt_suite
self.runtime_branch = None
#: The Flatpak branch to use for the app
#: The freedesktop.org cache directory
self.xdg_cache_dir = os.getenv(
'XDG_CACHE_HOME', os.path.expanduser('~/.cache'))
#: Where to write output
self.build_area = os.path.join(
self.xdg_cache_dir, 'flatdeb',
)
self.ostree_repo = os.path.join(self.build_area, 'ostree-repo')
self.__primary_dpkg_arch_matches_cache = {}
self.ostree_mode = 'archive-z2'
self.sources_required = set()
self.strip_source_version_suffix = None
self.apt_keyrings = []
self.apt_sources = []
@staticmethod
def yaml_dump_one_line(data, stream=None):
return yaml.safe_dump(
data,
stream=stream,
default_flow_style=True,
width=0xFFFFFFFF,
).replace('\n', ' ')
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
@staticmethod
def get_flatpak_arch(arch=None):
"""
Return the Flatpak architecture name corresponding to uname
result arch.
If arch is None, return the Flatpak architecture name
corresponding to the machine where this script is running.
"""
if arch is None:
arch = os.uname()[4]
if re.match(r'^i.86$', arch):
return 'i386'
elif re.match(r'^arm.*', arch):
if arch.endswith('b'):
return 'armeb'
else:
return 'arm'
elif arch in ('mips', 'mips64'):
import struct
if struct.pack('i', 1).startswith(b'\x01'):
return arch + 'el'
return arch
@staticmethod
def other_multiarch(arch):
"""
Return the other architecture that accompanies the given Debian
architecture in a multiarch setup, or None.
"""
if arch == 'amd64':
return 'i386'
elif arch == 'arm64':
return 'armhf'
else:
return None
@staticmethod
def multiarch_tuple(arch):
"""
Return the multiarch tuple for the given dpkg architecture name.
"""
if arch not in Builder.__multiarch_tuple_cache:
Builder.__multiarch_tuple_cache[arch] = subprocess.check_output([
'dpkg-architecture',
'-qDEB_HOST_MULTIARCH',
'-a{}'.format(arch),
]).decode('utf-8').strip()
return Builder.__multiarch_tuple_cache[arch]
@staticmethod
def dpkg_to_flatpak_arch(arch):
"""
Return the Flatpak architecture name corresponding to the given
dpkg architecture name.
"""
if arch == 'amd64':
return 'x86_64'
elif arch == 'arm64':
return 'aarch64'
elif arch in ('armel', 'armhf'):
return 'arm'
elif arch == 'powerpc':
return 'ppc'
elif arch == 'powerpc64':
return 'ppc64'
elif arch == 'powerpcel':
return 'ppcle'
elif arch == 'ppc64el':
return 'ppc64le'
return arch
@property
def primary_dpkg_arch(self):
"""
The Debian architecture we are building a runtime for, such as
i386 or amd64.
"""
return self.__dpkg_archs[0]
@property
def dpkg_archs(self):
"""
The Debian architectures we support via multiarch, such as
['amd64', 'i386'].
"""
return self.__dpkg_archs
@dpkg_archs.setter
def dpkg_archs(self, value):
self.__primary_dpkg_arch_matches_cache = {}
self.__dpkg_archs = value
def primary_dpkg_arch_matches(self, arch_spec):
Return True if arch_spec matches primary_dpkg_arch (or
equivalently, if primary_dpkg_arch is one of the architectures
described by arch_spec). For example, any-amd64 matches amd64
but not i386.
"""
if arch_spec not in self.__primary_dpkg_arch_matches_cache:
exit_code = subprocess.call(
['dpkg-architecture', '--host-arch', self.primary_dpkg_arch,
self.__primary_dpkg_arch_matches_cache[arch_spec] = (
exit_code == 0
)
return self.__primary_dpkg_arch_matches_cache[arch_spec]
def run_command_line(self):
"""
Run appropriate commands for the command-line arguments
"""
parser = argparse.ArgumentParser(
description='Build Flatpak runtimes',
)
parser.add_argument('--chdir', default=None)
'--ostree-mode', default=self.ostree_mode,
)
parser.add_argument(
'--export-bundles', action='store_true', default=False,
)
parser.add_argument('--build-area', default=self.build_area)
parser.add_argument('--ostree-repo', default=self.ostree_repo)
parser.add_argument('--suite', '-d', default=self.apt_suite)
parser.add_argument('--architecture', '--arch', '-a')
parser.add_argument('--runtime-branch', default=self.runtime_branch)
parser.add_argument('--version', action='store_true')
parser.add_argument(
'--replace-apt-source', action='append', default=[])
parser.add_argument(
'--remove-apt-source', action='append', default=[])
parser.add_argument(
'--add-apt-source', action='append', default=[])
parser.add_argument(
'--add-apt-keyring', action='append', default=[])
parser.add_argument(
'--generate-sysroot-tarball', action='store_true')
subparsers = parser.add_subparsers(dest='command', metavar='command')
subparser = subparsers.add_parser(
'base',
help='Build a fresh base tarball',
)
subparser = subparsers.add_parser(
'runtimes',
help='Build runtimes',
)
subparser.add_argument('yaml_file')
subparser = subparsers.add_parser(
'app',
help='Build an app',
)
subparser.add_argument('--app-branch', default=self.app_branch)
subparser.add_argument('yaml_manifest')
subparser = subparsers.add_parser(
'print-flatpak-architecture',
help='Print the Flatpak architecture',
)
args = parser.parse_args()
for replacement in args.replace_apt_source:
if '=' not in replacement:
parser.error(
'--replace-apt-source argument must be in the form '
'"LABEL=deb http://ARCHIVE SUITE COMPONENT[...]"')
if args.version:
print('flatdeb {}'.format(VERSION))
return
if args.chdir is not None:
os.chdir(args.chdir)
self.build_area = args.build_area
self.apt_suite = args.suite
self.export_bundles = args.export_bundles
subprocess.check_output(
['dpkg-architecture', '-q', 'DEB_HOST_ARCH'],
).decode('utf-8').rstrip('\n')
]
self.dpkg_archs = args.architecture.split(',')
self.flatpak_arch = self.dpkg_to_flatpak_arch(self.primary_dpkg_arch)
self.ensure_build_area()
os.makedirs(os.path.dirname(self.ostree_repo), exist_ok=True)
if args.command is None:
parser.error('A command is required')
with open(
os.path.join('suites', self.apt_suite + '.yaml'),
encoding='utf-8') as reader:
self.strip_source_version_suffix = self.suite_details.get(
'strip_source_version_suffix', '')
for source in self.suite_details['sources']:
keyring = source.get('keyring')
if keyring is not None:
self.apt_keyrings.append(keyring)
uri = source['apt_uri']
suite = source.get('apt_suite', self.apt_suite)
suite = suite.replace('*', self.apt_suite)
components = source.get(
'apt_components',
self.suite_details.get('apt_components', ['main'])
)
trusted = source.get('apt_trusted', False)
if 'label' in source:
replaced = False
for replacement in reversed(args.replace_apt_source):
key, value = replacement.split('=', 1)
if key == source['label']:
self.apt_sources.extend(
AptSource.multiple_from_string(value))
replaced = True
break
if replaced or source['label'] in args.remove_apt_source:
continue
if source.get('deb', True):
self.apt_sources.append(AptSource(
'deb', uri, suite,
components=components,
trusted=trusted,
))
if source.get('deb-src', True):
self.apt_sources.append(AptSource(
'deb-src', uri, suite,
components=components,
trusted=trusted,
))
for addition in args.add_apt_source:
self.apt_sources.extend(AptSource.multiple_from_string(addition))
for addition in args.add_apt_keyring:
self.apt_keyrings.append(addition)
if self.apt_sources[0].kind != 'deb':
parser.error('First apt source must provide .deb packages')
getattr(
self, 'command_' + args.command.replace('-', '_'))(**vars(args))
def command_print_flatpak_architecture(self, **kwargs):
print(self.flatpak_arch)
@property
def apt_uris(self):
for source in self.apt_sources:
yield source.uri
def ensure_build_area(self):
os.makedirs(self.xdg_cache_dir, 0o700, exist_ok=True)
os.makedirs(self.build_area, 0o755, exist_ok=True)
os.makedirs(os.path.join(self.build_area, 'tmp'), exist_ok=True)
def command_base(self, **kwargs):
with ExitStack() as stack:
scratch = stack.enter_context(
TemporaryDirectory(prefix='flatdeb.')
)
self.ensure_build_area()
# debootstrap only supports one suite, so we use the first
apt_suite = self.apt_sources[0].suite
dest_recipe = os.path.join(scratch, 'flatdeb.yaml')
shutil.copyfile(_DEBOS_BASE_RECIPE, dest_recipe)
for helper in (
'add-foreign-architectures',
'clean-up-base',
'clean-up-before-pack',
'disable-services',
'usrmerge',
dest = os.path.join(scratch, helper)
shutil.copyfile(
os.path.join(
os.path.dirname(__file__),
'flatdeb',
helper,
),
dest,
)
os.chmod(dest, 0o755)
os.makedirs(
os.path.join(
scratch, 'suites', apt_suite, 'overlay', 'etc',
'apt', 'trusted.gpg.d',
0o755,
exist_ok=True,
)
tarball = 'base-{}-{}.tar.gz'.format(
self.apt_suite,
','.join(self.dpkg_archs),
)
output = os.path.join(self.build_area, tarball)
script = self.suite_details.get('debootstrap_script')
if script is not None:
# TODO: flatdeb has historically used a configurable
# debootstrap_script, but debos doesn't support scripts other
# than 'unstable'. Does the Debian script work for precise and
# produce the same results as the 'precise' script?
# https://github.com/go-debos/debos/issues/16
logger.debug(
'Ignoring /usr/share/debootstrap/scripts/%s', script)
os.path.join(scratch, 'suites', apt_suite, 'overlay'))
argv = [
'debos',
'--artifactdir={}'.format(self.build_area),
'-t', 'architecture:{}'.format(self.primary_dpkg_arch),
'-t', 'suite:{}'.format(apt_suite),
'-t', 'mirror:{}'.format(
self.apt_sources[0].uri,
),
'-t', 'ospack:{}'.format(tarball + '.new'),
'-t', 'manifest_prefix:base-{}-{}'.format(
self.apt_suite,
','.join(self.dpkg_archs),
),
'-t', 'foreignarchs:{}'.format(
' '.join(self.dpkg_archs[1:]),
),
'-t', 'mergedusr:{}'.format(
str(
self.suite_details.get('can_merge_usr', False),
).lower(),
),
]
for keyring in self.apt_keyrings:
if os.path.exists(os.path.join('suites', keyring)):
keyring = os.path.join('suites', keyring)
elif os.path.exists(keyring):
pass
else:
raise RuntimeError('Cannot open {}'.format(keyring))
dest = os.path.join(
scratch, 'suites', apt_suite, 'overlay',
'etc', 'apt', 'trusted.gpg.d',
shutil.copyfile(keyring, dest)
argv.append('-t')
argv.append(
'keyring:suites/{}/overlay/etc/apt/trusted.gpg.d/'
'{}'.format(
apt_suite,
os.path.basename(keyring),
)
)
# debootstrap only supports one keyring and one apt source,
# so we take the first one
break
components = self.apt_sources[0].components
if components:
argv.append('-t')
argv.append('components:{}'.format(
self.yaml_dump_one_line(components)))
subprocess.check_call(argv)
os.makedirs(os.path.dirname(self.ostree_repo), 0o755, exist_ok=True)
subprocess.check_call([
'init',
'--mode={}'.format(self.ostree_mode),
def command_runtimes(
self,
*,
yaml_file,
generate_sysroot_tarball=False,
**kwargs
):
if self.runtime_branch is None:
self.runtime_branch = self.apt_suite
with open(yaml_file, encoding='utf-8') as reader:
self.runtime_details = yaml.safe_load(reader)
tarball = 'base-{}-{}.tar.gz'.format(
self.apt_suite,
','.join(self.dpkg_archs),
scratch = stack.enter_context(
TemporaryDirectory(prefix='flatdeb.')
)
self.ensure_build_area()
dest_recipe = os.path.join(scratch, 'flatdeb.yaml')
shutil.copyfile(_DEBOS_RUNTIMES_RECIPE, dest_recipe)
'clean-up-before-pack',
'collect-source-code',
'disable-services',
'make-flatpak-friendly',
'platformize',
'prepare-runtime',
'symlink-alternatives',
dest = os.path.join(scratch, helper)
shutil.copyfile(
os.path.join(
os.path.dirname(__file__),
'flatdeb',
helper,
),
dest,
)
os.chmod(dest, 0o755)
prefix = self.runtime_details['id_prefix']
# Do the Platform first, because we download its source
# packages as part of preparing the Sdk
for sdk in (False, True):
packages = list(self.runtime_details.get('add_packages', []))
for p in self.runtime_details.get(
'add_packages_multiarch', []
):
for a in self.dpkg_archs:
packages.append(p + ':' + a)
if sdk:
runtime = prefix + '.Sdk'
else:
runtime = prefix + '.Platform'
ostree_prefix = '{}-ostree-{}-{}'.format(
out_tarball = ostree_prefix + '.tar.gz'
argv = [
'debos',
'--artifactdir={}'.format(self.build_area),
'--scratchsize=8G',
'-t', 'architecture:{}'.format(self.primary_dpkg_arch),
'-t', 'flatpak_arch:{}'.format(self.flatpak_arch),
'-t', 'suite:{}'.format(self.apt_suite),
'-t', 'ospack:{}'.format(tarball),
'-t', 'ostree_prefix:{}'.format(ostree_prefix),
'-t', 'ostree_tarball:{}'.format(out_tarball + '.new'),
'-t', 'runtime:{}'.format(runtime),
'-t', 'runtime_branch:{}'.format(self.runtime_branch),
'-t', 'strip_source_version_suffix:{}'.format(
self.strip_source_version_suffix),
]
if packages:
logger.info('Installing packages:')
packages.sort()
for p in packages:
logger.info('- %s', p)
argv.append('-t')
argv.append('packages:{}'.format(
self.yaml_dump_one_line(packages)))
dest = os.path.join(scratch, 'runtimes', runtime)
os.makedirs(dest, 0o755, exist_ok=True)
dest = os.path.join(dest, 'packages.yaml')
with open(dest, 'w', encoding='utf-8') as writer:
yaml.safe_dump(packages, stream=writer)
script = self.runtime_details.get('post_script', '')
if script:
dest = os.path.join(scratch, 'post_script')
with open(dest, 'w', encoding='utf-8') as writer:
writer.write('#!/bin/sh\n')
writer.write(script)
writer.write('\n')
os.chmod(dest, 0o755)
argv.append('-t')
argv.append('post_script:post_script')
if sdk:
sources_prefix = '{}-sources-{}-{}'.format(
sources_tarball = sources_prefix + '.tar.gz'
debug_prefix = '{}-debug-{}-{}'.format(
runtime,
','.join(self.dpkg_archs),
self.runtime_branch,
)
debug_tarball = debug_prefix + '.tar.gz'
if generate_sysroot_tarball:
sysroot_prefix = '{}-sysroot-{}-{}'.format(
runtime,
','.join(self.dpkg_archs),
self.runtime_branch,
)
sysroot_tarball = sysroot_prefix + '.tar.gz'
argv.append('-t')
argv.append('sysroot_prefix:{}'.format(sysroot_prefix))
argv.append('-t')
argv.append(
'sysroot_tarball:{}'.format(
sysroot_tarball + '.new'))
else:
sysroot_prefix = None
sysroot_tarball = None
sdk_details = self.runtime_details.get('sdk', {})
sdk_packages = list(sdk_details.get('add_packages', []))
argv.append('-t')
argv.append('sdk:yes')
argv.append('-t')
argv.append('debug_tarball:' + debug_tarball + '.new')
argv.append('-t')
argv.append('debug_prefix:' + debug_prefix)
argv.append('-t')
argv.append('sources_tarball:' + sources_tarball + '.new')
argv.append('-t')
argv.append('sources_prefix:' + sources_prefix)
for p in sdk_details.get('add_packages_multiarch', []):
for a in self.dpkg_archs:
sdk_packages.append(p + ':' + a)
if sdk_packages:
logger.info('Installing extra packages for SDK:')
sdk_packages.sort()
for p in sdk_packages:
logger.info('- %s', p)
argv.append('-t')
argv.append(
'sdk_packages:{}'.format(
self.yaml_dump_one_line(sdk_packages)))
dest = os.path.join(scratch, 'runtimes', runtime)
os.makedirs(dest, 0o755, exist_ok=True)
dest = os.path.join(dest, 'sdk_packages.yaml')
with open(dest, 'w', encoding='utf-8') as writer:
yaml.safe_dump(sdk_packages, stream=writer)
script = sdk_details.get('post_script', '')
if script:
dest = os.path.join(scratch, 'sdk_post_script')
with open(dest, 'w', encoding='utf-8') as writer:
writer.write('#!/bin/sh\n')
writer.write(script)
writer.write('\n')
os.chmod(dest, 0o755)
argv.append('-t')
argv.append('sdk_post_script:sdk_post_script')
else: # not sdk
platform_details = self.runtime_details.get('platform', {})
script = platform_details.get('post_script', '')
if script:
dest = os.path.join(scratch, 'platform_post_script')
with open(dest, 'w', encoding='utf-8') as writer:
writer.write('#!/bin/sh\n')
writer.write(script)
writer.write('\n')
os.chmod(dest, 0o755)
argv.append('-t')
argv.append(
'platform_post_script:platform_post_script')
overlay = os.path.join(scratch, 'runtimes', runtime, 'overlay')
self.create_flatpak_manifest_overlay(
overlay, prefix, runtime, sdk=sdk)
subprocess.check_call(argv)
if sysroot_prefix is not None:
assert sysroot_tarball is not None
output = os.path.join(self.build_area, sysroot_tarball)
os.rename(output + '.new', output)
output = os.path.join(
self.build_area, sysroot_prefix + '.Dockerfile')
with open(
os.path.join(
os.path.dirname(__file__), 'flatdeb',
'Dockerfile.in'),
'r',
encoding='utf-8',
) as reader:
content = reader.read()
content = content.replace(
'@sysroot_tarball@', sysroot_tarball)
with open(
output + '.new', 'w', encoding='utf-8'
) as writer:
writer.write(content)
os.rename(output + '.new', output)
output = os.path.join(self.build_area, debug_tarball)
logger.info('Committing %s to OSTree', debug_tarball)
os.rename(output + '.new', output)
subprocess.check_call([
'time',
'ostree',
'--repo=' + self.ostree_repo,
'commit',
'--branch=runtime/{}.Debug/{}/{}'.format(
runtime,
self.flatpak_arch,
self.runtime_branch,
),
'--subject=Update',
'--tree=tar={}'.format(output),
'--fsync=false',
'--tar-autocreate-parents',
])
logger.info('Committing %s to OSTree', sources_tarball)
output = os.path.join(self.build_area, sources_tarball)
os.rename(output + '.new', output)
subprocess.check_call([
'time',
'ostree',
'commit',
'--branch=runtime/{}.Sources/{}/{}'.format(
runtime,
self.flatpak_arch,
self.runtime_branch,
),
'--subject=Update',
'--tree=tar={}'.format(output),
'--fsync=false',
'--tar-autocreate-parents',
])
output = os.path.join(self.build_area, out_tarball)
logger.info('Committing %s to OSTree', out_tarball)
subprocess.check_call([
'time',
'ostree',
'commit',
'--branch=runtime/{}/{}/{}'.format(
runtime,
self.flatpak_arch,
self.runtime_branch,
),
'--subject=Update',
'--tree=tar={}'.format(output),
'--fsync=false',
'--tar-autocreate-parents',
])
# Don't keep the history in this working repository:
# if history is desired, mirror the commits into a public
# repository and maintain history there.
subprocess.check_call([
'prune',
'--refs-only',
'--depth=1',
])
subprocess.check_call([
if self.export_bundles:
for suffix in ('.Platform', '.Sdk'):
bundle = '{}-{}-{}.bundle'.format(
prefix + suffix,
self.runtime_branch,
)
output = os.path.join(self.build_area, bundle)
subprocess.check_call([
'time',
'flatpak',
'build-bundle',
'--runtime',
"""
Configure apt. We only do this once, so that all chroots
created from the same base have their version numbers