pipx Agent Skills & AI Rules

# Introduction

`primary_packages.txt` is the master list, containing all packages
installed or injected in the pipx tests `tests`.  Platform-specific list files
listing both these primary packages and their dependencies are generated from
it.  These platform-specific list files are used to populate the directory
`.pipx_tests/package_cache`.

# Generating the platform-specific lists from the master list

Using the Github Workflow
* Make sure that the file in this directory `primary_packages.txt` is up to date for every package & version that is installed or injected in the tests.
* Manually activate the Github workflow: Create tests package lists for offline tests
* Download each `lists-<os>-<python>` artifact and put the files from it into this directory.

Or to locally generate these lists, on the target platform execute:
* `python scripts/list_test_packages.py testdata/tests_packages/primary_packages.txt testdata/tests_packages`

# Updating / Populating the directory `.pipx_tests/package_cache` before running the tests
Pre-populating this directory allows the pipx `tests` to run completely offline.

Execute from the top-level pipx repo directory:
* `mkdir -p .pipx_tests/package_cache`
* `python3 scripts/update_package_cache.py testdata/tests_packages .pipx_tests/package_cache`