{"action":"created","issue":{"url":"https://api.github.com/repos/Pylons/pyramid/issues/1897","labels_url":"https://api.github.com/repos/Pylons/pyramid/issues/1897/labels{/name}","comments_url":"https://api.github.com/repos/Pylons/pyramid/issues/1897/comments","events_url":"https://api.github.com/repos/Pylons/pyramid/issues/1897/events","html_url":"https://github.com/Pylons/pyramid/issues/1897","id":107687905,"number":1897,"title":"Pyramid quick tutorial teaches outdated Python package installation practices","user":{"login":"miohtama","id":49922,"avatar_url":"https://avatars.githubusercontent.com/u/49922?v=3","gravatar_id":"","url":"https://api.github.com/users/miohtama","html_url":"https://github.com/miohtama","followers_url":"https://api.github.com/users/miohtama/followers","following_url":"https://api.github.com/users/miohtama/following{/other_user}","gists_url":"https://api.github.com/users/miohtama/gists{/gist_id}","starred_url":"https://api.github.com/users/miohtama/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/miohtama/subscriptions","organizations_url":"https://api.github.com/users/miohtama/orgs","repos_url":"https://api.github.com/users/miohtama/repos","events_url":"https://api.github.com/users/miohtama/events{/privacy}","received_events_url":"https://api.github.com/users/miohtama/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-09-22T10:41:48Z","updated_at":"2015-09-22T10:49:40Z","closed_at":"2015-09-22T10:49:40Z","body":"Tutorial [here](http://docs.pylonsproject.org/projects/pyramid//en/latest/quick_tutorial/requirements.html) shows practices of\r\n\r\n* Manually setting $VENV environment variable\r\n\r\n* Using  `easy_install` instead of `pip`\r\n\r\nToday there exist an [official and maintained Python package installation guide](https://packaging.python.org/en/latest/installing.html). The preferred package installation method is creating a virtualenv, activating it and then using `pip` to install the package.\r\n\r\nIs there any particular reason why Pyramid tutorial differs from this or is it due to legacy?\r\n\r\nSee confusion e.g. here:\r\n\r\n* http://stackoverflow.com/questions/32710376/unable-to-use-easy-install"},"comment":{"url":"https://api.github.com/repos/Pylons/pyramid/issues/comments/142245079","html_url":"https://github.com/Pylons/pyramid/issues/1897#issuecomment-142245079","issue_url":"https://api.github.com/repos/Pylons/pyramid/issues/1897","id":142245079,"user":{"login":"miohtama","id":49922,"avatar_url":"https://avatars.githubusercontent.com/u/49922?v=3","gravatar_id":"","url":"https://api.github.com/users/miohtama","html_url":"https://github.com/miohtama","followers_url":"https://api.github.com/users/miohtama/followers","following_url":"https://api.github.com/users/miohtama/following{/other_user}","gists_url":"https://api.github.com/users/miohtama/gists{/gist_id}","starred_url":"https://api.github.com/users/miohtama/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/miohtama/subscriptions","organizations_url":"https://api.github.com/users/miohtama/orgs","repos_url":"https://api.github.com/users/miohtama/repos","events_url":"https://api.github.com/users/miohtama/events{/privacy}","received_events_url":"https://api.github.com/users/miohtama/received_events","type":"User","site_admin":false},"created_at":"2015-09-22T10:49:40Z","updated_at":"2015-09-22T10:49:40Z","body":"Ah found the mention at the very end of the page:\r\n\r\n* Why easy_install and not pip? Pyramid encourages use of namespace packages, for which pip's support is less-than-optimal. Also, Pyramid's dependencies use some optional C extensions for performance: with easy_install, Windows users can get these extensions without needing a C compiler (pip does not support installing binary Windows distributions, except for wheels, which are not yet available for all dependencies).\r\n\r\nI'll check if Windows installation have wheels in place yet."}}