Generate API Markdown

Generate an API markdown file and token file using ApiView. Use this when the user wants to generate an API markdown file and review API changes.

Azure Updated 5.6k repo stars

File contents

Generate API Markdown

Prerequisites

  1. Activate your virtual environment.
  2. Install the required dependencies:
    cd <repo_root>
    pip install -e ./eng/tools/azure-sdk-tools
    

Instructions

  1. Navigate to the desired package directory
  2. Run the command:
    azpysdk apistub .
    
  3. The command generates api.md and api.metadata.yml in the package directory, which are the files needed to pass the API consistency check. Provide these files to the user for review.
  4. If the user explicitly asks for the raw APIView token file, run azpysdk apistub . --token-file instead.

Azure/azure-sdk-for-python commit 5d55e93748

Frequently asked questions

npx get-skill add azure-azure-sdk-for-python/generate-api-markdown