How can I verify my package is the correct version?

Run 'pip show ' and check the 'Location' and 'Version' fields to ensure they point to your local development directory rather than site-packages.

Can I still use extras in my pyproject.toml?

Yes, you should keep extras for documentation and standard use, but for internal CLI installation logic, you should map those extras to direct package names to avoid name resolution issues.

How do I fix a broken installation caused by a name collision?

Uninstall the conflicting package, reinstall your local project in editable mode with 'pip install -e .', and verify the source path using 'pip show [package-name]'.

Why does pip download the wrong package for my local project?

If your local package name matches an existing project on PyPI, using the 'package[extra]' syntax often triggers a remote download that takes priority over your local editable installation.

PyPI Package Collision Fix

Name: PyPI Package Collision Fix
Author: smith6jt-cop

bysmith6jt-cop

Deployment & DevOps

Resolves package name conflicts between local editable installations and existing PyPI projects.

About

This skill provides a specialized workflow for Python developers to prevent and fix silent package installation failures caused by name collisions on PyPI. It addresses the specific issue where 'pip install package[extra]' defaults to downloading external versions rather than utilizing local editable installs. By implementing direct package dependency mapping and providing recovery procedures for broken environments, it ensures that your development environment remains consistent and secure even when using common or placeholder project names.

Key Features

Includes verification scripts using pip show
Maps extras to direct package dependencies
Detects silent PyPI package overwrites
Provides recovery workflows for broken local installs
0 GitHub stars
Standardizes CLI installation commands for local development

Use Cases

Creating CLI tools that install optional dependencies programmatically
Developing a local package with a common name already registered on PyPI
Troubleshooting environment corruption after running pip install on local projects

About

Key Features

Includes verification scripts using pip show
Maps extras to direct package dependencies
Detects silent PyPI package overwrites
Provides recovery workflows for broken local installs
0 GitHub stars
Standardizes CLI installation commands for local development

Use Cases

Creating CLI tools that install optional dependencies programmatically
Developing a local package with a common name already registered on PyPI
Troubleshooting environment corruption after running pip install on local projects