Flexx项目中的PScript模块与作用域详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00680/article/details/148578450

Flexx项目中的PScript模块与作用域详解

flexx 项目地址: https://gitcode.com/gh_mirrors/fle/flexx

前言

在Flexx框架中，开发者可以使用Python编写代码，这些代码会被自动转换为JavaScript并在浏览器中运行。这种神奇的功能背后，是一个名为PScript的转换工具在发挥作用。本文将深入探讨Flexx中PScript模块的工作原理、作用域机制以及在实际开发中的注意事项。

PScript简介

PScript是Flexx项目衍生出的一个Python到JavaScript的转译工具。它允许开发者：

使用Python语法编写代码
自动转换为等效的JavaScript代码
在浏览器环境中无缝执行

这种转换过程是自动进行的，当一个JsComponent类被定义（即导入）时，Flexx会自动识别浏览器需要了解的类，并在需要时发送相应的代码。

PScript与Python的异同

虽然PScript力求与Python保持高度兼容，但由于运行环境的差异，两者之间仍存在一些重要区别。

需要注意的差异点

属性访问：访问不存在的属性会返回undefined而不是抛出AttributeError
字典键处理：字典键会被隐式转换为字符串
命名约定：
- 类名必须以大写字母开头
- 函数名不能以大写字母开头
关键字参数：只有定义了**kwargs参数或*args后有名参数的函数才能接受关键字参数

PScript特有的功能

字典属性式访问：可以使用d.foo代替d["foo"]
隐式字符串转换：将值添加到字符串时会自动转换为字符串
除以零处理：结果为inf而不是抛出异常

作用域与模块处理

在Flexx中，开发者可以在同一个模块中定义PyComponents和JsComponents，但对于大型应用，建议分开定义以提高代码清晰度。

模块内资源共享

在JsComponent的方法中，可以使用同模块中定义的普通Python函数和类，前提是这些代码可以被PScript转译。同样，也可以使用模块中定义或导入的对象，只要这些对象可以被JSON序列化。

自动依赖检测

Flexx会智能地检测JS代码中使用了哪些变量名（但未在JS中声明），并尝试在模块中找到对应的对象。这种机制甚至支持从其他模块导入函数/类。

from flexx import flx
from foo import func1

def func2():
    ...

info = {'x': 1, 'y': 2}

class MyComponent(flx.JsComponent):
    @flx.reaction('some.event')
    def handler(self, *events):
        func1(info)
        func2()

在上面的例子中，Flexx会将func2和info的定义包含在与MyComponent相同的JS模块中，而func1则会被包含在JS模块foo中。如果MyComponent没有使用这些函数，它们的定义就不会被包含在生成的JS模块中。

高级技巧：使用RawJS

PScript提供的RawJS类是一个强大的工具，可以在模块中直接定义JS对象：

from flexx import flx

my_js_object = RawJS('window.something.get_some_object()')

class MyComponent(flx.JsComponent):
    @flx.reaction('some.event')
    def handler(self, *events):
        my_js_object.bar()