Metadata-Version: 2.1
Name: Flask-State
Version: 0.0.1
Summary: Show local state to users through Echarts.
Home-page: https://github.com/yoobool/flask-state
Author: Yoobool
Author-email: yhl@uuchat.io
Maintainer: Yoobool
License: BSD-3-Clause
Project-URL: Issue tracker, https://github.com/yoobool/flask-state/issues
Project-URL: Code, https://github.com/yoobool/flask-state
Description: # Flask-State
        
        Flask-States is a visual plug-in based on flask. It can record the local state every minute and read redis status (optional)，and generate data chart to show to users through [Echarts](https://github.com/apache/incubator-echarts).
        
        ![](https://github.com/yoobool/flask-state/blob/master/examples/static/flask_state.png)
        
        [![](https://img.shields.io/badge/license-BSD-green)](https://github.com/yoobool/flask-state/blob/master/LICENSE)
        
        
        
        ## Installation
        Install and update using [pip](https://pip.pypa.io/en/stable/quickstart/):
        ```
        $ pip install Flask-State
        ```
        
        
        ## Usage
        
        After the Flask-State is installed, you also need to import JavaScript files and CSS files to bind a convention ID value for your element, which can be used easily. In some configurations, you can also choose to modify them.
        
        
        #### Firstly：we'll set up a Flask app.
        ```python
        import flask
        
        app = flask.Flask(__name__)
        ```
        
        #### Secondly：Call the init_app method of the Flask-State to initialize the relevant configuration. It will add several routes for you to access some configurations and databases.
        ```python
        import flask_state
        
        flask_state.init_app(app)
        ```
        
        #### Thirdly：Introduce related files into your HTML file and bind ID values for an element.
        ```html
        <link href="https://cdn.jsdelivr.net/gh/yoobool/flask-state@v0.0.1/flask_state/static/flask_state.css" rel="stylesheet">
        
        <!-- Any element: div/button/a/span -->
        <a id='console_machine_status'></a>
        
        <script src="https://cdn.staticfile.org/echarts/4.2.1/echarts.min.js"></script>
        <script src="https://cdn.jsdelivr.net/gh/yoobool/flask-state@v0.0.1/flask_state/static/flask_state.js"></script>
        ```
        
        #### Extra：You can also customize some configuration files.
        ```python
        # If you still need to monitor the redis status, you need to configure your redis status on the Flask app
        app.config['REDIS_CONF'] = {'REDIS_STATE': True, 'REDIS_HOST': '192.168.1.2', 'REDIS_PORT':16379, 'REDIS_PASSWORD': 'fish09'}
        ```
        
        ```python
        from flask_state import default_conf_obj
        
        # ID_NAME is the ID of the binding element in HTML
        # NEED_BALL is set to false to use page element binding, and true to float ball binding
        ID_NAME = (False, 'console_machine_status')
        default_conf_obj.set_id_name(ID_NAME, NEED_BALL)
        ```
        
        ```python
        from flask_state import default_conf_obj
        
        # LANGUAGE is the plug-in display language, currently there are Chinese，English
        LANGUAGE = 'English'
        default_conf_obj.set_language(LANGUAGE)
        ```
        
        ```python
        from flask_state import default_conf_obj
        
        # ADDRESS is the database name
        # CATALOGUE 0 is the same level directory as Flask config, and 1 is the superior directory of Flask config
        ADDRESS = 'console_host'
        default_conf_obj.set_address(ADDRESS, CATALOGUE)
        ```
        
        ```python
        from flask_state import default_conf_obj
        
        # SECS is the time interval for recording the local state, with a minimum interval of 10 seconds
        SECS = 60
        default_conf_obj.set_secs(SECS)
        ```
        
        
        
        ## Contributing
        Welcome to [open an issue](https://github.com/yoobool/flask-state/issues/new)!
        
        Flask-State follows the [Contributor Covenant](https://www.contributor-covenant.org/version/1/3/0/code-of-conduct/) Code of Conduct.
        
        
        ## License
        #### ......
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Description-Content-Type: text/markdown
