extism-sys

1.10.0last stable release 1 month ago
Complexity Score
Low
Open Issues
30
Dependent Projects
0
Weekly Downloadsglobal
1,157

License

  • BSD-3-Clause
    • Yesattribution
    • Permissivelinking
    • Permissivedistribution
    • Permissivemodification
    • Nopatent grant
    • Yesprivate use
    • Permissivesublicensing
    • Notrademark grant

Downloads

Readme

Overview

Extism is a lightweight framework for building with WebAssembly (Wasm). It supports running Wasm code on servers, the edge, CLIs, IoT, browsers and everything in between. Extism is designed to be “universal” in that it supports a common interface, no matter where it runs.

Note: One of the primary use cases for Extism is building extensible software & plugins. You want to be able to execute arbitrary, untrusted code from your users? Extism makes this safe and practical to do.

Additionally, Extism adds some extra utilities on top of standard Wasm runtimes. For example, we support persistent memory/module-scope variables, secure & host-controlled HTTP without WASI, runtime limiters & timers, simpler host function linking, and more. Extism users build:

  • plug-in systems
  • FaaS platforms
  • code generators
  • web applications
  • & much more…

Supported Targets

We currently provide releases for the following targets:

  • aarch64-apple-darwin
  • aarch64-unknown-linux-gnu
  • aarch64-unknown-linux-musl
  • x86_64-apple-darwin
  • x86_64-pc-windows-gnu
  • x86_64-pc-windows-msvc
  • x86_64-unknown-linux-gnu
  • x86_64-unknown-linux-musl

For Android we suggest taking a look at the Chicory SDK for a pure Java Extism runtime.

Run WebAssembly In Your App

Pick a SDK to import into your program, and refer to the documentation to get started:

Type Language Source Code Package Rust SDK https://github.com/extism/extism/tree/main/runtime Crates.io JS SDK https://github.com/extism/js-sdk
(supports Web, Node, Deno & Bun!) NPM Elixir SDK https://github.com/extism/elixir-sdk Hex Go SDK https://github.com/extism/go-sdk Go mod Haskell SDK https://github.com/extism/haskell-sdk Hackage Java SDK https://github.com/extism/java-sdk Sonatype .NET SDK https://github.com/extism/dotnet-sdk
(supports C# & F#!) Nuget OCaml SDK https://github.com/extism/ocaml-sdk opam Perl SDK https://github.com/extism/perl-sdk CPAN PHP SDK https://github.com/extism/php-sdk Packagist Python SDK https://github.com/extism/python-sdk PyPi Ruby SDK https://github.com/extism/ruby-sdk RubyGems Zig SDK https://github.com/extism/zig-sdk N/A C SDK https://github.com/extism/extism/tree/main/libextism N/A C++ SDK https://github.com/extism/cpp-sdk N/A

Compile WebAssembly to run in Extism Hosts

Extism Hosts (running the SDK) must execute WebAssembly code that has a PDK, or Plug-in Development Kit, library compiled in to the .wasm binary. PDKs make it easy for plug-in / extension code authors to read input from the host and return data back, read provided configuration, set/get variables, make outbound HTTP calls if allowed, and more.

Pick a PDK to import into your Wasm program, and refer to the documentation to get started:

Type Language Source Code Package Rust PDK https://github.com/extism/rust-pdk Crates.io JS PDK https://github.com/extism/js-pdk N/A Python PDK https://github.com/extism/python-pdk N/A Go PDK https://github.com/extism/go-pdk Go mod Haskell PDK https://github.com/extism/haskell-pdk Hackage AssemblyScript PDK https://github.com/extism/assemblyscript-pdk NPM .NET PDK https://github.com/extism/dotnet-pdk
(supports C# & F#!) Nuget C PDK https://github.com/extism/c-pdk N/A C++ PDK https://github.com/extism/cpp-pdk N/A Zig PDK https://github.com/extism/zig-pdk N/A

Generating Bindings

It’s often very useful to define a schema to describe the function signatures and types you want to use between Extism SDK and PDK languages.

XTP Bindgen is an open source framework to generate PDK bindings for Extism plug-ins. It’s used by the XTP Platform, but can be used outside of the platform to define any Extism compatible plug-in system.

1. Install the xtp CLI.

See installation instructions here.

2. Create a schema using our OpenAPI-inspired IDL:

version: v1-draft
exports: 
  CountVowels:
      input: 
          type: string
          contentType: text/plain; charset=utf-8
      output:
          $ref: "#/components/schemas/VowelReport"
          contentType: application/json
# components.schemas defined in example-schema.yaml...

See an example in example-schema.yaml, or a full “kitchen sink” example on the docs page.

3. Generate bindings to use from your plugins:

xtp plugin init --schema-file ./example-schema.yaml
  > 1. TypeScript                      
    2. Go                              
    3. Rust                            
    4. Python                          
    5. C#                              
    6. Zig                             
    7. C++                             
    8. GitHub Template                 
    9. Local Template

This will create an entire boilerplate plugin project for you to get started with. Implement the empty function(s), and run xtp plugin build to compile your plugin.

For more information about XTP Bindgen, see the dylibso/xtp-bindgen repository and the official XTP Schema documentation.

Support

Discord

If you experience any problems or have any questions, please join our Discord and let us know. Our community is very responsive and happy to help get you started.

Usage

Head to the project website for more information and docs. Also, consider reading an overview of Extism and its goals & approach.

Contribution

Thank you for considering a contribution to Extism, we are happy to help you make a PR or find something to work on!

The easiest way to start would be to join the Discord or open an issue on the extism/proposals issue tracker, which can eventually become an Extism Improvement Proposal (EIP).

For more information, please read the Contributing guide.

Who’s behind this?

Extism is an open-source product from the team at:

Reach out and tell us what you’re building! We’d love to help: hello@dylibso.com

Dependencies

No runtime dependency information found for this package.

CVE IssuesActive
0
Scorecards Score
4.10
Test Coverage
No Data
Follows Semver
No
Github Stars
4,747
Dependenciestotal
1
DependenciesOutdated
0
DependenciesDeprecated
0
Threat Modelling
No
Repo Audits
No

Learn how to distribute extism-sys in your own private PyPI registry

pip install extism-sys
Processing...
Done

26 Releases

PyPI on Cloudsmith

Getting started with PyPI on Cloudsmith is fast and easy.