← Back to issue list

Document parallel build count environment variables

View original Github issue

Metadata

Project
craft-application
Number
#540
Type
issue
State
open
Author
mr-cal
Labels
Type: Enhancement Type: Documentation
Created
Updated
Closed
—

Current evaluation

Documentation request to define and explain CRAFT_PARALLEL_BUILD_COUNT and CRAFT_MAX_PARALLEL_BUILD_COUNT; docs/reference/environment-variables.rst still omits them while util/system.py defines precedence.

Suggested action: keep open

Reason: The issue is labelled Type: Documentation and authored by a maintainer; docs/reference/environment-variables.rst still lacks both variables, while craft_application/util/system.py documents their precedence and fixed-vs-CPU-capped behavior, so the requested documentation remains valid and ready to implement.

Evaluated by: mr-cal-bot

Impact: 35 Quick Win: 24 Complexity: 20 Confidence: 90 Actionability: 85

Issue body

### What needs to get done Define and explain `[app.name]CRAFT_PARALLEL_BUILD_COUNT` and `[app.name]CRAFT_MAX_PARALLEL_BUILD_COUNT` in the documentation. ### Why it needs to get done It is not clear how to use these or why both variables exist. Related: - https://github.com/canonical/craft-parts/issues/772 - https://github.com/snapcore/snapcraft/issues/4537

Evaluation history

Date Model Scores Action Summary
~deepseek/deepseek-pro-latest
Impact: 35
Quick Win: 24
Complexity: 20
Confidence: 90
Actionability: 85
keep open Documentation request to define and explain CRAFT_PARALLEL_BUILD_COUNT and CRAFT_MAX_PARALLEL_BUILD_COUNT; docs/reference/environment-variables.rst still omits them while util/system.py defines precedence.
stealth/space-bunny-alpha
Impact: 38
Quick Win: 28
Complexity: 20
Confidence: 96
Actionability: 92
keep open The open documentation reference omits both parallel-build environment variables, leaving their precedence and fixed-versus-CPU-capped behavior unclear.
qwen/qwen3.6-35b-a3b
Impact: 30
Quick Win: 22
Complexity: 10
Confidence: 80
Actionability: 80
keep open Document CRAFT_PARALLEL_BUILD_COUNT and CRAFT_MAX_PARALLEL_BUILD_COUNT environment variables. The code is implemented in craft_application/util/system.py but not documented for users.
qwen/qwen3.8-27b
Impact: 30
Quick Win: 26
Staleness: 55
Complexity: 15
Confidence: 80
Support Request: 5
keep open Docs gap: CRAFT_PARALLEL_BUILD_COUNT and CRAFT_MAX_PARALLEL_BUILD_COUNT (and app-prefixed variants) are implemented in craft_application/util/system.py but not documented. Labeled enhancement/docs by a maintainer, open 679 days, no comments, still unaddressed.
qwen/qwen3.6-35b-a3b
Staleness: 90
Complexity: 15
Confidence: 75
Support Request: 10
needs triage Request to document CRAFT_PARALLEL_BUILD_COUNT and CRAFT_MAX_PARALLEL_BUILD_COUNT environment variables. Unaddressed enhancement for over 17 months with no maintainer comments or triage.
qwen3.6-35b-a3b-mtp-q6
Staleness: 85
Complexity: 15
Confidence: 80
Support Request: 10
needs triage Enhancement to document CRAFT_PARALLEL_BUILD_COUNT and CRAFT_MAX_PARALLEL_BUILD_COUNT environment variables. Currently unaddressed with no maintainer comments or activity for over a year.

Update history

No update history recorded yet.

Related work

  • Related To: snapcore/snapcraft#4537 (confidence 85%)

    Issue body links this; Snapcraft issue was closed after documentation moved to craft-application#540.

  • Related To: canonical/craft-application#180 (confidence 85%)

    Original feature request that introduced parallel build count env vars; closed by PR #191.

  • Related To: canonical/craft-parts#772 (confidence 80%)

    Issue body links this; craft-parts issue discusses parallel_build_count usage and documentation.

Related issues

Issue Project State Summary Similarity
#180 Support setting a parallel build count craft-application closed Parallel build-count controls landed in canonical/craft-application#191 via commit 35b49c8f, adding app/CRAFT fixed settings and CPU-capped maximum settings.
75%
#631 Read `CRAFT_PARALLEL_BUILD_COUNT` craft-parts closed Closed without code changes after parallel build-count configuration was moved upstream; craft-parts no longer needed to read CRAFT_PARALLEL_BUILD_COUNT.
73%
#4537 Document and use the correct parallel build count envvars snapcraft closed Parallel-build documentation moved to canonical/craft-application#540; #4537 was closed without completing the requested Snapcraft documentation, as the maintainer later noted.
73%
#502 Incorrect value for $CRAFT_PARALLEL_BUILD_COUNT in project metadata craft-application closed Fixed project YAML expansion to use the resolved parallel-build count instead of always exposing 1; implemented by PR #517 in commit b508b6c0.
71%