nalgeon / codapi

Interactive code examples for documentation, education and fun
https://codapi.org
Apache License 2.0
1.52k stars 77 forks source link
code-playground interactive-code interactive-snippets playground sandbox snippets

Interactive code examples

for documentation, education and fun 🎉

Codapi is a platform for embedding interactive code snippets directly into your product documentation, online course or blog post.

┌───────────────────────────────┐
│ def greet(name):              │
│   print(f"Hello, {name}!")    │
│                               │
│ greet("World")                │
└───────────────────────────────┘
  Run ►  Edit  ✓ Done
┌───────────────────────────────┐
│ Hello, World!                 │
└───────────────────────────────┘

Codapi manages sandboxes (isolated execution environments) and provides an API to execute code in these sandboxes. It also provides a JavaScript widget codapi-js for easier integration.

Highlights:

For an introduction to Codapi, see this post: Interactive code examples for fun and profit.

Installation

See Installing Codapi for details.

Usage

See API to run sandboxed code using the HTTP API.

See codapi-js to embed the JavaScript widget into a web page.

Contributing

Contributions are welcome. For anything other than bugfixes, please first open an issue to discuss what you want to change.

Be sure to add or update tests as appropriate.

Support

Codapi is mostly a one-man project, not backed by a VC fund or anything.

If you find Codapi useful, please star it on GitHub and spread the word among your peers. It really helps to move the project forward.

Subscribe to stay on top of new features.