✍️ 필사 모드: パッケージマネージャ完全ガイド — 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 のインストール（コールドキャッシュ）
pip install:    12.4s
poetry install:  8.1s
uv sync:         0.8s   # 15倍速い

例: A>=1.0 は B>=2.0 を要求するが、C<1.5 は 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/    - ソースtarball
#   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

# ソースtarballを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

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

    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