MicrosoftのAIエージェント用のパッケージマネージャー、APM（Agent Package Manager）を試す

これは、なにをしたくて書いたもの？

Microsoftが公開しているAPM（Agent Package Manager）がちょっと気になったので、試してみることにしました。

APM（Agent Package Manager）

APM（Agent Package Manager）のWebサイトはこちら。

APM - Agent Package Manager | Agent Package Manager

GitHubリポジトリーはこちら。

GitHub - microsoft/apm: Agent Package Manager · GitHub

APMはAgent Package Managerの略で（以降は単にAPMと書きます）、AIエージェント向けの依存関係マネージャーです。
APMを使うとスキル、プロンプト、インストラクション、プラグイン、MCPサーバーをapm.ymlというファイルで管理できます。

apm.ymlの例はこんな感じですね。

# apm.yml — ships with your project

name: your-project
version: 1.0.0
dependencies:
  apm:
    # Skills from any repository
    - anthropics/skills/skills/frontend-design
    # Plugins
    - github/awesome-copilot/plugins/context-engineering
    # Specific agent primitives from any repository
    - github/awesome-copilot/agents/api-architect.agent.md
    # A full APM package with instructions, skills, prompts, hooks...
    - microsoft/apm-sample-package#v1.0.0
  mcp:
    # MCP servers -- installed into every detected client
    - name: io.github.github/github-mcp-server
      transport: http   # MCP transport name, not URL scheme -- connects over HTTPS

以前、Vercelのskillsでエージェントのスキルをインストールしたりしてみました。

Vercelのskillsでエージェントのスキルをインストールする - CLOVER🍀

またClaude Codeでもプラグインという形でスキルなどをインストールできます。マーケットプレイスという概念もありました。

Claude Codeのプラグインを試す＋GitLabでマーケットプレイスを作成する - CLOVER🍀

これらのツールはスキルなどの追加・削除を行ったり、現在インストールされているスキルなどは確認できますし、ロックファイルも
あります。ただ、これは現物確認に近いです。ここでAPMを使うと、スキルなどをパッケージとして管理できることになります。
npmやpipのエージェント向けのものですね。

対応しているエージェントは以下です。

• GitHub Copilot
• Claude Code
• Cursor
• OpenCode
• Codex
• Gemini
• Windsurf

APMのコンセプトはこちら。

What is APM? | Agent Package Manager

ここではAPMが以下のものを管理すると書かれています。これらのことをAPMでは「プリミティブ」と呼びます。

• インストラクション
• スキル
• プロンプト
• エージェント
• フック
• コマンド
• プラグイン
• MCPサーバー

インストールしたパッケージはバージョンやハッシュが記録されます。

各プリミティブが具体的にどういうファイルを指していて、各コーディングエージェント向けにAPMがどうサポートしているかは
こちらに書かれています。

Primitives and Targets | Agent Package Manager

インストール対象のプリミティブをそのまま使えるものもあれば（native）、APMが変換するものもあったり（compiled）、サポートしていない
ものもあります。

さらに各プリミティブがコーディングエージェントのどのファイルに対応するかは以下に書かれています。

Targets matrix | Agent Package Manager

ドキュメントはパッケージの利用者向け、パッケージを作成したり公開したりする人向け、組織内でのガバナンスを効かせたい人向けに
それぞれ書かれていますが、今回は利用者目線で見ていきます。

Use APM packages | Agent Package Manager

環境

今回の環境はこちら。Ubuntu Linux 24.04 LTSです。

$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 24.04.4 LTS
Release:        24.04
Codename:       noble


$ uname -srvmpio
Linux 6.8.0-124-generic #124-Ubuntu SMP PREEMPT_DYNAMIC Tue May 26 13:00:45 UTC 2026 x86_64 x86_64 x86_64 GNU/Linux

APMをインストールする

まずはAPMをインストールします。

Quickstart | Agent Package Manager

Linux、macOSであればcurl＋bashで、Windowsであればirm＋iexでインストールします。

今回はUbuntu Linux 24.04 LTSを対象とするのでこちらのコマンドでインストール。

$ curl -sSL https://aka.ms/apm-unix | sh

インストールされました。

$ apm --version
Agent Package Manager (APM) CLI version 0.16.0 (e94af4a)

ヘルプ。

$ apm --help
Usage: apm [OPTIONS] COMMAND [ARGS]...

  Agent Package Manager (APM): The package manager for AI-Native Development

Options:
  --version  Show version and exit.
  --help     Show this message and exit.

Commands:
  audit         Scan installed packages for hidden Unicode characters
  cache         Manage the local package cache
  compile       Compile APM context into distributed AGENTS.md files
  config        Configure APM CLI
  deps          Manage APM package dependencies
  experimental  Manage experimental feature flags
  init          Initialize a new APM project
  install       Install APM and MCP dependencies (supports APM packages,...
  list          List available scripts in the current project
  marketplace   Manage marketplaces for discovery and governance
  mcp           Discover, inspect, and install MCP servers
  outdated      Show outdated locked dependencies
  pack          Pack distributable artifacts from your APM project.
  plugin        Scaffold and manage plugins (plugin-author workflows)
  policy        Inspect and diagnose APM policy
  preview       Preview a script's compiled prompt files
  prune         Remove APM packages not listed in apm.yml
  publish       Publish a package to a registry.
  run           Run a script with parameters (experimental)
  runtime       Manage AI runtimes (experimental)
  search        Search plugins in a marketplace (QUERY@MARKETPLACE)
  self-update   Update the APM CLI binary itself to the latest version
  targets       Show resolved targets for the current project.
  uninstall     Remove APM packages, their integrated files, and apm.yml...
  unpack        [Deprecated] Extract an APM bundle into the current project.
  update        Refresh APM dependencies to the latest matching refs
  view          View package metadata or list remote versions

インストール先は/usr/local/binでした。$HOME/.local/binではないんですね。

$ which apm
/usr/local/bin/apm


$ ls -l $(which apm)
lrwxrwxrwx 1 root root 22  5月 31 20:39 /usr/local/bin/apm -> /usr/local/lib/apm/apm

実行可能バイナリーが置かれるだけのようです。

$ file /usr/local/lib/apm/apm
/usr/local/lib/apm/apm: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, for GNU/Linux 3.2.0, BuildID[sha1]=f5e4eb9bd95f0a14f41d1ef1a6f8ee703c85a059, stripped


$ ldd /usr/local/lib/apm/apm
        linux-vdso.so.1 (0x00007ffd02593000)
        libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2 (0x00007296b7d10000)
        libz.so.1 => /lib/x86_64-linux-gnu/libz.so.1 (0x00007296b7cf4000)
        libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007296b7cef000)
        libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007296b7a00000)
        /lib64/ld-linux-x86-64.so.2 (0x00007296b7d1d000)

APM自身のアップデートはself-updateコマンドで。

$ apm self-update

APMを使ってみる

利用者としてのAPMの使い方の基本はこちら。

• apm initコマンドでAPMプロジェクトを作成する
• apm instlal ＜パッケージ＞で依存関係を追加する
• apm installでapm.lock.ymlファイルに従って環境をリストアする
• apm run ＜スクリプト＞でapm.ymlに宣言されたスクリプトを呼び出す

Use APM packages / The consumer flow

まずはapm initコマンドでプロジェクトを作成します。

$ apm init --help
Usage: apm init [OPTIONS] [PROJECT_NAME]

  Initialize a new APM project

Options:
  -y, --yes        Skip interactive prompts and use auto-detected defaults
  --plugin         (deprecated) Use 'apm plugin init' instead. Scaffolds
                   plugin.json + apm.yml.
  --marketplace    (deprecated) Use 'apm marketplace init' instead. Seeds a
                   marketplace block.
  --target TARGET  Comma-separated target list (skip prompt, write directly)
  -v, --verbose    Show detailed output
  --help           Show this message and exit.

使ってみるとわかりますが、apm initにプロジェクト名を指定すると新しいプロジェクト（ディレクトリー）を作成し、指定しない場合は
カレントディレクトリーをプロジェクトとして扱うようです。

今回はプロジェクト名を指定してみます。

$ apm init apm-test

対話形式でいろいろと聞かれましたが、ほぼデフォルトのままにしました。コーディングエージェントはClaude Codeにしています。

[>] Created project directory: apm-test

Setting up your APM project...
Press ^C at any time to quit.

Project name (apm-test):
Version (1.0.0):
Description (APM project for apm-test):
Author (Developer):

Select targets for this project:
  1. [ ] copilot
  2. [ ] claude
  3. [ ] cursor
  4. [ ] opencode
  5. [ ] codex
  6. [ ] gemini
  7. [ ] windsurf
  (no signals detected)

[i] Tip: select the tools your team uses. You can change this later
    with 'apm targets set <target,...>' or edit apm.yml directly.
[i] Type a number to toggle, ranges like '1-3' or '1,3,5' for multiple,
    'all' / 'none' to flip every entry, or press Enter to confirm.
Toggle (1-7, ranges, 'all'/'none', or Enter to confirm): 2
  1. [ ] copilot
  2. [x] claude
  3. [ ] cursor
  4. [ ] opencode
  5. [ ] codex
  6. [ ] gemini
  7. [ ] windsurf
Toggle (1-7, ranges, 'all'/'none', or Enter to confirm):
╭────────────────────────────────────────────────────────────────────────────── About to create ──────────────────────────────────────────────────────────────────────────────╮
│ name: apm-test                                                                                                                                                              │
│ version: 1.0.0                                                                                                                                                              │
│ description: APM project for apm-test                                                                                                                                       │
│ author: Developer                                                                                                                                                           │
│ targets: claude                                                                                                                                                             │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Is this OK? [y/n] (y):
[>] Initializing APM project: apm-test
[*] APM project initialized successfully!
    Created Files
┏━━━━━━┳━━━━━━━━━━━━━┓
┃ File ┃ Description ┃
┡━━━━━━╇━━━━━━━━━━━━━┩
│ *    │ apm.yml     │
└──────┴─────────────┘

╭────────────────────────────────────────────────────────────────────────────────  Next Steps ────────────────────────────────────────────────────────────────────────────────╮
│ * Install a package:               apm install <owner>/<repo>                                                                                                               │
│ * Run a script:                    apm run <script>                                                                                                                         │
│ * Build a plugin? Scaffold one:    apm plugin init                                                                                                                          │
│ * Publishing a marketplace?:       apm marketplace init                                                                                                                     │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
  Docs: https://microsoft.github.io/apm  |  Star: https://github.com/microsoft/apm

プロジェクト内へ移動。

$ cd apm-test

apm.ymlができています。

$ tree -a
.
└── apm.yml

1 directory, 1 file

中身はこうでした。

apm.yml

name: apm-test
version: 1.0.0
description: APM project for apm-test
author: Developer
# Which agent platforms to deploy to.
# Resolution order: --target flag > this field > auto-detect from filesystem.
# Accepted values: copilot, claude, cursor, opencode, codex, gemini, windsurf, all
targets:
- claude
dependencies:
  apm: []
  mcp: []
includes: auto
scripts: {}

では、パッケージをインストールしてみましょう。

Install packages | Agent Package Manager

apm installでインストールするようです。記述方法は以下のイメージで。

$ apm install microsoft/apm-sample-package#v1.0.0
$ apm install github/awesome-copilot/skills/review-and-refactor
$ apm install ./packages/my-shared-skills        # local path
$ apm install --dev acme/internal-debug-agents   # devDependencies

お題はこのあたりにしてみましょう。

GitHub - anthropics/skills: Public repository for Agent Skills · GitHub

GitHub - hashicorp/agent-skills: A collection of Agent skills and Claude Code plugins for HashiCorp products. · GitHub

インストール。

$ apm install anthropics/skills

こんな感じになりました。

[*] Validating 1 package...
[+] anthropics/skills
[*] Updated apm.yml with 1 new package(s)
[>] Installing 1 new package...
[>] Resolving anthropics/skills...
[i] Targets: claude  (source: apm.yml)
  [+] anthropics/skills @da20c925
  |-- Skill integrated -> .agents/skills/, .claude/skills/
  |-- 17 skill(s) integrated -> .agents/skills/, .claude/skills/
[i] Added apm_modules/ to .gitignore
  [!] 1 dependency unpinned: anthropics/skills -- add #tag or #sha to prevent drift
[*] Installed 1 APM dependency in 4.9s.

apm.yml

name: apm-test
version: 1.0.0
description: APM project for apm-test
author: Developer
targets:
- claude
dependencies:
  apm:
  - anthropics/skills
  mcp: []
includes: auto
scripts: {}

.agentsと.claudeにそれぞれ展開されたようですね。そしてanthropics/skillsに含まれるスキルがすべて入っています。

$ tree -a -L 3
.
├── .agents
│   └── skills
│       ├── algorithmic-art
│       ├── brand-guidelines
│       ├── canvas-design
│       ├── claude-api
│       ├── doc-coauthoring
│       ├── docx
│       ├── frontend-design
│       ├── internal-comms
│       ├── mcp-builder
│       ├── pdf
│       ├── pptx
│       ├── skill-creator
│       ├── slack-gif-creator
│       ├── theme-factory
│       ├── web-artifacts-builder
│       ├── webapp-testing
│       └── xlsx
├── .claude
│   └── skills
│       ├── algorithmic-art
│       ├── brand-guidelines
│       ├── canvas-design
│       ├── claude-api
│       ├── doc-coauthoring
│       ├── docx
│       ├── frontend-design
│       ├── internal-comms
│       ├── mcp-builder
│       ├── pdf
│       ├── pptx
│       ├── skill-creator
│       ├── slack-gif-creator
│       ├── theme-factory
│       ├── web-artifacts-builder
│       ├── webapp-testing
│       └── xlsx
├── .gitignore
├── apm.lock.yaml
├── apm.yml
└── apm_modules
    └── anthropics
        └── skills

42 directories, 3 files

ロックファイル。

apm.lock.yaml

lockfile_version: '1'
generated_at: '2026-05-31T11:58:52.844136+00:00'
apm_version: 0.16.0
dependencies:
- repo_url: anthropics/skills
  host: github.com
  resolved_commit: da20c92503b2e8ff1cf28ca81a0df4673debdbf7
  package_type: marketplace_plugin
  deployed_files:
  - .agents/skills/algorithmic-art
  - .agents/skills/brand-guidelines
  - .agents/skills/canvas-design
  - .agents/skills/claude-api
  - .agents/skills/doc-coauthoring
  - .agents/skills/docx
  - .agents/skills/frontend-design
  - .agents/skills/internal-comms
  - .agents/skills/mcp-builder
  - .agents/skills/pdf
  - .agents/skills/pptx
  - .agents/skills/skill-creator
  - .agents/skills/slack-gif-creator
  - .agents/skills/theme-factory
  - .agents/skills/web-artifacts-builder
  - .agents/skills/webapp-testing
  - .agents/skills/xlsx
  - .claude/skills/algorithmic-art
  - .claude/skills/brand-guidelines
  - .claude/skills/canvas-design
  - .claude/skills/claude-api
  - .claude/skills/doc-coauthoring
  - .claude/skills/docx
  - .claude/skills/frontend-design
  - .claude/skills/internal-comms
  - .claude/skills/mcp-builder
  - .claude/skills/pdf
  - .claude/skills/pptx
  - .claude/skills/skill-creator
  - .claude/skills/slack-gif-creator
  - .claude/skills/theme-factory
  - .claude/skills/web-artifacts-builder
  - .claude/skills/webapp-testing
  - .claude/skills/xlsx
  content_hash: sha256:5a94c4600dca371e7571be73552f06e11293f558b3d3b295d306b0bfefb4245b

1度パッケージをアンインストール。

$ apm uninstall anthropics/skills
[>] Uninstalling 1 package(s)...
[+] anthropics/skills - found in apm.yml
[i] Removed anthropics/skills from apm.yml
[*] Updated /path/to/apm-test/apm.yml (removed 1 package(s))
[i] Removed anthropics/skills from apm_modules/
[+] Cleaned up 17 integrated skills
[*] Uninstall complete: Removed 1 package(s) from apm.yml, Removed 1 package(s) from apm_modules/

apm.ymlから依存関係がなくなりました。

apm.yml

name: apm-test
version: 1.0.0
description: APM project for apm-test
author: Developer
targets:
- claude
dependencies:
  apm: []
  mcp: []
includes: auto
scripts: {}

ファイルもなくなっている…と思いきや、.agentsの方には残っています…。

$ tree -a -L 3
.
├── .agents
│   └── skills
│       ├── algorithmic-art
│       ├── brand-guidelines
│       ├── canvas-design
│       ├── claude-api
│       ├── doc-coauthoring
│       ├── docx
│       ├── frontend-design
│       ├── internal-comms
│       ├── mcp-builder
│       ├── pdf
│       ├── pptx
│       ├── skill-creator
│       ├── slack-gif-creator
│       ├── theme-factory
│       ├── web-artifacts-builder
│       ├── webapp-testing
│       └── xlsx
├── .claude
│   └── skills
├── .gitignore
├── apm.yml
└── apm_modules

23 directories, 2 files

こちらは手動で削除…。

$ rm -rf .agents/skills/*

今度は単一のスキルを選んでインストールしてみます。

$ apm install anthropics/skills/skills/skill-creator
[*] Validating 1 package...
[+] anthropics/skills/skills/skill-creator
[*] Updated apm.yml with 1 new package(s)
[>] Installing 1 new package...
[>] Resolving skills-skill-creator...
[i] Targets: claude  (source: apm.yml)
  [+] github.com/anthropics/skills/skills/skill-creator @da20c925
  |-- Skill integrated -> .claude/skills/
  [!] 1 dependency unpinned: anthropics/skills -- add #tag or #sha to prevent drift
[*] Installed 1 APM dependency in 3.2s.

apm.yml

name: apm-test
version: 1.0.0
description: APM project for apm-test
author: Developer
targets:
- claude
dependencies:
  apm:
  - anthropics/skills/skills/skill-creator
  mcp: []
includes: auto
scripts: {}

面白いことに、このインストール方法だと.agentsにはインストールされなくなりました…。

$ tree -a -L 3
.
├── .agents
│   └── skills
├── .claude
│   └── skills
│       └── skill-creator
├── .gitignore
├── apm.lock.yaml
├── apm.yml
└── apm_modules
    └── anthropics
        └── skills

9 directories, 3 files

もう少し追加してみます。

$ apm install hashicorp/agent-skills/terraform/code-generation/skills/terraform-style-guide
[*] Validating 1 package...
[+] hashicorp/agent-skills/terraform/code-generation/skills/terraform-style-guide
[*] Updated apm.yml with 1 new package(s)
[>] Installing 1 new package...
[i] Targets: claude  (source: apm.yml)
  [+] github.com/hashicorp/agent-skills/terraform/code-generation/skills/terraform-style-guide #default @339a1139
  |-- Skill integrated -> .claude/skills/
  [!] 1 dependency unpinned: hashicorp/agent-skills -- add #tag or #sha to prevent drift
[*] Installed 1 APM dependency in 2.6s.

$ tree -a -L 3
.
├── .agents
│   └── skills
├── .claude
│   └── skills
│       ├── skill-creator
│       └── terraform-style-guide
├── .gitignore
├── apm.lock.yaml
├── apm.yml
└── apm_modules
    ├── anthropics
    │   └── skills
    └── hashicorp
        └── agent-skills

12 directories, 3 files

apm.yml

name: apm-test
version: 1.0.0
description: APM project for apm-test
author: Developer
targets:
- claude
dependencies:
  apm:
  - anthropics/skills/skills/skill-creator
  - hashicorp/agent-skills/terraform/code-generation/skills/terraform-style-guide
  mcp: []
includes: auto
scripts: {}

だいたい感覚がわかってきましたね。

apm installでパッケージを一括でインストールする

ここで、1度.agentsおよび.claude、apm_modulesディレクトリーを削除しておきます。

$ rm -rf .agents .claude apm_modules

ちなみにapm_modulesというのはパッケージキャッシュです。

apm_modules/
├── anthropics
│   └── skills
│       └── skills
│           └── skill-creator
│               ├── LICENSE.txt
│               ├── SKILL.md
│               ├── agents
│               │   ├── analyzer.md
│               │   ├── comparator.md
│               │   └── grader.md
│               ├── assets
│               │   └── eval_review.html
│               ├── eval-viewer
│               │   ├── generate_review.py
│               │   └── viewer.html
│               ├── references
│               │   └── schemas.md
│               └── scripts
│                   ├── __init__.py
│                   ├── aggregate_benchmark.py
│                   ├── generate_report.py
│                   ├── improve_description.py
│                   ├── package_skill.py
│                   ├── quick_validate.py
│                   ├── run_eval.py
│                   ├── run_loop.py
│                   └── utils.py
└── hashicorp
    └── agent-skills
        └── terraform
            └── code-generation
                └── skills
                    └── terraform-style-guide
                        ├── SECURITY.md
                        └── SKILL.md

これでapm.ymlとapm.lock.yamlファイルだけがある状態になります。

$ tree -a
.
├── .gitignore
├── apm.lock.yaml
└── apm.yml

1 directory, 3 files

ここでapm installを実行すると、これらのファイルに書かれた依存関係をインストールしてくれます。

$ apm install
[>] Installing dependencies from apm.yml...
[>] Resolving skills-skill-creator...
[>] Resolving agent-skills-terraform-style-guide...
[i] Targets: claude  (source: apm.yml)
  [+] github.com/anthropics/skills/skills/skill-creator @da20c925
  |-- Skill integrated -> .agents/skills/, .claude/skills/
  [+] github.com/hashicorp/agent-skills/terraform/code-generation/skills/terraform-style-guide @339a1139
  |-- Skill integrated -> .agents/skills/, .claude/skills/
  [!] 2 dependencies unpinned: anthropics/skills, hashicorp/agent-skills -- add #tag or #sha to prevent drift
[*] Installed 2 APM dependencies in 0.1s.


$ tree -a -L 3
.
├── .agents
│   └── skills
│       ├── skill-creator
│       └── terraform-style-guide
├── .claude
│   └── skills
│       ├── skill-creator
│       └── terraform-style-guide
├── .gitignore
├── apm.lock.yaml
├── apm.yml
└── apm_modules
    ├── anthropics
    │   └── skills
    └── hashicorp
        └── agent-skills

14 directories, 3 files

導入的な使い方はわかった感じでしょうか。

おわりに

Microsoftが開発しているAIエージェント用のパッケージマネージャー、APM（Agent Package Manager）を試していました。

今回はスキルで試してみましたが、こういうエージェントで再利用できそうなものはパッケージとして扱われて管理されていく感じに
なるのでしょうね。まだまだ手探りな状態かなとは思いますが。

RustでCSVを扱う

これは、なにをしたくて書いたもの？

RustでCSVを扱ってみましょう、ということで。

csvクレート

RustでCSVを使うには、csvクレートを使います。

csv - Rust

GitHubリポジトリーはこちら。

GitHub - BurntSushi/rust-csv: A CSV parser for Rust, with Serde support. · GitHub

csvクレートはSerdeの実装のひとつでもあります。

Overview · Serde

最初はチュートリアルを読むのがよいとされています。

csv::tutorial - Rust

Serdeを使っていない場合は標準のレコードタイプはStringRecordおよびByteRecordです。

Unless you’re using Serde, the standard CSV record types are StringRecord and ByteRecord. StringRecord should be used when you know your data to be valid UTF-8.

Serdeを使うと、データを独自の構造体にマッピングできます。

見ておく構造体はこのあたりでしょうか。

Reader in csv - Rust

ReaderBuilder in csv - Rust

Writer in csv - Rust

WriterBuilder in csv - Rust

環境

今回の環境はこちら。

$ rustup --version
rustup 1.29.0 (28d1352db 2026-03-05)
info: This is the version for the rustup toolchain manager, not the rustc compiler.
info: the currently active `rustc` version is `rustc 1.95.0 (59807616e 2026-04-14)`

準備

Cargoパッケージの作成。

$ cargo new --lib --vcs none serde-csv-getting-started
$ cd serde-csv-getting-started

ライブラリークレートとして作成していますが、確認はバイナリークレートを増やして行うことにします。

$ mkdir src/bin

クレートを追加。

$ cargo add csv
$ cargo add serde --features derive

serdeクレートは、構造体のシリアライズ、デシリアライズを使う場合には追加します。

Cargo.toml

[package]
name = "serde-csv-getting-started"
version = "0.1.0"
edition = "2024"

[dependencies]
csv = "1.4.0"
serde = { version = "1.0.228", features = ["derive"] }

csvクレートでCSVを読み込む

まずはCSVの読み込みからやってみましょう。

チュートリアルで参照するのはこちらです。

Module tutorial / Reading CSV

最初はSerdeを使わないシンプルなパターンで書いてみます。コマンドライン引数にファイルパスが指定されていれば
ファイルから、引数なしの場合は標準入力から読み込むようにしてみました。

src/bin/read_simple.rs

use std::{
    env::args,
    fs::File,
    io::{self, Read},
};

use csv::{Reader, StringRecord};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut rdr: Reader<Box<dyn Read>> = if args().len() > 1 {
        csv::Reader::from_reader(Box::new(File::open(args().nth(1).unwrap())?))
    } else {
        csv::Reader::from_reader(Box::new(io::stdin()))
    };

    for result in rdr.records() {
        let record = result?;
        println!("record: {:?}", record);

        let sr = record as StringRecord;
        println!(
            "first field: {}, second field: {}, third field: {}",
            &sr[0], &sr[1], &sr[2]
        );
    }

    Ok(())
}

Readerはデフォルト設定で作成しています。

    let mut rdr: Reader<Box<dyn Read>> = if args().len() > 1 {
        csv::Reader::from_reader(Box::new(File::open(args().nth(1).unwrap())?))
    } else {
        csv::Reader::from_reader(Box::new(io::stdin()))
    };

Readerからはレコードをイテレーションできます。

    for result in rdr.records() {
        let record = result?;
        println!("record: {:?}", record);

        let sr = record as StringRecord;
        println!(
            "first field: {}, second field: {}, third field: {}",
            &sr[0], &sr[1], &sr[2]
        );
    }

レコードをちゃんとした型で扱う場合は、StringRecordにキャストして扱います。各フィールドにアクセスする際は、
インデックスでのアクセスになりますね。

StringRecord in csv - Rust

標準入力から読み込み。

$ echo -e "field1,field2,field3\nJava,\"Rust\",Python\n\"MySQL\",Elasticsearch,Redis" | cargo run --bin read_simple
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.02s
     Running `target/debug/read_simple`
record: StringRecord(["Java", "Rust", "Python"])
first field: Java, second field: Rust, third field: Python
record: StringRecord(["MySQL", "Elasticsearch", "Redis"])
first field: MySQL, second field: Elasticsearch, third field: Redis

StringRecordとして解釈されていることがわかりますね。デフォルトで、1行目はヘッダーとみなされます。
"で囲った場合もデフォルトで解釈してくれるようです。

ファイルから読み込んでみます。

input/people.csv

first_name,last_name,age
カツオ,"磯野",11
"ワカメ",磯野,9
タラオ,フグ田,"3"

実行。

$ cargo run --bin read_simple input/people.csv
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.02s
     Running `target/debug/read_simple input/people.csv`
record: StringRecord(["カツオ", "磯野", "11"])
first field: カツオ, second field: 磯野, third field: 11
record: StringRecord(["ワカメ", "磯野", "9"])
first field: ワカメ, second field: 磯野, third field: 9
record: StringRecord(["タラオ", "フグ田", "3"])
first field: タラオ, second field: フグ田, third field: 3

よさそうです。

次はSerdeと組み合わせてみましょう。

Module tutorial / Reading CSV / Reading with Serde

データをマッピングする構造体を定義します。

src/lib.rs

use serde::{Deserialize, Serialize};

#[derive(Debug, Deserialize, Serialize)]
pub struct Person {
    pub first_name: String,
    pub last_name: String,
    pub age: i32,
}

読み込みだけで使うのならDeserializeであればいいのですが、この後の書き込みでも共用するのでSerializeも
つけておきました。

データを構造体にデシリアライズするコード。

src/bin/read_serde.rs

use std::{collections::HashMap, env::args};

use serde_csv_getting_started::Person;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut rdr = csv::ReaderBuilder::new()
        .has_headers(true)
        .delimiter(b',')
        .from_path(args().nth(1).unwrap())?;

    for result in rdr.deserialize() {
        let record: Person = result?;

        println!("deserialized record: {:?}", record);
        println!(
            "first name: {}, last_name: {}, age: {}",
            record.first_name, record.last_name, record.age
        );
    }

    let mut rdr = csv::ReaderBuilder::new()
        .has_headers(true)
        .delimiter(b',')
        .from_path(args().nth(1).unwrap())?;

    for result in rdr.deserialize() {
        let record: HashMap<String, String> = result?;

        println!("deserialized map record: {:?}", record);
        println!(
            "first name: {}, last_name: {}, age: {}",
            record.get("first_name").unwrap(),
            record.get("last_name").unwrap(),
            record.get("age").unwrap()
        );
    }

    Ok(())
}

今回はファイルを入力にします。同じファイルを2回読んでいて、今回作成した構造体とHashMapにそれぞれデシリアライズ
します。

あとReaderもカスタマイズするコードにしておきました。といっても、デフォルト値ですが。

    let mut rdr = csv::ReaderBuilder::new()
        .has_headers(true)
        .delimiter(b',')
        .from_path(args().nth(1).unwrap())?;

今回のポイントは、Reader#deserializeですね。

    for result in rdr.deserialize() {
        let record: Person = result?;

これで構造体にデシリアライズできるようになります。

確認。

$ cargo run --bin read_serde input/people.csv
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.06s
     Running `target/debug/read_serde input/people.csv`
deserialized record: Person { first_name: "カツオ", last_name: "磯野", age: 11 }
first name: カツオ, last_name: 磯野, age: 11
deserialized record: Person { first_name: "ワカメ", last_name: "磯野", age: 9 }
first name: ワカメ, last_name: 磯野, age: 9
deserialized record: Person { first_name: "タラオ", last_name: "フグ田", age: 3 }
first name: タラオ, last_name: フグ田, age: 3
deserialized map record: {"first_name": "カツオ", "age": "11", "last_name": "磯野"}
first name: カツオ, last_name: 磯野, age: 11
deserialized map record: {"last_name": "磯野", "first_name": "ワカメ", "age": "9"}
first name: ワカメ, last_name: 磯野, age: 9
deserialized map record: {"age": "3", "first_name": "タラオ", "last_name": "フグ田"}
first name: タラオ, last_name: フグ田, age: 3

用意した構造体、HashMapそれぞれにデシリアライズできていることが確認できました。

csvクレートでCSVを書き込む

次はCSVの書き込みです。

Module tutorial / Writing CSV

まずはシンプルなパターンから。ファイルパスの指定有無で、ファイルに書き出すか標準出力に書き出すかの動作が変わるように
しています。

src/bin/write_simple.rs

use std::{
    env::args,
    fs::File,
    io::{self, Write},
};

use csv::{StringRecord, Writer};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut wtr: Writer<Box<dyn Write>> = if args().len() > 1 {
        csv::Writer::from_writer(Box::new(File::create(args().nth(1).unwrap())?))
    } else {
        csv::Writer::from_writer(Box::new(io::stdout()))
    };

    // header
    wtr.write_record(["field1", "field2", "field3"])?;

    // data
    wtr.write_record(["Java", "Rust", "Python"])?;
    wtr.write_record(&StringRecord::from(vec!["MySQL", "Elasticsearch", "Redis"]))?;

    wtr.flush()?;

    Ok(())
}

ヘッダーもレコードとして書き出します。

    // header
    wtr.write_record(["field1", "field2", "field3"])?;

データは配列やVecとして与えてもいいですし、StringRecordとして与えてもOKです。

    // data
    wtr.write_record(["Java", "Rust", "Python"])?;
    wtr.write_record(&StringRecord::from(vec!["MySQL", "Elasticsearch", "Redis"]))?;

flushすることも忘れずに。

    wtr.flush()?;

ここで、ドキュメントでは少しWriter#write_recordのシグニチャーについて説明があります。

pub fn write_record<I, T>(&mut self, record: I) -> Result<()>
where
    I: IntoIterator<Item = T>,
    T: AsRef<[u8]>,

https://docs.rs/csv/1.4.0/csv/struct.Writer.html#method.write_record

これは引数はIteratorに変換でき、中身は[u8]（バイトスライス）に変換できる型であることを表しています。

確認してみましょう。

標準出力に書き出す場合。

$ cargo run --bin write_simple
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.06s
     Running `target/debug/write_simple`
field1,field2,field3
Java,Rust,Python
MySQL,Elasticsearch,Redis

ファイルに書き出す場合。

$ cargo run --bin write_simple output/simple.csv
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.01s
     Running `target/debug/write_simple output/simple.csv`

output/simple.csv

field1,field2,field3
Java,Rust,Python
MySQL,Elasticsearch,Redis

OKですね。

最後にSerdeを使ってみます。

src/bin/write_serde.rs

use std::env::args;

use serde_csv_getting_started::Person;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut wtr = csv::WriterBuilder::new()
        .has_headers(true)
        .delimiter(b',')
        .from_path(args().nth(1).unwrap())?;

    wtr.serialize(Person {
        first_name: "カツオ".to_string(),
        last_name: "磯野".to_string(),
        age: 11,
    })?;

    wtr.serialize(Person {
        first_name: "ワカメ".to_string(),
        last_name: "磯野".to_string(),
        age: 9,
    })?;

    wtr.serialize(Person {
        first_name: "タラオ".to_string(),
        last_name: "フグ田".to_string(),
        age: 3,
    })?;

    wtr.flush()?;

    Ok(())
}

Writerの作成もカスタマイズ向けのコードにしてみました。

    let mut wtr = csv::WriterBuilder::new()
        .has_headers(true)
        .delimiter(b',')
        .from_path(args().nth(1).unwrap())?;

構造体を書き込む時は、Write#serializeを呼び出します。

    wtr.serialize(Person {
        first_name: "カツオ".to_string(),
        last_name: "磯野".to_string(),
        age: 11,
    })?;

変わるのはここだけですね。

確認。

$ cargo run --bin write_serde output/people.csv
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.02s
     Running `target/debug/write_serde output/people.csv`

output/people.csv
first_name,last_name,age
カツオ,磯野,11
ワカメ,磯野,9
タラオ,フグ田,3

OKです。

こんなところでしょうか。

おわりに

RustでCSVを扱ってみました。

Serdeクレートも合わせて使ってみましたが、ちょっと独特なところがありますね。慣れたら使っていけるとは思いますが。

ひとまず、シリアライズ・デシリアライズにはSerdeと覚えておきましょう。