Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
070b0a6
Docs: #514 の実装計画を書く
takemi-ohama Nov 6, 2026
94f1098
Feat: #514 GitHub の参照の解決と gh の呼び出しを足す
takemi-ohama Nov 6, 2026
642f121
Feat: #514 作成フローの雛形と registry.yml への追記を足す
takemi-ohama Nov 6, 2026
cb1d1c7
Feat: #514 登録の照合と早送りの取り込みを足す
takemi-ohama Nov 6, 2026
858405a
Feat: #514 一時の clone から既定ブランチへ反映する処理を足す
takemi-ohama Nov 6, 2026
9decece
Feat: #514 devbase plugin repo new を足す
takemi-ohama Nov 6, 2026
848ed15
Feat: #514 devbase plugin new を足す
takemi-ohama Nov 6, 2026
cfc7033
Feat: #514 devbase project new を足す
takemi-ohama Nov 6, 2026
49db5f3
Feat: #514 新しいコマンドのシェル補完を足す
takemi-ohama Nov 6, 2026
0f06ff8
Feat: #514 TUI のプラグインのメニューを用途で分け、新規追加の入口を足す
takemi-ohama Nov 6, 2026
58a20dd
Docs: #514 新しいコマンドの文書と変更履歴を書く
takemi-ohama Nov 6, 2026
ba2b256
Docs: #514 名前の形とプロジェクトの走査の仕様へ作成フローを足す
takemi-ohama Nov 6, 2026
1b46bbe
Merge pull request #517 from devbasex/feat/issue-514-issue-514
takemi-ohama Nov 6, 2026
ca80477
Fix: #514 作成フローのレビューの指摘 7 件を直す
takemi-ohama Nov 6, 2026
bec38cf
Fix: #514 作成フローのレビューの指摘 4 件を直す
takemi-ohama Nov 6, 2026
0ec1696
Fix: #514 作成するプロジェクトのイメージ名を Docker の参照の形にする
takemi-ohama Nov 6, 2026
848847d
Fix: #514 Compose とブランチにできない名前のレビューの指摘 3 件を直す
takemi-ohama Nov 6, 2026
40d6c19
Docs: #514 の作成フローを確定仕様にする
takemi-ohama Nov 6, 2026
4fd5f67
Refactor: #514 新しいコマンドの副命令を new から create へ改名する
takemi-ohama Nov 6, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,19 @@

## [Unreleased]

### Added
- **リポジトリ・プラグイン・プロジェクトを新規に足すコマンドを足しました(#514)。**
`devbase plugin repo create <repo>`・`devbase plugin create <repo>`・`devbase project create <repo>` は、GitHub の URL か
`owner/repo` を受け、権限の確認からファイルの配置・PR・マージ・手元への取り込み・登録までを 1 回で行います。
新しいリポジトリは private で作り、`--public` のときだけ公開します。`project create` は入れ先のプラグインとアカウントグループを
引数か既存の値から決め、決まらないときは端末で聞きます。変更の前に作成の計画を示して確認し、端末が無いときは `--yes` が要ります。
コンテナは起動しません。`gh` が要るのはこの 3 つのコマンドだけです。

### Changed
- **`devbase list` の TUI のプラグインのメニューを、用途で分けた 2 階層に組み直しました(#514)。**
第 1 階層は「見る」「新規追加」「導入・更新」「削除」「保守」で、これまでの操作はすべてこの下にあります。
「新規追加」から上の 3 つの操作を実行できます。

## [4.1.1] - 2026-10-31

派生イメージ(`general`・`php`・`php85`)の言語サーバ(#236)は、`devbase build` でイメージを建て直した後に届きます。
Expand Down
4 changes: 4 additions & 0 deletions docs/developer/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,6 +154,10 @@ flowchart LR
| `registry.py` | `plugins.yml` の読み書き |
| `installer.py` | プラグインの install / uninstall。Git clone やローカルリンクに対応 |
| `repo_manager.py` | リポジトリの add / remove / list / refresh |
| `github.py` | GitHub の参照の解決と `gh` の呼び出し(権限・作成・PR・マージ) |
| `scaffold.py` | 作成フローの雛形の生成と `registry.yml` への追記 |
| `publish.py` | 一時の浅い clone から既定ブランチへ変更を入れる |
| `creator.py` | 作成フローの計画(読むだけ)と実行。入れ先とグループの決定 |
| `updater.py` | プラグインの update とマイグレーション |
| `syncer.py` | `plugins/*/projects/*` から `projects/` へのシンボリックリンク同期 |
| `info.py` | プラグイン詳細情報の表示 |
Expand Down
8 changes: 4 additions & 4 deletions docs/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -265,10 +265,10 @@ devbase up / scale がコンテナを起動して待ち、その後にホスト

## プラグインの配布(`plugin-distribution`)

プラグインリポジトリの作成と登録、プラグインとプロジェクトの追加(lib/devbase/plugin/ と devbase plugin / devbase project new)
プラグインリポジトリの作成と登録、プラグインとプロジェクトの追加(lib/devbase/plugin/ と devbase plugin / devbase project create)

| 語 | 識別子 | 意味 | 廃止した語 | 廃止した識別子 | 正本 |
| --- | --- | --- | --- | --- | --- |
| プラグインリポジトリ | — | 直下に registry.yml を持つ Git リポジトリ。収めたプラグインは 0 件でもよい。devbase plugin repo add で登録する | — | — | — |
| 作成フロー | — | リポジトリ・プラグイン・プロジェクトを足す一連の操作。権限の確認からマージ、手元への取り込み、登録までを含む | — | — | — |
| 作成の計画 | — | 作成フローが書き込みの前に確定する、作るもの・ファイル・マージ先の組 | — | — | — |
| プラグインリポジトリ | — | 直下に registry.yml を持つ Git リポジトリ。収めたプラグインは 0 件でもよい。devbase plugin repo add で登録する | — | — | `docs/specifications/plugin-creation-flow.md` |
| 作成フロー | — | リポジトリ・プラグイン・プロジェクトを足す一連の操作。権限の確認からマージ、手元への取り込み、登録までを含む | — | — | `docs/specifications/plugin-creation-flow.md` |
| 作成の計画 | — | 作成フローが書き込みの前に確定する、作るもの・ファイル・マージ先の組 | — | — | `docs/specifications/plugin-creation-flow.md` |
8 changes: 4 additions & 4 deletions docs/glossary/glossary.json
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@
{
"id": "plugin-distribution",
"name": "プラグインの配布",
"meaning": "プラグインリポジトリの作成と登録、プラグインとプロジェクトの追加(lib/devbase/plugin/ と devbase plugin / devbase project new)"
"meaning": "プラグインリポジトリの作成と登録、プラグインとプロジェクトの追加(lib/devbase/plugin/ と devbase plugin / devbase project create)"
}
],
"terms": [
Expand Down Expand Up @@ -1060,19 +1060,19 @@
"term": "プラグインリポジトリ",
"context": "plugin-distribution",
"meaning": "直下に registry.yml を持つ Git リポジトリ。収めたプラグインは 0 件でもよい。devbase plugin repo add で登録する",
"pending_source": "issues/issue-514-design.md"
"source": "docs/specifications/plugin-creation-flow.md"
},
{
"term": "作成フロー",
"context": "plugin-distribution",
"meaning": "リポジトリ・プラグイン・プロジェクトを足す一連の操作。権限の確認からマージ、手元への取り込み、登録までを含む",
"pending_source": "issues/issue-514-design.md"
"source": "docs/specifications/plugin-creation-flow.md"
},
{
"term": "作成の計画",
"context": "plugin-distribution",
"meaning": "作成フローが書き込みの前に確定する、作るもの・ファイル・マージ先の組",
"pending_source": "issues/issue-514-design.md"
"source": "docs/specifications/plugin-creation-flow.md"
}
]
}
3 changes: 2 additions & 1 deletion docs/plugin-dev/plugin-yml-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -285,7 +285,8 @@ ecommerce/

`plugin.yml` は Plugin ごとに 1 ファイルです。1 つのリポジトリで複数の Plugin を配布する場合は、
Plugin ごとにディレクトリを分けてそれぞれに `plugin.yml` を置き、リポジトリルートの
`registry.yml` に一覧を記述します。
`registry.yml` に一覧を記述します。リポジトリの直下に `registry.yml` があればプラグインリポジトリとして登録でき、
収めたプラグインは 0 件(`plugins: []`)でもかまいません。

```
my-registry/
Expand Down
14 changes: 14 additions & 0 deletions docs/plugin-dev/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,20 @@ devbase用のPluginを作成し、公開するまでの手順を解説します

---

## コマンドで足す

GitHub で公開するプラグインは、`gh` が使えればコマンド 1 つで足せます。ファイルの配置・PR・マージ・手元への取り込みまで終わります。

```bash
devbase plugin repo create your-user/my-plugins # プラグインリポジトリを用意して登録する
devbase plugin create your-user/my-plugins --name my-plugin # プラグインを足して導入する
devbase project create your-user/my-app --plugin my-plugin --group personal # プロジェクトを足す
```

詳しくは [plugin グループ](../user/cli-reference/04-plugin.md#作成フローplugin-create--plugin-repo-create--project-create-に共通)を参照してください。この後の節は、手でファイルを置くときの手順です。

---

## 1. Pluginリポジトリの作成

### 1.1 Gitリポジトリの初期化
Expand Down
7 changes: 4 additions & 3 deletions docs/specifications/cli-argument-resolution.md
Original file line number Diff line number Diff line change
Expand Up @@ -214,7 +214,7 @@ zsh(`etc/_devbase`)は、サブコマンドの分岐から `_arguments` を
| 規則 | `[A-Za-z0-9][A-Za-z0-9._-]*` に**全体が**一致する。先頭が英数字なので `.`・`..`・`-x`・空文字は当たらない。`/`・`\`・空白・非 ASCII は含められない |
| Python | `devbase.utils.names.is_single_segment_name(value)`。`re.fullmatch` で見るため、末尾の改行も不一致になる |
| shell | `_SINGLE_SEGMENT_NAME_RE='^[A-Za-z0-9][A-Za-z0-9._-]*$'`。比較は関数の中で `local LC_ALL=C` にして行う |
| 使う場所 | shell: `maybe_cd_project`、`build` の衝突の判定。Python: `_resolve_project_name`、`_named_lifecycle_project`、`_build_single_image` |
| 使う場所 | shell: `maybe_cd_project`、`build` の衝突の判定。Python: `_resolve_project_name`、`_named_lifecycle_project`、`_build_single_image`、作成フローのプラグイン名とプロジェクト名の確認(`plugin/creator.py` の `_checked_name`) |

プロジェクト名とイメージ名は同じ規則を使う。どちらも「決まった親ディレクトリ(`projects/` /
`containers/`)の直下の 1 つの名前」を表すためである。`/` と `..` だけを弾く拒否リストは採らない
Expand Down Expand Up @@ -283,8 +283,8 @@ shell が Python を呼ばずに同じ正規表現を文字列で持つのは、
プラグインの同期(`discover_projects`・実ディレクトリの知らせ)、`plugin info` と `status` の
プラグインのプロジェクト数(どちらも `discover_projects` を通す)、`status` のコンテナの状態、
`project list`、見つからない名前での `up` の候補、`project migrate-config`、`env export`、
`env doctor`、`env encrypt` / `env decrypt`、`env backend status` と backend の移行が、`projects/` を
走査するときの名前の条件としてこの述語を呼ぶ。ディレクトリの条件(`is_dir()`・壊れた symlink を
`env doctor`、`env encrypt` / `env decrypt`、`env backend status` と backend の移行、`project create` の
グループの案が、`projects/` を走査するときの名前の条件としてこの述語を呼ぶ。ディレクトリの条件(`is_dir()`・壊れた symlink を
拾う `is_symlink()`・`compose.yml` の有無)は走査ごとに持つ。名前の条件はディレクトリの条件より
先に見る(壊れた symlink を名前だけで外せ、`stat` を打たないため)。同期が張った symlink の掃除と、
別名の衝突を見るための実ディレクトリの集合は、プロジェクトを数えないため述語を通さない。
Expand All @@ -302,6 +302,7 @@ shell が Python を呼ばずに同じ正規表現を文字列で持つのは、
| `env doctor` の重なりと除外設定の確認 | `commands/env_ops.py` | `names.project_dirs` | `is_dir()` |
| `env encrypt` / `env decrypt` の対象 | `commands/env_migrate.py` | `names.project_dirs` | `is_dir()` |
| `env backend status` と backend の移行の対象 | `commands/env_backend.py` | `names.project_dirs` の後に `SecretRef.for_project`(拒まれた名前は黙って外す) | `is_dir()` |
| `project create` のグループの案(入れ先のプラグインの `projects/` を数える `suggest_group`) | `plugin/creator.py` | `names.project_dirs` | `is_dir()` |

`plugin info` と `status` のプラグインのプロジェクト数は、述語を個別に持たず `discover_projects` を
通す。同期と同じ関数を呼ぶことで、ディレクトリの条件まで同期と構造的に一致する。
Expand Down
Loading
Loading