✍️ 필사 모드: 패키지 매니저 완전 가이드 — npm, uv, RPM, Homebrew 원리와 소프트웨어 등록법

{
  "name": "my-project",
  "version": "1.0.0",
  "dependencies": {
    "express": "^4.18.0",
    "lodash": "~4.17.21"
  },
  "devDependencies": {
    "jest": "^29.0.0"
  }
}

{
  "name": "my-project",
  "lockfileVersion": 3,
  "packages": {
    "node_modules/express": {
      "version": "4.18.2",
      "resolved": "https://registry.npmjs.org/express/-/express-4.18.2.tgz",
      "integrity": "sha512-abc123..."
    }
  }
}

~/.pnpm-store/
  v3/
    files/
      ab/cdef1234...   # lodash 4.17.21의 실제 파일

project-a/node_modules/.pnpm/
  lodash@4.17.21/
    node_modules/
      lodash/
        index.js  -->  ~/.pnpm-store/v3/files/ab/cdef1234... (하드링크)

npm adduser
# 또는 이미 계정이 있다면
npm login

mkdir my-awesome-lib
cd my-awesome-lib
npm init

{
  "name": "my-awesome-lib",
  "version": "1.0.0",
  "description": "A library that does awesome things",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "files": ["dist"],
  "scripts": {
    "build": "tsc",
    "prepublishOnly": "npm run build"
  },
  "keywords": ["awesome", "utility"],
  "author": "Your Name",
  "license": "MIT",
  "repository": {
    "type": "git",
    "url": "https://github.com/yourname/my-awesome-lib"
  }
}

# 빌드 확인
npm run build

# 배포 전 미리보기 (어떤 파일이 포함되는지 확인)
npm pack --dry-run

# 실제 배포
npm publish

# 스코프가 있는 패키지 (공개)
npm publish --access public

# 패치 버전 올리기 (1.0.0 -> 1.0.1)
npm version patch

# 마이너 버전 올리기 (1.0.1 -> 1.1.0)
npm version minor

# 메이저 버전 올리기 (1.1.0 -> 2.0.0)
npm version major

# 배포
npm publish

# uv 설치
curl -LsSf https://astral.sh/uv/install.sh | sh

# 프로젝트 생성
uv init my-project
cd my-project

# 의존성 추가
uv add requests flask

# 의존성 동기화 (lock 파일 기반)
uv sync

# requests + flask + sqlalchemy 설치 (cold cache)
pip install:    12.4s
poetry install:  8.1s
uv sync:         0.8s   # 15x 빠름

예시: A>=1.0 requires B>=2.0, but C<1.5 requires B<2.0
  -> 충돌 발생
  -> 학습: A>=1.0 AND C<1.5 는 동시에 성립 불가
  -> 백트래킹 후 다른 버전 시도

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "my-python-lib"
version = "1.0.0"
description = "A useful Python library"
readme = "README.md"
requires-python = ">=3.9"
license = "MIT"
authors = [
    { name = "Your Name", email = "you@example.com" }
]
dependencies = [
    "requests>=2.28.0",
    "pydantic>=2.0",
]

[project.urls]
Homepage = "https://github.com/yourname/my-python-lib"
Documentation = "https://my-python-lib.readthedocs.io"

[project.optional-dependencies]
dev = ["pytest", "ruff", "mypy"]

# 빌드 도구 설치
uv add --dev build

# 빌드 실행
python -m build

# dist/ 디렉토리에 .whl과 .tar.gz 파일이 생성됨
ls dist/
# my_python_lib-1.0.0-py3-none-any.whl
# my_python_lib-1.0.0.tar.gz

# twine 설치
uv add --dev twine

# TestPyPI에 업로드
python -m twine upload --repository testpypi dist/*

# 테스트 설치
pip install --index-url https://test.pypi.org/simple/ my-python-lib

# PyPI에 업로드
python -m twine upload dist/*

# 이제 누구나 설치 가능
pip install my-python-lib
# 또는
uv add my-python-lib

name: Publish to PyPI
on:
  release:
    types: [published]

jobs:
  publish:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: pip install build
      - run: python -m build
      - uses: pypa/gh-action-pypi-publish@release/v1

# RPM 직접 사용 (의존성 자동 해결 안 됨)
rpm -ivh package-1.0.0-1.el9.x86_64.rpm

# dnf 사용 (의존성 자동 해결)
dnf install nginx

# 패키지 정보 조회
rpm -qi nginx

# 패키지에 포함된 파일 목록
rpm -ql nginx

# 빌드 도구 설치
dnf install rpm-build rpmdevtools

# 빌드 디렉토리 구조 생성
rpmdev-setuptree

# 생성되는 구조:
# ~/rpmbuild/
#   BUILD/      - 빌드가 수행되는 디렉토리
#   RPMS/       - 빌드된 RPM 파일
#   SOURCES/    - 소스 타르볼
#   SPECS/      - spec 파일
#   SRPMS/      - 소스 RPM 파일

Name:           myapp
Version:        1.0.0
Release:        1%{?dist}
Summary:        My awesome application

License:        MIT
URL:            https://github.com/yourname/myapp
Source0:        %{name}-%{version}.tar.gz

BuildRequires:  gcc
BuildRequires:  make
Requires:       openssl-libs

%description
MyApp is an awesome application that does useful things.
It supports multiple platforms and is easy to configure.

%prep
%autosetup

%build
%configure
%make_build

%install
%make_install

%files
%license LICENSE
%doc README.md
%{_bindir}/myapp
%{_mandir}/man1/myapp.1*
%config(noreplace) %{_sysconfdir}/myapp.conf

%changelog
* Sat Apr 12 2026 Your Name <you@example.com> - 1.0.0-1
- Initial package

# 소스 타르볼을 SOURCES에 복사
cp myapp-1.0.0.tar.gz ~/rpmbuild/SOURCES/

# RPM 빌드 (-ba: 바이너리와 소스 RPM 모두)
rpmbuild -ba ~/rpmbuild/SPECS/myapp.spec

# 빌드된 RPM 확인
ls ~/rpmbuild/RPMS/x86_64/
# myapp-1.0.0-1.el9.x86_64.rpm

# createrepo 설치
dnf install createrepo_c

# 레포 디렉토리 생성
mkdir -p /var/www/html/myrepo/

# RPM 복사
cp ~/rpmbuild/RPMS/x86_64/myapp-*.rpm /var/www/html/myrepo/

# 레포 메타데이터 생성
createrepo /var/www/html/myrepo/

# /etc/yum.repos.d/myrepo.repo
[myrepo]
name=My Custom Repository
baseurl=http://myserver.example.com/myrepo/
enabled=1
gpgcheck=0

# 패키지 설치
brew install wget

# 설치 경로 확인
brew --prefix wget
# /opt/homebrew/opt/wget

# Cellar 내부 구조
ls /opt/homebrew/Cellar/wget/1.21.4/
# bin/  etc/  share/

# keg-only 패키지 강제 링크
brew link --force openssl@3

# Formula/myapp.rb
class Myapp < Formula
  desc "My awesome command-line application"
  homepage "https://github.com/yourname/myapp"
  url "https://github.com/yourname/myapp/archive/refs/tags/v1.0.0.tar.gz"
  sha256 "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
  license "MIT"

  depends_on "go" => :build

  def install
    system "go", "build", *std_go_args(ldflags: "-s -w -X main.version=#{version}")
  end

  test do
    assert_match "myapp version #{version}", shell_output("#{bin}/myapp --version")
  end
end

# Tap 추가
brew tap yourname/mytap

# 설치
brew install yourname/mytap/myapp

# 또는 Tap 추가 후 직접 설치
brew install myapp

# homebrew-core 클론 및 Formula 추가
brew tap --force homebrew/core
cd $(brew --repository homebrew/core)

# Formula 생성 헬퍼
brew create https://github.com/yourname/myapp/archive/refs/tags/v1.0.0.tar.gz

# Formula 검증
brew audit --new myapp
brew test myapp

# PR 제출 (GitHub CLI)
gh pr create --title "myapp 1.0.0 (new formula)" --body "Description of the tool..."

# Casks/myguiapp.rb
cask "myguiapp" do
  version "2.1.0"
  sha256 "abc123def456..."

  url "https://github.com/yourname/myguiapp/releases/download/v#{version}/MyGuiApp-#{version}.dmg"
  name "MyGuiApp"
  desc "A beautiful GUI application"
  homepage "https://myguiapp.example.com"

  app "MyGuiApp.app"

  zap trash: [
    "~/Library/Application Support/MyGuiApp",
    "~/Library/Preferences/com.yourname.myguiapp.plist",
  ]
end

# Cask 설치
brew install --cask myguiapp

class ComplexApp < Formula
  desc "A complex application with many build options"
  homepage "https://complexapp.dev"

  # 안정 버전 소스
  url "https://github.com/yourname/complexapp/archive/refs/tags/v2.0.0.tar.gz"
  sha256 "deadbeef..."

  # HEAD 버전 (개발 중)
  head "https://github.com/yourname/complexapp.git", branch: "main"

  license "Apache-2.0"

  # 빌드 의존성
  depends_on "cmake" => :build
  depends_on "pkg-config" => :build

  # 런타임 의존성
  depends_on "openssl@3"
  depends_on "sqlite"

  # 플랫폼 제한
  depends_on :macos

  # Python 바인딩 (선택)
  option "with-python", "Build Python bindings"
  depends_on "python@3.12" if build.with?("python")

  def install
    args = %W[
      --prefix=#{prefix}
      --with-openssl=#{Formula["openssl@3"].opt_prefix}
      --with-sqlite=#{Formula["sqlite"].opt_prefix}
    ]

    args << "--with-python" if build.with?("python")

    system "./configure", *args
    system "make", "install"

    # 쉘 완성 스크립트 설치
    bash_completion.install "completions/complexapp.bash"
    zsh_completion.install "completions/_complexapp"
    fish_completion.install "completions/complexapp.fish"
  end

  # 설치 후 안내 메시지
  def caveats
    <<~EOS
      To start complexapp as a service:
        brew services start complexapp
    EOS
  end

  # 설치 검증 테스트
  test do
    assert_match version.to_s, shell_output("#{bin}/complexapp --version")
    system "#{bin}/complexapp", "check"
  end
end