Skip to content

feat(package): add integrated package management and mdBook documentation#5

Merged
KercyDing merged 3 commits intomainfrom
kercy/021
Nov 17, 2025
Merged

feat(package): add integrated package management and mdBook documentation#5
KercyDing merged 3 commits intomainfrom
kercy/021

Conversation

@KercyDing
Copy link
Owner

Description

This PR introduces v0.2.1, adding integrated package management commands and comprehensive mdBook documentation. Users can now manage packages directly through uvup commands after environment activation, and access complete documentation hosted on GitHub Pages.

Changes

All commands require an activated environment and use uv --project internally for location-independent operation:

  • uvup add <packages>: Add packages to active environment

    • Support for --group <name> to add to optional dependency groups
    • Example: uvup add requests numpy or uvup add --group dev pytest black
  • uvup remove <packages>: Remove packages from active environment

    • Support for --group <name> to remove from optional dependency groups
    • Example: uvup remove pandas or uvup remove --group dev pytest
  • uvup lock: Update lockfile of active environment

    • Support for --upgrade flag to upgrade all packages to latest versions
    • Example: uvup lock or uvup lock --upgrade
  • uvup tree: Display dependency tree of active environment

    • Support for --depth <n> to limit display depth
    • Example: uvup tree or uvup tree --depth 2

Checklist

  • I have performed a self-review of my own code.
  • I have added tests that prove my feature works or my fix is effective.
  • I have updated the documentation accordingly.
  • All new and existing tests passed.

Add package management commands that work with activated environments:
- uvup add: add packages to active environment (supports --group)
- uvup remove: remove packages from active environment (supports --group)
- uvup lock: update lockfile of active environment (supports --upgrade)
- uvup tree: display dependency tree of active environment (supports --depth)

All commands use `uv --project` internally, enabling management from any
directory. Added NoActiveEnvironment error type for better error messages
when commands are used without an activated environment.
@KercyDing KercyDing merged commit 84dff65 into main Nov 17, 2025
5 checks passed
@KercyDing KercyDing deleted the kercy/021 branch November 18, 2025 13:35
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.

1 participant