{"action":"created","issue":{"url":"https://api.github.com/repos/pypa/pip/issues/2292","labels_url":"https://api.github.com/repos/pypa/pip/issues/2292/labels{/name}","comments_url":"https://api.github.com/repos/pypa/pip/issues/2292/comments","events_url":"https://api.github.com/repos/pypa/pip/issues/2292/events","html_url":"https://github.com/pypa/pip/issues/2292","id":53162310,"number":2292,"title":"Give a clearer message when an upgrade is needed","user":{"login":"eksperimental","id":9133420,"avatar_url":"https://avatars.githubusercontent.com/u/9133420?v=3","gravatar_id":"","url":"https://api.github.com/users/eksperimental","html_url":"https://github.com/eksperimental","followers_url":"https://api.github.com/users/eksperimental/followers","following_url":"https://api.github.com/users/eksperimental/following{/other_user}","gists_url":"https://api.github.com/users/eksperimental/gists{/gist_id}","starred_url":"https://api.github.com/users/eksperimental/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eksperimental/subscriptions","organizations_url":"https://api.github.com/users/eksperimental/orgs","repos_url":"https://api.github.com/users/eksperimental/repos","events_url":"https://api.github.com/users/eksperimental/events{/privacy}","received_events_url":"https://api.github.com/users/eksperimental/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2014-12-31T01:57:28Z","updated_at":"2015-01-02T17:33:25Z","closed_at":null,"body":"This is the first time I use pip,\r\nso I wanted to install the \"pygments\" package.\r\n\r\nI run:\r\n`sudo pip install pygments`\r\nand I get:\r\n`Requirement already satisfied (use --upgrade to upgrade): pygments in /usr/lib/python2.7/dist-packages`\r\n\r\nso then i run\r\n`sudo pip --upgrade pygments`\r\nand\r\n`sudo pip upgrade pygments`\r\nand both don't work, so I check the help command, and there is no option such as \"upgrade\" listed.\r\nso then I had to end up googling it.\r\nthe fact that install and upgrade usually work as separate commands in most of the command line commands... makes it unclear that --upgrade in an additional option to the command \"install\"\r\n\r\nSo i think it is better to give a clearer message, or create a new command called \"upgrade\"\r\n\r\nsomething like this would have worked for me:\r\n``Requirement already satisfied. Use `pip install pygments --upgrade` to upgrade package:  in /usr/lib/python2.7/dist-packages``\r\n\r\nAgain, this comes using the tool for the first time in my life.\r\nCheers\r\n"},"comment":{"url":"https://api.github.com/repos/pypa/pip/issues/comments/68544809","html_url":"https://github.com/pypa/pip/issues/2292#issuecomment-68544809","issue_url":"https://api.github.com/repos/pypa/pip/issues/2292","id":68544809,"user":{"login":"farvour","id":511702,"avatar_url":"https://avatars.githubusercontent.com/u/511702?v=3","gravatar_id":"","url":"https://api.github.com/users/farvour","html_url":"https://github.com/farvour","followers_url":"https://api.github.com/users/farvour/followers","following_url":"https://api.github.com/users/farvour/following{/other_user}","gists_url":"https://api.github.com/users/farvour/gists{/gist_id}","starred_url":"https://api.github.com/users/farvour/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/farvour/subscriptions","organizations_url":"https://api.github.com/users/farvour/orgs","repos_url":"https://api.github.com/users/farvour/repos","events_url":"https://api.github.com/users/farvour/events{/privacy}","received_events_url":"https://api.github.com/users/farvour/received_events","type":"User","site_admin":false},"created_at":"2015-01-02T17:33:25Z","updated_at":"2015-01-02T17:33:25Z","body":"I'm not really sure it makes a difference since pip will still return a zero exit code, which is what you are looking for to indicate success. The message is just there to indicate that pip isn't going to try and re-install or upgrade the package if all the other requirements of the installed package is satisfied without the `--upgrade` flag."}}