add about us docs

This commit is contained in:
金戟 2021-01-02 16:23:57 +08:00
parent acc3f0bdf2
commit 079410ee0f
6 changed files with 22 additions and 2 deletions

View File

@ -5,7 +5,7 @@
无需初始化不挑测试框架甭管要换的是私有方法、静态方法、构造方法还是其他任何类的任何方法也甭管要换的对象是怎么创建的。写好Mock定义加个`@MockMethod`注解,一切统统搞定。
- 文档https://alibaba.github.io/testable-mock/
- 国内文档镜像http://freyrlin.gitee.io/testable-mock/ 速度快,内容稍有延迟)
- 国内文档镜像http://freyrlin.gitee.io/testable-mock/ (内容延迟问题已解决
阅读[这里](https://mp.weixin.qq.com/s/KyU6Eu7mDkZU8FspfSqfMw)了解更多故事。

View File

@ -0,0 +1,9 @@
## About Us
The core development team of `TestableMock` comes from **Alibaba Cloud · Cloud R&D Department** (formerly known as **Alibaba Group R&D Efficiency Department**). We not only internally support Alibaba Group's end-to-end project code, testing, and release process of thousands of BU-level product lines, but also the product R&D team of Alibaba Cloud enterprise-level R&D collaboration platform [云效](https://www.aliyun.com/product/yunxiao). As has been deeply involved in the field of developer tools, we are committed to improving the production experience of developers and building a digital R&D ecosystem for enterprises.
The function of `TestableMock` is inspired by our summary of the pain points that Java developers often encounter in daily unit testing ([External dependence on Mock is cumbersome](en-us/doc/use-mock.md), [Private method is difficult to test](en-us/doc/private-accessor.md), [Void type method is difficult to test](en-us/doc/test-void-method.md), and complex parameters are difficult to construct). Its internal name is `Testable`, and was renamed `TestableMock` for SEO reason when it was open sourced, thus the lightweight mock function is highlighted. Don't be fooled by its name, `TestableMock` is more than just a mocking tool.
From the incubation during a hackathon activity, to internal open source, and then to external open source, `TestableMock` has accumulated a group of developer users in the internal and external communities. At the same time, we are constantly improving the functional richness and stability of `TestableMock` itself. According to the current version release process, we usually update the internal beta version containing the `SNAPSHOT` mark internally, and release the official version to the Maven central warehouse (except for the severe bug fix version) after at least one day of stable used to ensure the update will bring more convenience and less burden to everyone.
Finally, we are relatively optimistic about the discussion in the community about "whether too powerful test assistance is equivalent to condoning code corruption". Just as the birth of `PowerMock` did not really spawn more bad projects, but actually solved many test problems left over by the Java language. Rather than use "code tricks" to test functions indirectly, it could be worth to just remove the constraints, and let the unit test break in all its fury! 🤠

View File

@ -14,4 +14,5 @@
- Technical Reference
- [Mock Tools Comparison](en-us/doc/comparation.md)
- [Release Note](en-us/doc/release-note.md)
- [About Us](en-us/doc/about-us.md)
- [Feedback Channel](en-us/doc/feedback.md)

View File

@ -0,0 +1,9 @@
## 关于我们
`TestableMock`的核心开发团队来自**阿里云·云研发部**(前身为**阿里集团研发效能部**。我们不仅对内支持阿里集团数千个BU级产品线的项目代码、测试、发布全生命周期流程同时也是阿里云企业级研发协同平台[云效](https://www.aliyun.com/product/yunxiao)的产品研发团队,一直深耕在开发者工具领域,致力于改善开发者生产体验和构筑企业数字化研发生态。
`TestableMock`功能的灵感来自于我们对Java开发者在日常单元测试中经常遇到的痛点总结[外部依赖Mock繁琐](zh-cn/doc/use-mock.md)、[私有方法难测试](zh-cn/doc/private-accessor.md)、[无返回值方法难测试](zh-cn/doc/test-void-method.md)、复杂参数难构造)。它在内部的名字是`Testable`,在开源时为了搜索引擎优化,改名为`TestableMock`并主推轻量级Mock功能。 不要被它的名字所迷惑,`TestableMock`绝不仅仅是Mock。
从黑客马拉松活动孵化,到内部开源,再到对外开源,`TestableMock`已经积累了一批阿里集团内部和外部社区的开发者用户。与此同时,我们也在不断完善`TestableMock`自身的功能丰富性和稳定性。按照当前的版本发布流程,我们通常会先在内部更新包含`SNAPSHOT`标记的内测版在至少稳定使用一天以后才发布正式版本到Maven中心仓库除严重BUG修复版本外以确保工具能为大家带来更多的便捷和更少的负担。
最后,关于社区里常有对“过于强大的测试辅助是否等同于纵容代码腐化”的讨论,我们持相对乐观的态度。正如`PowerMock`的诞生并没有真的催生更多烂项目反而切实解决了许多Java语言遗留的测试难题。与其拐弯抹角的采用“测试技巧”间接测试功能不如大胆打破约束就让单元测试来得更猛烈一些吧🤠

View File

@ -39,7 +39,7 @@ Kotlin语言中的`String`类型实际上是`kotlin.String`,而非`java.lang.S
同样有效Mock的作用范围是整个测试运行过程。
例如测试类`AaaTest`中Mock了`Aaa`类的某些私有方法、以及某些公有方法中的外部调用;在另一个测试类`BbbTest`中测试`Bbb`类时,某些方法间接用到了`Aaa`类被Mock过的方法或调用此时实际调用的同样会是`AaaTest`类中定义的Mock方法。
例如测试类`AaaTest`中Mock了`Aaa`类的某些私有方法(或者某些外部方法调用);在另一个测试类`BbbTest`中测试`Bbb`类时,某些方法间接用到了`Aaa`类被Mock过的方法或调用此时实际调用的同样会是`AaaTest`类中定义的Mock方法。
#### 7. `TestableMock`能否用于Android项目的测试

View File

@ -14,4 +14,5 @@
- 技术参考
- [主流Mock工具对比](zh-cn/doc/comparation.md)
- [Release Note](zh-cn/doc/release-note.md)
- [关于我们](zh-cn/doc/about-us.md)
- [问题反馈](zh-cn/doc/feedback.md)