# Artefacts ツールキット (ベータ版)

> Artefacts ツールキットの使用方法

---

Site [llms.txt](/ja/llms.txt)

---

> [!NB] _Artefacts ツールキットは常に開発中であり、新機能の追加や改善が行われています。定期的にご確認ください！_

Artefacts ツールキットは、開発者の生産性を向上させるために設計された Python パッケージです。一般的なテストタスクを簡素化し、Artefacts プラットフォームと統合するヘルパー関数のコレクションを提供します。

ツールキットは以下のモジュールで構成されています：

* [設定ヘルパー](/artefacts-toolkit/config) - パラメトリックテストを簡素化し、 `artefacts.yaml` ファイルから設定を取り込む
* [チャートヘルパー](/artefacts-toolkit/charts) - テストデータから可視化を生成する
* [Gazebo ヘルパー](/artefacts-toolkit/gazebo) - テスト中に Gazebo シミュレーションとやり取りする
* [Rosbag ヘルパー](/artefacts-toolkit/rosbag) - ROS バッグファイルからデータを記録、抽出、分析する
* [Rerun ヘルパー](/artefacts-toolkit/rerun) - シミュレーション中に Rerun の `.rrd` ファイルを記録し、それに対してテストのアサーションを行う
* [ナビゲーションヘルパー](/artefacts-toolkit/navigation) - RViz でルートを記録し、その開始位置にロボットをスポーンさせ、Nav2 で走行させて結果に対してアサーションを行う

## インストール

```bash
pip install artefacts-toolkit
```

> [!NOTE]
> Artefacts ツールキットは、Artefacts CLI、 `artefacts.yaml`、および Artefacts ダッシュボードと一緒に使用するように設計されています。一部の機能はそれらがなくても動作する場合がありますが、保証はできません。

## Artefacts ツールキットを使用したサンプルプロジェクト：

* <a href="https://github.com/art-e-fact/navigation2_ignition_gazebo_example/tree/main" target="_blank">Nav2</a> - Nav2 ナビゲーションスタックと Gazebo を使用したサンプルプロジェクト。

---

Section pages:

- [Artefacts ツールキットの設定ヘルパー](/ja/artefacts-toolkit/config/)
- [Artefacts ツールキットのチャートヘルパー](/ja/artefacts-toolkit/charts/)
- [Artefacts ツールキットの Gazebo ヘルパー](/ja/artefacts-toolkit/gazebo/)
- [Artefacts ツールキットの Rosbag ヘルパー](/ja/artefacts-toolkit/rosbag/)
- [Artefacts ツールキットの Rerun ヘルパー](/ja/artefacts-toolkit/rerun/)
- [Artefacts ツールキットのナビゲーションヘルパー](/ja/artefacts-toolkit/navigation/)