diff options
| author | 魏曹先生 <1992414357@qq.com> | 2026-08-17 05:51:36 +0800 |
|---|---|---|
| committer | 魏曹先生 <1992414357@qq.com> | 2026-08-17 05:51:36 +0800 |
| commit | db84beb600532f2366babd9a6563214bee1f3732 (patch) | |
| tree | adf20172ad20d41cebc8beebc514e4972b2a17bb /docs/dev/pages/issues/t0_remove-pack-macros.md | |
| parent | 57c53affe3542cb6bd4e79ee4c18f20a1bd76b2d (diff) | |
docs(sidebar): mark completed issues and reorder them
Diffstat (limited to 'docs/dev/pages/issues/t0_remove-pack-macros.md')
| -rw-r--r-- | docs/dev/pages/issues/t0_remove-pack-macros.md | 49 |
1 files changed, 0 insertions, 49 deletions
diff --git a/docs/dev/pages/issues/t0_remove-pack-macros.md b/docs/dev/pages/issues/t0_remove-pack-macros.md deleted file mode 100644 index 517646a..0000000 --- a/docs/dev/pages/issues/t0_remove-pack-macros.md +++ /dev/null @@ -1,49 +0,0 @@ -`<h1 align="center">[T0] Remove the pack! Family of Macros</h1> -<p align="center"> - Breaking: retire the entire <code>pack!</code> family in favor of the <code>Grouped</code> derive -</p> - -> [!NOTE] -> -> This is a **Breaking Change** planned for Mingling 0.5.0. - -## Background - -Since the very first version of Mingling, the `pack!` macro has been around. Its purpose has gradually narrowed from "creating a type and registering it to Mingling" to "creating a newtype that derives Grouped". In other words, the functionality of `pack!` is gradually being replaced by the `Grouped derive`. - -Furthermore, in 0.2.0, in order to accommodate `StructuralData derive`, Mingling introduced `pack_structural!` and `pack_err_structural!` variants all at once, which greatly increases the maintenance cost of the project. - -## Plan - -Remove the entire `pack!` family of macros (`pack!`, `pack_structural!`, `pack_err_structural!`) as a Breaking Change in 0.5.0. - -All future type creation will be done as follows: - -```rust -// Before -pack!(ResultNames = Vec<String>); - -// After -#[derive(Grouped)] -pub struct ResultNames { - names: Vec<String> -} -``` - -## Tasks - -- [ ] Identify all usages of `pack!` / `pack_structural!` / `pack_err_structural!` across the codebase, examples, and docs -- [ ] Migrate internal usages to `#[derive(Grouped)]` -- [ ] Remove the macro definitions and their re-exports -- [ ] Update the docs / helpdoc examples that reference `pack!` -- [ ] Update downstream feature docs (`structural_renderer` etc.) where `pack_structural!` was involved -- [ ] Verify all tests pass - -## 🕘 Progress - -- [ ] In Progress -- [ ] Complete - -<p align="center" style="font-size: 0.85em; color: gray;"> - Written by @Weicao-CatilGrass -</p> |
