后端【免费下载链接】koudokuRobust subscription support for Rails with Stripe.项目地址https://gitcode.com/gh_mirrors/ko/koudoku点击查看免费下载Koudoku 是一款为 Ruby on Rails 应用提供 Stripe 订阅支持的开源引擎内置定价页、支付页和订阅管理页面。它最大的亮点是一条命令装好运行rails g koudoku:install user后install 生成器会自动创建 3 个模型、向现有模型注入关联、并把引擎挂载到路由里。这篇文章带你拆解 install 与 views 两个生成器的源码看看这套自动注入是如何实现的 1️⃣ 先认清两个生成器的分工Koudoku 提供了两个 Rails 生成器职责非常清晰生成器命令作用installrails g koudoku:install user一键安装生成 3 个模型、注入关联与路由、输出初始化配置viewsrails g koudoku:views把引擎内置的订阅页面整套复制到宿主应用方便二次定制核心源码位置install 生成器lib/generators/koudoku/install_generator.rbviews 生成器lib/generators/koudoku/views_generator.rb模板目录lib/generators/koudoku/templates/两个生成器在 lib/koudoku.rb 中被显式注册require generators/koudoku/install_generator require generators/koudoku/views_generator此外lib/tasks/koudoku_tasks.rake 还封装了rake koudoku:install和rake koudoku:views两个快捷任务本质只是转调上面的 rails 命令。2️⃣ install 生成器四步完成注入手术声明必需参数订阅的主人模型argument :subscription_owner_model, :type :string, :required true, :desc Owner of the subscription命令后必须跟一个参数通常是user也可能是company表示谁拥有订阅。紧接着有一个小技巧——重写argument自动生成的访问器保证该参数在模板插值中永远以小写形式出现def subscription_owner_model subscription_owner_model.downcase end三连招一次生成 3 个模型对每个模型Koudoku 都采用generatetemplate两步组合先调用 Rails 内置 model 生成器建表会自动生成 migration再用内置模板覆盖模型文件注入业务逻辑# 生成 subscription字段名过长此处省略号略 generate(model, subscription stripe_id:string plan_id:integer ... #{subscription_owner_model}_id:integer) template app/models/subscription.rb # 生成 plan 与 coupon套路相同三个模板文件分别是templates/app/models/subscription.rbinclude 核心 concern Koudoku::Subscription并声明 owner 关联templates/app/models/plan.rb套餐模型has_many :subscriptionstemplates/app/models/coupon.rb优惠码模型模板是标准的 ERB 写法比如 subscription 模板里的belongs_to :% subscription_owner_model %生成时传入user落盘后就是belongs_to :user。一份模板适配任意 owner 模型正是生成器机制的精髓 ✨同时source_paths告诉 Thor 到两个地方找模板引擎根目录和生成器旁边的 templates 目录def self.source_paths [Koudoku::Engine.root, File.expand_path(../templates, __FILE__)] end关联注入不动一行现有代码owner 模型通常是User是宿主应用已有的模型Koudoku 不能覆盖它于是用 Thor 的inject_into_class精确插入一行关联inject_into_class app/models/#{subscription_owner_model}.rb, subscription_owner_model.camelize.constantize, # Added by Koudoku.\n has_one :subscription\n\n三个参数分别是目标文件、目标类名user动态驼峰化为User、要插入的代码。执行后has_one :subscription被干净利落地写进app/models/user.rb的类体内部其余代码分毫未动 路由注入挂载引擎 暴露定价页最后一步用route动作向config/routes.rb末尾追加内容route -RUBY # Added by Koudoku. mount Koudoku::Engine, at: koudoku scope module: koudoku do get pricing subscriptions#index, as: pricing end RUBYmount挂载的 Koudoku::Engine 使用isolate_namespace Koudoku做命名空间隔离引擎内部的路由定义在 config/routes.rb订阅资源、取消订阅的 member 路由以及把 StripeEvent 引擎挂在/webhooks上接收支付回调默认订阅的事件见 config/initializers/stripe_event.rb。而外层的pricing路由则让宿主应用可以直接用pricing_path链接到定价页。生成器还会顺手用template生成 templates/config/initializers/koudoku.rb其中subscriptions_owned_by被动态填充为 owner 模型Stripe API key 默认读取STRIPE_PUBLISHABLE_KEY/STRIPE_SECRET_KEY环境变量——密钥不进版本库。最后终端会提示你把 Stripe webhook 指向/koudoku/events安装流程至此闭环。3️⃣ views 生成器极简的全量复制方案views 生成器只有十几行核心逻辑把引擎里app/views/koudoku/subscriptions/目录下的所有文件复制到宿主应用同名路径files_to_copy Dir.entries(#{Koudoku::Engine.root}/app/views/koudoku/subscriptions) - %w[. ..] files_to_copy.each do |file| copy_file file, app/views/koudoku/subscriptions/#{file} end被复制的源文件就在 app/views/koudoku/subscriptions/包括index定价页、new/edit/show订阅流程、_pricing_table、_stripe_js、unauthorized等默认视图。为什么单独做这个生成器因为默认安装时只会复制一个_social_proof.html.erb用户评价占位片段由 install 生成器 copy 进去。Rails 引擎的视图查找顺序是宿主应用优先于引擎所以想改某一张页面时手动复制那一个文件即可想全套接管时rails g koudoku:views一条命令全部落盘 4️⃣ 总结三个值得借鉴的设计点generate template 组合拳表结构交给 Rails 官方 model 生成器migration 自动生成业务逻辑交给 ERB 模板一个模板适配任意 owner 模型。外科手术式注入用inject_into_class和route往现有文件里精准插代码而不是覆盖整个文件天然避免与宿主代码冲突。引擎隔离Koudoku 作为独立 Rails::Engine 运行视图、路由、资产全部收敛在koudoku命名空间下宿主应用只需mount一下即完成集成。 附生成物速查表生成/修改的文件来源动作app/models/subscription.rb、plan.rb、coupon.rbgeneratetemplate对应 3 份 migrationgenerate(model, ...)自动产出config/initializers/koudoku.rbtemplateapp/models/user.rb插入has_oneinject_into_classconfig/routes.rb追加 mount 与 pricing 路由routeapp/views/koudoku/subscriptions/_social_proof.html.erbcopy_file整套订阅视图可选views 生成器回过头看整个安装体验你传入的user参数一路贯穿了模型字段user_id、模板插值、关联注入和初始化配置。这就是 Rails 生成器机制优雅的地方——把约定固化进生成器把选择留给开发者 ⚡赞分享后端【免费下载链接】koudokuRobust subscription support for Rails with Stripe.项目地址https://gitcode.com/gh_mirrors/ko/koudoku点击查看免费下载相关推荐hygen 实战为 Express 应用自动生成路由与 Handler 的注入模板指南hygen 实战为 Express 应用自动生成路由与 Handler 的注入模板指南 Express.js 被广泛认为是 Node.js 生态中最流行的 W开发工具CLI终极指南深度解析MessagePack-CSharp源码生成器如何实现自动化代码生成终极指南深度解析MessagePack CSharp源码生成器如何实现自动化代码生成 MessagePack CSharp源码生成器是一个革命性的工具通过R序列化后端Soup主动学习采样active-sample从海量数据挑出最硬的10%训练Soup主动学习采样active sample从海量数据挑出最硬的10%训练 Soup 是一个一个 YAML 文件就能微调 LLM的训练框架内置的人工智能大模型微调LoRACLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考