PyStart

This project serves as an example for a project using DevContainers

Setup

Start by forking the project

Once the project is in your account, there are different ways you can set up this project. We will cover how you can set it up in GitHub Codespaces and in VS Code on your local machine.

GitHub Codespaces

You can set up this project to develop in GitHub Codespaces, where you can code, debug, and run your app remotely in a codespace. A codespace provides a fully configured development environment hosted in the cloud, eliminating the need for local setup. This environment includes your project's dependencies, tools, and extensions, ensuring a consistent and reproducible development experience. It streamlines collaboration by providing real-time editing, integrated version control, and easy access to debugging and testing tools, all while maintaining the security and reliability of your project.

Steps:

1. Click on the "<> Code" button
2. Click on the "Codespaces" tab
3. Click on the "Create codespace on main"

Locally in VS Code

You first need to set up your Python development environment. Specifically, this tutorial requires:

Python 3.11 (check the installation guide if you don't have it installed) Python extension for VS Code (For additional details on installing extensions, you can read Extension Marketplace).

It is recommended to use conda or env to isolate the python environment:

• Conda information
• venv information

VS Code should have the following extensions:

• ms-python.python
• ms-python.vscode-pylance
• esbenp.prettier-vscode
• ms-python.black-formatter
• charliermarsh.ruff
• ms-python.debugpy

VS Code and DevContainer

If you prefer to use DevContainer, you just need to install the DevContainer extension and all necessary extensions will be taken care for you. Follow the instructions from the DevContainer site.