feat: add --download_only flag and visdom-download CLI for offline setups

Adds a dedicated mechanism to download all required static assets
(JS, CSS, fonts) without starting the Tornado server. This addresses
the workflow described in issue #942 where users on air-gapped machines
need to pre-download assets on an online machine.

Three ways to use:
  - visdom --download_only
  - visdom-download
  - python -m visdom.server --download_only

Closes #942

Author: baidpankaj567

py/visdom/server/__main__.py

@@ -11,6 +11,11 @@
 assert sys.version_info[0] >= 3, "To use visdom with python 2, downgrade to v0.1.8.9"
 
 if __name__ == "__main__":
-    from visdom.server.run_server import download_scripts_and_run
+    if "--download_only" in sys.argv:
+        from visdom.server.run_server import download_only
 
-    download_scripts_and_run()
+        download_only()
+    else:
+        from visdom.server.run_server import download_scripts_and_run
+
+        download_scripts_and_run()

py/visdom/server/run_server.py

@@ -143,8 +143,20 @@ def main(print_func=None):
         action="store_true",
         help="Load data from filesystem when starting server (and not lazily upon first request).",
     )
+    parser.add_argument(
+        "--download_only",
+        default=False,
+        action="store_true",
+        help="Download all required scripts (JS, CSS, fonts) and exit "
+        "without starting the server. Useful for offline/air-gapped setups.",
+    )
     FLAGS = parser.parse_args()
 
+    if FLAGS.download_only:
+        download_scripts()
+        print("Downloaded all required scripts. Exiting.")
+        return
+
     # Process base_url
     base_url = FLAGS.base_url if FLAGS.base_url != DEFAULT_BASE_URL else ""
     assert base_url == "" or base_url.startswith("/"), "base_url should start with /"
@@ -236,5 +248,11 @@ def download_scripts_and_run():
     main()
 
 
+def download_only():
+    """Download all required scripts and exit without starting the server."""
+    download_scripts()
+    print("Downloaded all required scripts. Exiting.")
+
+
 if __name__ == "__main__":
     download_scripts_and_run()

setup.py

@@ -70,5 +70,8 @@ def get_dist(pkgname):
     include_package_data=True,
     zip_safe=False,
     install_requires=requirements,
-    entry_points={'console_scripts': ['visdom=visdom.server.run_server:download_scripts_and_run']}
+    entry_points={'console_scripts': [
+        'visdom=visdom.server.run_server:download_scripts_and_run',
+        'visdom-download=visdom.server.run_server:download_only',
+    ]}
 )