您的位置 首页 编程知识

开始为流行的开源项目做出贡献

序幕 tpy是一个基于的web框架,用于构建数据驱动的应用程序。开发者只需使用python即可创建web应用,…


序幕

tpy是一个基于的web框架,用于构建数据驱动的应用程序。开发者只需使用python即可创建web应用,这对于数据科学家和分析师尤其方便。taipy在hub上拥有超过1.9k个fork和17.6万颗星,深受开发者欢迎。 开始为流行的开源项目做出贡献

我长期参与Taipy的贡献工作。我之所以开始参与,是因为我对数据科学和分析充满热情,并且认为我的技能与该项目非常契合。通过贡献,我积累了宝贵的经验,帮助其他开发者解决问题,并从经验丰富的维护者那里学到了很多。在Hacktoberfest期间,我发现许多开发者在测试环境更新方面遇到困难,因此我决定分享我的工作流程,希望能帮助更多想为Taipy贡献力量的开发者。

设置工作流程

当您准备开始贡献时,首先阅读项目的CONTRIBUTING.md文件。即使您不需要编写任何JavaScript代码,Taipy也依赖于React作为底层技术。我的大部分贡献都集中在React部分。为了测试更新,您需要构建React前端,将更新后的Taipy安装到Python环境中,然后运行测试脚本。每次重复这些步骤都比较繁琐,所以我创建了一个Bash脚本 taipy-build.sh:

#!/bin/bash # 自动化Taipy仓库的构建流程  # 构建taipy-gui cd ~/projects/taipy/frontend/taipy-gui/dom; npm i; cd ..; npm i --omit=optional; npm run build;  # 构建taipy cd ~/projects/taipy/frontend/taipy; npm i; npm run build;  # 安装新的taipy cd ~/projects/test-taipy; source venv/bin/activate pip install ../taipy
登录后复制

运行此脚本后,只需在虚拟环境中执行 taipy run -use-reloader main.py 即可查看更新后的效果。 pip install ../taipy 非常重要,它会安装您本地修改后的Taipy版本,请确保路径指向您文件系统中的Taipy目录。

示例PR

让我们来看一下我在年提交的第一个Taipy PR。开发者发现height属性在单选模式下无法在Selector组件上正常工作。

开始为流行的开源项目做出贡献

首先,需要创建一个简单的Python脚本重现该错误,以便验证更新是否解决了问题。在这个问题中,维护者提供了一个脚本,所以我直接使用了它。

重现错误后,我开始查看Taipy的代码库。搜索“Selector”后,我找到了相关的文件“selector.tsx”。我发现height属性在单选模式下未被使用,并且组件中对模式的检查方式存在问题。我需要找到一种方法来应用height属性。参考其他样式属性的处理方式,我决定使用useMemo来创建height。

开始为流行的开源项目做出贡献

最初,我将sx传递给父元素(FormControl),效果良好,但维护者建议从RadioGroup/FormGroup级别控制样式,因为在Taipy应用中该标签仍然可见。这带来了新的挑战,因为样式并未按预期工作。

开始为流行的开源项目做出贡献

使用浏览器开发者工具调试样式时,我发现flex-flow: column wrap是导致该问题的根源。我将flex-flow设置为’column’,问题得到解决。安装更新后的Taipy后,我按照测试脚本验证了修复效果。

完成代码修改后,我添加了单元测试。这相对容易,因为我可以参考现有的测试案例。我为单选模式和检查模式下的height样式添加了新的测试用例。

这看起来很简单,但我经历了很多尝试和错误。在与维护者交流并完善PR后,最终它被批准并合并。

选择合适的问题 开始为流行的开源项目做出贡献

我知道您可能渴望完成令人印象深刻的工作,但如果一开始就尝试解决非常复杂的问题,对您和维护者来说都是不可持续的。选择一些相对简单的问题,可以帮助您快速熟悉项目,并学习新的知识。我通常会先进行一些研究,确保自己能够胜任后再着手解决问题。 正如Tom Fujita所说:

不用担心,不要比较

不要期望太快 > 对自己友善

除了Taipy核心代码库外,您也可以考虑贡献Taipy文档。文档对于库的易用性至关重要。

结论

为Taipy做出贡献是一次有意义的经历。无论是修复bug、添加新功能还是改进文档,每一个贡献都非常重要。不要犹豫,从小事做起——您的努力可能会帮助下一个遇到同样问题的开发者!

以上就是开始为流行的开源项目做出贡献的详细内容,更多请关注php中文网其它相关文章!

本文来自网络,不代表四平甲倪网络网站制作专家立场,转载请注明出处:http://www.elephantgpt.cn/6487.html

作者: nijia

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注

联系我们

联系我们

18844404989

在线咨询: QQ交谈

邮箱: 641522856@qq.com

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部