mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-09-24 19:40:10 +01:00
This adds a defined Carbon version to the Bazel build and codebase that can be used both to implement features like version checks and to report a meaningful version on the command line. This replaces a hard-coded string and a TODO in the driver. As part of this, it adds support for defining the version in Bazel, and special build flags for overriding relevant parts such as the pre-release marker used. The exact structure and meaning of our version string, including the pre-release parts, is implemented here in line with the draft proposal: https://docs.google.com/document/d/11S5VAPe5Pm_BZPlajWrqDDVr9qc7-7tS2VshqO0wWkk/edit?resourcekey=0-2YFC9Uvl4puuDnWlr2MmYw This also introduces a workspace status command to the repository to extract the git commit SHA and other information when building, and the logic to stamp that into binaries as part of the version string when useful. The technique used leverages weak symbols with whole archive linking to allow a link-time override of unstamped data with stamped data in the leaf executable. This makes building with `--stamp` a reasonable default, especially for development builds. The CI system is explicitly opted out of this as there it has no benefit. Last but not least, all of these are wired into the install rules so that we build installable packages with the version number in a conventional place in the directory and filename. --------- Co-authored-by: Jon Ross-Perkins <jperkins@google.com>
23 lines
862 B
Python
23 lines
862 B
Python
# Part of the Carbon Language project, under the Apache License v2.0 with LLVM
|
|
# Exceptions. See /LICENSE for license information.
|
|
# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
|
|
"""The base version of the Carbon repository.
|
|
|
|
Carbon's version is defined here for export to various layers
|
|
where it is needed. This is not the currently *released* version, but the
|
|
version under *active development*.
|
|
|
|
The current active development version is 0.0.0 -- we haven't yet made enough
|
|
progress towards our 0.1 milestone to meaningfully bump the version to that even
|
|
to describe the development activity. We also never plan to make even a
|
|
non-development pre-release of 0.0.0, only nightly development pre-releases are
|
|
expected.
|
|
|
|
For more details on Carbon's versioning, see:
|
|
https://semver.org/
|
|
TODO: Add Carbon-specific link.
|
|
"""
|
|
|
|
version_base = "0.0.0"
|