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
|
|
|
|
apt install -y python3 python3-pip
|
2023-05-01 18:42:16 +00:00
|
|
|
# ADJUST THIS: install all dependencies (including pdoc)
|
2023-05-01 19:43:36 +00:00
|
|
|
#- run: pip install -e .
|
|
|
|
#- run: pip install --upgrade pip
|
2023-05-01 19:01:47 +00:00
|
|
|
- run: pip install pdoc
|
2023-05-01 19:46:57 +00:00
|
|
|
- run: pip install requests
|
2023-05-01 19:48:28 +00:00
|
|
|
#- run: pip install json
|
2023-05-01 18:42:16 +00:00
|
|
|
# ADJUST THIS: build your documentation into docs/.
|
|
|
|
# We use a custom build script for pdoc itself, ideally you just run `pdoc -o docs/ ...` here.
|
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
|
|
|
- run: python3 -m pdoc -d markdown -o docs src/plankapy/plankapy.py
|
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
|
|
|
|