Merge pull request #179 from pandas-profiling/develop

Support for offline mode. Adds feature requested in [#177].

README.md

@@ -119,7 +119,6 @@ profile.to_file(output_file="output.html")
 
 ## Dependencies
 
-* **An internet connection.** Pandas-profiling requires an internet connection to download the Bootstrap and JQuery libraries. I might change this in the future, let me know if you want that sooner than later.
 * python ([>= 3.5](https://python3statement.org/))
 * pandas (>=0.19)
 * matplotlib  (>=1.4)

docs/index.html

@@ -113,7 +113,6 @@ <h3 id="advanced-usage">Advanced usage</h3>
 </code></pre>
 <h2 id="dependencies">Dependencies</h2>
 <ul>
-<li><strong>An internet connection.</strong> Pandas-profiling requires an internet connection to download the Bootstrap and JQuery libraries. I might change this in the future, let me know if you want that sooner than later.</li>
 <li>python (<a href="https://python3statement.org/">&gt;= 3.5</a>)</li>
 <li>pandas (&gt;=0.19)</li>
 <li>matplotlib
@@ -202,6 +201,7 @@ <h2 id="dependencies">Dependencies</h2>
         # Render HTML
         self.html = to_html(sample, description_set)
         self.minify_html = config[&#34;minify_html&#34;].get(bool)
+        self.use_local_assets = config[&#34;use_local_assets&#34;].get(bool)
         self.title = config[&#34;title&#34;].get(str)
         self.description_set = description_set
         self.sample = sample
@@ -268,6 +268,7 @@ <h2 id="dependencies">Dependencies</h2>
             missing=len(self.description_set[&#34;missing&#34;]) &gt; 0,
             sample=len(self.sample) &gt; 0,
             version=__version__,
+            offline=self.use_local_assets,
         )
 
     def get_unique_file_name(self):
@@ -396,6 +397,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
         # Render HTML
         self.html = to_html(sample, description_set)
         self.minify_html = config[&#34;minify_html&#34;].get(bool)
+        self.use_local_assets = config[&#34;use_local_assets&#34;].get(bool)
         self.title = config[&#34;title&#34;].get(str)
         self.description_set = description_set
         self.sample = sample
@@ -462,6 +464,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
             missing=len(self.description_set[&#34;missing&#34;]) &gt; 0,
             sample=len(self.sample) &gt; 0,
             version=__version__,
+            offline=self.use_local_assets,
         )
 
     def get_unique_file_name(self):
@@ -634,6 +637,7 @@ <h2 id="returns">Returns</h2>
         missing=len(self.description_set[&#34;missing&#34;]) &gt; 0,
         sample=len(self.sample) &gt; 0,
         version=__version__,
+        offline=self.use_local_assets,
     )</code></pre>
 </details>
 </dd>

pandas_profiling/__init__.py

@@ -71,6 +71,7 @@ def __init__(self, df, **kwargs):
         # Render HTML
         self.html = to_html(sample, description_set)
         self.minify_html = config["minify_html"].get(bool)
+        self.use_local_assets = config["use_local_assets"].get(bool)
         self.title = config["title"].get(str)
         self.description_set = description_set
         self.sample = sample
@@ -137,6 +138,7 @@ def to_html(self) -> str:
             missing=len(self.description_set["missing"]) > 0,
             sample=len(self.sample) > 0,
             version=__version__,
+            offline=self.use_local_assets,
         )
 
     def get_unique_file_name(self):

pandas_profiling/config_default.yaml

@@ -7,6 +7,9 @@ pool_size: 0
 # Minify the html
 minify_html: True
 
+# Offline support
+use_local_assets: True
+
 # Per variable type description settings
 vars:
     num:

pandas_profiling/view/templates/javascript.html

@@ -0,0 +1,34 @@
+{% if offline %}
+<script>
+    {% include 'assets/jquery-latest.min.js' %}
+    {% include 'assets/bootstrap.min.js' %}
+</script>
+{% else %}
+<script src="https://code.jquery.com/jquery-latest.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
+{% endif %}
+<script>
+    $(function () {
+        $('[data-toggle="tooltip"]').tooltip()
+    })
+
+    $("a[href^='#'].anchor").on('click', function (e) {
+
+        // prevent default anchor click behavior
+        e.preventDefault();
+
+        // store hash
+        var hash = this.hash;
+
+        // animate
+        $('html, body').animate({
+            scrollTop: $(hash).offset().top
+        }, 300, function () {
+
+            // when done, add hash to url
+            // (default click behaviour)
+            window.location.hash = hash;
+        });
+
+    });
+</script>

pandas_profiling/view/templates/style.html

@@ -0,0 +1,15 @@
+{% if offline %}
+<style>
+    {% include 'assets/bootstrap.min.css' %}
+    {% include 'assets/bootstrap-theme.min.css' %}
+</style>
+{% else %}
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap-theme.min.css" integrity="sha384-rHyoN1iRsVXV4nD0JutlnGaslCJuC7uwjduW9SVrLvRYooPp2bWYgmgJQIXwl/Sp" crossorigin="anonymous">
+{% endif %}
+<style>
+body {
+  padding-top: 80px;
+}
+{% include 'assets/style.css' %}
+</style>

pandas_profiling/view/templates/wrapper.html

@@ -10,46 +10,13 @@
 
     <title>{{ title }}</title>
 
-    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
-    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap-theme.min.css" integrity="sha384-rHyoN1iRsVXV4nD0JutlnGaslCJuC7uwjduW9SVrLvRYooPp2bWYgmgJQIXwl/Sp" crossorigin="anonymous">
-    <style>
-    body {
-      padding-top: 80px;
-    }
-    {% include 'style.css' %}
-    </style>
+    {% include 'style.html' %}
 </head>
 
 <body>
     {% include 'navigation.html' %}
     {{ content }}
     {% include 'footer.html' %}
-    <script src="https://code.jquery.com/jquery-latest.js"></script>
-    <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
-    <script>
-        $(function () {
-            $('[data-toggle="tooltip"]').tooltip()
-        })
-
-        $("a[href^='#'].anchor").on('click', function (e) {
-
-            // prevent default anchor click behavior
-            e.preventDefault();
-
-            // store hash
-            var hash = this.hash;
-
-            // animate
-            $('html, body').animate({
-                scrollTop: $(hash).offset().top
-            }, 300, function () {
-
-                // when done, add hash to url
-                // (default click behaviour)
-                window.location.hash = hash;
-            });
-
-        });
-    </script>
+    {% include 'javascript.html' %}
 </body>
 </html>