原文作者:Nate Finch
I’d like to announce starlight -https://github.com/starlight-go/starlight.
Starlight wraps google’s Go implementation of thestarlark python dialect(most notably found in the Bazel build tool). Starlight makes it super easy for users to extend your application by writing simple python-like scripts that interact seamlessly with your current Go code… with no boilerplate on your part.
What is Starlark?
Starlark is asubset of pythonthat removes some of the more advanced features, but keeps the easy to read-and-write feel. For the purposes of this article, to avoid confusion between starlight (my package) and starlark (the language), I’ll be referring to the code as python (since starlark code is a subset of python code), but there are some small differences (described in the previous link).
Parser by google
The parser and runner are maintained by google’s bazel team, which write starlark-go. Starlight is a wrapper on top of that, which makes it so much easier to use starlark-go. The problem with the starlark-go API is that it is more built to be a used as configuration, so it assumes you want to get information out of starlark and into Go. It’s actually pretty difficult to get Go information into a starlark script…. unless you use starlight.
Easy two-way interaction
Starlight has adapters that use reflection to automatically make any Go value usable in a starlark script. Passing aninto a starlark script? Sure, you can doin the python without any work on your part.
Starlight is built tojust workthe way you hope it’ll work. You can access any Go methods or fields, basic types get converted back and forth seamlessly… and even though it uses reflection, it’s not as slow as you’d think. A basic benchmark wrapping a couple values and running a starlark script to work with them runs in a tiny fraction of a millisecond.
The great thing is that the changes made by the python code are reflected in your go objects, just as if it had been written in Go. So, set a field on a pointer to a struct? Your go code will see the change, no additional work needed.
100% Safe
The great thing about starlark and starlight is that the scripts are 100% safe to run. By default they have no access to other parts of your project or system - they can’t write to disk or connect to the internet. The only access they have to the outside is what you give them. Because of this, it’s safe to run untrusted scripts (as long as you’re not giving them dangerous functions to run, like). But at the same time, if you’re only running trusted scripts, you can give them whatever you want (? Sure, why not?)
Example
Below is an example of a webserver that changes its output depending on the python script it runs. This is the full code, it’s not truncated for readability… this is all it takes.
First the go web server code. Super standard stuff, except a few lines to run starlight…
And the python handle.star:
You can run this example by runningand usingin theexample folder. You can then update the python and watch the changes the next time you hit the server. This just uses, which rereads and reparses the script every time.
Caching
In a production environment, you probably want to only read a script once and parse it once. You can do that with starlight’s. This cache takes a list of directories to look in for scripts, which it will read and parse on-demand, and then store the parsed object in memory for later use. It also uses a cache for anycalls the scripts use to load scripts they depend on.
Work Ongoing
Starlight is still a work in progress, so don’t expect the API to be perfectly stable quite yet. But it’s getting pretty close, and there shouldn’t be any earth shattering changes, but definitely pin your imports. Right now it’s more about finding corner cases where the starlight wrappers don’t work quite like you’d expect, and supporting the last few things that aren’t implemented yet (like channels).
版权申明:内容来源网络,版权归原创者所有。除非无法确认,我们都会标明作者及出处,如有侵权烦请告知,我们会立即删除并表示歉意。谢谢。
Golang语言社区
ID:Golangweb
游戏服务器架构丨分布式技术丨大数据丨游戏算法学习
领取专属 10元无门槛券
私享最新 技术干货