From 215813e91d375bfc345426851ab4463f55137bbd Mon Sep 17 00:00:00 2001 From: Siu Date: Wed, 30 Mar 2022 22:57:31 +0800 Subject: [PATCH 01/17] fix grammar errors in `crate-module/module.md` --- src/basic/crate-module/module.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/basic/crate-module/module.md b/src/basic/crate-module/module.md index bc97d6f2..eba9d122 100644 --- a/src/basic/crate-module/module.md +++ b/src/basic/crate-module/module.md @@ -261,7 +261,7 @@ mod back_of_house { ## 使用 `self` 引用模块 -`self` 其实就是引用自身模块中的项，也就是说和我们之前章节的代码类似，都调用同一模块中的内容，区别在于之间章节中直接通过名称调用即可，而 `self`，你得多此一举： +`self` 其实就是引用自身模块中的项，也就是说和我们之前章节的代码类似，都调用同一模块中的内容，区别在于之前章节中直接通过名称调用即可，而 `self`，你得多此一举： ```rust fn serve_order() { From fde6e05257052438ed93e8564eb5b10e4a57f312 Mon Sep 17 00:00:00 2001 From: Mathias Zhang Date: Thu, 31 Mar 2022 09:14:50 +0800 Subject: [PATCH 02/17] fix(do-we-need-it.md): typo fix --- src/too-many-lists/do-we-need-it.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/too-many-lists/do-we-need-it.md b/src/too-many-lists/do-we-need-it.md index d9d5ba54..965613e9 100644 --- a/src/too-many-lists/do-we-need-it.md +++ b/src/too-many-lists/do-we-need-it.md @@ -54,7 +54,7 @@ 对于前者，那性能如何自然无关紧要。而对于后者，我们只需要使用 `Vec::with_capacity` 提前分配足够的空间即可，同时，Rust 中所有的迭代器还提供了 `size_hint` 也可以解决这种问题。 -当然，如果这段代码在热点路径，且你无法提前预测所需的容量，那么链表确实会更节省性能。 +当然，如果这段代码在热点路径，且你无法提前预测所需的容量，那么链表确实会更提升性能。 #### 链表更节省内存空间 首先，这个问题较为复杂。一个标准的数组调整策略是：增加或减少数组的长度使数组最多有一半为空，例如 capacity 增长是翻倍的策略。这确实会导致内存空间的浪费，特别是在 Rust 中，我们不会自动收缩集合类型。 From 1596766503313f08935d6fa98b66434feae7e038 Mon Sep 17 00:00:00 2001 From: sunface Date: Thu, 31 Mar 2022 10:43:09 +0800 Subject: [PATCH 03/17] update about-book.md --- README.md | 12 ++++++++---- book.toml | 2 +- src/about-book.md | 17 +++++++++++++++++ 3 files changed, 26 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 8c984474..45482ff4 100644 --- a/README.md +++ b/README.md @@ -116,13 +116,17 @@ ## 创作感悟 -截至目前，Rust语言圣经已写了 170 余章，110 余万字，历经 800 多个小时，其中每一个章节都是手动写就，没有任何机翻和质量上的妥协( 相信深入阅读过的读者都能体会到这一点 )，经过不懈地付出和努力，我们收获了 0 元钱。 +截至目前，Rust语言圣经已写了 170 余章，110 余万字，历经 800 多个小时，每一个章节都是手动写就，没有任何机翻和质量上的妥协( 相信深入阅读过的读者都能体会到这一点 )。 -是的，这本书没有带来一分钱的收入，在用爱发电。事实上，已经有不少出版社联系我出版了，但我希望能保持自己的初心。Rust 要在国内真正发展起来，必须得有一群追逐梦想的人在做着不计付出的事情，而我希望自己能贡献一份微薄之力。 +曾经有读者问过 "这么好的书为何要开源，而不是出版?"，原因很简单：**只有完全开源才能完美地呈现出我想要的教学效果**。 -但是要说完全无欲无求，那也是不可能的，谁看到读者的认可不欢喜？谁听到他人的称赞不雀跃？而我，最想获取的就是你们用指尖绘制的星空，这里繁星点点，每一颗都在鼓励着怀揣着开源梦想的程序员披荆斩棘、不断前行，不夸张的说，没有你们，开源世界就没有星光，自然也就不会有今天的开源盛世。 +总之，Rust 要在国内真正发展起来，必须得有一些追逐梦想的人在做着不计付出的事情，而我希望自己能贡献一份微薄之力。 -因此，我恳请大家，如果觉得书还可以，就在你的指尖星空绘制一颗新的 🌟，指引我们继续砥砺前行。这个人世间，因善意而美好。 +但是要说完全无欲无求，那也是不可能的，看到项目多了一颗 🌟，那感觉...棒极了，因为它代表了读者的认可和称赞。 + +你们用指尖绘制的星空，那里繁星点点，每一颗都在鼓励着怀揣着开源梦想的程序员披荆斩棘、不断前行，不夸张的说，没有你们，开源世界就没有星光，自然也就不会有今天的开源盛世。 + +因此，**我恳请大家，如果觉得书还可以，就在你的指尖星空绘制一颗新的 🌟，指引我们继续砥砺前行**。这个人世间，因善意而美好。 最后，能通过开源在茫茫人海中与大家相识，这感觉真好 :D diff --git a/book.toml b/book.toml index e6fcd905..fbbeecbe 100644 --- a/book.toml +++ b/book.toml @@ -7,7 +7,7 @@ src = "src" [output.html] additional-css = ["theme/style2.css"] additional-js = ["assets/custom.js", "assets/bigPicture.js"] -git-repository-url = "https://github.com/sunface/rust-course#创作感悟" +git-repository-url = "https://github.com/sunface/rust-course" edit-url-template = "https://github.com/sunface/rust-course/edit/main/{path}" [output.html.playground] diff --git a/src/about-book.md b/src/about-book.md index f36ad588..307d27f9 100644 --- a/src/about-book.md +++ b/src/about-book.md @@ -32,6 +32,23 @@ Rust语言真的好：连续六年成为全世界最受欢迎的语言、没有G + +## 创作感悟 + +截至目前，Rust语言圣经已写了 170 余章，110 余万字，历经 800 多个小时，每一个章节都是手动写就，没有任何机翻和质量上的妥协( 相信深入阅读过的读者都能体会到这一点 )。 + +曾经有读者问过 "这么好的书为何要开源，而不是出版?"，原因很简单：**只有完全开源才能完美地呈现出我想要的教学效果**。 + +总之，Rust 要在国内真正发展起来，必须得有一些追逐梦想的人在做着不计付出的事情，而我希望自己能贡献一份微薄之力。 + +但是要说完全无欲无求，那也是不可能的，看到项目多了一颗 🌟，那感觉...棒极了，因为它代表了读者的认可和称赞。 + +你们用指尖绘制的星空，那里繁星点点，每一颗都在鼓励着怀揣着开源梦想的程序员披荆斩棘、不断前行，不夸张的说，没有你们，开源世界就没有星光，自然也就不会有今天的开源盛世。 + +因此，**我恳请大家，如果觉得书还可以，就在你的指尖星空绘制一颗新的 🌟，指引我们继续砥砺前行**。这个人世间，因善意而美好。 + +最后，能通过开源在茫茫人海中与大家相识，这感觉真好 :D + ## 🏅 贡献者 非常感谢本教程的[所有贡献者](https://github.com/sunface/rust-course/graphs/contributors)，正是有了你们，才有了现在的高质量 Rust 教程! From 7192119b599255d8c05a8bdbda8b8be887973345 Mon Sep 17 00:00:00 2001 From: Fanyjie Date: Fri, 1 Apr 2022 07:34:24 +0800 Subject: [PATCH 04/17] fix typo --- src/about-book.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/about-book.md b/src/about-book.md index 307d27f9..a8107245 100644 --- a/src/about-book.md +++ b/src/about-book.md @@ -8,7 +8,7 @@ Rust语言真的好：连续六年成为全世界最受欢迎的语言、没有G 至于 Rust 难学，那正是本书要解决的问题，如果看完后，你觉得没有学会 Rust，可以找我们退款，哦抱歉，这是开源书，那就退 🌟 吧：） -如果看到这里，大家觉得这本书的介绍并没有吸引到你，不要立即放弃，强烈建议读一下[进入 Rust 编程世界](ttps://course.rs/into-rust.html)，那里会有不一样的精彩。 +如果看到这里，大家觉得这本书的介绍并没有吸引到你，不要立即放弃，强烈建议读一下[进入 Rust 编程世界](https://course.rs/into-rust.html)，那里会有不一样的精彩。 > 本书完全开源，所有的文档内容都在 `Github` 上，至于里面还藏有什么秘密，大家点击右上角自行发现吧 ：） @@ -116,4 +116,4 @@ Rust语言真的好：连续六年成为全世界最受欢迎的语言、没有G - \ No newline at end of file + From c641d89f4f1fb6ff32ac6b875691ba3a5770b8bc Mon Sep 17 00:00:00 2001 From: zongzi531 Date: Fri, 1 Apr 2022 13:30:44 +0800 Subject: [PATCH 05/17] fix: typo at features --- src/cargo/reference/features/examples.md | 6 ++--- src/cargo/reference/features/intro.md | 30 ++++++++++++------------ 2 files changed, 18 insertions(+), 18 deletions(-) diff --git a/src/cargo/reference/features/examples.md b/src/cargo/reference/features/examples.md index 00d50d22..feed1ec0 100644 --- a/src/cargo/reference/features/examples.md +++ b/src/cargo/reference/features/examples.md @@ -12,7 +12,7 @@ ### 行为扩展 -[`serde_json`](https://crates.io/crates/serde_json) 拥有一个 [`preserve_order` feature](https://github.com/serde-rs/json/blob/v1.0.60/Cargo.toml#L53-L56)，可以用于在序列化时保留 JSON 键值队的顺序。同时，该 feature 还会启用一个可选依赖 [indexmap](https://crates.io/crates/indexmap)。 +[`serde_json`](https://crates.io/crates/serde_json) 拥有一个 [`preserve_order` feature](https://github.com/serde-rs/json/blob/v1.0.60/Cargo.toml#L53-L56)，可以用于在序列化时保留 JSON 键值对的顺序。同时，该 feature 还会启用一个可选依赖 [indexmap](https://crates.io/crates/indexmap)。 当这么做时，一定要小心不要破坏了 SemVer 的版本兼容性，也就是说：启用 feature 后，代码依然要能正常工作。 @@ -40,7 +40,7 @@ 在这种情况下，将过程宏所在的包定义为可选依赖，是很不错的选择。这样做还有一个好处：有时过程宏的版本必须要跟父包进行同步，但是我们又不希望所有的用户都进行同步。 -其中给一个例子就是 [serde](https://crates.io/crates/serde) ，它有一个 [derive](https://github.com/serde-rs/serde/blob/v1.0.118/serde/Cargo.toml#L34-L35) feature 可以启用 [serde_derive](https://crates.io/crates/serde_derive) 过程宏。由于 `serde_derive` 包跟 `serde` 的关系非常紧密，因此它使用了[版本相同的需求](https://github.com/serde-rs/serde/blob/v1.0.118/serde/Cargo.toml#L17)来保证两者的版本同步性。 +其中一个例子就是 [serde](https://crates.io/crates/serde) ，它有一个 [derive](https://github.com/serde-rs/serde/blob/v1.0.118/serde/Cargo.toml#L34-L35) feature 可以启用 [serde_derive](https://crates.io/crates/serde_derive) 过程宏。由于 `serde_derive` 包跟 `serde` 的关系非常紧密，因此它使用了[版本相同的需求](https://github.com/serde-rs/serde/blob/v1.0.118/serde/Cargo.toml#L17)来保证两者的版本同步性。 ## 只能用于 nightly 的 feature @@ -52,7 +52,7 @@ Rust 有些实验性的 API 或语言特性只能在 nightly 版本下使用， ## 实验性 feature -有一些包会提前将一些实验性的 API 放出去，既然是实验性的，自然无法保证其稳定性。在这种情况下，通过会在文档中将相应的 features 标记为实验性，意味着它们在未来可能会发生大的改变(甚至 minor 版本都可能发生)。 +有一些包会提前将一些实验性的 API 放出去，既然是实验性的，自然无法保证其稳定性。在这种情况下，通常会在文档中将相应的 features 标记为实验性，意味着它们在未来可能会发生大的改变(甚至 minor 版本都可能发生)。 其中一个例子是 [async-std](https://crates.io/crates/async-std) 包，它拥有一个 [unstable feature](https://github.com/async-rs/async-std/blob/v1.8.0/Cargo.toml#L38-L42)，用来[标记一些新的 API](https://github.com/async-rs/async-std/blob/v1.8.0/src/macros.rs#L46)，表示人们已经可以选择性的使用但是还没有准备好去依赖它。 diff --git a/src/cargo/reference/features/intro.md b/src/cargo/reference/features/intro.md index e91fa58d..77fd08ee 100644 --- a/src/cargo/reference/features/intro.md +++ b/src/cargo/reference/features/intro.md @@ -25,7 +25,7 @@ pub mod webp; 在 `Cargo.toml` 中定义的 `feature` 会被 `Cargo` 通过命令行参数 `--cfg` 传给 `rustc`，最终由后者完成编译：`rustc --cfg ...`。若项目中的代码想要测试 `feature` 是否存在，可以使用 [`cfg` 属性](https://doc.rust-lang.org/stable/reference/conditional-compilation.html#the-cfg-attribute)或 [`cfg` 宏](https://doc.rust-lang.org/stable/std/macro.cfg.html)。 -之前我们提到了一个 `feature` 还可以开启其他 `feature`，举个例子，例如 `ICO` 图片格式包含 `BMP` 和 `PNG`，因此当 `ICO` 图片格式被启用后，它还得确保启用 `BMP` 和 `PNG` 格式： +之前我们提到了一个 `feature` 还可以开启其他 `feature`，举个例子，例如 ICO 图片格式包含 BMP 和 PNG 格式，因此当 `ico` 被启用后，它还得确保启用 `bmp` 和 `png` ： ```toml [features] @@ -70,11 +70,11 @@ webp = [] gif = { version = "0.11.1", optional = true } ``` -**这种可选依赖的写法会自动定义一个与依赖同名的 feature，也就是 `gif` feature**，这样一来，当我们启用 `gif` feautre 时，该依赖库也会被自动引入并启用：例如通过 `--feature gif` 的方式启用 feauture。 +**这种可选依赖的写法会自动定义一个与依赖同名的 feature，也就是 `gif` feature**，这样一来，当我们启用 `gif` feature 时，该依赖库也会被自动引入并启用：例如通过 `--feature gif` 的方式启用 feature 。 -> 注意：目前来说，`[fetuare]` 中定义的 feature 还不能与已引入的依赖库同名。但是在 `nightly` 中已经提供了实验性的功能用于改变这一点: [namespaced features](https://doc.rust-lang.org/stable/cargo/reference/unstable.html#namespaced-features) +> 注意：目前来说，`[feature]` 中定义的 feature 还不能与已引入的依赖库同名。但是在 `nightly` 中已经提供了实验性的功能用于改变这一点: [namespaced features](https://doc.rust-lang.org/stable/cargo/reference/unstable.html#namespaced-features) -当然，**我们还可以通过显式定义 feature 的方式来启用这些可选依赖库**，例如为了支持 `AVIF` 图片格式，我们需要引入两个依赖包，由于 `AVIF` 是通过 feature 引入的可选格式，因此它依赖的两个包也必须声明为可选的: +当然，**我们还可以通过显式定义 feature 的方式来启用这些可选依赖库**，例如为了支持 AVIF 图片格式，我们需要引入两个依赖包，由于 `avif` 是通过 feature 引入的可选格式，因此它依赖的两个包也必须声明为可选的: ```toml [dependencies] @@ -91,7 +91,7 @@ avif = ["ravif", "rgb"] ## 依赖库自身的 feature -就像我们的项目可以定义 `feature` 一样，依赖库也可以定义它自己的 feature、也有需要启用的 feature 列表，当引入该依赖库时，我们可以通过以下方式为其启用相关的 features : +就像我们的项目可以定义 `feature` 一样，依赖库也可以定义它自己的 `feature`，也有需要启用的 `feature` 列表，当引入该依赖库时，我们可以通过以下方式为其启用相关的 `features` : ```toml [dependencies] @@ -109,7 +109,7 @@ flate2 = { version = "1.0.3", default-features = false, features = ["zlib"] } > 注意：这种方式未必能成功禁用 `default`，原因是可能会有其它依赖也引入了 `flate2`，并且没有对 `default` 进行禁用，那此时 `default` 依然会被启用。 > -> 查看下文的 [feature 同一化](#feature同一化) 获取更多信息 +> 查看下文的 [feature 同一化](#feature-同一化) 获取更多信息 除此之外，还能通过下面的方式来间接开启依赖库的 feature : @@ -134,7 +134,7 @@ parallel = ["jpeg-decoder/rayon"] - `--features FEATURES`: 启用给出的 feature 列表，可以使用逗号或空格进行分隔，若你是在终端中使用，还需要加上双引号，例如 `--features "foo bar"`。 若在工作空间中构建多个 `package`，可以使用 `package-name/feature-name` 为特定的成员启用 features - `--all-features`: 启用命令行上所选择的所有包的所有 features -- `--no-default-features`: 对选择的包禁用 `default` featue +- `--no-default-features`: 对选择的包禁用 `default` feature ## feature 同一化 @@ -150,7 +150,7 @@ parallel = ["jpeg-decoder/rayon"] 例如，如果我们想可选的支持 `no_std` 环境(不使用标准库)，那么有两种做法： -- 默认代码使用标准库的，当该 `no_std` feature 启用时，禁用相关的标准库代码 +- 默认代码使用标准库的，当 `no_std` feature 启用时，禁用相关的标准库代码 - 默认代码使用非标准库的，当 `std` feature 启用时，才使用标准库的代码 前者就是功能削减，与之相对，后者是功能添加，根据之前的内容，我们应该选择后者的做法： @@ -203,7 +203,7 @@ test_cargo v0.1.0 (/Users/sunfei/development/rust/demos/test_cargo) `cargo tree -f "{p} {f}"` 命令会提供一个更加紧凑的视图： ```shell -% cargo tree -f "{p} {f}" +$ cargo tree -f "{p} {f}" test_cargo v0.1.0 (/Users/sunfei/development/rust/demos/test_cargo) └── uuid v0.8.2 default,std ``` @@ -211,7 +211,7 @@ test_cargo v0.1.0 (/Users/sunfei/development/rust/demos/test_cargo) `cargo tree -e features -i foo`，该命令会显示 `features` 会如何"流入"指定的包 `foo` 中: ```shell -cargo tree -e features -i uuid +$ cargo tree -e features -i uuid uuid v0.8.2 ├── uuid feature "default" │ └── test_cargo v0.1.0 (/Users/sunfei/development/rust/demos/test_cargo) @@ -238,8 +238,8 @@ resolver = "2" V2 版本的解析器可以在某些情况下避免 feature 同一化的发生，具体的情况在[这里](https://doc.rust-lang.org/stable/cargo/reference/resolver.html#feature-resolver-version-2)有描述，下面做下简单的总结: - 为特定平台开启的 `features` 且此时并没有被构建，会被忽略 -- `Build-dependencies` 和 `proc-macros` 不再跟普通的依赖共享 `features` -- `Dev-dependencies` 的 `features` 不会被启用，除非正在构建的对象需要它们(例如测试对象、示例对象等) +- `build-dependencies` 和 `proc-macros` 不再跟普通的依赖共享 `features` +- `dev-dependencies` 的 `features` 不会被启用，除非正在构建的对象需要它们(例如测试对象、示例对象等) 对于部分场景而言，feature 同一化确实是需要避免的，例如，一个构建依赖开启了 `std` feature，而同一个依赖又被用于 `no_std` 环境，很明显，开启 `std` 将导致错误的发生。 @@ -249,7 +249,7 @@ V2 版本的解析器可以在某些情况下避免 feature 同一化的发生 ## 构建脚本 -[构建脚本](https://course.rs/cargo/reference/build-script/intro.html)可以通过 `CARGO_FEATURE_` 环境变量获取启用的 `feauture` 列表，其中 `` 是 feature 的名称，该名称被转换成大全写字母，且 `-` 被转换为 `_`。 +[构建脚本](https://course.rs/cargo/reference/build-script/intro.html)可以通过 `CARGO_FEATURE_` 环境变量获取启用的 `feature` 列表，其中 `` 是 feature 的名称，该名称被转换成大全写字母，且 `-` 被转换为 `_`。 ## required-features @@ -257,14 +257,14 @@ V2 版本的解析器可以在某些情况下避免 feature 同一化的发生 ## SemVer 兼容性 -启用一个 feautre 不应该引入一个不兼容 SemVer 的改变。例如，启用的 feature 不应该改变现有的 API，因为这会给用户造成不兼容的破坏性变更。 如果大家想知道哪些变化是兼容的，可以参见[官方文档](https://doc.rust-lang.org/stable/cargo/reference/semver.html)。 +启用一个 feature 不应该引入一个不兼容 SemVer 的改变。例如，启用的 feature 不应该改变现有的 API，因为这会给用户造成不兼容的破坏性变更。 如果大家想知道哪些变化是兼容的，可以参见[官方文档](https://doc.rust-lang.org/stable/cargo/reference/semver.html)。 总之，在新增/移除 feature 或可选依赖时，你需要小心，因此这些可能会造成向后不兼容性。更多信息参见[这里](https://doc.rust-lang.org/stable/cargo/reference/semver.html#cargo)，简单总结如下： - 在发布 `minor` 版本时，以下通常是安全的: - [新增 feature](https://doc.rust-lang.org/stable/cargo/reference/semver.html#cargo-feature-add) 或[可选依赖](https://doc.rust-lang.org/stable/cargo/reference/semver.html#cargo-dep-add) - [修改某个依赖的 features](https://doc.rust-lang.org/stable/cargo/reference/semver.html#cargo-change-dep-feature) -- 在发布 `minor` 时，以下操作应该避免： +- 在发布 `minor` 版本时，以下操作应该避免： - [移除 feature](https://doc.rust-lang.org/stable/cargo/reference/semver.html#cargo-feature-remove) 或[可选依赖](https://doc.rust-lang.org/stable/cargo/reference/semver.html#cargo-remove-opt-dep) - [将现有的公有代码放在某个 feature 之后](https://doc.rust-lang.org/stable/cargo/reference/semver.html#cargo-remove-opt-dep) - [从 feature 列表中移除一个 feature](https://doc.rust-lang.org/stable/cargo/reference/semver.html#cargo-feature-remove-another) From 5a2251f61f57ec34ba796352a4c34c490e00cbfe Mon Sep 17 00:00:00 2001 From: sunface Date: Fri, 1 Apr 2022 16:10:44 +0800 Subject: [PATCH 06/17] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E7=AB=A0=E8=8A=82=20[C?= =?UTF-8?q?ookbook=20-=20=E7=94=9F=E6=88=90=E9=9A=8F=E6=9C=BA=E6=95=B0]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/SUMMARY.md | 46 +++--- src/advance/functional-programing/closure.md | 5 +- src/cases/intro.md | 3 - src/cookbook/algos/randomness.md | 155 +++++++++++++++++++ src/{cases => cookbook}/cmd.md | 0 src/{cases => cookbook}/config.md | 0 src/{cases => cookbook}/crypto.md | 0 src/{cases => cookbook}/database.md | 0 src/{cases => cookbook}/date.md | 0 src/{cases => cookbook}/dev/intro.md | 0 src/{cases => cookbook}/dev/logs.md | 0 src/{cases => cookbook}/dev/profile.md | 0 src/{cases => cookbook}/encoding/csv.md | 0 src/{cases => cookbook}/encoding/intro.md | 0 src/{cases => cookbook}/encoding/json.md | 0 src/{cases => cookbook}/encoding/protobuf.md | 0 src/{cases => cookbook}/file/dir.md | 0 src/{cases => cookbook}/file/file.md | 0 src/{cases => cookbook}/file/intro.md | 0 src/cookbook/intro.md | 22 +++ src/{cases => cookbook}/protocol/grpc.md | 0 src/{cases => cookbook}/protocol/http.md | 0 src/{cases => cookbook}/protocol/intro.md | 0 src/{cases => cookbook}/protocol/tcp.md | 0 src/{cases => cookbook}/protocol/udp.md | 0 src/{cases => cookbook}/regexp.md | 0 src/practice.md | 3 + 27 files changed, 208 insertions(+), 26 deletions(-) delete mode 100644 src/cases/intro.md create mode 100644 src/cookbook/algos/randomness.md rename src/{cases => cookbook}/cmd.md (100%) rename src/{cases => cookbook}/config.md (100%) rename src/{cases => cookbook}/crypto.md (100%) rename src/{cases => cookbook}/database.md (100%) rename src/{cases => cookbook}/date.md (100%) rename src/{cases => cookbook}/dev/intro.md (100%) rename src/{cases => cookbook}/dev/logs.md (100%) rename src/{cases => cookbook}/dev/profile.md (100%) rename src/{cases => cookbook}/encoding/csv.md (100%) rename src/{cases => cookbook}/encoding/intro.md (100%) rename src/{cases => cookbook}/encoding/json.md (100%) rename src/{cases => cookbook}/encoding/protobuf.md (100%) rename src/{cases => cookbook}/file/dir.md (100%) rename src/{cases => cookbook}/file/file.md (100%) rename src/{cases => cookbook}/file/intro.md (100%) create mode 100644 src/cookbook/intro.md rename src/{cases => cookbook}/protocol/grpc.md (100%) rename src/{cases => cookbook}/protocol/http.md (100%) rename src/{cases => cookbook}/protocol/intro.md (100%) rename src/{cases => cookbook}/protocol/tcp.md (100%) rename src/{cases => cookbook}/protocol/udp.md (100%) rename src/{cases => cookbook}/regexp.md (100%) create mode 100644 src/practice.md diff --git a/src/SUMMARY.md b/src/SUMMARY.md index 09790c86..fa7c584d 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -263,28 +263,30 @@ - [HashMap todo](std/hashmap.md) - [Iterator 常用方法 todo](std/iterator.md) -- [CookBook todo](cases/intro.md) - - [命令行解析 todo](cases/cmd.md) - - [配置文件解析 todo](cases/config.md) - - [编解码 todo](cases/encoding/intro.md) - - [JSON](cases/encoding/json.md) - - [CSV](cases/encoding/csv.md) - - [protobuf](cases/encoding/protobuf.md) - - [文件系统 todo](cases/file/intro.md) - - [文件读写](cases/file/file.md) - - [目录操作](cases/file/dir.md) - - [网络通信 todo](cases/protocol/intro.md) - - [HTTP](cases/protocol/http.md) - - [TCP](cases/protocol/tcp.md) - - [UDP](cases/protocol/udp.md) - - [gRPC](cases/protocol/grpc.md) - - [数据库访问 todo](cases/database.md) - - [正则表达式 todo](cases/regexp.md) - - [加密解密 todo](cases/crypto.md) - - [时间日期](cases/date.md) - - [开发调试 todo](cases/dev/intro.md) - - [日志](cases/dev/logs.md) - - [性能分析](cases/dev/profile.md) +- [CookBook doing](cookbook/intro.md) + - [常用算法]() + - [生成随机值](cookbook/algos/randomness.md) + - [命令行解析 todo](cookbook/cmd.md) + - [配置文件解析 todo](cookbook/config.md) + - [编解码 todo](cookbook/encoding/intro.md) + - [JSON](cookbook/encoding/json.md) + - [CSV](cookbook/encoding/csv.md) + - [protobuf](cookbook/encoding/protobuf.md) + - [文件系统 todo](cookbook/file/intro.md) + - [文件读写](cookbook/file/file.md) + - [目录操作](cookbook/file/dir.md) + - [网络通信 todo](cookbook/protocol/intro.md) + - [HTTP](cookbook/protocol/http.md) + - [TCP](cookbook/protocol/tcp.md) + - [UDP](cookbook/protocol/udp.md) + - [gRPC](cookbook/protocol/grpc.md) + - [数据库访问 todo](cookbook/database.md) + - [正则表达式 todo](cookbook/regexp.md) + - [加密解密 todo](cookbook/crypto.md) + - [时间日期](cookbook/date.md) + - [开发调试 todo](cookbook/dev/intro.md) + - [日志](cookbook/dev/logs.md) + - [性能分析](cookbook/dev/profile.md)