Skip to main content

mkdocs plugin to generate pages from asyncapi spec files

Project description

Mkdocs Async API Plugin

Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public. License PyPi Supported python versions

Setup

  1. Install asyncapi/generator
npm install -g @asyncapi/generator
  1. Install this plugin.
pip install mkdocs-asyncapi-plugin
  1. Add render_asyncapi to mkdocs.yml:
plugins:
  - render_asyncapi

Usage

Create a new markdown file which contains only this line:

!!asyncapi <path-to-spec-file>!!

path-to-spec-file is the path to the AsyncAPI spec file relative to the root of the repository (where you run mkdocs).

Then, the entire content of this file will be the AsyncAPI spec.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocs-asyncapi-plugin-0.2.0.tar.gz (3.0 kB view details)

Uploaded Source

Built Distribution

mkdocs_asyncapi_plugin-0.2.0-py3-none-any.whl (3.5 kB view details)

Uploaded Python 3

File details

Details for the file mkdocs-asyncapi-plugin-0.2.0.tar.gz.

File metadata

  • Download URL: mkdocs-asyncapi-plugin-0.2.0.tar.gz
  • Upload date:
  • Size: 3.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.8 CPython/3.9.6 Darwin/19.6.0

File hashes

Hashes for mkdocs-asyncapi-plugin-0.2.0.tar.gz
Algorithm Hash digest
SHA256 2e3ed9af9952263880dbc41d1e416ced70bc71da9c705e2c9192498c776cf276
MD5 4a63cf0872dc1478521fb885be9cbd0b
BLAKE2b-256 1d05b68ec099c9f5b602d7cfaac840561c1c5415657a591a74552a4ad4df77e4

See more details on using hashes here.

File details

Details for the file mkdocs_asyncapi_plugin-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mkdocs_asyncapi_plugin-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7c4a6f12f020501c36db8bb5fba66d164607b7c5fedd1bf33778bbe82d32d86f
MD5 42c5c1ec613772a0a6a66bf392d00bf8
BLAKE2b-256 b891f918fe6fa31ea7649eb0965cf832202f13343e86edb793274c237584094c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page