← Back to issue list

Snapcraft complain on a non-executable hook named `README.md`

View original Launchpad issue

Metadata

Project
snapcraft (launchpad)
Number
#1792078
Type
issue
State
open
Author
~brlin
Labels
—
Created
Updated
Closed
—

Current evaluation

Snapcraft rejects a documentation-only snap/hooks/README.md; maintainers attributed the failure to snap check and proposed exempting non-executable README files, but no fix is recorded.

Suggested action: keep open

Reason: Maintainer chipaca confirmed that snapd is picky about snap/hooks contents and explicitly proposed making Snapcraft ignore non-executable README files, so this remains a valid scoped enhancement despite its age. The exact command path still needs implementation investigation because snap check produced no current source-code match.

Evaluated by: mr-cal-bot

Impact: 42 Quick Win: 17 Complexity: 38 Confidence: 85 Actionability: 65

Issue body

Error message: ``` Determining the version from the project repo (version-script). The version has been set to '2.8.1-d+pkg-8c01' hook 'README.md' is not executable Build failed ``` This causes trouble on documenting the sub-dirs under /snap[1]. Since according to [Supported snap hooks - doc - snapcraft.io](https://forum.snapcraft.io/t/supported-snap-hooks/3795) snapcraft requires hooks to be named to certain keywords it shouldn't care about files that aren't named that way. [1] https://github.com/Lin-Buo-Ren/snapcrafters-template-plus/tree/master/snap/hooks

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 42
Quick Win: 17
Complexity: 38
Confidence: 85
Actionability: 65
keep open Snapcraft rejects a documentation-only snap/hooks/README.md; maintainers attributed the failure to snap check and proposed exempting non-executable README files, but no fix is recorded.
stealth/space-bunny-alpha
Impact: 32
Quick Win: 20
Complexity: 25
Confidence: 88
Actionability: 82
keep open Snapcraft rejects a non-executable README.md used to document snap/hooks. Maintainers confirmed snap check/snapd as the source and discussed exempting README files; no resolution is recorded.
qwen/qwen3.6-35b-a3b
Impact: 30
Quick Win: 15
Complexity: 30
Confidence: 60
Actionability: 70
keep open Snapcraft treats all files in snap/hooks as hooks and complains when they're not executable, even if they're not valid hook names like README.md.
qwen/qwen3.8-27b
Impact: 35
Quick Win: 24
Staleness: 90
Complexity: 30
Confidence: 55
Support Request: 15
needs triage Snapcraft build fails when snap/hooks/ contains a non-executable README.md used to document sub-dirs; reporter argues only known hook names should be validated. Open ~8 years, zero comments, no labels or maintainer engagement.
qwen/qwen3.6-35b-a3b
Staleness: 98
Complexity: 20
Confidence: 85
Support Request: 10
close stale Snapcraft incorrectly flags a non-executable README.md file as a hook, causing build failures. Issue remains open with no maintainer response or labels after nearly 8 years.
qwen/qwen3.6-35b-a3b
Staleness: 95
Complexity: 30
Confidence: 85
Support Request: 10
close stale Snapcraft incorrectly flags non-executable files like README.md in the hooks directory as invalid hooks. The issue lacks labels, has zero comments, and has been inactive for nearly eight years.
qwen3.6-35b-a3b-mtp-q6
Staleness: 98
Complexity: 20
Confidence: 80
Support Request: 10
close stale Snapcraft incorrectly flags a non-executable README.md in the snap/hooks directory as a required executable hook. Open for ~7.8 years with no maintainer response or activity for ~5.8 years.

Update history

Date Change
created

Related work

  • Related To: snapcraft (launchpad)#1812003 (confidence 95%)

    Explicitly cited as related; that resolved issue made recognized hooks executable rather than exempting non-hook documentation files.

  • Duplicate Of: snapcraft (launchpad)#1845276 (confidence 88%)

    Open report requests allowing README.md under snap/ without unsupported-file warnings and has essentially the same documentation-file use case.

Related issues

Issue Project State Summary Similarity
#1845276 snapcraft shouldn't complain about snap/README.md snapcraft (launchpad) open Snapcraft’s current snap-directory allowlist still rejects snap/README.md; the long-open request remains untriaged and has no maintainer feedback.
79%