{ "__type": "IngestedDoc", "__tag": 4010, "_content": {}, "_ordered_sections": [], "item_file": null, "item_line": null, "item_type": null, "aliases": [], "example_section_data": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "see_also": [], "signature": null, "references": null, "qa": "dev:dev_quickstart", "arbitrary": [ { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "After " }, { "__type": "CrossRef", "__tag": 4002, "value": "getting the source code from GitHub", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "docs", "path": "dev:gitwash:development_setup" }, "kind": "exists" }, { "__type": "Text", "__tag": 4046, "value": ", there are three steps to start contributing:" } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": true, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Strong", "__tag": 4048, "children": [ { "__type": "Text", "__tag": 4046, "value": "Set up a development environment" } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Using " }, { "__type": "InlineCode", "__tag": 4051, "value": "mamba" }, { "__type": "Text", "__tag": 4046, "value": ", or some flavor of the many virtual environment management tools, you can make sure the development version of SciPy does not interfere with any other local installations of SciPy on your machine." } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Strong", "__tag": 4048, "children": [ { "__type": "Text", "__tag": 4046, "value": "Build SciPy" } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "SciPy uses compiled code for speed, which means you might need extra dependencies to complete this step depending on your system - see " }, { "__type": "CrossRef", "__tag": 4002, "value": "building-from-source", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "docs", "path": "building:index" }, "kind": "exists" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Strong", "__tag": 4048, "children": [ { "__type": "Text", "__tag": 4046, "value": "Perform development tasks" } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "These can include any changes you want to make to the source code, running tests, building the documentation, running benchmarks, etc." } ] } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Contributor quickstart guide" } ], "level": 0, "target": "dev-quickstart" }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Admonition", "__tag": 4056, "kind": "note", "base_type": "note", "children": [ { "__type": "AdmonitionTitle", "__tag": 4055, "children": [ { "__type": "Text", "__tag": 4046, "value": "note " } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "We " }, { "__type": "Strong", "__tag": 4048, "children": [ { "__type": "Text", "__tag": 4046, "value": "strongly" } ] }, { "__type": "Text", "__tag": 4046, "value": " recommend using a user-activated environment setup, such as a conda or virtual environment." } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Since SciPy contains parts written in C, C++, and Fortran that need to be compiled before use, make sure you have the necessary compilers and Python development headers installed. If you are using " }, { "__type": "InlineCode", "__tag": 4051, "value": "mamba" }, { "__type": "Text", "__tag": 4046, "value": ", these will be installed automatically. If you are using " }, { "__type": "InlineCode", "__tag": 4051, "value": "pip" }, { "__type": "Text", "__tag": 4046, "value": ", check which " }, { "__type": "CrossRef", "__tag": 4002, "value": "system-level dependencies", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "docs", "path": "building:index" }, "kind": "exists" }, { "__type": "Text", "__tag": 4046, "value": " you might need." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "First, fork a copy of the main SciPy repository in GitHub onto your own account and then create your local repository via " } ] }, { "__type": "Code", "__tag": 4050, "value": "git clone git@github.com:YOURUSERNAME/scipy.git scipy\ncd scipy\ngit submodule update --init\ngit remote add upstream https://github.com/scipy/scipy.git", "execution_status": null }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Next, set up your development environment. " }, { "__type": "Strong", "__tag": 4048, "children": [ { "__type": "Text", "__tag": 4046, "value": "With" } ] }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "CrossRef", "__tag": 4002, "value": "system-level dependencies", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "docs", "path": "building:index" }, "kind": "exists" }, { "__type": "Text", "__tag": 4046, "value": " " }, { "__type": "Strong", "__tag": 4048, "children": [ { "__type": "Text", "__tag": 4046, "value": "installed" } ] }, { "__type": "Text", "__tag": 4046, "value": ", execute the instructions in " }, { "__type": "CrossRef", "__tag": 4002, "value": "building-from-source", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "docs", "path": "building:index" }, "kind": "exists" }, { "__type": "Text", "__tag": 4046, "value": "." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "For details on how to test your changes, see the more complete setup walkthrough in " }, { "__type": "CrossRef", "__tag": 4002, "value": "development-workflow", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "docs", "path": "dev:contributor:development_workflow" }, "kind": "exists" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Basic workflow" } ], "level": 1, "target": null }, { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "There are many possible ways to set up your development environment. For more detailed instructions, see the " }, { "__type": "CrossRef", "__tag": 4002, "value": "contributor-toc", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "docs", "path": "dev:contributor:contributor_toc" }, "kind": "exists" }, { "__type": "Text", "__tag": 4046, "value": "." } ] }, { "__type": "Admonition", "__tag": 4056, "kind": "note", "base_type": "note", "children": [ { "__type": "AdmonitionTitle", "__tag": 4055, "children": [ { "__type": "Text", "__tag": 4046, "value": "note " } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If you are having trouble building SciPy from source or setting up your local development environment, you can try to build SciPy with GitHub Codespaces. It allows you to create the correct development environment right in your browser, reducing the need to install local development environments and deal with incompatible dependencies." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If you have good internet connectivity and want a temporary set-up, it is often faster to work on SciPy in a Codespaces environment. For documentation on how to get started with Codespaces, see " }, { "__type": "Link", "__tag": 4049, "children": [ { "__type": "Text", "__tag": 4046, "value": "the Codespaces docs" } ], "url": "https://docs.github.com/en/codespaces", "title": "" }, { "__type": "Text", "__tag": 4046, "value": ". When creating a codespace for the " }, { "__type": "InlineCode", "__tag": 4051, "value": "scipy/scipy" }, { "__type": "Text", "__tag": 4046, "value": " repository, the default 2-core machine type works; 4-core will build and work a bit faster (but of course at a cost of halving your number of free usage hours). Once your codespace has started, you can run " }, { "__type": "InlineCode", "__tag": 4051, "value": "conda activate scipy-dev" }, { "__type": "Text", "__tag": 4046, "value": " and your development environment is completely set up - you can then follow the relevant parts of the SciPy documentation to build, test, develop, write docs, and contribute to SciPy." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Another alternative is to use " }, { "__type": "Link", "__tag": 4049, "children": [ { "__type": "Text", "__tag": 4046, "value": "Gitpod" } ], "url": "https://www.gitpod.io", "title": "" }, { "__type": "Text", "__tag": 4046, "value": ". We do not maintain this solution anymore but some information can be found in previous versions of our " }, { "__type": "Link", "__tag": 4049, "children": [ { "__type": "Text", "__tag": 4046, "value": "docs" } ], "url": "https://docs.scipy.org/doc/scipy-1.10.1/dev/contributor/quickstart_gitpod.html", "title": "" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ] } ], "title": [ { "__type": "Text", "__tag": 4046, "value": "Other workflows" } ], "level": 1, "target": null } ], "local_refs": [] }