Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

package --include-source: the project source archive requires a licenses/ directory that does not exist

Open Beginner friendly
#387 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
85/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
python
Domain
release

Research direction

Start with ReleaseBuildConstants.PROJECT_SOURCE_PATHS in scripts/nvx_tools/build_constants.py and the source-archive flow in scripts/nvx_tools/release.py. Check that every listed path exists, then run python3 scripts/nvx.py package --include-source after collect-sources; done means the package succeeds from a clean checkout and a test catches missing listed paths.

Written by the indexing model from the issue text.

Description

confirmed

Summary

package --include-source cannot succeed from a clean checkout. The project source archive lists a top-level licenses/ path that is not in the repository, and archive creation refuses missing inputs. This is independent of #374. I found it while validating #385 on a bare-metal Linux/KVM host.

Where

Trigger: the documented source-inclusive flow (doc/distribution.md L12-L26): collect-sources, then package --include-source.

Expected: package --include-source creates the project source archive from the repository's project files.

Actual: on prometheus32 (Linux/KVM), at a3d929a plus #385, after a successful collect-sources:

$ python3 scripts/nvx.py package --include-source
!! source-inclusive package omits the Azure Linux guest: collect-sources does not collect its corresponding source
error: cannot create source archive; missing: /home/ppenna/nvx-issue-374/licenses

After I created an empty licenses/ directory in the scratch clone, the same command succeeded and staged all four source archives.

Suggested fix

  • Remove "licenses" from PROJECT_SOURCE_PATHS. LICENSE, THIRD_PARTY_NOTICES.md, and kernel/COPYING-LINUX are already covered.
  • Add a unit test that every PROJECT_SOURCE_PATHS entry exists, preferably as a git-tracked path, so the list cannot drift from the tree again.
Dominant language
Python
Stars
237
Forks
14
Avg merge
13h 18m
Merged PRs (30d)
232

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from microsoft/nvx

All issues in microsoft/nvx

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.