What License Is Headroom Distributed Under? Apache 2.0 Explained

Headroom is distributed under the Apache License, Version 2.0, as explicitly declared in the repository's Cargo.toml workspace metadata and the full license text provided in the root LICENSE file.

The chopratejas/headroom repository is an open-source project that makes its licensing terms transparent through standard Rust packaging conventions. Understanding what license Headroom is distributed under is essential for developers integrating the library into commercial or open-source applications, as the Apache 2.0 license permits free use, modification, and distribution with specific attribution requirements.

License Declaration in Source Files

The project maintains dual confirmation of its licensing terms through both legal text and package metadata.

The LICENSE File

The repository root contains a LICENSE file that includes the complete text of the Apache License, Version 2.0. This file serves as the primary legal document governing the distribution and use of the Headroom codebase.

Cargo.toml Workspace Configuration

In the [workspace.package] section of Cargo.toml, the project explicitly sets the SPDX identifier for the license:

[workspace.package]
edition = "2021"
rust-version = "1.80"
license = "Apache-2.0"
repository = "https://github.com/chopratejas/headroom"

This declaration ensures that Rust package management tools such as cargo publish and cargo audit automatically recognize the licensing terms. The license field is propagated to all crates within the workspace, ensuring consistent licensing across the entire project.

Programming Language Bindings

Headroom provides configuration examples for both Rust and Python ecosystems to ensure downstream compliance.

Rust Crate Configuration

When declaring Headroom as a dependency in your Cargo.toml, the license metadata is automatically inherited from the workspace configuration. The license = "Apache-2.0" field in the [workspace.package] section ensures that any crate published from this repository carries the correct SPDX identifier.

Python Extension Setup

For the headroom-py Python extension built with maturin, the license file is referenced in pyproject.toml:

[project]
name = "headroom-py"
version = "0.1.0"
license = { file = "LICENSE" }

This configuration ensures that PyPI and Python package managers display the correct Apache 2.0 licensing information to users installing the extension.

Verifying the License Programmatically

You can inspect the license metadata using Rust's cargo_metadata crate:

use cargo_metadata::MetadataCommand;

fn main() {
    let metadata = MetadataCommand::new()
        .manifest_path("Cargo.toml")
        .exec()
        .expect("Failed to read Cargo metadata");

    for pkg in metadata.packages {
        println!("Package {} is licensed under {}", pkg.name, pkg.license.unwrap_or("unknown"));
    }
}

Running this script against the Headroom workspace outputs Apache-2.0 for each package, confirming the license declaration is properly embedded in the crate metadata.

Summary

• Headroom is distributed under the Apache License, Version 2.0, a permissive open-source license allowing commercial and private use.
• The license is declared in Cargo.toml via license = "Apache-2.0" in the [workspace.package] section and fully documented in the root LICENSE file.
• Additional attribution requirements are specified in the NOTICE file located in the repository root.
• Both Rust's cargo ecosystem and Python's maturin build tools recognize and propagate this license metadata to downstream consumers.

Frequently Asked Questions

Is Headroom open source?

Yes, Headroom is open source. The project is publicly available in the chopratejas/headroom repository and distributed under the Apache License, Version 2.0, which meets the Open Source Initiative's criteria for open-source software.

Can I use Headroom in commercial projects?

Yes. The Apache 2.0 license permits commercial use, modification, and distribution. You must include a copy of the license and preserve any attribution notices found in the NOTICE file, but you are not required to open-source your own derivative works.

Where can I find the full license text for Headroom?

The complete Apache License, Version 2.0 text is located in the LICENSE file at the repository root. You can also view it directly on GitHub at https://github.com/chopratejas/headroom/blob/main/LICENSE.

What is the NOTICE file in the Headroom repository?

The NOTICE file contains additional attribution notices required by the Apache 2.0 license. When redistributing Headroom or derivative works, you must include this file alongside the license to acknowledge the original authors' contributions.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}