Add thebe to the extract_ functions page

eliasdabbas · Feb 23, 2022 · 6b6d7d8 · 6b6d7d8
1 parent e226da4
commit 6b6d7d8
Show file tree

Hide file tree

Showing 62 changed files with 1,781 additions and 100 deletions.
diff --git a/advertools/extract.py b/advertools/extract.py
diff --git a/advertools/logs.py b/advertools/logs.py
@@ -236,7 +236,7 @@
 ====  ========================================  ================  ================  ==================  ===============  ==================  ==================  ==============  ===============  ===============  ===============  ==================
    0  \-                                                                            \-                                                                      nan             nan  \-               nan                          nan  \-
    1  \-                                                                            \-                                                                      nan             nan  \-               nan                          nan  \-
-   2  http://adver.tools/                      http              adver.tools        /                                                                       nan             nan  nan              nan                          nan  nan
+   2  http://adver.tools/                       http              adver.tools       /                                                                       nan             nan  nan              nan                          nan  nan
    3  \-                                                                            \-                                                                      nan             nan  \-               nan                          nan  \-
    4  \-                                                                            \-                                                                      nan             nan  \-               nan                          nan  \-
    5  \-                                                                            \-                                                                      nan             nan  \-               nan                          nan  \-
@@ -245,6 +245,7 @@
    8  http://www.adver.tools/staging/urlytics/  http              www.adver.tools   /staging/urlytics/                                                      nan             nan  staging          urlytics                     nan  urlytics
    9  http://www.adver.tools/staging/urlytics/  http              www.adver.tools   /staging/urlytics/                                                      nan             nan  staging          urlytics                     nan  urlytics
 ====  ========================================  ================  ================  ==================  ===============  ==================  ==================  ==============  ===============  ===============  ===============  ==================
+
 Parse the ``user_agent`` column.
 
 .. thebe-button::

diff --git a/advertools/urlytics.py b/advertools/urlytics.py
@@ -27,11 +27,20 @@
 The main function here is :func:`url_to_df`, which as the name suggests,
 converts URLs to DataFrames.
 
->>> urls = ['https://netloc.com/path_1/path_2?price=10&color=blue#frag_1',
-...         'https://netloc.com/path_1/path_2?price=15&color=red#frag_2',
-...         'https://netloc.com/path_1/path_2/path_3?size=sm&color=blue#frag_1',
-...         'https://netloc.com/path_1?price=10&color=blue']
->>> url_to_df(urls)
+
+.. thebe-button::
+    Run this code
+
+.. code-block::
+    :class: thebe, thebe-init
+
+    import advertools as adv
+
+    urls = ['https://netloc.com/path_1/path_2?price=10&color=blue#frag_1',
+            'https://netloc.com/path_1/path_2?price=15&color=red#frag_2',
+            'https://netloc.com/path_1/path_2/path_3?size=sm&color=blue#frag_1',
+            'https://netloc.com/path_1?price=10&color=blue']
+    adv.url_to_df(urls)
 
 ====  =================================================================  ========  ==========  =====================  ===================  ==========  =======  =======  =======  ==========  =============  =============  ============
   ..  url                                                                scheme    netloc      path                   query                fragment    dir_1    dir_2    dir_3    last_dir    query_color      query_price  query_size
@@ -42,6 +51,9 @@
    3  https://netloc.com/path_1?price=10&color=blue                      https     netloc.com  /path_1                price=10&color=blue              path_1   nan      nan      path_1      blue                      10  nan
 ====  =================================================================  ========  ==========  =====================  ===================  ==========  =======  =======  =======  ==========  =============  =============  ============
 
+ِA more elaborate exmaple on :ref:`how to analyze URLs <sitemaps>` shows how you
+might use this function after obtaining a set of URLs.
+
 * **url**: The original URLs are listed as a reference. They are decoded for
   easier reading, and you can set ``decode=False`` if you want to retain the
   original encoding.

diff --git a/docs/_build/doctrees/advertools.extract.doctree b/docs/_build/doctrees/advertools.extract.doctree
diff --git a/docs/_build/doctrees/advertools.logs.doctree b/docs/_build/doctrees/advertools.logs.doctree
diff --git a/docs/_build/doctrees/advertools.urlytics.doctree b/docs/_build/doctrees/advertools.urlytics.doctree
diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle
diff --git a/docs/_build/html/.buildinfo b/docs/_build/html/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: dcffe16a241ebe10751e1c816c8a1e5a
+config: ac9e0f7445c29a29d6ca26f0baa57518
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/docs/_build/html/_modules/advertools/ad_create.html b/docs/_build/html/_modules/advertools/ad_create.html
@@ -233,7 +233,7 @@ <h1>Source code for advertools.ad_create</h1><div class="highlight"><pre>
   <hr/>
 
   <div role="contentinfo">
-    <p>&#169; Copyright 2021, Elias Dabbas.</p>
+    <p>&#169; Copyright 2022, Elias Dabbas.</p>
   </div>
 
   Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a

diff --git a/docs/_build/html/_modules/advertools/ad_from_string.html b/docs/_build/html/_modules/advertools/ad_from_string.html
@@ -337,7 +337,7 @@ <h1>Source code for advertools.ad_from_string</h1><div class="highlight"><pre>
   <hr/>
 
   <div role="contentinfo">
-    <p>&#169; Copyright 2021, Elias Dabbas.</p>
+    <p>&#169; Copyright 2022, Elias Dabbas.</p>
   </div>
 
   Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a

diff --git a/docs/_build/html/_modules/advertools/emoji.html b/docs/_build/html/_modules/advertools/emoji.html
@@ -4960,7 +4960,7 @@ <h1>Source code for advertools.emoji</h1><div class="highlight"><pre>
   <hr/>
 
   <div role="contentinfo">
-    <p>&#169; Copyright 2021, Elias Dabbas.</p>
+    <p>&#169; Copyright 2022, Elias Dabbas.</p>
   </div>
 
   Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a