diff options
Diffstat (limited to 'docs/contributing/1.-contributing-guide/index.html')
-rw-r--r-- | docs/contributing/1.-contributing-guide/index.html | 1735 |
1 files changed, 1735 insertions, 0 deletions
diff --git a/docs/contributing/1.-contributing-guide/index.html b/docs/contributing/1.-contributing-guide/index.html new file mode 100644 index 00000000..da3c16fa --- /dev/null +++ b/docs/contributing/1.-contributing-guide/index.html @@ -0,0 +1,1735 @@ + +<!doctype html> +<html lang="en" class="no-js"> + <head> + + <meta charset="utf-8"> + <meta name="viewport" content="width=device-width,initial-scale=1"> + + + + + <link rel="icon" href="../../../art/logo.png"> + <meta name="generator" content="mkdocs-1.2.3, mkdocs-material-7.3.0"> + + + + <title>1. Contributing Guide - isort</title> + + + + <link rel="stylesheet" href="../../../assets/stylesheets/main.8b42a75e.min.css"> + + + <link rel="stylesheet" href="../../../assets/stylesheets/palette.3f5d1f46.min.css"> + + + + + + + + <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> + <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback"> + <style>:root{--md-text-font-family:"Roboto";--md-code-font-family:"Roboto Mono"}</style> + + + + + <link rel="stylesheet" href="../../../art/stylesheets/extra.css"> + + + + + + + + </head> + + + + + + + + <body dir="ltr" data-md-color-scheme="isort" data-md-color-primary="" data-md-color-accent=""> + + + <script>function __prefix(e){return new URL("../../..",location).pathname+"."+e}function __get(e,t=localStorage){return JSON.parse(t.getItem(__prefix(e)))}</script> + + <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off"> + <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off"> + <label class="md-overlay" for="__drawer"></label> + <div data-md-component="skip"> + + + <a href="#contributing-to-isort" class="md-skip"> + Skip to content + </a> + + </div> + <div data-md-component="announce"> + + </div> + + + +<header class="md-header" data-md-component="header"> + <nav class="md-header__inner md-grid" aria-label="Header"> + <a href="../../.." title="isort" class="md-header__button md-logo" aria-label="isort" data-md-component="logo"> + + <img src="../../../art/logo.png" alt="logo"> + + </a> + <label class="md-header__button md-icon" for="__drawer"> + <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg> + </label> + <div class="md-header__title" data-md-component="header-title"> + <div class="md-header__ellipsis"> + <div class="md-header__topic"> + <span class="md-ellipsis"> + isort + </span> + </div> + <div class="md-header__topic" data-md-component="header-topic"> + <span class="md-ellipsis"> + + 1. Contributing Guide + + </span> + </div> + </div> + </div> + + + + <label class="md-header__button md-icon" for="__search"> + <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg> + </label> + +<div class="md-search" data-md-component="search" role="dialog"> + <label class="md-search__overlay" for="__search"></label> + <div class="md-search__inner" role="search"> + <form class="md-search__form" name="search"> + <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required> + <label class="md-search__icon md-icon" for="__search"> + <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg> + <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg> + </label> + <nav class="md-search__options" aria-label="Search"> + + <button type="reset" class="md-search__icon md-icon" aria-label="Clear" tabindex="-1"> + <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg> + </button> + </nav> + + </form> + <div class="md-search__output"> + <div class="md-search__scrollwrap" data-md-scrollfix> + <div class="md-search-result" data-md-component="search-result"> + <div class="md-search-result__meta"> + Initializing search + </div> + <ol class="md-search-result__list"></ol> + </div> + </div> + </div> + </div> +</div> + + + <div class="md-header__source"> + +<a href="https://github.com/timothycrosley/isort/" title="Go to repository" class="md-source" data-md-component="source"> + <div class="md-source__icon md-icon"> + + <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg> + </div> + <div class="md-source__repository"> + isort + </div> +</a> + </div> + + </nav> + +</header> + + <div class="md-container" data-md-component="container"> + + + + + + + <main class="md-main" data-md-component="main"> + <div class="md-main__inner md-grid"> + + + + <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" > + <div class="md-sidebar__scrollwrap"> + <div class="md-sidebar__inner"> + + + +<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0"> + <label class="md-nav__title" for="__drawer"> + <a href="../../.." title="isort" class="md-nav__button md-logo" aria-label="isort" data-md-component="logo"> + + <img src="../../../art/logo.png" alt="logo"> + + </a> + isort + </label> + + <div class="md-nav__source"> + +<a href="https://github.com/timothycrosley/isort/" title="Go to repository" class="md-source" data-md-component="source"> + <div class="md-source__icon md-icon"> + + <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg> + </div> + <div class="md-source__repository"> + isort + </div> +</a> + </div> + + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + + + <li class="md-nav__item"> + <a href="../../.." class="md-nav__link"> + Home + </a> + </li> + + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../CHANGELOG/" class="md-nav__link"> + Changelog + </a> + </li> + + + + + + + + + + + + <li class="md-nav__item md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_3" type="checkbox" id="__nav_3" > + + + + + <label class="md-nav__link" for="__nav_3"> + Configuration + <span class="md-nav__icon md-icon"></span> + </label> + + <nav class="md-nav" aria-label="Configuration" data-md-level="1"> + <label class="md-nav__title" for="__nav_3"> + <span class="md-nav__icon md-icon"></span> + Configuration + </label> + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/action_comments/" class="md-nav__link"> + Action Comments + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/add_or_remove_imports/" class="md-nav__link"> + Add Or Remove Imports + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/black_compatibility/" class="md-nav__link"> + Black Compatibility + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/config_files/" class="md-nav__link"> + Config Files + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/custom_sections_and_ordering/" class="md-nav__link"> + Custom Sections And Ordering + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/git_hook/" class="md-nav__link"> + Git Hook + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/github_action/" class="md-nav__link"> + Github Action + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/multi_line_output_modes/" class="md-nav__link"> + Multi Line Output Modes + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/options/" class="md-nav__link"> + Options + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/pre-commit/" class="md-nav__link"> + Pre Commit + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/profiles/" class="md-nav__link"> + Profiles + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../configuration/setuptools_integration/" class="md-nav__link"> + Setuptools Integration + </a> + </li> + + + + + </ul> + </nav> + </li> + + + + + + + + + + + + + + <li class="md-nav__item md-nav__item--active md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_4" type="checkbox" id="__nav_4" checked> + + + + + <label class="md-nav__link" for="__nav_4"> + Contributing + <span class="md-nav__icon md-icon"></span> + </label> + + <nav class="md-nav" aria-label="Contributing" data-md-level="1"> + <label class="md-nav__title" for="__nav_4"> + <span class="md-nav__icon md-icon"></span> + Contributing + </label> + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + + + <li class="md-nav__item md-nav__item--active"> + + <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc"> + + + + + + <label class="md-nav__link md-nav__link--active" for="__toc"> + 1. Contributing Guide + <span class="md-nav__icon md-icon"></span> + </label> + + <a href="./" class="md-nav__link md-nav__link--active"> + 1. Contributing Guide + </a> + + +<nav class="md-nav md-nav--secondary" aria-label="Table of contents"> + + + + + + + <label class="md-nav__title" for="__toc"> + <span class="md-nav__icon md-icon"></span> + Table of contents + </label> + <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> + + <li class="md-nav__item"> + <a href="#getting-isort-set-up-for-local-development" class="md-nav__link"> + Getting isort set up for local development + </a> + + <nav class="md-nav" aria-label="Getting isort set up for local development"> + <ul class="md-nav__list"> + + <li class="md-nav__item"> + <a href="#docker-development" class="md-nav__link"> + Docker development + </a> + +</li> + + </ul> + </nav> + +</li> + + <li class="md-nav__item"> + <a href="#making-a-contribution" class="md-nav__link"> + Making a contribution + </a> + +</li> + + <li class="md-nav__item"> + <a href="#thank-you" class="md-nav__link"> + Thank you! + </a> + +</li> + + </ul> + +</nav> + + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../2.-coding-standard/" class="md-nav__link"> + 2. Coding Standard + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../3.-code-of-conduct/" class="md-nav__link"> + 3. Code Of Conduct + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../4.-acknowledgements/" class="md-nav__link"> + 4. Acknowledgements + </a> + </li> + + + + + </ul> + </nav> + </li> + + + + + + + + + + + + <li class="md-nav__item md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_5" type="checkbox" id="__nav_5" > + + + + + <label class="md-nav__link" for="__nav_5"> + Major Releases + <span class="md-nav__icon md-icon"></span> + </label> + + <nav class="md-nav" aria-label="Major Releases" data-md-level="1"> + <label class="md-nav__title" for="__nav_5"> + <span class="md-nav__icon md-icon"></span> + Major Releases + </label> + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + <li class="md-nav__item"> + <a href="../../major_releases/introducing_isort_5/" class="md-nav__link"> + Introducing Isort 5 + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../major_releases/release_policy/" class="md-nav__link"> + Release Policy + </a> + </li> + + + + + </ul> + </nav> + </li> + + + + + + + + + + + + <li class="md-nav__item md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_6" type="checkbox" id="__nav_6" > + + + + + <label class="md-nav__link" for="__nav_6"> + Quick Start + <span class="md-nav__icon md-icon"></span> + </label> + + <nav class="md-nav" aria-label="Quick Start" data-md-level="1"> + <label class="md-nav__title" for="__nav_6"> + <span class="md-nav__icon md-icon"></span> + Quick Start + </label> + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + <li class="md-nav__item"> + <a href="../../quick_start/0.-try/" class="md-nav__link"> + 0. Try + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../quick_start/1.-install/" class="md-nav__link"> + 1. Install + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../quick_start/2.-cli/" class="md-nav__link"> + 2. Cli + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../quick_start/3.-api/" class="md-nav__link"> + 3. Api + </a> + </li> + + + + + </ul> + </nav> + </li> + + + + + + + + + + + + <li class="md-nav__item md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_7" type="checkbox" id="__nav_7" > + + + + + <label class="md-nav__link" for="__nav_7"> + Upgrade Guides + <span class="md-nav__icon md-icon"></span> + </label> + + <nav class="md-nav" aria-label="Upgrade Guides" data-md-level="1"> + <label class="md-nav__title" for="__nav_7"> + <span class="md-nav__icon md-icon"></span> + Upgrade Guides + </label> + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + <li class="md-nav__item"> + <a href="../../upgrade_guides/5.0.0/" class="md-nav__link"> + 5.0.0 + </a> + </li> + + + + + </ul> + </nav> + </li> + + + + + + + + + + + + <li class="md-nav__item md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_8" type="checkbox" id="__nav_8" > + + + + + <label class="md-nav__link" for="__nav_8"> + Warning And Error Codes + <span class="md-nav__icon md-icon"></span> + </label> + + <nav class="md-nav" aria-label="Warning And Error Codes" data-md-level="1"> + <label class="md-nav__title" for="__nav_8"> + <span class="md-nav__icon md-icon"></span> + Warning And Error Codes + </label> + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + <li class="md-nav__item"> + <a href="../../warning_and_error_codes/W0500/" class="md-nav__link"> + W0500 + </a> + </li> + + + + + </ul> + </nav> + </li> + + + + + + + + + + + + <li class="md-nav__item md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9" type="checkbox" id="__nav_9" > + + + + + <label class="md-nav__link" for="__nav_9"> + Reference + <span class="md-nav__icon md-icon"></span> + </label> + + <nav class="md-nav" aria-label="Reference" data-md-level="1"> + <label class="md-nav__title" for="__nav_9"> + <span class="md-nav__icon md-icon"></span> + Reference + </label> + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + + <li class="md-nav__item md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9_1" type="checkbox" id="__nav_9_1" > + + + + + <label class="md-nav__link" for="__nav_9_1"> + Isort + <span class="md-nav__icon md-icon"></span> + </label> + + <nav class="md-nav" aria-label="Isort" data-md-level="2"> + <label class="md-nav__title" for="__nav_9_1"> + <span class="md-nav__icon md-icon"></span> + Isort + </label> + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/api/" class="md-nav__link"> + API + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/comments/" class="md-nav__link"> + Comments + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/core/" class="md-nav__link"> + Core + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/exceptions/" class="md-nav__link"> + Exceptions + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/files/" class="md-nav__link"> + Files + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/format/" class="md-nav__link"> + Format + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/hooks/" class="md-nav__link"> + Hooks + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/identify/" class="md-nav__link"> + Identify + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/" class="md-nav__link"> + Index + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/io/" class="md-nav__link"> + Io + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/literal/" class="md-nav__link"> + Literal + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/logo/" class="md-nav__link"> + Logo + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/main/" class="md-nav__link"> + Main + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/output/" class="md-nav__link"> + Output + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/parse/" class="md-nav__link"> + Parse + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/place/" class="md-nav__link"> + Place + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/profiles/" class="md-nav__link"> + Profiles + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/pylama_isort/" class="md-nav__link"> + Pylama Isort + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/sections/" class="md-nav__link"> + Sections + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/settings/" class="md-nav__link"> + Settings + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/setuptools_commands/" class="md-nav__link"> + Setuptools Commands + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/sorting/" class="md-nav__link"> + Sorting + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/utils/" class="md-nav__link"> + Utils + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/wrap/" class="md-nav__link"> + Wrap + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/wrap_modes/" class="md-nav__link"> + Wrap Modes + </a> + </li> + + + + + + + + + + + <li class="md-nav__item md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9_1_26" type="checkbox" id="__nav_9_1_26" > + + + + + <label class="md-nav__link" for="__nav_9_1_26"> + Deprecated + <span class="md-nav__icon md-icon"></span> + </label> + + <nav class="md-nav" aria-label="Deprecated" data-md-level="3"> + <label class="md-nav__title" for="__nav_9_1_26"> + <span class="md-nav__icon md-icon"></span> + Deprecated + </label> + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/deprecated/finders/" class="md-nav__link"> + Finders + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/deprecated/" class="md-nav__link"> + Index + </a> + </li> + + + + + </ul> + </nav> + </li> + + + + + + + + + + + <li class="md-nav__item md-nav__item--nested"> + + + <input class="md-nav__toggle md-toggle" data-md-toggle="__nav_9_1_27" type="checkbox" id="__nav_9_1_27" > + + + + + <label class="md-nav__link" for="__nav_9_1_27"> + Stdlibs + <span class="md-nav__icon md-icon"></span> + </label> + + <nav class="md-nav" aria-label="Stdlibs" data-md-level="3"> + <label class="md-nav__title" for="__nav_9_1_27"> + <span class="md-nav__icon md-icon"></span> + Stdlibs + </label> + <ul class="md-nav__list" data-md-scrollfix> + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/all/" class="md-nav__link"> + All + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/" class="md-nav__link"> + Index + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/py2/" class="md-nav__link"> + Py2 + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/py27/" class="md-nav__link"> + Py27 + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/py3/" class="md-nav__link"> + Py3 + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/py310/" class="md-nav__link"> + Py310 + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/py35/" class="md-nav__link"> + Py35 + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/py36/" class="md-nav__link"> + Py36 + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/py37/" class="md-nav__link"> + Py37 + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/py38/" class="md-nav__link"> + Py38 + </a> + </li> + + + + + + + + + + <li class="md-nav__item"> + <a href="../../../reference/isort/stdlibs/py39/" class="md-nav__link"> + Py39 + </a> + </li> + + + + + </ul> + </nav> + </li> + + + + + </ul> + </nav> + </li> + + + + + </ul> + </nav> + </li> + + + + </ul> +</nav> + </div> + </div> + </div> + + + + <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" > + <div class="md-sidebar__scrollwrap"> + <div class="md-sidebar__inner"> + +<nav class="md-nav md-nav--secondary" aria-label="Table of contents"> + + + + + + + <label class="md-nav__title" for="__toc"> + <span class="md-nav__icon md-icon"></span> + Table of contents + </label> + <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix> + + <li class="md-nav__item"> + <a href="#getting-isort-set-up-for-local-development" class="md-nav__link"> + Getting isort set up for local development + </a> + + <nav class="md-nav" aria-label="Getting isort set up for local development"> + <ul class="md-nav__list"> + + <li class="md-nav__item"> + <a href="#docker-development" class="md-nav__link"> + Docker development + </a> + +</li> + + </ul> + </nav> + +</li> + + <li class="md-nav__item"> + <a href="#making-a-contribution" class="md-nav__link"> + Making a contribution + </a> + +</li> + + <li class="md-nav__item"> + <a href="#thank-you" class="md-nav__link"> + Thank you! + </a> + +</li> + + </ul> + +</nav> + </div> + </div> + </div> + + + <div class="md-content" data-md-component="content"> + <article class="md-content__inner md-typeset"> + + + <a href="https://github.com/pycqa/isort/edit/main/docs/contributing/1.-contributing-guide.md" title="Edit this page" class="md-content__button md-icon"> + <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25z"/></svg> + </a> + + + <h1 id="contributing-to-isort">Contributing to isort</h1> +<p>Looking for a useful open source project to contribute to? +Want your contributions to be warmly welcomed and acknowledged? +Welcome! You have found the right place.</p> +<h2 id="getting-isort-set-up-for-local-development">Getting isort set up for local development</h2> +<p>The first step when contributing to any project is getting it set up on your local machine. isort aims to make this as simple as possible.</p> +<p>Account Requirements:</p> +<ul> +<li><a href="https://github.com/join">A valid GitHub account</a></li> +</ul> +<p>Base System Requirements:</p> +<ul> +<li>Python3.6+</li> +<li>poetry</li> +<li>bash or a bash compatible shell (should be auto-installed on Linux / Mac)</li> +<li>WSL users running Ubuntu may need to install Python's venv module even after installing Python.</li> +</ul> +<p>Once you have verified that your system matches the base requirements you can start to get the project working by following these steps:</p> +<ol> +<li><a href="https://github.com/pycqa/isort/fork">Fork the project on GitHub</a>.</li> +<li>Clone your fork to your local file system: + <code>git clone https://github.com/$GITHUB_ACCOUNT/isort.git</code></li> +<li><code>cd isort</code></li> +<li><code>poetry install</code></li> +<li>Optionally, isolate poetry's installation from the rest of your system using the instructions on the poetry site here: https://python-poetry.org/docs/#installation</li> +<li><code>./scripts/test.sh</code> should yield Success: no issues found</li> +<li><code>./scripts/clean.sh</code> should yield a Safety report checking packages</li> +</ol> +<p><strong>TIP</strong>: <code>./scripts/done.sh</code> will run both clean and test in one step.</p> +<h3 id="docker-development">Docker development</h3> +<p>If you would instead like to develop using Docker, the only local requirement is docker. +See the <a href="https://docs.docker.com/get-started/">docker docs</a> if you have not used docker before.</p> +<p>Once you have the docker daemon running and have cloned the repository, you can get started by following these steps:</p> +<ol> +<li><code>cd isort</code></li> +<li><code>./scripts/docker.sh</code></li> +</ol> +<p>A local test cycle might look like the following:</p> +<ol> +<li><code>docker build ./ -t isort:latest</code></li> +<li><code>docker run isort</code></li> +<li>if #2 fails, debug, save, and goto #1<ul> +<li><code>docker run -it isort bash</code> will get you into the failed environment</li> +<li><code>docker run -v $(git rev-parse --show-toplevel):/isort</code> will make changes made in the docker environment persist on your local checkout. + <strong>TIP</strong>: combine both to get an interactive docker shell that loads changes made locally, even after build, to quickly rerun that pesky failing test</li> +</ul> +</li> +<li><code>./scripts/docker.sh</code></li> +<li>if #4 fails, debug, save and goto #1; you may need to specify a different <code>--build-arg VERSION=$VER</code></li> +<li>congrats! you are probably ready to push a contribution</li> +</ol> +<h2 id="making-a-contribution">Making a contribution</h2> +<p>Congrats! You're now ready to make a contribution! Use the following as a guide to help you reach a successful pull-request:</p> +<ol> +<li>Check the <a href="https://github.com/pycqa/isort/issues">issues page</a> on GitHub to see if the task you want to complete is listed there.<ul> +<li>If it's listed there, write a comment letting others know you are working on it.</li> +<li>If it's not listed in GitHub issues, go ahead and log a new issue. Then add a comment letting everyone know you have it under control.<ul> +<li>If you're not sure if it's something that is good for the main isort project and want immediate feedback, you can discuss it <a href="https://gitter.im/timothycrosley/isort">here</a>.</li> +</ul> +</li> +</ul> +</li> +<li>Create an issue branch for your local work <code>git checkout -b issue/$ISSUE-NUMBER</code>.</li> +<li>Do your magic here.</li> +<li>Ensure your code matches the <a href="https://github.com/hugapi/HOPE/blob/master/all/HOPE-8--Style-Guide-for-Hug-Code.md#hope-8----style-guide-for-hug-code">HOPE-8 Coding Standard</a> used by the project.</li> +<li>Run tests locally to make sure everything is still working + <code>./scripts/done.sh</code> + <em>Or if you are using Docker</em> + <code>docker run isort:latest</code></li> +<li>Submit a pull request to the main project repository via GitHub.</li> +</ol> +<p>Thanks for the contribution! It will quickly get reviewed, and, once accepted, will result in your name being added to the acknowledgments list :).</p> +<h2 id="thank-you">Thank you!</h2> +<p>I can not tell you how thankful I am for the hard work done by isort contributors like <em>you</em>.</p> +<p>Thank you!</p> +<p>~Timothy Crosley</p> + + + + + + + + </article> + </div> + </div> + + </main> + + +<footer class="md-footer"> + + <div class="md-footer-nav"> + <nav class="md-footer-nav__inner md-grid"> + + <a href="../../configuration/setuptools_integration/" title="Setuptools Integration" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev"> + <div class="md-flex__cell md-flex__cell--shrink"> + <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> + </div> + <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> + <span class="md-flex__ellipsis"> + <span class="md-footer-nav__direction"> + Previous + </span> + Setuptools Integration + </span> + </div> + </a> + + + <a href="../2.-coding-standard/" title="2. Coding Standard" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next"> + <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> + <span class="md-flex__ellipsis"> + <span class="md-footer-nav__direction"> + Next + </span> + 2. Coding Standard + </span> + </div> + <div class="md-flex__cell md-flex__cell--shrink"> + <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i> + </div> + </a> + + </nav> + </div> + + <div class="md-footer-meta md-typeset"> + <div class="md-footer-meta__inner md-grid"> + <div class="md-footer-copyright"> + + Powered by + <a href="http://timothycrosley.github.io/portray">portray.</a> + You too can + <a href="http://timothycrosley.github.io/portray"> + portray</a> + your Python project well using automatic documentation. + </div> + + </div> + </div> +</footer> + + </div> + <div class="md-dialog" data-md-component="dialog"> + <div class="md-dialog__inner md-typeset"></div> + </div> + <script id="__config" type="application/json">{"base": "../../..", "features": [], "translations": {"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.placeholder": "Search", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing", "select.version.title": "Select version"}, "search": "../../../assets/javascripts/workers/search.f8263e09.min.js", "version": null}</script> + + + <script src="../../../assets/javascripts/bundle.4fc53ad4.min.js"></script> + + + </body> +</html>
\ No newline at end of file |