mirror of
https://github.com/aykhans/AzSuicideDataVisualization.git
synced 2025-04-22 10:28:02 +00:00
107 lines
3.1 KiB
Python
107 lines
3.1 KiB
Python
# Copyright 2018-2022 Streamlit Inc.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
"""Streamlit version utilities."""
|
|
import random
|
|
|
|
import packaging.version
|
|
import requests
|
|
|
|
import streamlit as st
|
|
from streamlit.logger import get_logger
|
|
|
|
LOGGER = get_logger(__name__)
|
|
|
|
PYPI_STREAMLIT_URL = "https://pypi.org/pypi/streamlit/json"
|
|
|
|
# Probability that we'll make a network call to PyPI to check
|
|
# the latest version of streamlit. This is used each time
|
|
# should_show_new_version_notice() is called.
|
|
CHECK_PYPI_PROBABILITY = 0.10
|
|
|
|
|
|
def _version_str_to_obj(version_str):
|
|
return packaging.version.Version(version_str)
|
|
|
|
|
|
def _get_installed_streamlit_version():
|
|
"""Return the streamlit version string from setup.py.
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
The version string specified in setup.py.
|
|
|
|
"""
|
|
version_str = st.__version__
|
|
return _version_str_to_obj(version_str)
|
|
|
|
|
|
def _get_latest_streamlit_version(timeout=None):
|
|
"""Request the latest streamlit version string from PyPI.
|
|
|
|
NB: this involves a network call, so it could raise an error
|
|
or take a long time.
|
|
|
|
Parameters
|
|
----------
|
|
timeout : float or None
|
|
The request timeout.
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
The version string for the latest version of streamlit
|
|
on PyPI.
|
|
|
|
"""
|
|
rsp = requests.get(PYPI_STREAMLIT_URL, timeout=timeout)
|
|
try:
|
|
version_str = rsp.json()["info"]["version"]
|
|
except Exception as e:
|
|
raise RuntimeError("Got unexpected response from PyPI", e)
|
|
return _version_str_to_obj(version_str)
|
|
|
|
|
|
def should_show_new_version_notice():
|
|
"""True if streamlit should show a 'new version!' notice to the user.
|
|
|
|
We need to make a network call to PyPI to determine the latest streamlit
|
|
version. Since we don't want to do this every time streamlit is run,
|
|
we'll only perform the check ~5% of the time.
|
|
|
|
If we do make the request to PyPI and there's any sort of error,
|
|
we log it and return False.
|
|
|
|
Returns
|
|
-------
|
|
bool
|
|
True if we should tell the user that their streamlit is out of date.
|
|
|
|
"""
|
|
if random.random() >= CHECK_PYPI_PROBABILITY:
|
|
# We don't check PyPI every time this function is called.
|
|
LOGGER.debug("Skipping PyPI version check")
|
|
return False
|
|
|
|
try:
|
|
installed_version = _get_installed_streamlit_version()
|
|
latest_version = _get_latest_streamlit_version(timeout=1)
|
|
except BaseException as e:
|
|
# Log this as a debug. We don't care if the user sees it.
|
|
LOGGER.debug("Failed PyPI version check.\n%s", e)
|
|
return False
|
|
|
|
return latest_version > installed_version
|