Pandoc Bridge

name: CI/CD Pipeline on: push: branches: [main] pull_request: branches: [main] workflow_dispatch: permissions: contents: read pages: write id-token: write concurrency: group: "pages" cancel-in-progress: false jobs: ci: name: CI - Test & Lint runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@v4 - name: Setup Pandoc uses: r-lib/actions/setup-pandoc@v2 with: pandoc-version: "latest" - name: Setup Python uses: actions/setup-python@v5 with: python-version: "3.12" cache: "pip" - name: Install dependencies run: pip install -e ".[dev]" - name: Lint with ruff run: ruff check . - name: Check formatting with ruff run: ruff format --check . - name: Type check with mypy run: mypy src - name: Run tests with coverage run: pytest --cov=src cd: name: CD - Build & Deploy Docs needs: ci runs-on: ubuntu-latest if: github.ref == 'refs/heads/main' && github.event_name == 'push' environment: name: github-pages url: ${{ steps.deployment.outputs.page_url }} steps: - name: Checkout repository uses: actions/checkout@v4 - name: Setup Pandoc uses: r-lib/actions/setup-pandoc@v2 with: pandoc-version: "latest" - name: Setup Python uses: actions/setup-python@v5 with: python-version: "3.12" cache: "pip" - name: Setup Node.js uses: actions/setup-node@v4 with: node-version: "20" - name: Install dependencies run: pip install -e ".[dev]" - name: Create public directory run: mkdir -p public - name: Convert README to HTML run: pandoc README.md -s -o public/index.html --metadata title="Pandoc Bridge" - name: Export OpenAPI specification run: python scripts/export_openapi.py - name: Generate API documentation with Redoc run: | npx @redocly/cli build-docs public/openapi.json -o public/api.html - name: Setup Pages uses: actions/configure-pages@v5 - name: Upload artifact uses: actions/upload-pages-artifact@v3 with: path: public/ - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v4