Skip to content

Commit

Permalink
add docs
Browse files Browse the repository at this point in the history
  • Loading branch information
timkpaine committed Jul 21, 2024
1 parent 98d06e3 commit 482a5a6
Show file tree
Hide file tree
Showing 5 changed files with 90 additions and 1 deletion.
30 changes: 30 additions & 0 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
name: Docs

on:
push:
branches:
- main
tags:
- v*
paths-ignore:
- LICENSE
- README.md

permissions:
contents: write

jobs:
docs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v4
- run: pip install yardang
- run: yardang build
- name: Deploy
uses: peaceiris/actions-gh-pages@v3
with:
publish_branch: gh-pages
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: docs/html
force_orphan: true
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
docs/html
28 changes: 28 additions & 0 deletions index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
```{toctree}
---
caption: ""
maxdepth: 2
hidden: true
---
```

## Python Project Templates

[![GitHub](https://img.shields.io/badge/repo-github-181717?logo=github&logoColor=white)](https://github.com/python-project-templates)
[![License](https://img.shields.io/badge/license-Apache--2.0-brightgreen)](https://github.com/python-project-templates)

This organization contains repos with examples of integrating Python with various tooling (CI/CD, linting, testing etc) and bindings/other language integration.

| Type | Build | Description |
|:-----|:-----|:------|
| [Python](https://github.com/python-project-templates/python-template) | [![Build Status](https://github.com/python-project-templates/python-template/actions/workflows/build.yml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/python-template/actions/workflows/build.yml) | Pure Python |
| [Python/C++](https://github.com/python-project-templates/cpp) | [![Build Status](https://github.com/python-project-templates/cpp/workflows/Build%20Status/badge.svg?branch=main)](https://github.com/python-project-templates/cpp/actions?query=workflow%3A%22Build+Status%22) | Python/C++ (binding via `pybind11` and/or standalone C++) |
| [Python/Rust](https://github.com/python-project-templates/rust-template) | [![Build Status](https://github.com/python-project-templates/rust-template/actions/workflows/build.yml/badge.svg?branch=main&event=push)](https://github.com/python-project-templates/rust-template/actions/workflows/build.yml) | Python with rust binding via `PyO3` |
| [Python/Jupyter](https://github.com/python-project-templates/jupyter) | [![Build Status](https://github.com/python-project-templates/jupyter/workflows/Build%20Status/badge.svg?branch=main)](https://github.com/python-project-templates/jupyter/actions?query=workflow%3A%22Build+Status%22) | Python with Jupyter extension (JS) |
| [Python/JavaScript](https://github.com/python-project-templates/js) | | Python with self-contained JS frontend |
| [Python/JS/Rust](https://github.com/python-project-templates/rust-js-wasm) | [![Build Status](https://github.com/python-project-templates/rust-js-wasm/workflows/Build%20Status/badge.svg?branch=main)](https://github.com/python-project-templates/rust-js-wasm/actions?query=workflow%3A%22Build+Status%22) | Rust with Python binding (`PyO3`) and WebAssembly binding (to JS) |

Don't see a template you want? Reach out via [discussions](https://github.com/python-project-templates/.github/discussions)
3 changes: 2 additions & 1 deletion profile/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
## Python Project Templates

[![GitHub](https://img.shields.io/badge/repo-github-181717?logo=github&logoColor=white)](https://github.com/python-project-templates)
[![License](https://img.shields.io/badge/license-Apache--2.0-brightgreen)](https://github.com/python-project-templates)

This organization contains repos with examples of integrating Python with various tooling (CI/CD, linting, testing etc) and bindings/other language integration.
This organization contains repos with examples of integrating Python with various tooling (CI/CD, linting, testing etc) and bindings/other language integration.

| Type | Build | Description |
|:-----|:-----|:------|
Expand Down
29 changes: 29 additions & 0 deletions pyproject.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
[build-system]
requires = ["hatchling"]
build-backend="hatchling.build"

[project]
name = "python-project-templates"
authors = [{name = "the python-project-template authors", email = "[email protected]"}]
description = "Python Project Templates"
readme = "README.md"
license = { text = "Apache-2.0" }
version = "0.1.0"
requires-python = ">=3.9"
keywords = []
classifiers = []
dependencies = []

[project.urls]
Repository = "https://github.com/python-project-templates"
Homepage = "https://python-templates.dev/"

[project.optional-dependencies]
develop = []

[tool.yardang]
title = "Python Project Templates"
root = "profile/README.md"
cname = "python-templates.dev"
pages = []
use-autoapi = false

0 comments on commit 482a5a6

Please sign in to comment.