Commit graph

7 commits

Author SHA1 Message Date
25a81c0a9d
feat: name uploaded documentation artifact
All checks were successful
website / build (push) Successful in 33s
Added a specific name ('docs') to the uploaded documentation artifact in the GitHub Actions workflow. This change makes the artifact easily identifiable in the GitHub Actions UI, improving the accessibility and management of build artifacts for developers and maintainers.
2024-04-25 09:08:36 +02:00
cb84abacac
feat: switch to GitHub's artifact upload action
Some checks failed
website / build (push) Has been cancelled
Changed the artifact upload step in the pdoc workflow to use GitHub's official `actions/upload-artifact@v3` instead of `forgejo/upload-artifact@v4`. This update ensures compatibility and reliability by leveraging the native GitHub Action support and potentially offers better integration with the GitHub ecosystem.
2024-04-25 09:05:31 +02:00
2bef3bb119
fix: optimize git pull in pdoc workflow
Some checks failed
website / build (push) Failing after 32s
Replaced custom git pull command with `actions/checkout@v4` in the pdoc documentation generation workflow. This change streamlines the checkout process, leveraging a more robust and standardized approach provided by GitHub Actions. It ensures compatibility and potential performance improvements in our CI/CD pipeline.
2024-04-25 09:01:16 +02:00
fbf9b49248
feat: add git install and pull to pdoc workflow
Some checks failed
website / build (push) Failing after 20s
This update modifies the pdoc workflow by adding git to the list of installed dependencies and incorporating a step to perform a `git pull`. The inclusion of git ensures that the latest version of the codebase is always used for generating documentation, enhancing the accuracy and relevance of the output. The change acknowledges the critical role of version control in continuous integration environments and aims to reduce discrepancies between the documentation and the codebase.

By ensuring the documentation is always in sync with the latest code, this adjustment helps to prevent confusion and fosters better understanding and usage of the software by end users and contributors alike.
2024-04-25 08:59:44 +02:00
a0cc7a742b
feat: optimize pdoc workflow and deps installation
Some checks failed
website / build (push) Failing after 20s
Reworked the Python dependency installation step in the `.forgejo/workflows/pdoc.yml` workflow file to install from the current directory (`.`) instead of specifying packages directly. This adjustment ensures that local package dependencies are correctly resolved and installed, aligning with best practices for Python projects. Additionally, streamlined the documentation generation process by modifying the `pdoc` execution command to use the package's dot notation, improving clarity and consistency in how the `pdoc` tool is invoked for generating Markdown documentation.

This change enhances the maintainability of our documentation workflow and ensures that our environment mirrors production more closely, potentially reducing the occurrence of "works on my machine" issues.
2024-04-25 08:58:31 +02:00
4f3159b3fa
refactor(workflows): streamline Python dep installation
Some checks failed
website / build (push) Failing after 27s
Simplified the Python dependency installation process within the pdoc workflow by combining multiple pip install commands into a single instruction. This reduces the number of steps and makes the workflow more efficient. The update also includes the removal of unnecessary comments and unused dependency installation commands, making the YAML file cleaner and easier to understand. This change could potentially speed up the documentation generation process by reducing the overall runtime of the workflow.
2024-04-25 08:53:35 +02:00
d5777fac54
refactor: restructure project for pip packaging
Some checks failed
website / build (push) Failing after 30s
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 08:48:11 +02:00