Skip to content

Commit

Permalink
Rename to sphinx-helm (#1)
Browse files Browse the repository at this point in the history
  • Loading branch information
jacobtomlinson authored Dec 9, 2024
1 parent de9b394 commit 45d2a94
Show file tree
Hide file tree
Showing 74 changed files with 111 additions and 1,324 deletions.
2 changes: 1 addition & 1 deletion .gitattributes
Original file line number Diff line number Diff line change
@@ -1 +1 @@
frigate/_version.py export-subst
sphinx-helm/_version.py export-subst
17 changes: 0 additions & 17 deletions .github/workflows/build.yaml

This file was deleted.

56 changes: 0 additions & 56 deletions .github/workflows/build_conda_and_pypi.yaml

This file was deleted.

33 changes: 0 additions & 33 deletions .github/workflows/pr.yaml

This file was deleted.

29 changes: 29 additions & 0 deletions .github/workflows/test.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
name: "Test sphinx-helm"
on:
pull_request:
push:

concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: true

jobs:
test:
runs-on: ubuntu-latest
timeout-minutes: 45
strategy:
fail-fast: false
matrix:
python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]

steps:
- uses: actions/checkout@v2
- uses: actions/setup-python@v2
with:
python-version: ${{ matrix.python-version }}
- name: Install
run: pip install -e .
- name: Run tests
run: pytest
- name: Upload coverage reports to Codecov
uses: codecov/codecov-action@v4
2 changes: 1 addition & 1 deletion .pre-commit-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,6 @@ repos:
hooks:
- id: flake8
args: ["--exclude=src,style,test"]
files: frigate/.*$
files: sphinx-helm/.*$
default_language_version:
python: python3
11 changes: 0 additions & 11 deletions .pre-commit-hooks.yaml

This file was deleted.

6 changes: 3 additions & 3 deletions MANIFEST.in
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
include versioneer.py
include frigate/_version.py
include frigate/templates/*.jinja2
exclude frigate/tests
include sphinx-helm/_version.py
include sphinx-helm/templates/*.jinja2
exclude sphinx-helm/tests
55 changes: 10 additions & 45 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,67 +1,32 @@
# Frigate
# sphinx-helm

Frigate is a tool for automatically generating documentation for your [Helm charts](https://helm.sh/).
sphinx-helm is a Sphinx plugin for automatically generating documentation for your [Helm charts](https://helm.sh/).

<!-- TODO: Add badges for CI, PyPI, etc -->

Features:

- Render documentation from your `Chart.yaml` and `values.yaml` files.
- Supports outputting as markdown, reStructuredText and HTML.
- Sphinx extension for including in Python documentation.

## Installation

```
$ pip install frigate
$ pip install sphinx-helm
```

## Usage

```
$ frigate gen path/to/chart
Chart
==========
Add the extension to your Sphinx config.

Chart description.
```python
# conf.py

...
extensions = ['sphinx-helm']
```

<!-- TODO: Link to docs once set up on RTD -->


Use the directive to generate documentation for your helm chart.

### Pre-commit-hook

Into the repository you want to have the pre-commit hook installed, run:


```
cat <<EOF >> .pre-commit-config.yaml
- repo: https://github.com/rapidsai/frigate
rev: v0.4.0 # pre-commit autoupdate - to keep the version up to date
hooks:
- id: frigate
EOF
```rst
.. helm:: path/to/your/helm/chart
```


#### Parameters

You can add extra parameters with :


```
- repo: https://github.com/rapidsai/frigate
rev: v0.4.0 # pre-commit autoupdate - to keep the version up to date
hooks:
- id: frigate
args:
- --output=README.rst
- --format=rst
- --no-credits
- --no-deps
```
25 changes: 0 additions & 25 deletions ci/checks/style.sh

This file was deleted.

69 changes: 0 additions & 69 deletions ci/cpu/build.sh

This file was deleted.

48 changes: 0 additions & 48 deletions ci/cpu/upload.sh

This file was deleted.

Loading

0 comments on commit 45d2a94

Please sign in to comment.