.TH PIPX\-UPGRADE "1" "April 2021" "" "User Commands"
.SH NAME
pipx upgrade \- upgrade a package
.SH SYNOPSIS
.B pipx upgrade
.RB [ \-h ]
.RB [ \-\-include\-injected ]
.RB [ \-\-force ]
.RB [ \-\-system\-site\-packages ]
.RB [ \-\-index\-url\ \fIINDEX_URL ]
.RB [ \-\-editable ]
.RB [ \-\-pip\-args\ \fIPIP_ARGS ]
.RB [ \-\-verbose ]
.I package
.SH DESCRIPTION
Upgrade a package in a
.BR pipx (1)-managed
virtual environment by running
.B pip\ install\ \-\-upgrade\ \fIPACKAGE
.SH OPTIONS
.SS "POSITIONAL\ ARGUMENTS"
.TP
.I package
Name of the existing
.BR pipx (1)-managed
virtual environment to inject into
.SS "OPTIONAL\ ARGUMENTS"
.TP
.B \-h, \-\-help
Show a help message and exit
.TP
.B \-\-include\-injected
Also upgrade packages injected into the main app\(cqs environment
.TP
.B \-\-force\fR, \fB\-f
Modify existing virtual environment and files in
.I PIPX_BIN_DIR
.TP
.B \-\-system\-site\-packages
Give the virtual environment access to the system site-packages dir.
.TP
.B \-\-index\-url\ \fIINDEX_URL\fR, \fB\-i\ \fIINDEX_URL
Base URL of Python Package Index
.TP
.B \-\-editable\fR, \fB\-e
Install a project in editable mode
.TP
.B \-\-pip\-args\ \fIPIP_ARGS
Arbitrary
.BR pip (1)
arguments to pass directly to
.BR pip\-install (1)/upgrade
commands
.TP
.B \-\-verbose
.SH "SEE\ ALSO"
.BR pip (1),
.BR pip\-install (1)
.P
.BR python (1)
.P
.BR pipx (1),
.BR pipx\-completions (1),
.BR pipx\-ensurepath (1),
.BR pipx\-install (1),
.BR pipx\-inject (1),
.BR pipx\-list (1),
.BR pipx\-reinstall (1),
.BR pipx\-reinstall\-all (1),
.BR pipx\-run (1),
.BR pipx\-runpip (1),
.BR pipx\-uninstall (1),
.BR pipx\-uninstall\-all (1),
.BR pipx\-upgrade\-all (1)