강의 계획 레슨 250개 중 240번째 · 캡스톤: 내보내기 (프로젝트 묶기)
캡스톤: 내보내기 (프로젝트 묶기)

저장소 배치하기

앞의 캡스톤에서 진짜를 만들었어요: 지원 코파일럿, 문서 추출기, 평가 관문. 지금은 아마 셀 더미나 긴 스크립트 하나로 살고 있을 거예요. 그걸 연 채용 담당자는 무엇이 어디 있는지 추측해야 하고, 복제했는데 돌릴 뻔한 방법이 안 보이는 리크루터는 그냥 탭을 닫아요. 포트폴리오 프로젝트에 할 수 있는 가장 효과 큰 일은 누구든 30초 안에 길을 찾을 수 있도록 지루하고 관례적인 배치를 주는 거예요.

먼저 솔직한 메모: 이 모듈은 실시간 클라우드 배포가 아니라 저장소에 관한 거예요. 브라우저 안에서는 서버를 띄우거나 호스트로 밀어 올릴 수 없고, 그런 척하지도 않을 거예요. 여기서 배우고 증명할 수 있는 건 나중에 배포를 하찮게 만드는 구조, 테스트, 명령 하나로 돌리기예요. 끝의 배포 메모는 정말 메모예요 -> 채점하지 않는다고 표시돼요.

거의 모든 Python 프로젝트가 모이는 배치:

my_project/
  README.md            # what it is + how to run it
  pyproject.toml       # name, version, dependencies
  .env.example         # the shape of the secrets (NEVER the real ones)
  src/
    my_project/        # the importable package
      __init__.py
      __main__.py      # runs on `python -m my_project`
      core.py          # your actual code
  tests/
    test_my_project.py # pytest finds these by the test_ prefix

눈여겨볼 두 가지. 첫째, 패키지는 src/ 아래 프로젝트 이름을 딴 폴더에 살아요 -> 그게 "src 배치"이고, 테스트가 설치된 패키지 대신 로컬 폴더를 실수로 가져오지 않게 막아요. 둘째, 패키지 디렉터리 이름은 프로젝트 이름을 따라가요: triage라는 프로젝트는 src/triage/를, copilot이라는 프로젝트는 src/copilot/을 얻어요. 고정된 답 하나는 없어요 -> 트리는 이름의 함수예요.

여러분의 일은 그 함수를 쓰는 거예요. build_manifest(name)은 프로젝트 이름을 받아 저장소에 있어야 할 파일 리스트를 경로 문자열의 정렬된 리스트로 돌려줘요. README.md, pyproject.toml, __init__.py와 모듈 파일 하나를 담은 src/<name>/ 아래 패키지 디렉터리, 그리고 tests/test_*.py 파일을 포함해야 해요. 이름을 올바른 패키지 디렉터리로 정규화하세요(소문자, 그리고 공백과 하이픈을 밑줄로. doc-extractor는 가져올 수 있는 모듈 이름이 아니지만 doc_extractor는 그렇거든요).

이게 뼈대 스크립트가 디스크에 만들 목록이에요. 채점기에서 파일을 쓰지는 않아요 -> 어떤 프로젝트 이름이든 올바른 트리를 설명할 수 있는지 확인해요. Run을 눌러 triage라는 프로젝트의 배치를 출력하세요.

내 차례

프로젝트의 저장소 파일 트리를 경로 문자열의 정렬된 리스트로 돌려주는 build_manifest(name)을 쓰세요. README.md, pyproject.toml, __init__.py, __main__.py(이 파일이 3번째 레슨의 실행 명령인 python -m <pkg>를 작동하게 해요), 그리고 적어도 하나의 다른 모듈 .py 파일이 있는 src/<pkg>/ 아래 패키지 디렉터리, 그리고 tests/test_<pkg>.py라는 테스트 파일을 포함해야 해요. 다른 프로젝트 이름이 다른 트리를 만들도록 name을 패키지 디렉터리로 정규화하세요(소문자, 공백과 하이픈은 밑줄로).

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.