pyvuejs 0.5.0

Pythonic Vue.js

Install

using pip

pip install pyvuejs

Usage

start server by main.py file in project directory

python .\main.py

Config editing guide

• config file has 2 dictionaries
  • pages: information of apps
  • server: server host, port information

pages = {
    "sample": {
        # entry, vue, url are required
        "entry": "src/app/main.py",
        "vue": "src/app/index.vue", 
        "url": "/sample",
        "title": "sample!"
    }
}

server = {
    # host and port are not required
    "host": "0.0.0.0",
    "port": 8080
}

VUE editing guide

same as vue.js, can support by linting

• for now, template, style blocks are supported

<template>
    <div id="sample">
        <p>{{ text }}</p>
    </div>
</template>

<style>
    div#sample {
        width: 100%;
        height: 100%;
    }
</style>

App model editing guide

• Model defines in main.py in app directory
• same syntax as Vue.js javascript defines
• get object by export property

from pyvuejs import Vue

class sample():
    def data(self):
        # return as dictionary
        return {
            "text": "hello, pyvuejs!"
        }

    def methods(self):
        def change_text(self):
            self.text = "I'm changed!"

        # return as dictionary
        return {
            "change_text": change_text
        }

# "__export__" must be defined
__export__ = Vue.createApp(sample).mount("#sample")

Component editing guide

• component defines in component directory
• name of python file is not important
• components are registered as global component
• get object by export property

from pyvuejs import Vue

class sample():
    # props are list only
    props = [ "label" ]
    # template is required
    template = "<label>{{ label }}</label>"

# "__export__" must be defined
__export__ = Vue.component("sample-label", sample)

Todo

• method, created, mounted of component

License

pyvuejs is MIT license

Release History

• V 0.1.0 [2020/07/17]
  • initial commit

• V 0.2.0 [2020/07/18]

  • enable componenting
  • multi locational data binding
  • add computed binding
  • dataSession

• V 0.2.1 [2020/07/19]

  • change decoration as "@method", "@compute"
  • multi locational strategy changed to IP from idGeneration

• V 0.2.2 [2020/07/19]

  • bug fixes
  • parsing errors if model block is empy

• V 0.2.2.Rev1 [2020/07/19]

  • bug fixes
  • show default favicon correctly

• V 0.2.2.Rev2 [2020/07/20]

  • remove "Variable" model
  • change component's default size to 100% of parent

• V 0.2.2.Rev3

  • depricated
  • revoke changes and upgrade to Rev4

• V 0.2.2.Rev4 [2020/07/20]

  • variables can upload to session by adding ":session" when it's definition
  • session variables can be used in template by calling "sesssion" dictionary

• V 0.2.2.Rev5 [2020/07/20]

  • change component parsing logic
  • component tag format changed to "<component name="[componentName]" />"

• V 0.2.2.Rev6 [2020/07/20]

  • move multi locational strategy to initial viewpoints
  • add event bind decoration as "@event"
    • currently only support for "load", "show" event
  • enabled to import python modules in app's directory
    • base directory of modules is plugins

• V 0.2.2.Rev7 [2020/07/20]

  • change pyvuejs object to class with constructor
  • bug fixed
    • pyvuejs calls other view's models also

• V 0.3.0 [2020/07/21]

  • change backend server to flask from quart
  • changes in requirements.txt
  • bug fixed
    • session datas are not sync from view to model

• V 0.3.0.Rev1 [2020/07/21]

  • bug fixed
    • session datas changed in vue model are not sync to model

• V 0.3.1 [2020/07/21]

  • cli changed
    • "init" command is available from module cli
    • "run", "stop", "create", "remove" commands are moved to manage.py
  • logger added
    • server logs server-side loggings only
    • client(web) logs client-side loggings only

• V 0.3.2 [2020/07/22]

  • standalone mode added
    • use PySide2 WebEngineView as UI
  • "logging" option added
    • if enable, server log to console
    • if not, server doesn't log to console

• V 0.3.2.Rev1 [2020/07/22]

  • webview window can be invoked from model with name webview

• V 0.3.2.Rev2 [2020/07/22]

  • bug fixed
    • multiple session datas upload correctly

• V 0.3.3 [2020/07/22]

  • bug fixed
    • model's native functions got erros during interpreting
  • add pyvue-component tag and change component to pyvue-component
    • format change to normal html format, "<pyvue-component endpoint="componentName">"
  • webview attribute changed to appView
  • creating a new WebView window is available from model

• V 0.3.3.Rev1 [2020/07/22]

  • bug fixed
    • decorator text was miss-parsed

• V 0.3.4 [2020/07/22]

  • change UI module from PySide2 to pycefsharp
    • appView can be invoked, too

• V 0.4.0 [2020/07/28]

  • change structure of project
    • project now managed by app
      • app has single view.html file
      • app can has multiple models in models.py
    • project information managed by .config file
  • cli changed
    • cli provides as follows
      • create-project
      • create-app
      • remove-app
      • start
      • stop

• V 0.4.1 [2020/07/29]

  • remove unnecessary requirements
  • change session refresh interval from 0.5s to 0.1s

• V 0.4.2 [2020/07/29]

  • change webview frontend from pycefsharp to pywebview

• V 0.4.3 [2020/07/29]

  • change webview frontend from pywebview to PySide2
  • child window appears properly

• V 0.5.0 [2020/08/10]

  • BIG CHANGES!
    • server changes to bottle
    • change project structure more likely to Vue.js
    • separate cli to pyvuejs-cli