-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
494c36e
commit 3399546
Showing
6 changed files
with
101 additions
and
25 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,16 +1,88 @@ | ||
| #!/bin/bash | ||
| # WF 2020-01-31 | ||
| checkinstalled() { | ||
| local l_cmd="$1" | ||
| which $l_cmd > /dev/null | ||
| if [ $? -ne 0 ] | ||
| then | ||
| echo "$l_cmd need to be installed" 1>&2 | ||
| exit 1 | ||
| fi | ||
| # create docs for a configurable project | ||
| # WF 2024-07-30 - updated | ||
|
|
||
| # Extract project name from pyproject.toml | ||
| PROJECT_NAME=$(grep "\[project\]" pyproject.toml -A1 | grep name | cut -d '=' -f2 | tr -d ' "') | ||
| PACKAGE_NAME=$(grep "\[tool.hatch.build.targets.wheel.sources\]" pyproject.toml -A1 | tail -1 | cut -d '=' -f2 | tr -d ' "') | ||
|
|
||
|
|
||
| # Function to print usage information | ||
| print_usage() { | ||
| echo "Usage: $0 [OPTIONS]" | ||
| echo "Options:" | ||
| echo " -pr, --project NAME Set the project name (default: $PROJECT_NAME)" | ||
| echo " -pa, --package NAME Set the package name (default: $PACKAGE_NAME)" | ||
| echo " -d, --deploy Deploy the documentation after building" | ||
| echo " -h, --help Display this help message" | ||
| } | ||
| checkinstalled sphinx-apidoc | ||
| sphinx-apidoc -f -o docs/source . wikibot/crypt wikibot/wikibot wikibot/smw | ||
| cd docs | ||
| make clean html | ||
| open build/html/index.html | ||
|
|
||
| # Parse command line arguments | ||
| DEPLOY=false | ||
| while [[ "$#" -gt 0 ]]; do | ||
| case $1 in | ||
| -pr|--project) PROJECT_NAME="$2"; shift ;; | ||
| -pa|--package) PACKAGE_NAME="$2"; shift ;; | ||
| -d|--deploy) DEPLOY=true ;; | ||
| -h|--help) print_usage; exit 0 ;; | ||
| *) echo "Unknown parameter: $1"; print_usage; exit 1 ;; | ||
| esac | ||
| shift | ||
| done | ||
|
|
||
| # Ensure we're in the correct directory | ||
| if [[ ! -d "$PACKAGE_NAME" ]]; then | ||
| echo "Error: $PACKAGE_NAME package directory not found. Are you in the correct directory?" | ||
| exit 1 | ||
| fi | ||
|
|
||
| # Check if mkdocs is installed | ||
| if ! command -v mkdocs &> /dev/null; then | ||
| pip install mkdocs mkdocs-material mkdocstrings[python] | ||
| fi | ||
|
|
||
| # Create or update mkdocs.yml | ||
| cat << EOF > mkdocs.yml | ||
| site_name: $PROJECT_NAME API Documentation | ||
| theme: | ||
| name: material | ||
| plugins: | ||
| - search | ||
| - mkdocstrings: | ||
| handlers: | ||
| python: | ||
| setup_commands: | ||
| - import sys | ||
| - import os | ||
| - sys.path.insert(0, os.path.abspath(".")) | ||
| selection: | ||
| docstring_style: google | ||
| rendering: | ||
| show_source: true | ||
| nav: | ||
| - API: index.md | ||
| EOF | ||
|
|
||
| # Create or update index.md | ||
| index_md=docs/index.md | ||
| mkdir -p docs | ||
| cat << EOF > $index_md | ||
| # $PROJECT_NAME API Documentation | ||
| ::: $PACKAGE_NAME | ||
| options: | ||
| show_submodules: true | ||
| EOF | ||
|
|
||
| # Ignore DeprecationWarnings during build | ||
| export PYTHONWARNINGS="ignore::DeprecationWarning" | ||
|
|
||
| # Build the documentation | ||
| mkdocs build --config-file ./mkdocs.yml | ||
|
|
||
| # Deploy if requested | ||
| if [ "$DEPLOY" = true ]; then | ||
| mkdocs gh-deploy --force --config-file ./mkdocs.yml | ||
| fi | ||
|
|
||
| echo "Documentation process completed for $PROJECT_NAME." |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,7 +1,8 @@ | ||
| #!/bin/bash | ||
| # WF 2020-03-26 | ||
| # create a release see https://packaging.python.org/tutorials/packaging-projects/ | ||
| rm -rf dist | ||
| scripts/doc | ||
| python3 setup.py sdist bdist_wheel | ||
| python3 -m twine upload -u __token__ --repository-url https://upload.pypi.org/legacy/ dist/* | ||
| scripts/doc -d | ||
|
|
||
| # Commit with a message that includes the current ISO timestamp | ||
| git commit -a -m "release commit" | ||
| git push |