{"id":21658708,"url":"https://github.com/dylibso/actism","last_synced_at":"2025-04-30T21:51:29.970Z","repository":{"id":217930815,"uuid":"745123578","full_name":"dylibso/actism","owner":"dylibso","description":"Extism plug-ins as a CI pipeline in a GitHub Action","archived":false,"fork":false,"pushed_at":"2024-04-04T17:10:10.000Z","size":1455,"stargazers_count":13,"open_issues_count":1,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-30T21:51:26.446Z","etag":null,"topics":["ci","extism","github-actions","plugins","wasm"],"latest_commit_sha":null,"homepage":"https://extism.org","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dylibso.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-18T17:28:57.000Z","updated_at":"2024-11-08T09:01:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"a3b047f3-8eab-4ccc-9f0a-482eafbb7026","html_url":"https://github.com/dylibso/actism","commit_stats":null,"previous_names":["dylibso/actism"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylibso%2Factism","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylibso%2Factism/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylibso%2Factism/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dylibso%2Factism/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dylibso","download_url":"https://codeload.github.com/dylibso/actism/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251789307,"owners_count":21644081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ci","extism","github-actions","plugins","wasm"],"created_at":"2024-11-25T09:29:42.046Z","updated_at":"2025-04-30T21:51:29.944Z","avatar_url":"https://github.com/dylibso.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# Actism\n\nRun [Extism](https://extism.org) plug-ins as a pipeline on GitHub Actions.\n\n### Example\n\n```yaml\nname: test action\n\non:\n  push:\n  pull_request:\n\njobs:\n  ci_example_pipelines:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: dylibso/actism@main\n        id: actism-image\n        with:\n          wasi: true\n          input: \"this is a test\"\n          output_type: text\n          steps: |- # line-delimited set of named plugin calls, where \"step()\" export is ran\n            count vowels | https://github.com/extism/plugins/releases/latest/download/count_vowels.wasm | count_vowels\n            convert output to image data | https://cdn.modsurfer.dylibso.com/api/v1/module/271d6599df5fc1c54ddc33c266840123636d2c886e5064a739324f92ae8fc5ac.wasm\n            generate png | https://cdn.modsurfer.dylibso.com/api/v1/module/2c9eb901052b1e6397d2414bdb796975407cc87085e6b5fe9564932538d8af51.wasm | handle\n      - name: check output\n        run: |\n          echo '${{steps.actism-image.outputs.output}}' | jq '.value' | base64 -d -i \u003e out.png\n      - uses: actions/upload-artifact@v4\n        with:\n          name: out.png\n          path: ./out.png\n\n      - uses: dylibso/actism@main\n        id: actism-text\n        with:\n          wasi: true\n          input: \"this is a test\"\n          output_type: text\n          steps: |- # line-delimited set of named plugin calls, where \"step()\" export is ran\n            count vowels | https://github.com/extism/plugins/releases/latest/download/count_vowels.wasm | count_vowels\n      - name: check output\n        run: |\n          echo '${{steps.actism-text.outputs.output}}' | grep '\"count\":4'\n```\n\nThe above step with `id` \"actism-image\" will count the vowels in the input, convert that to a known format for the image generator, and then use the total count from the first plugin to generate an image with the value encoded. Then the output (out.png) will be uploaded to the summary artifacts on the Action run. \n\n![out](https://github.com/dylibso/actism/assets/7517515/3a18f70c-a233-4e9d-bac4-2e933904d53b)\n\nYou can combine Extism plug-ins and arbitrary GitHub Action steps to execute pipelines to do anything.\n\n## Usage\n\nWithin the `steps` key, you write the pipeline. This must be a line-delimited, \"|\"-segmented  list of Extism plug-ins to run in a pipeline. Components are: name | source (url or path) | function (optional export to call, default = run). \n\n```yaml\n  with:\n    wasi: true # enable WASI access to all plugins\n    input: '{\"some\": \"data\"}' # or `$(cat file.data)` etc. to be used as input to first plugin\n    output_type: text # or `bytes` used to tell the runner how to encode the final plugin's output\n    steps: |-\n      this is plugin 1 | https://.../plugin.wasm\n      this is plugin 2 | ./path/to/local.wasm | override_function_name_to_call\n      ...\n```\n\n\u003e *Note*: checkout https://modsurfer.dylibso.com for plug-in hosting!\n\nThere is no known limit to the number of plug-ins you can call in a single pipeline. \n\n## Next Steps\n\nThe Extism plug-ins should get host functions that wrap the convenient `@actions/core` and `@actions/github` JavaScript package functions, so a plug-in could interact with GitHub Actions more directly. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdylibso%2Factism","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdylibso%2Factism","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdylibso%2Factism/lists"}