Project Logo

PackMate

πŸ€– μŠ€λ§ˆνŠΈν•˜κ³  μΉœκ·Όν•œ μ˜μ‘΄μ„± μ—…λ°μ΄νŠΈ 및 정리 CLI 도ꡬ

npm Info

npm Version npm Release Version npm Downloads npm Package License

github Stars github Forks github Contributors github Issues

English Β· ν•œκ΅­μ–΄

--- PackmateλŠ” Node.js ν”„λ‘œμ νŠΈ μ˜μ‘΄μ„±μ„ 관리, μ—…λ°μ΄νŠΈ 및 μ •λ¦¬ν•˜λŠ” ν˜„λŒ€μ μΈ CLI λ„κ΅¬μž…λ‹ˆλ‹€. **npm**, **pnpm**, **yarn**을 μ§€μ›ν•˜λ©°, 직관적인 μΈν„°λž™ν‹°λΈŒ UI와 κ°•λ ₯ν•œ μ„±λŠ₯ μ΅œμ ν™”λ‘œ ν”„λ‘œμ νŠΈλ₯Ό 더 λΉ λ₯΄κ³  μ•ˆμ „ν•˜κ²Œ μ΅œμ‹  μƒνƒœλ‘œ μœ μ§€ν•  수 μžˆμŠ΅λ‹ˆλ‹€. ## πŸ€– μ™œ PackmateμΈκ°€μš”? - **⚑ μ„±λŠ₯**: μΊμ‹œμ™€ 병렬 처리λ₯Ό ν™œμš©ν•΄ 반볡 μ‹€ν–‰ 속도λ₯Ό κ°œμ„  - **🎯 μ •ν™•μ„±**: 개발 도ꡬ μΈν…”λ¦¬μ „μŠ€μ™€ ꡐ차 검증 기반의 λ―Έμ‚¬μš© νŒ¨ν‚€μ§€ 탐지 - **πŸ›‘οΈ μ•ˆμ „μ„±**: νŒ¨ν‚€μ§€ λ§€λ‹ˆμ € 슀마트 폴백, λ―Έμ‚¬μš© νŒ¨ν‚€μ§€λŠ” μ—…λ°μ΄νŠΈ μ œμ™Έ - **🎨 λͺ…λ£Œμ„±**: 그룹별 UI μ„Έμ…˜ (Patch/Minor/Major) 및 색상 μ½”λ”© μ—…λ°μ΄νŠΈ - **πŸ”§ μœ μ—°μ„±**: `packmate.config.json`을 ν†΅ν•œ μ™„μ „ν•œ μ„€μ • 지원 - **🌍 ν˜„λŒ€μ **: κΉ”λ”ν•˜κ³  전문적인 μΈν„°νŽ˜μ΄μŠ€μ™€ 직관적인 μ›Œν¬ν”Œλ‘œμš° ## πŸš€ μ£Όμš” κΈ°λŠ₯ ### μ„±λŠ₯ 및 μ΅œμ ν™” - **3단계 캐싱 μ‹œμŠ€ν…œ**: λ©”λͺ¨λ¦¬ β†’ λ””μŠ€ν¬ (1μ‹œκ°„ TTL) β†’ λ„€νŠΈμ›Œν¬ - 첫 μ‹€ν–‰: ν‘œμ€€ 속도 - 두 번째 μ‹€ν–‰: μΊμ‹œλœ λ ˆμ§€μŠ€νŠΈλ¦¬ λ°μ΄ν„°λ‘œ 더 λΉ λ₯΄κ²Œ λ™μž‘ - **병렬 처리**: 파일 μŠ€μΊ”μ„ μœ„ν•œ λ©€ν‹°μ½”μ–΄ CPU ν™œμš© (**2-4λ°° 빠름**) - **μ μ‘ν˜• λ™μ‹œμ„±**: CPU μ½”μ–΄ 기반 동적 μš”μ²­ μ œν•œ (8-16 λ™μ‹œ μš”μ²­) ### 슀마트 탐지 - **ν–₯μƒλœ λ―Έμ‚¬μš© νŒ¨ν‚€μ§€ 탐지**: - 동적 import 탐지: `import('module')` - 쑰건뢀 require 탐지: `try-catch`, `if` 블둝 - DevDependencies μΈν…”λ¦¬μ „μŠ€: λΉŒλ“œ 도ꡬ, λ¦°ν„°, νƒ€μž… μ •μ˜ 인식 - ꡐ차 검증: precinct + depcheck둜 높은 신뒰도 - **μ—…λ°μ΄νŠΈ 탐지**: - Patch/Minor/Major별 κ·Έλ£Ήν™” 및 색상 μ½”λ”© - λ―Έμ‚¬μš© νŒ¨ν‚€μ§€λ₯Ό μ—…λ°μ΄νŠΈλ³΄λ‹€ λ¨Όμ € νŒλ‹¨ - λ³΄μ•ˆ κΆŒκ³ κ°€ μžˆλŠ” direct μ˜μ‘΄μ„± μ—…λ°μ΄νŠΈ 후보 ν‘œμ‹œ - Semver 기반 버전 비ꡐ - **μ„€μΉ˜ 탐지**: μ„ μ–Έλ˜μ—ˆμ§€λ§Œ μ„€μΉ˜λ˜μ§€ μ•Šμ€ νŒ¨ν‚€μ§€ μ°ΎκΈ° ### λ›°μ–΄λ‚œ UI/UX - **그룹별 UI μ„Έμ…˜**: - πŸ”Ή **Patch μ—…λ°μ΄νŠΈ** (녹색): 버그 μˆ˜μ •, μ•ˆμ „ν•˜κ²Œ μ—…λ°μ΄νŠΈ - πŸ”Έ **Minor μ—…λ°μ΄νŠΈ** (λ…Έλž€μƒ‰): μƒˆλ‘œμš΄ κΈ°λŠ₯, ν•˜μœ„ ν˜Έν™˜μ„± μœ μ§€ - πŸ”Ά **Major μ—…λ°μ΄νŠΈ** (빨간색): μ£Όμš” 변경사항, κ²€ν†  ν•„μš” - πŸ—‘οΈ **λ―Έμ‚¬μš© νŒ¨ν‚€μ§€**: λ†’μŒ/쀑간 신뒰도 레벨 - πŸ“₯ **λ―Έμ„€μΉ˜ νŒ¨ν‚€μ§€**: λˆ„λ½λœ μ„ μ–Έ μ˜μ‘΄μ„± - πŸ›‘οΈ **λ³΄μ•ˆ ꢌ고**: direct/transitive ꢌ고 ꡬ뢄 - **μ•ˆμ „ κΈ°λŠ₯**: - Major μ—…λ°μ΄νŠΈμ— λŒ€ν•œ 확인 ν”„λ‘¬ν”„νŠΈ - μ£Όμš” 변경사항 κ²½κ³  - λͺ…ν™•ν•œ μž‘μ—… μš”μ•½ - **μ‹œκ°μ  κ°œμ„ **: - 색상 μ½”λ”©λœ 버전 λ³€κ²½ - 뢄석 쀑 멈좘 κ²ƒμ²˜λŸΌ 보이지 μ•Šλ„λ‘ 진행 μƒνƒœ ν‘œμ‹œ - κ°„κ²°ν•œ 뢄석 μš”μ•½κ³Ό μ΅œμ’… μž‘μ—… κ²€ν†  ### μ„€μ • 및 μœ μ—°μ„± - **슀마트 νŒ¨ν‚€μ§€ λ§€λ‹ˆμ € 탐지**: - 락 νŒŒμΌμ—μ„œ μžλ™ 탐지 (pnpm-lock.yaml, yarn.lock, package-lock.json) - μ„€μΉ˜ μƒνƒœ 확인 - μ‚¬μš© κ°€λŠ₯ν•œ λ§€λ‹ˆμ €λ‘œ μžλ™ 폴백 및 μœ μš©ν•œ 팁 제곡 - **μ„€μ • μ˜΅μ…˜**: - μ»€μŠ€ν…€ λ¬΄μ‹œ νŒ¨ν„΄ (glob 지원) - 뢄석 λͺ¨λ“œ (conservative/moderate/aggressive) - UI μ»€μŠ€ν„°λ§ˆμ΄μ§• (κΈ°λ³Έ 선택, 색상 μŠ€ν‚΄) - μΊμ‹œ μ„€μ • (κΈ°κ°„, μœ„μΉ˜) ## πŸ’Ύ μ„€μΉ˜ ```sh npm install -g packmate # λ˜λŠ” pnpm add -g packmate # λ˜λŠ” yarn global add packmate ``` μ¦‰μ‹œ μ‹€ν–‰: ```sh npx packmate ``` ## πŸ“ μ‚¬μš©λ²• ν”„λ‘œμ νŠΈ 루트 λ””λ ‰ν† λ¦¬μ—μ„œ μ‹€ν–‰ν•˜μ„Έμš”: ```sh packmate ``` **일반적인 μ›Œν¬ν”Œλ‘œμš° μ˜ˆμ‹œ:** ```sh β”Œ πŸ“¦ Packmate: Dependency Updates & Cleanup β”‚ β—‡ Multiple lock files found. Which package manager should PackMate use? β”‚ pnpm Analysis Summary Category Count Details Updates 7 Available package updates Unused 1 Possible cleanup candidates Missing 0 Declared but not installed Current 9 Already up-to-date Security 2 advisories 1 direct, 1 transitive πŸ—‘οΈ Unused Packages (High Confidence: 1) Likely safe to remove β”‚ β—‡ Select packages to remove: β”‚ none Security Risk: High (1) Update recommended β”‚ β—‡ Select security updates: β”‚ lodash 2 advisories πŸ”Ά Major Updates (3) ⚠️ Breaking changes possible - Review carefully β”‚ β—‡ Select major updates (caution required): β”‚ none Review Actions Security updates (1) - lodash (high) Updates (2) - fs-extra β†’ 11.3.5 - js-yaml β†’ 4.1.1 β”‚ β—‡ Proceed with 3 action(s)? β”‚ No β”‚ No changes were made. β”‚ β”” Packmate complete! πŸŽ‰ ``` ## βš™οΈ μš”κ΅¬μ‚¬ν•­ - Node.js v18 이상 - npm, yarn, pnpm 지원 - Mac, Linux, Windowsμ—μ„œ μž‘λ™ ## πŸ”‘ CLI μ˜΅μ…˜ μΆ”κ°€ μ˜΅μ…˜ 없이 ν”„λ‘œμ νŠΈ λ””λ ‰ν† λ¦¬μ—μ„œ packmate만 μ‹€ν–‰ν•˜λ©΄ λ©λ‹ˆλ‹€. λͺ¨λ“  선택(μ—…λ°μ΄νŠΈ, 제거, μ„€μΉ˜)은 μΈν„°λž™ν‹°λΈŒλ‘œ μ΄λ£¨μ–΄μ§‘λ‹ˆλ‹€. ## βš™οΈ μ„€μ • PackmateλŠ” `packmate.config.json` λ˜λŠ” `package.json`의 `packmate` ν•„λ“œλ₯Ό 톡해 섀정을 μ§€μ›ν•©λ‹ˆλ‹€. ### `packmate.config.json` μ˜ˆμ‹œ: ```json { "ignorePatterns": ["@types/*", "eslint-*"], "analysisMode": { "unused": "moderate", "devDeps": true }, "ui": { "groupSessions": true, "colorScheme": "auto", "defaultChecked": { "updateAvailable": true, "unused": false, "notInstalled": true, "latest": false } }, "detection": { "dynamicImport": true, "conditionalRequire": true, "ignoreUnused": [ "eslint", "prettier", "jest", "webpack" ] } } ``` ### μ„€μ • μ˜΅μ…˜: - **ignorePatterns**: νŒ¨ν‚€μ§€ λ¬΄μ‹œλ₯Ό μœ„ν•œ glob νŒ¨ν„΄ λ°°μ—΄ (예: `["@types/*"]`) - **analysisMode.unused**: 탐지 λͺ¨λ“œ - `"conservative"` | `"moderate"` | `"aggressive"` - **analysisMode.devDeps**: devDependenciesλ₯Ό λ³„λ„λ‘œ 뢄석할지 μ—¬λΆ€ - **ui.groupSessions**: 그룹별 UI μ„Έμ…˜ ν™œμ„±ν™” (Patch/Minor/Major) - **ui.defaultChecked**: 각 νŒ¨ν‚€μ§€ μœ ν˜•μ˜ κΈ°λ³Έ 선택 μƒνƒœ - **detection.dynamicImport**: 동적 import 탐지 ν™œμ„±ν™” - **detection.conditionalRequire**: 쑰건뢀 require 탐지 ν™œμ„±ν™” - **detection.ignoreUnused**: λ―Έμ‚¬μš© νƒμ§€μ—μ„œ 항상 λ¬΄μ‹œν•  νŒ¨ν‚€μ§€ λͺ©λ‘ ### μΊμ‹œ 관리 PackmateλŠ” 더 λΉ λ₯Έ 후속 싀행을 μœ„ν•΄ λ ˆμ§€μŠ€νŠΈλ¦¬ 응닡을 μžλ™μœΌλ‘œ μΊμ‹œν•©λ‹ˆλ‹€. ν•„μš”ν•œ 경우 μΊμ‹œλ₯Ό μ§€μšΈ 수 μžˆμŠ΅λ‹ˆλ‹€: ```bash # Windows del /q %TEMP%\packmate-cache\* # Linux/Mac rm -rf /tmp/packmate-cache/* ``` μΊμ‹œ μœ„μΉ˜: - Windows: `C:\Users\\AppData\Local\Temp\packmate-cache` - Linux/Mac: `/tmp/packmate-cache` ## 🀝 κΈ°μ—¬ν•˜κΈ° κΈ°μ—¬λŠ” μ–Έμ œλ‚˜ ν™˜μ˜ν•©λ‹ˆλ‹€! 이슈λ₯Ό μ—΄κ±°λ‚˜ ν’€ λ¦¬ν€˜μŠ€νŠΈλ₯Ό μ œμΆœν•΄ μ£Όμ„Έμš”. ## πŸ’³ λΌμ΄μ„ μŠ€ [MIT](LICENSE) ---

Made with ❀️ by AGUMON πŸ¦–