project-aggregator 0.3.0

폴더 구조와 코드들을 하나의 txt 파일에 작성해주는 도구

pagr (Project Aggregator) 📄➡️📦

pagr는 프로젝트의 디렉토리 구조와 선택된 파일들의 내용을 하나의 텍스트 파일로 깔끔하게 취합해주는 명령줄 도구입니다. ChatGPT와 같은 AI 모델에게 프로젝트 전체 컨텍스트를 효율적으로 전달해야 할 때 유용하게 사용할 수 있습니다.

이 도구는 .gitignore와 .pagrignore 파일에 명시된 패턴을 기반으로 동작합니다. 특히 .pagrignore 파일을 사용하면 .gitignore에서 무시된 파일도 ! 패턴을 통해 다시 포함시킬 수 있는 유연성을 제공합니다.

🚀 설치 (Installation)

pipx를 사용하여 pagr를 설치하는 것을 강력히 권장합니다. pipx는 CLI 도구를 시스템의 다른 라이브러리와 격리된 환경에 설치하고 실행해주어, 파이썬 환경의 충돌을 방지합니다.

1. pipx 설치 (아직 없다면):

   # pip를 통해 pipx 설치
   pip install --user pipx
   # PATH 환경변수에 pipx 경로 추가 (필요시)
   python -m pipx ensurepath
   

   (설치 후 터미널을 재시작해야 할 수도 있습니다.)

2. pagr 설치 (via pipx):

   pipx install project-aggregator
   

   이제 터미널 어디서든 pagr 명령어를 사용할 수 있습니다! 🎉

💡 사용법 (Usage)

1. 프로젝트 취합 (run)

.gitignore와 .pagrignore 파일의 규칙에 따라 파일을 필터링하고 취합하여 하나의 텍스트 파일을 생성합니다.

# 현재 디렉토리의 모든 파일(무시 규칙 제외) 취합
pagr run

# 결과를 특정 파일에 저장
pagr run --output full_project.txt

# 'src' 폴더와 최상위의 모든 '.py' 파일만 대상으로 취합 (무시 규칙은 여전히 적용됨)
pagr run "src/**/*.py" "*.py"

# 특정 루트 디렉토리를 기준으로 실행
pagr run --root /path/to/my_project

3. 미리보기 (preview, preview-only)

파일을 실제로 생성하지 않고 어떤 파일들이 취합될지 목록을 미리 확인합니다.

# run 명령어가 어떤 파일을 포함할지 미리보기
pagr preview

# run 명령어에 패턴을 줬을 때의 결과 미리보기
pagr preview "src/**/*.py"

4. 설정 파일 편집

# 무시 규칙(.pagrignore) 편집 (모든 명령어에 적용)
pagr ignore

ℹ️ 기타 명령어

# 버전 확인
pagr --version

# 전체 도움말 보기
pagr --help

# 특정 명령어의 도움말 보기
pagr run --help