Skip to content

fix: complete the distros foo.spec example#49

Closed
henryiii wants to merge 4 commits into
mainfrom
fix/examples-distros-spec
Closed

fix: complete the distros foo.spec example#49
henryiii wants to merge 4 commits into
mainfrom
fix/examples-distros-spec

Conversation

@henryiii

@henryiii henryiii commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

🤖 AI text below 🤖

examples/5_04_distros/foo.spec was a hollow stub (just a preamble and an empty %files) while the chapter and slides walk through a full spec, so it had drifted.

  • Flesh out foo.spec into the complete spec taught by the chapter/slides: %prep, %generate_buildrequires, %build, %install, %check, %files -f %{pyproject_files}, plus the required BuildRequires: python3-devel.
  • Matches the spec as corrected by docs: fix code snippets that fail when run #46, i.e. %pyproject_buildrequires -x test so pytest is available for %check.
  • Now that docs: fix code snippets that fail when run #46 is merged, content/other-tools/04_distros.md literalincludes foo.spec instead of carrying an inline copy, so the two cannot drift again. The Marp deck keeps its (identical) inline copy since Marp has no include mechanism.
  • Static validation only (rpmbuild/mock unavailable on macOS; rpmlint cannot load librpm there), checked against the Fedora Python packaging guidelines. Verified the built chapter HTML renders the included spec.

henryiii added 4 commits July 13, 2026 00:13
The example spec was a hollow stub with only a preamble and an empty
%files section, while the chapter and slides walk through a full spec.
Flesh it out to match the walked-through spec, including the
%pyproject_buildrequires -x test fix from PR #46 so pytest is present
in the buildroot for %check.

Assisted-by: ClaudeCode:claude-opus-4-8
The example spec was a hollow stub with only a preamble and an empty
%files section, while the chapter and slides walk through a full spec.
Flesh it out to match the walked-through spec, including the
%pyproject_buildrequires -x test fix from PR #46 so pytest is present
in the buildroot for %check.

Assisted-by: ClaudeCode:claude-opus-4-8
Now that #46 is merged, the chapter can include the example spec
directly instead of carrying an inline copy, so the two cannot drift
again. The Marp deck keeps its inline copy (no include mechanism).

Assisted-by: ClaudeCode:claude-opus-4-8
@henryiii henryiii requested a review from LecrisUT July 13, 2026 05:24
@LecrisUT

Copy link
Copy Markdown
Collaborator

The difference is intentional. That example is a no-op version that they can start building on top of it. Would probably add this one alongside

@henryiii

Copy link
Copy Markdown
Contributor Author

Ah, okay.

@henryiii henryiii closed this Jul 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants