{"action":"created","comment":{"url":"https://api.github.com/repos/numpy/numpy/pulls/comments/23257061","id":23257061,"diff_hunk":"@@ -0,0 +1,152 @@\n+.. _development-environment:\n+\n+Setting up and using your development environment\n+=================================================\n+\n+\n+Recommended development setup\n+-----------------------------\n+\n+Since NumPy contains parts written in C and Cython that need to be\n+compiled before use, make sure you have the necessary compilers and Python\n+development headers installed - see :ref:`building-from-source`.\n+\n+Having compiled code also means that importing Numpy from the development\n+sources needs some additional steps, which are explained below.  For the rest\n+of this chapter we assume that you have set up your git repo as described in\n+:ref:`using-git`.\n+\n+To build the development version of NumPy and run tests, spawn\n+interactive shells with the Python import paths properly set up etc.,\n+do one of::\n+\n+    $ python runtests.py -v\n+    $ python runtests.py -v -s random\n+    $ python runtests.py -v -t numpy/core/tests/test_iter.py:test_iter_c_order\n+    $ python runtests.py --ipython\n+    $ python runtests.py --python somescript.py\n+    $ python runtests.py --bench\n+    $ python runtests.py -g -m full\n+\n+This builds Numpy first, so the first time it may take a few minutes.  If\n+you specify ``-n``, the tests are run against the version of NumPy (if\n+any) found on current PYTHONPATH.\n+\n+Using ``runtests.py`` is the recommended approach to running tests.\n+There are also a number of alternatives to it, for example in-place\n+build or installing to a virtualenv. See the FAQ below for details.\n+\n+\n+Building in-place\n+-----------------\n+\n+For development, you can set up an in-place build so that changes made to\n+``.py`` files have effect without rebuild. First, run::\n+\n+    $ python setup.py build_ext -i","path":"doc/source/dev/development_environment.rst","position":46,"original_position":46,"commit_id":"1b49bc5ad5cc454d628ba4eb36ff231c5f1f177b","original_commit_id":"1b49bc5ad5cc454d628ba4eb36ff231c5f1f177b","user":{"login":"juliantaylor","id":542663,"avatar_url":"https://avatars.githubusercontent.com/u/542663?v=3","gravatar_id":"","url":"https://api.github.com/users/juliantaylor","html_url":"https://github.com/juliantaylor","followers_url":"https://api.github.com/users/juliantaylor/followers","following_url":"https://api.github.com/users/juliantaylor/following{/other_user}","gists_url":"https://api.github.com/users/juliantaylor/gists{/gist_id}","starred_url":"https://api.github.com/users/juliantaylor/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/juliantaylor/subscriptions","organizations_url":"https://api.github.com/users/juliantaylor/orgs","repos_url":"https://api.github.com/users/juliantaylor/repos","events_url":"https://api.github.com/users/juliantaylor/events{/privacy}","received_events_url":"https://api.github.com/users/juliantaylor/received_events","type":"User","site_admin":false},"body":"oh you already mention it a few paragraphs down, nevermind then ;)","created_at":"2015-01-20T21:22:57Z","updated_at":"2015-01-20T21:22:57Z","html_url":"https://github.com/numpy/numpy/pull/5473#discussion_r23257061","pull_request_url":"https://api.github.com/repos/numpy/numpy/pulls/5473","_links":{"self":{"href":"https://api.github.com/repos/numpy/numpy/pulls/comments/23257061"},"html":{"href":"https://github.com/numpy/numpy/pull/5473#discussion_r23257061"},"pull_request":{"href":"https://api.github.com/repos/numpy/numpy/pulls/5473"}}},"pull_request":{"url":"https://api.github.com/repos/numpy/numpy/pulls/5473","id":27713125,"html_url":"https://github.com/numpy/numpy/pull/5473","diff_url":"https://github.com/numpy/numpy/pull/5473.diff","patch_url":"https://github.com/numpy/numpy/pull/5473.patch","issue_url":"https://api.github.com/repos/numpy/numpy/issues/5473","number":5473,"state":"open","locked":false,"title":"DOC: update build instructions, add developer docs","user":{"login":"rgommers","id":98330,"avatar_url":"https://avatars.githubusercontent.com/u/98330?v=3","gravatar_id":"","url":"https://api.github.com/users/rgommers","html_url":"https://github.com/rgommers","followers_url":"https://api.github.com/users/rgommers/followers","following_url":"https://api.github.com/users/rgommers/following{/other_user}","gists_url":"https://api.github.com/users/rgommers/gists{/gist_id}","starred_url":"https://api.github.com/users/rgommers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rgommers/subscriptions","organizations_url":"https://api.github.com/users/rgommers/orgs","repos_url":"https://api.github.com/users/rgommers/repos","events_url":"https://api.github.com/users/rgommers/events{/privacy}","received_events_url":"https://api.github.com/users/rgommers/received_events","type":"User","site_admin":false},"body":"Closes gh-5465, and hopefully helps people get started developing on numpy itself a bit smoother.","created_at":"2015-01-20T21:18:55Z","updated_at":"2015-01-20T21:22:57Z","closed_at":null,"merged_at":null,"merge_commit_sha":"e89e5d306841fec19fe1fa934934f23ca05b6c18","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/numpy/numpy/pulls/5473/commits","review_comments_url":"https://api.github.com/repos/numpy/numpy/pulls/5473/comments","review_comment_url":"https://api.github.com/repos/numpy/numpy/pulls/comments/{number}","comments_url":"https://api.github.com/repos/numpy/numpy/issues/5473/comments","statuses_url":"https://api.github.com/repos/numpy/numpy/statuses/1b49bc5ad5cc454d628ba4eb36ff231c5f1f177b","head":{"label":"rgommers:doc-inplace-build","ref":"doc-inplace-build","sha":"1b49bc5ad5cc454d628ba4eb36ff231c5f1f177b","user":{"login":"rgommers","id":98330,"avatar_url":"https://avatars.githubusercontent.com/u/98330?v=3","gravatar_id":"","url":"https://api.github.com/users/rgommers","html_url":"https://github.com/rgommers","followers_url":"https://api.github.com/users/rgommers/followers","following_url":"https://api.github.com/users/rgommers/following{/other_user}","gists_url":"https://api.github.com/users/rgommers/gists{/gist_id}","starred_url":"https://api.github.com/users/rgommers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rgommers/subscriptions","organizations_url":"https://api.github.com/users/rgommers/orgs","repos_url":"https://api.github.com/users/rgommers/repos","events_url":"https://api.github.com/users/rgommers/events{/privacy}","received_events_url":"https://api.github.com/users/rgommers/received_events","type":"User","site_admin":false},"repo":{"id":915473,"name":"numpy","full_name":"rgommers/numpy","owner":{"login":"rgommers","id":98330,"avatar_url":"https://avatars.githubusercontent.com/u/98330?v=3","gravatar_id":"","url":"https://api.github.com/users/rgommers","html_url":"https://github.com/rgommers","followers_url":"https://api.github.com/users/rgommers/followers","following_url":"https://api.github.com/users/rgommers/following{/other_user}","gists_url":"https://api.github.com/users/rgommers/gists{/gist_id}","starred_url":"https://api.github.com/users/rgommers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rgommers/subscriptions","organizations_url":"https://api.github.com/users/rgommers/orgs","repos_url":"https://api.github.com/users/rgommers/repos","events_url":"https://api.github.com/users/rgommers/events{/privacy}","received_events_url":"https://api.github.com/users/rgommers/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/rgommers/numpy","description":"Numpy main repository","fork":true,"url":"https://api.github.com/repos/rgommers/numpy","forks_url":"https://api.github.com/repos/rgommers/numpy/forks","keys_url":"https://api.github.com/repos/rgommers/numpy/keys{/key_id}","collaborators_url":"https://api.github.com/repos/rgommers/numpy/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/rgommers/numpy/teams","hooks_url":"https://api.github.com/repos/rgommers/numpy/hooks","issue_events_url":"https://api.github.com/repos/rgommers/numpy/issues/events{/number}","events_url":"https://api.github.com/repos/rgommers/numpy/events","assignees_url":"https://api.github.com/repos/rgommers/numpy/assignees{/user}","branches_url":"https://api.github.com/repos/rgommers/numpy/branches{/branch}","tags_url":"https://api.github.com/repos/rgommers/numpy/tags","blobs_url":"https://api.github.com/repos/rgommers/numpy/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/rgommers/numpy/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/rgommers/numpy/git/refs{/sha}","trees_url":"https://api.github.com/repos/rgommers/numpy/git/trees{/sha}","statuses_url":"https://api.github.com/repos/rgommers/numpy/statuses/{sha}","languages_url":"https://api.github.com/repos/rgommers/numpy/languages","stargazers_url":"https://api.github.com/repos/rgommers/numpy/stargazers","contributors_url":"https://api.github.com/repos/rgommers/numpy/contributors","subscribers_url":"https://api.github.com/repos/rgommers/numpy/subscribers","subscription_url":"https://api.github.com/repos/rgommers/numpy/subscription","commits_url":"https://api.github.com/repos/rgommers/numpy/commits{/sha}","git_commits_url":"https://api.github.com/repos/rgommers/numpy/git/commits{/sha}","comments_url":"https://api.github.com/repos/rgommers/numpy/comments{/number}","issue_comment_url":"https://api.github.com/repos/rgommers/numpy/issues/comments/{number}","contents_url":"https://api.github.com/repos/rgommers/numpy/contents/{+path}","compare_url":"https://api.github.com/repos/rgommers/numpy/compare/{base}...{head}","merges_url":"https://api.github.com/repos/rgommers/numpy/merges","archive_url":"https://api.github.com/repos/rgommers/numpy/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/rgommers/numpy/downloads","issues_url":"https://api.github.com/repos/rgommers/numpy/issues{/number}","pulls_url":"https://api.github.com/repos/rgommers/numpy/pulls{/number}","milestones_url":"https://api.github.com/repos/rgommers/numpy/milestones{/number}","notifications_url":"https://api.github.com/repos/rgommers/numpy/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/rgommers/numpy/labels{/name}","releases_url":"https://api.github.com/repos/rgommers/numpy/releases{/id}","created_at":"2010-09-16T13:27:45Z","updated_at":"2014-05-26T19:16:37Z","pushed_at":"2015-01-20T21:17:09Z","git_url":"git://github.com/rgommers/numpy.git","ssh_url":"git@github.com:rgommers/numpy.git","clone_url":"https://github.com/rgommers/numpy.git","svn_url":"https://github.com/rgommers/numpy","homepage":"http://www.numpy.org/","size":35303,"stargazers_count":4,"watchers_count":4,"language":"C","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":0,"forks":1,"open_issues":0,"watchers":4,"default_branch":"master"}},"base":{"label":"numpy:master","ref":"master","sha":"4ed1587a7de85b4fa01dff8ef6e0e901a25f149c","user":{"login":"numpy","id":288276,"avatar_url":"https://avatars.githubusercontent.com/u/288276?v=3","gravatar_id":"","url":"https://api.github.com/users/numpy","html_url":"https://github.com/numpy","followers_url":"https://api.github.com/users/numpy/followers","following_url":"https://api.github.com/users/numpy/following{/other_user}","gists_url":"https://api.github.com/users/numpy/gists{/gist_id}","starred_url":"https://api.github.com/users/numpy/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/numpy/subscriptions","organizations_url":"https://api.github.com/users/numpy/orgs","repos_url":"https://api.github.com/users/numpy/repos","events_url":"https://api.github.com/users/numpy/events{/privacy}","received_events_url":"https://api.github.com/users/numpy/received_events","type":"Organization","site_admin":false},"repo":{"id":908607,"name":"numpy","full_name":"numpy/numpy","owner":{"login":"numpy","id":288276,"avatar_url":"https://avatars.githubusercontent.com/u/288276?v=3","gravatar_id":"","url":"https://api.github.com/users/numpy","html_url":"https://github.com/numpy","followers_url":"https://api.github.com/users/numpy/followers","following_url":"https://api.github.com/users/numpy/following{/other_user}","gists_url":"https://api.github.com/users/numpy/gists{/gist_id}","starred_url":"https://api.github.com/users/numpy/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/numpy/subscriptions","organizations_url":"https://api.github.com/users/numpy/orgs","repos_url":"https://api.github.com/users/numpy/repos","events_url":"https://api.github.com/users/numpy/events{/privacy}","received_events_url":"https://api.github.com/users/numpy/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/numpy/numpy","description":"Numpy main repository","fork":false,"url":"https://api.github.com/repos/numpy/numpy","forks_url":"https://api.github.com/repos/numpy/numpy/forks","keys_url":"https://api.github.com/repos/numpy/numpy/keys{/key_id}","collaborators_url":"https://api.github.com/repos/numpy/numpy/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/numpy/numpy/teams","hooks_url":"https://api.github.com/repos/numpy/numpy/hooks","issue_events_url":"https://api.github.com/repos/numpy/numpy/issues/events{/number}","events_url":"https://api.github.com/repos/numpy/numpy/events","assignees_url":"https://api.github.com/repos/numpy/numpy/assignees{/user}","branches_url":"https://api.github.com/repos/numpy/numpy/branches{/branch}","tags_url":"https://api.github.com/repos/numpy/numpy/tags","blobs_url":"https://api.github.com/repos/numpy/numpy/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/numpy/numpy/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/numpy/numpy/git/refs{/sha}","trees_url":"https://api.github.com/repos/numpy/numpy/git/trees{/sha}","statuses_url":"https://api.github.com/repos/numpy/numpy/statuses/{sha}","languages_url":"https://api.github.com/repos/numpy/numpy/languages","stargazers_url":"https://api.github.com/repos/numpy/numpy/stargazers","contributors_url":"https://api.github.com/repos/numpy/numpy/contributors","subscribers_url":"https://api.github.com/repos/numpy/numpy/subscribers","subscription_url":"https://api.github.com/repos/numpy/numpy/subscription","commits_url":"https://api.github.com/repos/numpy/numpy/commits{/sha}","git_commits_url":"https://api.github.com/repos/numpy/numpy/git/commits{/sha}","comments_url":"https://api.github.com/repos/numpy/numpy/comments{/number}","issue_comment_url":"https://api.github.com/repos/numpy/numpy/issues/comments/{number}","contents_url":"https://api.github.com/repos/numpy/numpy/contents/{+path}","compare_url":"https://api.github.com/repos/numpy/numpy/compare/{base}...{head}","merges_url":"https://api.github.com/repos/numpy/numpy/merges","archive_url":"https://api.github.com/repos/numpy/numpy/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/numpy/numpy/downloads","issues_url":"https://api.github.com/repos/numpy/numpy/issues{/number}","pulls_url":"https://api.github.com/repos/numpy/numpy/pulls{/number}","milestones_url":"https://api.github.com/repos/numpy/numpy/milestones{/number}","notifications_url":"https://api.github.com/repos/numpy/numpy/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/numpy/numpy/labels{/name}","releases_url":"https://api.github.com/repos/numpy/numpy/releases{/id}","created_at":"2010-09-13T23:02:39Z","updated_at":"2015-01-20T10:08:23Z","pushed_at":"2015-01-19T17:10:22Z","git_url":"git://github.com/numpy/numpy.git","ssh_url":"git@github.com:numpy/numpy.git","clone_url":"https://github.com/numpy/numpy.git","svn_url":"https://github.com/numpy/numpy","homepage":"http://www.numpy.org/","size":61671,"stargazers_count":1680,"watchers_count":1680,"language":"C","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":824,"mirror_url":null,"open_issues_count":780,"forks":824,"open_issues":780,"watchers":1680,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/numpy/numpy/pulls/5473"},"html":{"href":"https://github.com/numpy/numpy/pull/5473"},"issue":{"href":"https://api.github.com/repos/numpy/numpy/issues/5473"},"comments":{"href":"https://api.github.com/repos/numpy/numpy/issues/5473/comments"},"review_comments":{"href":"https://api.github.com/repos/numpy/numpy/pulls/5473/comments"},"review_comment":{"href":"https://api.github.com/repos/numpy/numpy/pulls/comments/{number}"},"commits":{"href":"https://api.github.com/repos/numpy/numpy/pulls/5473/commits"},"statuses":{"href":"https://api.github.com/repos/numpy/numpy/statuses/1b49bc5ad5cc454d628ba4eb36ff231c5f1f177b"}}}}