# dbx_build_tools
**Repository Path**: mirrors_dropbox/dbx_build_tools
## Basic Information
- **Project Name**: dbx_build_tools
- **Description**: Dropbox's Bazel rules and tools
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-02-14
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# `dbx_build_tools`
`dbx_build_tools` is a collection of Bazel rules and associated tooling to build and test applications deployed to Linux servers.
The build rules support hermetic Python binaries. This includes the ability to use packages from PyPI and link with C libraries built with Bazel’s built-in C/C++ rules. Python binaries include a Python interpreter built with Bazel. The `BUILD` file generator can automatically generate dependencies for Python libraries and binaries, saving you from the drudgery of updating the deps every time you add or remove an import.
We also have Go rules. Our `BUILD` file generator supports generating rules entirely from Go source files on the filesystem.
We also include the tooling to generate a custom build and runtime environment. This isolates the build environment from system tools to make remote caching and execution more reliable. It also isolates your binaries outputs from the host system, making major OS upgrades much simpler.
# Lightning tour
## Install Bazel
Follow the [installation instructions](https://docs.bazel.build/versions/master/install.html) making sure Bazel is on your path.
## Create a new `WORKSPACE`
```console
$ mkdir ~/dbx_build_tools_guide
$ cd ~/dbx_build_tools_guide
$ cat > .bazelrc
build --experimental_strict_action_env
build --platforms @dbx_build_tools//build_tools/cc:linux-x64-drte-off
build --host_platform @dbx_build_tools//build_tools/cc:linux-x64-drte-off
build --sandbox_fake_username
build --modify_execution_info=TestRunner=+block-network
# Work around https://github.com/bazelbuild/bazel/issues/6293 by setting a
# dummy lcov.
coverage --test_env=LCOV_MERGER=/bin/true
$ cat > WORKSPACE
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
# Real use cases should pin a commit and set the sha256.
http_archive(
name = "dbx_build_tools",
urls = ["https://github.com/dropbox/dbx_build_tools/archive/master.tar.gz"],
strip_prefix = "dbx_build_tools-master",
)
load('@dbx_build_tools//build_tools/bazel:external_workspace.bzl', 'drte_deps')
drte_deps()
register_toolchains(
"@dbx_build_tools//thirdparty/cpython:drte-off-39-toolchain",
)
```
## Install `bzl`
```console
$ bazel build @dbx_build_tools//build_tools:bzl
$ sudo cp -rL bazel-bin/external/dbx_build_tools/build_tools/bzl{,.runfiles} /usr/bin/
```
## Create an application
```console
$ mkdir -p python/website
$ cat > python/website/hello.py
import random
def say_hello():
return 'Hello'
$ cat > python/website/main.py
import sys
from wsgiref.simple_server import make_server
from python.website.hello import say_hello
def hello_app(environ, start_response):
start_response('200 OK', [('Content-type', 'text/html')])
return [
'',
say_hello(),
'',
]
def main(port):
server = make_server('localhost', port, hello_app)
server.serve_forever()
if __name__ == '__main__':
main(int(sys.argv[1]))
$ cat > python/website/BUILD.in
load('@dbx_build_tools//build_tools/services:svc.bzl', 'dbx_service_daemon')
dbx_py_library(
name = "hello",
srcs = ["hello.py"],
)
dbx_py_binary(
name = "website",
main = 'main.py',
)
dbx_service_daemon(
name = "website_service",
owner = "web_site_team",
exe = ":website",
args = ['5432'],
http_health_check = 'http://localhost:5432',
)
$ bzl gen //python/website/...
```
## Run an interactive development environment
```console
$ bzl itest-start //python/website:website_service
$ curl http://localhost:5432
Hello
$ bzl itest-stop //python/website:website_service
```
## Write some tests
```console
$ cat > python/website/unit_test.py
from python.website.hello import say_hello
def test_say_hello():
assert say_hello() == 'Hello'
$ cat > python/website/itest.py
try:
from urllib2 import urlopen
except ImportError:
from urllib.request import urlopen
def test_hello():
assert b'Hello' in urlopen('http://localhost:5432').read()
$ cat >> python/website/BUILD.in
dbx_py_pytest_test(
name ='unit_test',
srcs = ['unit_test.py'],
)
dbx_py_pytest_test(
name ='itest',
srcs = ['itest.py'],
services = [":website_service"],
)
$ bzl gen //python/website/...
$ bazel test //python/website/...
INFO: Elapsed time: 46.494s, Critical Path: 40.22s
INFO: 1618 processes: 1578 linux-sandbox, 40 local.
INFO: Build completed successfully, 1825 total actions
//python/website:itest PASSED in 1.3s
//python/website:unit_test PASSED in 1.1s
//python/website:website_service_service_test PASSED in 0.5s
INFO: Build completed successfully, 1825 total actions
```