草庐IT

git - 使用原型(prototype)代码将 Git 存储库重构为实际的可发布项目

coder 2023-06-25 原文

我最近一直在研究 API 库，该库将相对较大的外部 API 的一部分包装到更惯用的结构中。当我在编写原型(prototype)代码时进行 API 探索时，我最终实现了三个具有不同功能程度的可用子 API。或者简单地说，我有一个项目，它的结构看起来像

dir:root
 └ dir:feature-a
 └ dir:feature-b
 └ dir:feature-c
 └ dir:common
 └ file:build.gradle
 └ file:build.py

其中每个功能都与其中一个子 API 匹配。值得一提的是，目录不是平面的，为了简单起见，我只是省略了子目录。

我的主要问题是，虽然我实际上曾经提供了一个半体面的版本历史记录，但它都在一个分支中，并且只有一个子 API 准备发布。理想情况下，我想找到最方便的方式
  • 拆分现有的 repo，以便我可以将每个功能转换为自己的分支，以便我可以在它们足够成熟时一一发布
  • 保留当前版本历史(可能有一些 rebase )

    • 我以前用过 git filter-branch 出于类似的目的，但这里的一个主要曲线球是存储库根实际上是另一个存储库 - 在元级别上，存储库有两个父级，这无疑是时髦的，对于保持构建脚本的最新非常有用，但如果我尝试过做我想做的事 filter-branch项目根目录下的构建脚本将被删除，这绝对不是我想要的。

    最后是 common目录有点特别——我不介意削减它的版本历史，只要它的内容在那里。

    最佳答案

    摘要

    如果您想保留一些公共(public)资源的历史记录 ( build.* ) 并保持这些资源在将来易于 merge ，并且您想重写/过滤/删除存储库中其他树的子集 ( feature-a ， common ) 使用 git filter-branch ，您应该首先按顺序重写现有的提交:

  • 项目从模板 fork 之前的所有常见提交(这已经是这种情况)。
  • 所有提交修改 build.* ，包括来自上游 Cradle 的本地更改和 merge 。
  • 最后，所有项目特定的提交 feature-*和 common .

    • 然后你可以运行 git filter-branch在特定于项目的开发线上安全地运行，无需重写任何上游资源历史记录。如果你不这样做，你可能最终会重写涉及构建脚本的提交，包括来自上游 Cradle 的 merge 提交，这将抑制历史可追溯性和 future 的 merge 。

    详情

    听起来你有一个黄金项目模板，称之为 T ，并且每次开始一个新项目时，您都会 fork 该存储库(在传统的 GitHub 意义上，或者只是创建一个发散克隆)，将其命名为 Pn .所以Pn和 T从相同的历史记录和常见的提交开始(调用分支点 Pn-0 )。

    如 Pn开发其代码库，其他项目可能会发现对基本项目模板基础结构的改进，并对文件 F 进行更改。在 T .任何项目Pn ，这可能是模板之前的数百次提交，仍然可以 merge 来自 T 的公共(public)文件中的更改.

    现在，您想重写 Pn 中的历史记录.自 Pn-0您已经进行了许多特定于项目的提交，然后是来自 T 的 merge ，然后是更多特定于项目的提交。如果你不得不重写 P返回 Pn-0为了filter-branch ，来自 T 的 merge 历史丢失了，因为历史已经发生分歧， future 从 T merge 变得 hell 。

    这是否描述了您的问题？

    我认为您已经看到，当您想要完全自由地重写历史来重新组织您的项目存储库时，使用从模板克隆项目的方法有其局限性。如果您有来自 T 的 merge 提交前后的历史记录，您将不得不进行一些花哨的重组以保留共同的历史。该解决方案是:
  • 让 Tx是 T 的最新提交您已将其完全 merge 到 Pn .
  • 获取 T进Pn repo，并在 Pn 创建一个分支以提交 Tx 开头.
  • 重新调整您当前的 Pn历史记录到该分支上，将其从 Pn-0 的基础移动(与 T 共同提交)到 Tx ，最新的常见提交 T .

    • 这种方法将在 Pn 中重放您的整个历史记录。好像它以 Tx 开头而不是 Pn-0 ，所以提交 Pn-1有一个新的 parent Tx .当然，每次提交都将被重写，因此 Pn 的任何现有克隆都将被重写。立即成为孤儿。

    一旦你有了这个，你就可以自由运行 git filter-branch从重写的提交开始 Pn-1 ，并删除不完整模块的任何历史记录。

    现在 - 这是相当多的麻烦，并且以棘手的方式重写历史，但历史将被保留。你不会想每天都在做这个过程。

    您可能需要考虑的一件事是，是否有任何方法可以在不共享源代码的情况下生产和使用您的 Cradle。它可能不如 Git merge 方便，但如果您的模板项目是版本控制的，并且您 organize your build logic也许使用 shared scripts ，你可以模块化你的模板项目，这样你就不再依赖于维护公共(public)源历史的子项目来 merge ——他们只会使用最新的模板二进制文件。除了构建逻辑之外，很大程度上取决于模板中的内容。

    关于git - 使用原型(prototype)代码将 Git 存储库重构为实际的可发布项目，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/30555654/

    储库prototypecode的git

    有关git - 使用原型(prototype)代码将 Git 存储库重构为实际的可发布项目的更多相关文章

    1. ruby - 如何使用 Nokogiri 的 xpath 和 at_xpath 方法 - 2

      我正在学习如何使用Nokogiri，根据这段代码我遇到了一些问题:require'rubygems'require'mechanize'post_agent=WWW::Mechanize.newpost_page=post_agent.get('http://www.vbulletin.org/forum/showthread.php?t=230708')puts"\nabsolutepathwithtbodygivesnil"putspost_page.parser.xpath('/html/body/div/div/div/div/div/table/tbody/tr/td/div

    2. ruby - 使用 RubyZip 生成 ZIP 文件时设置压缩级别 - 2

      我有一个Ruby程序，它使用rubyzip压缩XML文件的目录树。gem。我的问题是文件开始变得很重，我想提高压缩级别，因为压缩时间不是问题。我在rubyzipdocumentation中找不到一种为创建的ZIP文件指定压缩级别的方法。有人知道如何更改此设置吗？是否有另一个允许指定压缩级别的Ruby库？ 最佳答案 这是我通过查看ruby​​zip内部创建的代码。level=Zlib::BEST_COMPRESSIONZip::ZipOutputStream.open(zip_file)do|zip|Dir.glob("**/*")d

    3. ruby - 为什么我可以在 Ruby 中使用 Object#send 访问私有(private)/ protected 方法？ - 2

      类classAprivatedeffooputs:fooendpublicdefbarputs:barendprivatedefzimputs:zimendprotecteddefdibputs:dibendendA的实例a=A.new测试a.foorescueputs:faila.barrescueputs:faila.zimrescueputs:faila.dibrescueputs:faila.gazrescueputs:fail测试输出failbarfailfailfail.发送测试[:foo,:bar,:zim,:dib,:gaz].each{|m|a.send(m)resc

    4. ruby-on-rails - 使用 Ruby on Rails 进行自动化测试 - 最佳实践 - 2

      很好奇，就使用ruby​​onrails自动化单元测试而言，你们正在做什么？您是否创建了一个脚本来在cron中运行rake作业并将结果邮寄给您？git中的预提交Hook？只是手动调用？我完全理解测试，但想知道在错误发生之前捕获错误的最佳实践是什么。让我们理所当然地认为测试本身是完美无缺的，并且可以正常工作。下一步是什么以确保他们在正确的时间将可能有害的结果传达给您？ 最佳答案 不确定您到底想听什么，但是有几个级别的自动代码库控制:在处理某项功能时，您可以使用类似autotest的内容获得关于哪些有效，哪些无效的即时反馈。要确保您的提

    5. ruby - 在 Ruby 中使用匿名模块 - 2

      假设我做了一个模块如下:m=Module.newdoclassCendend三个问题:除了对m的引用之外，还有什么方法可以访问C和m中的其他内容？我可以在创建匿名模块后为其命名吗(就像我输入“module...”一样)？如何在使用完匿名模块后将其删除，使其定义的常量不再存在？ 最佳答案 三个答案:是的，使用ObjectSpace.此代码使c引用你的类(class)C不引用m:c=nilObjectSpace.each_object{|obj|c=objif(Class===objandobj.name=~/::C$/)}当然这取决于

    6. ruby - 使用 ruby​​ 和 savon 的 SOAP 服务 - 2

      我正在尝试使用ruby​​和Savon来使用网络服务。测试服务为http://www.webservicex.net/WS/WSDetails.aspx?WSID=9&CATID=2require'rubygems'require'savon'client=Savon::Client.new"http://www.webservicex.net/stockquote.asmx?WSDL"client.get_quotedo|soap|soap.body={:symbol=>"AAPL"}end返回SOAP异常。检查soap信封，在我看来soap请求没有正确的命名空间。任何人都可以建议我

    7. python - 如何使用 Ruby 或 Python 创建一系列高音调和低音调的蜂鸣声？ - 2

      关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题？更新问题，以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我想在固定时间创建一系列低音和高音调的哔哔声。例如:在150毫秒时发出高音调的蜂鸣声在151毫秒时发出低音调的蜂鸣声200毫秒时发出低音调的蜂鸣声250毫秒的高音调蜂鸣声有没有办法在Ruby或Python中做到这一点？我真的不在乎输出编码是什么(.wav、.mp3、.ogg等等)，但我确实想创建一个输出文件。

    8. ruby-on-rails - 如何验证 update_all 是否实际在 Rails 中更新 - 2

      给定这段代码defcreate@upgrades=User.update_all(["role=?","upgraded"],:id=>params[:upgrade])redirect_toadmin_upgrades_path,:notice=>"Successfullyupgradeduser."end我如何在该操作中实际验证它们是否已保存或未重定向到适当的页面和消息？ 最佳答案 在Rails3中，update_all不返回任何有意义的信息，除了已更新的记录数(这可能取决于您的DBMS是否返回该信息)。http://ar.ru

    9. ruby-on-rails - 'compass watch' 是如何工作的/它是如何与 rails 一起使用的 - 2

      我在我的项目目录中完成了compasscreate.和compassinitrails。几个问题:我已将我的.sass文件放在public/stylesheets中。这是放置它们的正确位置吗？当我运行compasswatch时，它不会自动编译这些.sass文件。我必须手动指定文件:compasswatchpublic/stylesheets/myfile.sass等。如何让它自动运行？文件ie.css、print.css和screen.css已放在stylesheets/compiled。如何在编译后不让它们重新出现的情况下删除它们？我自己编译的.sass文件编译成compiled/t

    10. ruby - 使用 ruby​​ 将 HTML 转换为纯文本并维护结构/格式 - 2

      我想将html转换为纯文本。不过，我不想只删除标签，我想智能地保留尽可能多的格式。为插入换行符标签，检测段落并格式化它们等。输入非常简单，通常是格式良好的html(不是整个文档，只是一堆内容，通常没有anchor或图像)。我可以将几个正则表达式放在一起，让我达到80%，但我认为可能有一些现有的解决方案更智能。 最佳答案 首先，不要尝试为此使用正则表达式。很有可能你会想出一个脆弱/脆弱的解决方案，它会随着HTML的变化而崩溃，或者很难管理和维护。您可以使用Nokogiri快速解析HTML并提取文本:require'nokogiri'h

    随机推荐