2023-05-01 18:42:16 +00:00
|
|
|
name: website
|
|
|
|
|
|
|
|
# build the documentation whenever there are new commits on main
|
2023-05-01 18:59:19 +00:00
|
|
|
on:
|
|
|
|
push:
|
|
|
|
branches:
|
|
|
|
- main
|
|
|
|
# Alternative: only build for tags.
|
|
|
|
# tags:
|
|
|
|
# - '*'
|
|
|
|
workflow_dispatch:
|
2023-05-01 18:50:15 +00:00
|
|
|
## security: restrict permissions for CI jobs.
|
2023-05-01 18:42:16 +00:00
|
|
|
permissions:
|
|
|
|
contents: read
|
|
|
|
|
|
|
|
jobs:
|
|
|
|
# Build the documentation and upload the static HTML files as an artifact.
|
|
|
|
build:
|
refactor: restructure project for pip packaging
Restructured the entire project directory, making `plankapy` pip-installable, enhancing its modularity and maintainability. This involved moving and renaming Python source files and tests into a dedicated `src/plankapy` structure, introducing a `pyproject.toml` for modern packaging standards, and removing obsolete `setup.py` and `__init__.py` files. Updated CI/CD pipelines to accommodate the new structure, ensuring continued automation efficiency. Added a `test_config.py` for centralized test configuration, improving test reliability and ease of modification.
- Migrated project documentation and workflow under new `.forgejo` directory for consistency with Forgejo platform requirements.
- Enhanced Docker containerization in CI builds by specifying a node-based container, streamlining the environment setup process.
- Expanded `.gitignore` to include `venv/`, promoting local development best practices.
- Introduced a comprehensive README update, clarifying the project's forked nature and pip-installation goal, fostering better community understanding and contribution suitability.
2024-04-25 06:48:11 +00:00
|
|
|
container:
|
|
|
|
image: node:20-bookworm
|
2023-05-01 18:42:16 +00:00
|
|
|
steps:
|
refactor: restructure project for pip packaging
Restructured the entire project directory, making `plankapy` pip-installable, enhancing its modularity and maintainability. This involved moving and renaming Python source files and tests into a dedicated `src/plankapy` structure, introducing a `pyproject.toml` for modern packaging standards, and removing obsolete `setup.py` and `__init__.py` files. Updated CI/CD pipelines to accommodate the new structure, ensuring continued automation efficiency. Added a `test_config.py` for centralized test configuration, improving test reliability and ease of modification.
- Migrated project documentation and workflow under new `.forgejo` directory for consistency with Forgejo platform requirements.
- Enhanced Docker containerization in CI builds by specifying a node-based container, streamlining the environment setup process.
- Expanded `.gitignore` to include `venv/`, promoting local development best practices.
- Introduced a comprehensive README update, clarifying the project's forked nature and pip-installation goal, fostering better community understanding and contribution suitability.
2024-04-25 06:48:11 +00:00
|
|
|
- name: Install dependencies
|
|
|
|
run: |
|
|
|
|
apt update
|
2024-04-25 06:59:44 +00:00
|
|
|
apt install -y python3 python3-pip git
|
|
|
|
|
|
|
|
- name: Git pull
|
|
|
|
run: |
|
|
|
|
git pull
|
2024-04-25 06:53:35 +00:00
|
|
|
|
|
|
|
- name: Install Python dependencies
|
|
|
|
run: |
|
2024-04-25 06:58:31 +00:00
|
|
|
pip install pdoc . --break-system-packages
|
2024-04-25 06:53:35 +00:00
|
|
|
|
2024-04-25 06:58:31 +00:00
|
|
|
- run: python3 -m pdoc -d markdown -o docs plankapy
|
2023-05-01 18:42:16 +00:00
|
|
|
|
refactor: restructure project for pip packaging
Restructured the entire project directory, making `plankapy` pip-installable, enhancing its modularity and maintainability. This involved moving and renaming Python source files and tests into a dedicated `src/plankapy` structure, introducing a `pyproject.toml` for modern packaging standards, and removing obsolete `setup.py` and `__init__.py` files. Updated CI/CD pipelines to accommodate the new structure, ensuring continued automation efficiency. Added a `test_config.py` for centralized test configuration, improving test reliability and ease of modification.
- Migrated project documentation and workflow under new `.forgejo` directory for consistency with Forgejo platform requirements.
- Enhanced Docker containerization in CI builds by specifying a node-based container, streamlining the environment setup process.
- Expanded `.gitignore` to include `venv/`, promoting local development best practices.
- Introduced a comprehensive README update, clarifying the project's forked nature and pip-installation goal, fostering better community understanding and contribution suitability.
2024-04-25 06:48:11 +00:00
|
|
|
- uses: forgejo/upload-artifact@v4
|
2023-05-01 18:42:16 +00:00
|
|
|
with:
|
refactor: restructure project for pip packaging
Restructured the entire project directory, making `plankapy` pip-installable, enhancing its modularity and maintainability. This involved moving and renaming Python source files and tests into a dedicated `src/plankapy` structure, introducing a `pyproject.toml` for modern packaging standards, and removing obsolete `setup.py` and `__init__.py` files. Updated CI/CD pipelines to accommodate the new structure, ensuring continued automation efficiency. Added a `test_config.py` for centralized test configuration, improving test reliability and ease of modification.
- Migrated project documentation and workflow under new `.forgejo` directory for consistency with Forgejo platform requirements.
- Enhanced Docker containerization in CI builds by specifying a node-based container, streamlining the environment setup process.
- Expanded `.gitignore` to include `venv/`, promoting local development best practices.
- Introduced a comprehensive README update, clarifying the project's forked nature and pip-installation goal, fostering better community understanding and contribution suitability.
2024-04-25 06:48:11 +00:00
|
|
|
path: docs
|
2023-05-01 18:42:16 +00:00
|
|
|
|