Skip to content

This repository is a template for a python project using the poetry container. The intent is to do all the basic lifting for a python project so that people can hit the ground running with their ideas.

License

Notifications You must be signed in to change notification settings

michplunkett/python-project-template

Repository files navigation

Poetry Python 🐍 Project Template

This repository is a template for a python 🐍 project using the poetry container. The intent is to do all the basic lifting for a python project so that people can hit the ground running with their ideas.

To make this project your own

  1. Create a new repository, using this one as a template.
  2. Change the project folder name to the kebab-case name of your project.
  3. Update the information in the pyproject.toml file with your project's and your personal information.
  4. Update the information in the CODEOWNERS file so that it uses your GitHub ID and the kebab-case name of your project folder.

🐍 by Default (Feel free to delete this after creating your project)

  • pre-commit: This serves as the codebase formatter and linter.
  • requests: This is the project's means of communicating with external APIs.
  • responses: This is used in conjunction with Pytest and Requests to mock API calls in the test module.

Project Requirements

  • Python version: ^3.11
  • Poetry

Instructions to Run the Project

  1. Go into the base directory of the repository and type poetry shell into the terminal.
  2. Use the make run command.

Technical Notes

  • Any modules should be added via the poetry add [module] command.
    • Example: poetry add black

Standard Commands

  • make lint: Runs pre-commit.
  • make test: Runs test cases in the tests directory.
  • make run: Runs the main function in the project folder.

About

This repository is a template for a python project using the poetry container. The intent is to do all the basic lifting for a python project so that people can hit the ground running with their ideas.

Resources

License

Stars

Watchers

Forks

Packages

No packages published