온보딩 가이드#

이 가이드는 Python에 익숙하지 않은 개발자가 Python을 빠르고 효율적으로 시작할 수 있도록 도와줍니다.

Python 설정:

공식 Python 웹사이트에서 Python을 설치합니다.

Python은 Mise로도 설치할 수 있습니다:

mise use python@3.14

macOS에는 Python이 사전 설치되어 있지만, 별도의 Python 버전을 설치하여 사용하는 것을 강력히 권장합니다.

패키지 관리를 위해 Poetry 설치:

Poetry는 패키징과 의존성 처리를 단순화하는 현대적인 Python 전용 의존성 관리자입니다. 설치하려면 다음을 실행합니다:

 curl --silent --show-error --location "https://install.python-poetry.org" | python3 -

Poetry는 Mise로도 설치할 수 있습니다:

mise install poetry

전체 설치 세부 정보는 Poetry 설치 가이드를 반드시 읽어보세요.

설치 후 Poetry로 새 Python 프로젝트를 생성합니다:

poetry new my_project
cd my_project
poetry install

기존 코드 실행 및 디버깅

README.md를 따라 프로젝트 구조를 파악합니다.

코드를 디버깅하려면 pdb 또는 IDE 디버깅 기능을 사용합니다. 예시:

poetry shell
python -m pdb <file_name>.py

PyCharm과 VSCode 모두 코드 디버깅에 유용한 도구를 제공합니다.

---

학습 자료#

Python을 처음 접하거나 지식을 다시 익히려는 경우, 이 섹션에서 다양한 학습 자료를 제공합니다.

• Zen of Python Zen of Python - PEP 20 - 은 필독 자료로, Python에 대한 사고방식과 "Pythonic"한 코드 작성 방법을 형성합니다.

• Python Cheatsheet 필수 Python 문법, 내장 함수, 유용한 라이브러리를 다루는 종합 참고 자료입니다. Python의 주요 기능을 빠르고 체계적으로 정리하여 초보자와 숙련된 사용자 모두에게 이상적입니다.

• 100-page Python Intro 간략한 가이드로, 효과적인 프로그래밍을 시작하는 데 필요한 모든 핵심 내용을 다루는 Python 입문서입니다. 문법부터 디버깅과 테스팅까지 모든 것을 다루는 초보자 친화적인 옵션입니다.

• Learn X in Y Minutes: Python Python의 핵심 문법과 기능을 바로 다루는 매우 간결하고 고수준의 입문서로, Python으로 전환하는 개발자에게 유용한 빠른 시작 자료입니다.

• Exercism Python Track Exercism의 Python 트랙을 Python 개념과 모범 사례 학습의 기반으로 활용하세요. Exercism은 멘토링 지원과 함께 실습을 제공하여 코딩 연습과 피드백을 통해 Python을 마스터할 수 있는 훌륭한 리소스입니다.

Python API를 개발할 때는 FastAPI와 Pydantic을 사용합니다. 이 기술들을 시작하고 리뷰하려면 다음 자료를 참고하세요:

• FastAPI Documentation FastAPI는 Python으로 API를 구축하기 위한 현대적인 웹 프레임워크입니다. 이 자료는 빠르고 효율적인 웹 애플리케이션과 API를 만드는 방법을 배우는 데 도움이 됩니다. FastAPI는 특히 고성능과 확장성이 필요한 Python 애플리케이션 구축에 유용합니다.

• Pydantic Documentation Pydantic은 Python 타입 어노테이션을 사용한 데이터 유효성 검사 및 설정 관리를 위한 Python 라이브러리입니다. FastAPI와 함께 작업할 때 특히 유용하며, 더 쉬운 데이터 유효성 검사 및 관리를 위해 Python 프로젝트에 Pydantic을 통합하는 방법을 알아보세요.

Python 코드 테스팅에는 pytest를 사용합니다. pytest로 테스트를 작성하고 실행하는 방법에 대해 자세히 알아보려면 다음 자료를 참고하세요:

• pytest Documentation pytest는 간단하고 확장 가능한 테스트를 쉽게 작성할 수 있게 해주는 인기 있는 Python 테스팅 프레임워크입니다. 픽스처, 플러그인, 테스트 검색 등 pytest를 사용하여 테스트를 작성하고 실행하는 방법에 대한 포괄적인 문서를 제공합니다.

• Python Testing with pytest (Book) 이 책은 pytest로 Python 코드를 테스팅하기 위한 종합 가이드입니다. 테스트 작성의 기초부터 픽스처, 플러그인, 테스트 구성과 같은 고급 주제까지 모든 것을 다룹니다.

• Python Function to flowchart 이 프로젝트는 Python 함수를 가져와 코드가 동작하는 방식을 보여주는 시각적 플로우차트를 자동으로 생성합니다.

---

학습 그룹#

개발자들이 Python, FastAPI, Pydantic을 함께 공부하고 실제 앱을 구축하는 데 집중하는 협업 공간입니다.

진행 중인 업데이트 및 논의는 Python 학습 그룹의 세션 추적 및 제안 이슈를 참고하세요.

그룹 학습 핵심 주제:

기본 Python 문법:

변수, 함수, 루프, 조건문과 같은 Python 개념을 배웁니다.

• Exercism Python Track에서 연습하세요.

FastAPI와 Pydantic:

FastAPI를 사용하여 API를 구축하고 Pydantic으로 데이터 유효성을 검사하는 방법을 배웁니다.

• 주요 자료:

FastAPI Documentation

• Pydantic Documentation

커뮤니케이션#

• 학습 그룹 이슈를 팔로우하여 최신 정보를 받아보세요.

• Slack 토론에 참여하세요: #python_getting_started

---

Python 리뷰 오피스 아워#

• 경험 있는 Python 개발자들이 진행하는 격주 세션으로 코드 리뷰와 토론이 이루어집니다.

• 이 세션은 실질적인 피드백을 통해 Python 실력을 향상시킬 수 있도록 설계되었습니다.

• 오피스 아워를 캘린더에 자유롭게 추가하세요.

---

녹화된 그룹 미팅 장려#

모든 리뷰 및 스터디 그룹 미팅은 Python, FastAPI, Pydantic의 핵심 개념을 다루며 녹화 후 공유됩니다. 이 녹화 자료는 주제를 다시 살펴보거나 세션을 놓쳤을 때 따라잡기에 좋습니다.

업로드된 동영상은 Python Resources 재생목록에 추가하세요.

---

멘토십 프로세스#

Python에 대한 1:1 멘토십이 가능하며 장려됩니다. 멘토와 함께 시작하는 방법에 대한 자세한 내용은 GitLab 멘토링 핸드북을 참고하세요.

---

추가 학습 자료#

이미 언급된 자료 외에도 이 섹션에서는 언어와 그 생태계를 학습하기 위한 다양한 자료를 제공합니다. 특정 순서 없이 나열합니다.

• A Whirlwind Tour of Python (Jupyter Notebook) 데이터 과학 실무자를 위해 특별히 맞춰진 Python 기초에 대한 빠른 입문서이지만, 언어의 기본적인 이해를 원하는 모든 사람에게도 잘 맞습니다. 이 자료는 Jupyter Notebook으로 되어 있어 인터랙티브한 리소스이자 Jupyter Notebook 자체에 대한 훌륭한 입문서입니다.

• Python imports 몇 가지 프로젝트를 경험한 Python 사용자에게도 임포트는 혼란스러울 수 있습니다! 특히 절대 임포트와 상대 임포트에 대해 Python의 임포트를 더 깊이 이해하고 싶다면 이 자료를 읽어보세요.

• Python -m flag -m 플래그를 학습하면 올바른 Python 환경을 사용하여 Python 도구를 실행할 수 있어 일반적인 설정 문제를 피하는 데 도움이 됩니다.

• Poetry vs pip virtualenv와 pip는 프로젝트 의존성과 환경을 처리하는 내장 도구입니다. 언제 왜 Poetry를 사용해야 할까요?

• Python roadmap 2025년에 Python 개발자가 되기 위한 단계별 가이드입니다. 영감을 얻고 추가 자료를 찾는 데 활용하세요.

• Programiz Python basics 이 초보자 친화적인 Python 강좌로 프로그래밍의 세계에 발을 들이고 탄탄한 프로그래밍 기초를 쌓으세요.