|
41 | 41 | <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=8f2a1f02" /> |
42 | 42 | <link rel="stylesheet" type="text/css" href="_static/copybutton.css?v=76b2166b" /> |
43 | 43 | <link rel="stylesheet" type="text/css" href="https://fonts.googleapis.com/css?family=Vibur" /> |
44 | | - <link rel="stylesheet" type="text/css" href="_static/jupyterlite_sphinx.css?v=2c9f8f05" /> |
| 44 | + <link rel="stylesheet" type="text/css" href="_static/jupyterlite_sphinx.css?v=8ee2c72c" /> |
45 | 45 | <link rel="stylesheet" type="text/css" href="_static/sg_gallery.css?v=d2d258e8" /> |
46 | 46 | <link rel="stylesheet" type="text/css" href="_static/sg_gallery-binder.css?v=f4aeca0c" /> |
47 | 47 | <link rel="stylesheet" type="text/css" href="_static/sg_gallery-dataframe.css?v=2082cf3c" /> |
|
54 | 54 | <link rel="preload" as="script" href="_static/scripts/bootstrap.js?digest=8878045cc6db502f8baf" /> |
55 | 55 | <link rel="preload" as="script" href="_static/scripts/pydata-sphinx-theme.js?digest=8878045cc6db502f8baf" /> |
56 | 56 |
|
57 | | - <script src="_static/documentation_options.js?v=2a2fe768"></script> |
| 57 | + <script src="_static/documentation_options.js?v=e1a677a5"></script> |
58 | 58 | <script src="_static/doctools.js?v=9bcbadda"></script> |
59 | 59 | <script src="_static/sphinx_highlight.js?v=dc90522c"></script> |
60 | 60 | <script src="_static/clipboard.min.js?v=a7894cd8"></script> |
|
64 | 64 | <script> |
65 | 65 | DOCUMENTATION_OPTIONS.theme_version = '0.16.1'; |
66 | 66 | DOCUMENTATION_OPTIONS.theme_switcher_json_url = 'https://raw.githubusercontent.com/skrub-data/skrub/main/doc/version.json'; |
67 | | - DOCUMENTATION_OPTIONS.theme_switcher_version_match = '0.5.3'; |
| 67 | + DOCUMENTATION_OPTIONS.theme_switcher_version_match = '0.5.4'; |
68 | 68 | DOCUMENTATION_OPTIONS.show_version_warning_banner = |
69 | 69 | true; |
70 | 70 | </script> |
|
75 | 75 | <link rel="prev" title="About" href="about.html" /> |
76 | 76 | <meta name="viewport" content="width=device-width, initial-scale=1"/> |
77 | 77 | <meta name="docsearch:language" content="en"/> |
78 | | - <meta name="docsearch:version" content="0.5.3" /> |
| 78 | + <meta name="docsearch:version" content="0.5.4" /> |
79 | 79 | </head> |
80 | 80 |
|
81 | 81 |
|
@@ -682,39 +682,14 @@ <h4>Preparing the ground<a class="headerlink" href="#preparing-the-ground" title |
682 | 682 | </section> |
683 | 683 | <section id="setting-up-the-environment"> |
684 | 684 | <h4>Setting up the environment<a class="headerlink" href="#setting-up-the-environment" title="Link to this heading">#</a></h4> |
685 | | -<p>To contribute, you will first have to run through some steps:</p> |
686 | | -<ul class="simple"> |
687 | | -<li><p>Set up your environment by forking the repository (<a class="reference external" href="https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo">Github doc on |
688 | | -forking and |
689 | | -cloning</a>).</p></li> |
690 | | -<li><p>Create and activate a new virtual environment:</p> |
691 | | -<ul> |
692 | | -<li><p>With <a class="reference external" href="https://docs.python.org/3/library/venv.html">venv</a>, create |
693 | | -the env with <code class="docutils literal notranslate"><span class="pre">python</span> <span class="pre">-m</span> <span class="pre">venv</span> <span class="pre">env_skrub</span></code> and then activate it with |
694 | | -<code class="docutils literal notranslate"><span class="pre">source</span> <span class="pre">env_skrub/bin/activate</span></code>.</p></li> |
695 | | -<li><p>With |
696 | | -<a class="reference external" href="https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html">conda</a>, |
697 | | -create the env with <code class="docutils literal notranslate"><span class="pre">conda</span> <span class="pre">new</span> <span class="pre">-n</span> <span class="pre">env_skrub</span></code> and activate it with |
698 | | -<code class="docutils literal notranslate"><span class="pre">conda</span> <span class="pre">activate</span> <span class="pre">env_skrub</span></code>.</p></li> |
699 | | -<li><p>While at the root of your local copy of skrub and within the new |
700 | | -env, install the required development dependencies by running |
701 | | -<code class="docutils literal notranslate"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">--editable</span> <span class="pre">".[dev,</span> <span class="pre">lint,</span> <span class="pre">test,</span> <span class="pre">doc]"</span></code>.</p></li> |
702 | | -</ul> |
703 | | -</li> |
704 | | -<li><p>Run <code class="docutils literal notranslate"><span class="pre">pre-commit</span> <span class="pre">install</span></code> to activate some checks that will run every |
705 | | -time you do a <code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">commit</span></code> (mostly, formatting checks).</p></li> |
706 | | -</ul> |
707 | | -<p>If you want to make sure that everything runs properly, you can run all |
708 | | -the tests with the command <code class="docutils literal notranslate"><span class="pre">pytest</span> <span class="pre">-s</span> <span class="pre">skrub/tests</span></code>; note that this may |
709 | | -take a long time. Some tests may raise warnings such as:</p> |
710 | | -<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>UserWarning:<span class="w"> </span>Only<span class="w"> </span>pandas<span class="w"> </span>and<span class="w"> </span>polars<span class="w"> </span>DataFrames<span class="w"> </span>are<span class="w"> </span>supported,<span class="w"> </span>but<span class="w"> </span>input<span class="w"> </span>is<span class="w"> </span>a<span class="w"> </span>Numpy<span class="w"> </span>array.<span class="w"> </span>Please<span class="w"> </span>convert<span class="w"> </span>Numpy<span class="w"> </span>arrays<span class="w"> </span>to<span class="w"> </span>DataFrames<span class="w"> </span>before<span class="w"> </span>passing<span class="w"> </span>them<span class="w"> </span>to<span class="w"> </span>skrub<span class="w"> </span>transformers.<span class="w"> </span>Converting<span class="w"> </span>to<span class="w"> </span>pandas<span class="w"> </span>DataFrame<span class="w"> </span>with<span class="w"> </span>columns<span class="w"> </span><span class="o">[</span><span class="s1">'0'</span>,<span class="w"> </span><span class="s1">'1'</span>,<span class="w"> </span>…<span class="o">]</span>. |
711 | | -<span class="w"> </span>warnings.warn<span class="o">(</span> |
712 | | -</pre></div> |
713 | | -</div> |
714 | | -<p>This is expected, and you may proceed with the next steps without worrying about them. However, no tests should fail at this point: if they do fail, then let us know.</p> |
715 | | -<p>Now that the development environment is ready, you may start working on |
716 | | -the new issue by creating a new branch:</p> |
717 | | -<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>git<span class="w"> </span>checkout<span class="w"> </span>-b<span class="w"> </span>my-branch-name-eg-fix-issue-123 |
| 685 | +<p>To setup your development environment, you need to follow the steps in “From Source” tab |
| 686 | +present in <a class="reference internal" href="install.html#installing-from-source"><span class="std std-ref">Installing from source</span></a> page. |
| 687 | +After that, you can return to this page to continue.</p> |
| 688 | +<p>Now that the development environment is ready, you may create a new branch and start working on |
| 689 | +the new issue.</p> |
| 690 | +<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># fetch latest updates and start from the current head</span> |
| 691 | +git<span class="w"> </span>fetch<span class="w"> </span>upstream |
| 692 | +git<span class="w"> </span>checkout<span class="w"> </span>-b<span class="w"> </span>my-branch-name-eg-fix-issue-123 |
718 | 693 | <span class="c1"># make some changes</span> |
719 | 694 | git<span class="w"> </span>add<span class="w"> </span>./the/file-i-changed |
720 | 695 | git<span class="w"> </span>commit<span class="w"> </span>-m<span class="w"> </span><span class="s2">"my message"</span> |
@@ -776,7 +751,7 @@ <h3>Testing the code<a class="headerlink" href="#testing-the-code" title="Link t |
776 | 751 | <code class="docutils literal notranslate"><span class="pre">skrub/_dataframe/tests/test_common.py</span></code> to add a test for the |
777 | 752 | <code class="docutils literal notranslate"><span class="pre">amazing_function</span></code>.</p> |
778 | 753 | <p>Run each updated test file using <code class="docutils literal notranslate"><span class="pre">pytest</span></code> |
779 | | -([pytest docs](<a class="reference external" href="https://docs.pytest.org/en/stable/">https://docs.pytest.org/en/stable/</a>)):</p> |
| 754 | +(<a class="reference external" href="https://docs.pytest.org/en/stable">pytest docs</a>):</p> |
780 | 755 | <div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>pytest<span class="w"> </span>-vsl<span class="w"> </span>skrub/tests/test_amazing_transformer.py<span class="w"> </span><span class="se">\</span> |
781 | 756 | skrub/_dataframe/tests/test_common.py<span class="w"> </span><span class="se">\</span> |
782 | 757 | skrub/_dataframe/tests/test_table_vectorizer.py |
@@ -913,11 +888,6 @@ <h2>Building the documentation<a class="headerlink" href="#building-the-document |
913 | 888 | and addressing any issues.</strong></p> |
914 | 889 | <p>First, make sure you have properly installed the development version of skrub. |
915 | 890 | You can follow the <a class="reference internal" href="install.html#installation-instructions"><span class="std std-ref">Install</span></a> > “From source” section, if needed.</p> |
916 | | -<p>Building the documentation requires installing some additional packages:</p> |
917 | | -<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">cd</span><span class="w"> </span>skrub |
918 | | -pip<span class="w"> </span>install<span class="w"> </span><span class="s1">'.[doc]'</span> |
919 | | -</pre></div> |
920 | | -</div> |
921 | 891 | <p>To build the documentation, you need to be in the <code class="docutils literal notranslate"><span class="pre">doc</span></code> folder:</p> |
922 | 892 | <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">cd</span><span class="w"> </span>doc |
923 | 893 | </pre></div> |
@@ -1058,7 +1028,7 @@ <h3>This Page</h3> |
1058 | 1028 | <div class="footer-item"> |
1059 | 1029 |
|
1060 | 1030 | <p class="sphinx-version"> |
1061 | | - Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.1.3. |
| 1031 | + Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3. |
1062 | 1032 | <br/> |
1063 | 1033 | </p> |
1064 | 1034 | </div> |
|
0 commit comments