Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion .github/workflows/update-contribs-reviews.yml
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,11 @@ jobs:
update-contributors
update-reviews
update-review-teams

- name: Update content from RSS Feeds
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: |
fetch-rss-feed "https://www.pyopensci.org/python-package-guide/tutorials.rss" "_tutorials"
- name: Create Pull Request
uses: peter-evans/create-pull-request@v7
with:
Expand Down
11 changes: 0 additions & 11 deletions _tutorials/0-hatch-python-packaging.md

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "0. Publish your Python package that is on PyPI to conda-forge"
excerpt: "
Learn how to publish your Python package on conda-forge to make it easily installable with conda. This lesson covers the submission process, metadata requirements, and maintaining your feedstock."
link: https://www.pyopensci.org/python-package-guide/tutorials/publish-conda-forge.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
8 changes: 8 additions & 0 deletions _tutorials/01-publish-your-python-package-to-pypi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "1. Publish your Python package to PyPI"
excerpt: "
Learn how to publish your Python package on PyPI so others can install it using pip. This lesson covers building your package, creating a PyPI account, and uploading your distribution files."
link: https://www.pyopensci.org/python-package-guide/tutorials/publish-pypi.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "2. Make your Python package PyPI ready - pyproject.toml"
excerpt: "
The pyproject.toml file is the central configuration file for building and packaging Python projects. This lesson explains key sections like name, version, dependencies, and how they support packaging and distribution. You’ll learn how to set up this file to ensure your package is ready for publishing."
link: https://www.pyopensci.org/python-package-guide/tutorials/pyproject-toml.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "3. Using Hatch to Migrate setup.py to a pyproject.toml"
excerpt: "
If you’re creating a pure Python project, pyproject.toml is preferred over setup.py for packaging and configuration. Learn how to migrate from the older setup.py format to the modern pyproject.toml file. This lesson walks you through updating your package metadata and build settings to align with current Python packaging standards."
link: https://www.pyopensci.org/python-package-guide/tutorials/setup-py-to-pyproject-toml.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "4. Setup Trusted Publishing for secure and automated publishing via GitHub Actions"
excerpt: "
Learn how to publish your Python package automatically via GitHub Actions. This lesson also covers how to do publishing in a secure way by using Trusted Publishing."
link: https://www.pyopensci.org/python-package-guide/tutorials/trusted-publishing.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "5. Add a License and Code of Conduct to your python package"
excerpt: "
Learn how to add a LICENSE and CODE_OF_CONDUCT file to your Python package. This lesson covers choosing a permissive license, placing key files for visibility on GitHub and PyPI, and adopting the Contributor Covenant to support an inclusive community."
link: https://www.pyopensci.org/python-package-guide/tutorials/add-license-coc.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
8 changes: 8 additions & 0 deletions _tutorials/06-add-a-readme-file-to-your-python-package.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "6. Add a README file to your Python package"
excerpt: "
Learn how to create a clear, effective README file for your Python package. This lesson covers what to include, why each section matters, and how a well-structured README improves usability and discoverability on GitHub and PyPI."
link: https://www.pyopensci.org/python-package-guide/tutorials/add-readme.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
8 changes: 8 additions & 0 deletions _tutorials/07-command-line-reference-guide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "7. Command Line Reference Guide"
excerpt: "
Learn how to add a command-line interface (CLI) to your Python package using the argparse library. This lesson walks you through creating a CLI entry point so users can run your package directly from the terminal."
link: https://www.pyopensci.org/python-package-guide/tutorials/command-line-reference.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "8. Create a Python package from scratch, a beginner-friendly tutorial"
excerpt: "
Learn how to create a Python package and make your code installable using Hatch. This tutorial walks you through structuring your code and configuring a pyproject.toml so others can easily install and use your package."
link: https://www.pyopensci.org/python-package-guide/tutorials/create-python-package.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "9. Use Hatch environments with your Python package: a beginner-friendly tutorial"
excerpt: "
The pyOpenSci pure Python package template uses Hatch to manage environments and run tests, docs, and other maintenance steps. Learn how to use Hatch environments to manage your Python package."
link: https://www.pyopensci.org/python-package-guide/tutorials/develop-python-package-hatch.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
12 changes: 0 additions & 12 deletions _tutorials/1-what-is-package.md

This file was deleted.

8 changes: 8 additions & 0 deletions _tutorials/10-get-to-know-hatch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "10. Get to Know Hatch"
excerpt: "
Get started with Hatch, a modern Python packaging tool. This lesson introduces Hatch’s features and shows how it simplifies environment management, project scaffolding, and building your package."
link: https://www.pyopensci.org/python-package-guide/tutorials/get-to-know-hatch.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
8 changes: 8 additions & 0 deletions _tutorials/11-python-packaging-101.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: "11. Python packaging 101"
excerpt: "
This page outlines the key steps to create, document, and share a high-quality scientific Python package. Here you will also get an overview of the pyOpenSci packaging guide and what you’ll learn."
link: https://www.pyopensci.org/python-package-guide/tutorials/intro.html
btn_label: View Tutorial
btn_class: btn--success btn--large
---
10 changes: 0 additions & 10 deletions _tutorials/2-make-code-installable.md

This file was deleted.

12 changes: 0 additions & 12 deletions _tutorials/3-publish-to-pypi.md

This file was deleted.

11 changes: 0 additions & 11 deletions _tutorials/4-publish-conda-forge.md

This file was deleted.

11 changes: 0 additions & 11 deletions _tutorials/5-add-readme.md

This file was deleted.

12 changes: 0 additions & 12 deletions _tutorials/6-add-license-code-of-conduct.md

This file was deleted.

11 changes: 0 additions & 11 deletions _tutorials/7-add-metadata-pyproject-toml.md

This file was deleted.