Metadata-Version: 2.1
Name: sweetheart
Version: 0.1.0b7
Summary: build at the speedlight full-stacked webapps including AI
Home-page: UNKNOWN
Author: Nicolas Champion
Author-email: champion.nicolas@gmail.com
License: CeCILL-C
Project-URL: Documentation, https://filedn.eu/l2gmEvR5C1WbxfsrRYz9Kh4/sweetheart/book
Project-URL: Source Code, https://github.com/IncredibleProgress/sweetheart.py
Description: # Sweetheart **0.1.0-beta**
        
        build at the speedlight full-stacked webapps including AI and best coding practices
        
        ## Introduction
        
        Since *Ubuntu 20.04* can be installed as usual softwares within *Windows 10*, it provides an incredible way for any organization to develop, administrate and deploy **powerfull responsive webapps including AI** on its own local network keeping high capabilities of integration with the already existing tools like databases, MS-Excel, and SAP.
        
        The *sweet.py* script provides a simple python/html/css centric approach leading you to the best components and best coding practices. Due to the current top-rated place of the python language regarding to data handling, calculations and AI, this makes sweetheart a fast and ideal toolkit for e-voluting towards **Industry4.0** precepts.
        
        Sweetheart is shared under the [CeCILL-C FREE SOFTWARE LICENSE AGREEMENT](https://github.com/IncredibleProgress/sweetheart.py/blob/master/LICENSE).
        
        ## A supercharged heart for the non-expert hands
        
        Sweetheart helps you getting coding full power from scratch:
        
        - easy to learn, easy to use
        - full documentation provided
        - built-in reponsive user interfaces
        - quick and clean prototyping
        - quick and clean deployement
        - ready for maintenable great code quality
        - ready for datacenters, big-data and AI
        - ready for inovation and creativity
        
        ## The highest quality components that can be adopted by newbies
        
        Sweetheart delivers ready-to-use features for any projects:
        
        - backend language: [**Python3**](https://www.python.org/)
        - optionnal AI library: [scikit-learn](https://scikit-learn.org/stable/index.html)
        - provided database server: [**MongoDB**](https://www.mongodb.com/)
        - provided asynchronous webserver: [Uvicorn](https://www.uvicorn.org/)
        - optionnal webserver for static contents: [CherryPy](https://cherrypy.org/)
        - provided asgi framework that shines: [Starlette](https://www.starlette.io/)
        - optionnal asgi framework (built on Starlette): [FastApi](https://fastapi.tiangolo.com/)
        - responsive user interfaces: [Html5](https://www.w3schools.com/), [mdBook](https://rust-lang.github.io/mdBook/)
        - provided web libs for going fast: [**Knacss**](https://www.knacss.com/), [W3css](https://www.w3schools.com/w3css/)
        - provided web libs for high-level featuring: [Bootstrap4](https://getbootstrap.com/), [Vue.js](https://vuejs.org/)
        - optionnal frontend language: [Typescript](https://www.typescriptlang.org/), [WebAssembly](https://www.assemblyscript.org/)
        - optionnal low-level language: [Rust](https://www.rust-lang.org/)
        
        **And all other nice things you wish using [apt](https://en.wikipedia.org/wiki/APT_(software)), [cargo](https://doc.rust-lang.org/cargo/), [pip](https://pip.pypa.io/en/stable/) and [npm](https://docs.npmjs.com/about-npm/):** sweetheart comes with the above mentionned package to support you saving time. Your are not forced to use these components, but these are what you should highly consider for starting new project. In a first approach consider these provide to you **an incredible full-stacked sandbox**.
        
        ## The sweetheart developpement chart
        
        Next table allows to evaluate coding and cost efforts at the statement of sweetheart today.
        
        |                                              | Coding effort | Costs effort |
        | :------------------------------------------- | :-----------: | :----------: |
        | Build responsive webapp with default libs    | FAST          | FREE         |
        | Build responsive webapp with bootstrap4      | MIDDLE        | FREE         |
        | Run MongoDB/webserver on local network       | FAST          | FREE         |
        | Run MongoDB/webserver as internet services   | MIDDLE        | MODERATE     |
        | Improve code quality and reinforce security  | EXPERT        | CHEAP        |
        | Implement AI capabilities                    | MIDDLE        | MODERATE     |
        | Implement SAP gateway                        | MIDDLE        | MODERATE     |
        | Erect and run a dedicated datacenter         | EXPERT        | HIGH         |
        
        ## Code examples
        
        ### your first standalone webpage controller written in Python
        
        ``` python
        import sweet
        
        def welcome():
            """render a welcome message"""
            return sweet.html()
        
        sweet.quickstart(welcome)
        ```
        
        ### your first *sweet* Html webpage including a bit of KNACss
        
        ``` html
        % rebase("sweet.HTML")
        
        <div class="txtcenter">
            <h1>Welcome!</h1>
            <p>get coding full power at the speedlight</p>
        </div>
        ```
        
        ## Install and run sweetheart
        
        On *Windows 10* you have first to open the *Windows Store* for installing **Ubuntu 20.04 LTS** and the **Windows Terminal**. Due to a current bug for accessing *localhost*, this is recommended to use [**Wsl1**](https://docs.microsoft.com/en-us/windows/wsl/install-win10#set-your-distribution-version-to-wsl-1-or-wsl-2) and not Wsl2. We can expect than Microsoft will solve this matter soon.
        
        Generally speaking sweetheart runs on *Ubuntu 20.04 LTS*. It will work on other Linux OS but it will require in this case some manual tasks for installing the usefull dependencies.
        
        Opening an Ubuntu terminal, the 3 following lines will do for you all what is needed:
        
        ``` sh
        sudo apt install python3-pip
        pip3 install sweetheart
        python3 -m sweet --init
        ```
        
        Main resources are now located within the `/opt/sweetheart` directory. Have a look on it could help you later for quicker understanding of what is doing sweetheart under the hood.
        
        Now start the standalone welcome webapp providing the documentation. With the given initial config the following command will work on *Windows 10* up-to-date, *Windows Terminal* and *MS Edge* installed. In other cases omit the `--webapp` option and open manually the indicated url in any other webbrowser.
        
        ``` sh
        sweet start --webapp
        ```
        
        ## Epilogue: a new incredible life starts now
        
        Even at this early step, sweetheart allows you to make a lot by yourself. Enjoy discovering and learning how coding can help and support you, using amazing raw materials widely used by GAFAM and others!
        
Keywords: ubuntu rust python3 mongodb webapp machinelearning industry4.0
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Manufacturing
Classifier: License :: CeCILL-C Free Software License Agreement (CECILL-C)
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Database :: Database Engines/Servers
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Office/Business
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: System :: Installation/Setup
Description-Content-Type: text/markdown
