bindery-cli 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: af953a6d3a3f8b05cff050e4a9e7a6ced73a8bfc59a6c9269793b5f53e60cbde
+  data.tar.gz: 877069de98701d6a504b010f3268cb1f2a1ce471fc4e5b56d3ea058ec769e35d
+SHA512:
+  metadata.gz: 95295349a768fd7abb2c8c2a557391ae789b581265a07d299b9dfb617bcad57f6a902956fb53dc87dd7a8bc1bf480a390d4f28a08f0f07f4598cfb28d0f06cfc
+  data.tar.gz: c05bfa81b2fa39164c2d0d21497b1cbebb1ae090fb95f6b87590796cd58a6542b9e69531849c62a2ac7989486082c3aaf201b0b17d93f63caf4c18d328079441

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Billow Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,76 @@
+# bindery
+
+把 Markdown 公版书批量构建为 EPUB 的项目脚手架工具。
+
+- `bindery new <项目名>` 创建整套项目结构
+- `bindery generate book <id> <书名>` 为单本书生成骨架
+- `bindery build` 调用 [Pandoc](https://pandoc.org) 批量构建 EPUB
+
+仅依赖 Ruby 标准库，不引入任何第三方 gem。
+
+## 安装
+
+```bash
+gem install bindery-cli
+```
+
+系统需要另外安装 Pandoc：
+
+```bash
+# Debian/Ubuntu
+apt-get install -y pandoc
+
+# macOS
+brew install pandoc
+```
+
+## 快速开始
+
+```bash
+# 1. 创建项目
+bindery new my-books
+cd my-books
+
+# 2. 新建一本书
+bindery generate book lunyu "论语" --author "孔子及弟子" --dynasty "先秦"
+
+# 3. 编辑 books/lunyu/chapters/ 下的章节文件
+
+# 4. 构建 EPUB
+bindery build lunyu
+
+# 批量构建所有书
+bindery build --all
+
+# 查看书籍状态
+bindery status
+```
+
+## 项目结构
+
+```
+my-books/
+├── config/bindery.yml     # 项目标记文件，不要删除
+├── books/                 # 每本书一个子目录
+│   └── <id>/
+│       ├── metadata.yaml  # 书籍元信息
+│       ├── cover.jpg      # 封面（可选）
+│       └── chapters/      # Markdown 章节，按文件名排序合并
+├── templates/style.css    # 全项目共用的 EPUB 样式
+├── output/epub/           # 构建产物
+└── books.json             # 自动生成的书目索引
+```
+
+## 开发
+
+```bash
+# 运行本地版本
+ruby -Ilib exe/bindery --help
+
+# 构建 gem
+gem build bindery.gemspec
+```
+
+## License
+
+MIT

data/exe/bindery

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/bindery"
+
+Bindery::CLI.start(ARGV)

data/lib/bindery/book.rb

@@ -0,0 +1,78 @@
+require "yaml"
+require "pathname"
+
+module Bindery
+  # 代表一本书：对应 books/<id>/ 目录
+  class Book
+    attr_reader :id, :dir
+
+    def initialize(dir)
+      @dir = Pathname.new(dir)
+      @id = @dir.basename.to_s
+    end
+
+    def self.all(project_root = Project.root!)
+      books_dir = Project.books_dir(project_root)
+      return [] unless books_dir.directory?
+
+      books_dir.children.select(&:directory?).sort.map { |d| new(d) }
+    end
+
+    def self.find(id, project_root = Project.root!)
+      dir = Project.books_dir(project_root) + id
+      raise Bindery::BookNotFoundError, "找不到书籍: #{id}（#{dir} 不存在）" unless dir.directory?
+
+      new(dir)
+    end
+
+    def metadata_file
+      dir + "metadata.yaml"
+    end
+
+    def metadata
+      raise Bindery::Error, "缺少 metadata.yaml: #{metadata_file}" unless metadata_file.file?
+
+      @metadata ||= YAML.safe_load(metadata_file.read, permitted_classes: [Symbol]) || {}
+    end
+
+    def title
+      metadata["title"] || id
+    rescue Bindery::Error
+      id
+    end
+
+    def author
+      metadata["author"] || "佚名"
+    rescue Bindery::Error
+      "佚名"
+    end
+
+    def cover_path
+      name = metadata["cover"] || "cover.jpg"
+      path = dir + name
+      path.file? ? path : nil
+    end
+
+    def chapters_dir
+      dir + "chapters"
+    end
+
+    def chapters
+      return [] unless chapters_dir.directory?
+
+      chapters_dir.children.select { |f| f.file? && f.extname == ".md" }.sort
+    end
+
+    def valid?
+      metadata_file.file? && chapters.any?
+    end
+
+    def epub_output(project_root = Project.root!)
+      Project.output_dir(project_root) + "epub" + "#{id}.epub"
+    end
+
+    def built?(project_root = Project.root!)
+      epub_output(project_root).file?
+    end
+  end
+end

data/lib/bindery/builder.rb

@@ -0,0 +1,100 @@
+require "open3"
+require "yaml"
+require "fileutils"
+require "tmpdir"
+require "pathname"
+
+module Bindery
+  # 负责把一本书的多个章节 md 文件合并，并调用 Pandoc 生成 EPUB
+  class Builder
+    class BuildError < Bindery::Error; end
+
+    def initialize(book, project_root: Project.root!)
+      @book = book
+      @project_root = project_root
+    end
+
+    # 返回 true/false 表示是否成功；详细错误信息可通过 #last_error 获取
+    def build_epub
+      chapters = @book.chapters
+      if chapters.empty?
+        @last_error = "#{@book.id} 的 chapters/ 目录下没有任何 .md 文件"
+        return false
+      end
+
+      meta = @book.metadata
+      ensure_pandoc!
+
+      Dir.mktmpdir("bindery-#{@book.id}-") do |tmp|
+        merged = merge_chapters(chapters, tmp)
+        meta_file = write_pandoc_metadata(tmp, meta)
+
+        out_dir = Project.output_dir(@project_root) + "epub"
+        FileUtils.mkdir_p(out_dir)
+        out_path = out_dir + "#{@book.id}.epub"
+
+        cmd = ["pandoc", merged.to_s, "-o", out_path.to_s,
+               "--metadata-file", meta_file.to_s, "--toc"]
+
+        css = Project.templates_dir(@project_root) + "style.css"
+        cmd += ["--css", css.to_s] if css.file?
+
+        cover = @book.cover_path
+        cmd += ["--epub-cover-image", cover.to_s] if cover
+
+        run(cmd)
+      end
+    rescue Bindery::Error => e
+      @last_error = e.message
+      false
+    end
+
+    def last_error
+      @last_error
+    end
+
+    private
+
+    def ensure_pandoc!
+      return if system("pandoc", "--version", out: File::NULL, err: File::NULL)
+
+      raise BuildError, "找不到 pandoc 命令，请先安装：apt-get install -y pandoc（或参考 https://pandoc.org/installing.html）"
+    end
+
+    def merge_chapters(chapters, tmp_dir)
+      path = Pathname.new(tmp_dir) + "merged.md"
+      path.open("w") do |out|
+        chapters.each_with_index do |chapter, i|
+          out.puts if i.positive?
+          out.puts chapter.read
+        end
+      end
+      path
+    end
+
+    def write_pandoc_metadata(tmp_dir, meta)
+      pandoc_meta = {
+        "title"     => meta["title"] || @book.id,
+        "author"    => meta["author"] || "佚名",
+        "lang"      => meta["lang"] || "zh-CN",
+        "rights"    => meta["rights"] || "公共领域",
+        "publisher" => meta["publisher"] || "再读经典",
+      }
+      pandoc_meta["date"] = meta["dynasty"] if meta["dynasty"] && !meta["dynasty"].to_s.empty?
+
+      path = Pathname.new(tmp_dir) + "metadata.yaml"
+      path.write(pandoc_meta.to_yaml)
+      path
+    end
+
+    def run(cmd)
+      stdout, stderr, status = Open3.capture3(*cmd)
+      if status.success?
+        true
+      else
+        @last_error = stderr.empty? ? stdout : stderr
+        false
+      end
+    end
+  end
+end

data/lib/bindery/cli.rb

@@ -0,0 +1,167 @@
+require "optparse"
+
+module Bindery
+  # 命令行入口：解析子命令并分发
+  # 支持: new / generate(g) / build / status / version / help
+  class CLI
+    def self.start(argv)
+      new.run(argv)
+    end
+
+    def run(argv)
+      command, *rest = argv
+      case command
+      when "new"
+        cmd_new(rest)
+      when "generate", "g"
+        cmd_generate(rest)
+      when "build"
+        cmd_build(rest)
+      when "status"
+        cmd_status(rest)
+      when "version", "-v", "--version"
+        puts "bindery #{Bindery::VERSION}"
+      when nil, "help", "-h", "--help"
+        print_help
+      else
+        warn "未知命令: #{command}"
+        print_help
+        exit 1
+      end
+    rescue OptionParser::ParseError => e
+      warn "参数错误: #{e.message}"
+      exit 1
+    rescue Bindery::Error => e
+      warn "错误: #{e.message}"
+      exit 1
+    end
+
+    private
+
+    # ---------- bindery new <项目名> ----------
+    def cmd_new(args)
+      name = args.first
+      if name.nil? || name.empty?
+        warn "用法: bindery new <项目名>"
+        exit 1
+      end
+      Generators::ProjectGenerator.call(name)
+    end
+
+    # ---------- bindery generate book <id> <title> [选项] ----------
+    def cmd_generate(args)
+      type, *rest = args
+      case type
+      when "book"
+        cmd_generate_book(rest)
+      when nil
+        warn "用法: bindery generate book <id> <书名> [--author NAME] [--dynasty 朝代] [--category 分类]"
+        exit 1
+      else
+        warn "未知的生成器类型: #{type}（目前只支持 book）"
+        exit 1
+      end
+    end
+
+    def cmd_generate_book(args)
+      options = { author: "佚名", dynasty: "", category: "" }
+      parser = OptionParser.new do |o|
+        o.on("--author NAME") { |v| options[:author] = v }
+        o.on("--dynasty NAME") { |v| options[:dynasty] = v }
+        o.on("--category NAME") { |v| options[:category] = v }
+      end
+      positional = parser.parse(args)
+      id, title = positional
+      if id.nil? || title.nil?
+        warn "用法: bindery generate book <id> <书名> [--author NAME] [--dynasty 朝代] [--category 分类]"
+        exit 1
+      end
+
+      Generators::BookGenerator.call(
+        id, title,
+        author: options[:author], dynasty: options[:dynasty], category: options[:category]
+      )
+    end
+
+    # ---------- bindery build [<id>] [--all] ----------
+    def cmd_build(args)
+      options = { all: false }
+      parser = OptionParser.new do |o|
+        o.on("--all") { options[:all] = true }
+      end
+      positional = parser.parse(args)
+
+      project_root = Project.root!
+      books = options[:all] ? Bindery::Book.all(project_root) : [book_from_arg(positional.first, project_root)]
+
+      if books.empty?
+        warn "books/ 目录下没有任何书籍"
+        return
+      end
+
+      success = 0
+      failure = 0
+      books.each do |book|
+        builder = Builder.new(book, project_root: project_root)
+        if builder.build_epub
+          puts "✅ [#{book.id}] epub 构建成功"
+          success += 1
+        else
+          puts "❌ [#{book.id}] epub 构建失败"
+          puts "   #{builder.last_error}"
+          failure += 1
+        end
+      end
+
+      Index.rebuild(project_root)
+      puts "" if options[:all]
+      puts "完成：成功 #{success} 本，失败 #{failure} 本" if options[:all]
+    end
+
+    def book_from_arg(id, project_root)
+      if id.nil?
+        warn "请指定书籍 id，或使用 --all 构建全部"
+        exit 1
+      end
+      Bindery::Book.find(id, project_root)
+    end
+
+    # ---------- bindery status ----------
+    def cmd_status(_args)
+      project_root = Project.root!
+      books = Bindery::Book.all(project_root)
+      if books.empty?
+        puts "books/ 目录下没有任何书籍"
+        return
+      end
+
+      printf("%-16s %-16s %-8s %-6s\n", "书籍ID", "标题", "章节数", "EPUB")
+      puts "-" * 50
+      books.each do |book|
+        printf(
+          "%-16s %-16s %-8d %-6s\n",
+          book.id, book.title, book.chapters.size,
+          book.built?(project_root) ? "✅" : "—"
+        )
+      end
+      puts "-" * 50
+      puts "共 #{books.size} 本书"
+    end
+
+    def print_help
+      puts <<~HELP
+        bindery #{Bindery::VERSION} — 再读经典项目脚手架工具
+
+        用法:
+          bindery new <项目名>                              创建新项目
+          bindery generate book <id> <书名> [选项]           为项目生成一本新书
+            简写: bindery g book <id> <书名>
+            选项: --author NAME  --dynasty 朝代  --category 分类
+          bindery build <id>                                构建单本书的 epub
+          bindery build --all                               批量构建所有书
+          bindery status                                     查看所有书籍状态
+          bindery version                                    查看版本号
+      HELP
+    end
+  end
+end

data/lib/bindery/errors.rb

@@ -0,0 +1,5 @@
+module Bindery
+  class Error < StandardError; end
+  class ProjectNotFoundError < Error; end
+  class BookNotFoundError < Error; end
+end

data/lib/bindery/generators/base.rb

@@ -0,0 +1,63 @@
+require "erb"
+require "fileutils"
+require "pathname"
+
+module Bindery
+  module Generators
+    # 所有生成器的基类：提供"渲染ERB模板 -> 写入目标文件"的公共能力
+    # 风格类似 Rails::Generators::Base，但不依赖 Thor / Rails，纯标准库实现
+    class Base
+      TEMPLATES_ROOT = Pathname.new(__dir__) + "templates"
+
+      class << self
+        attr_reader :log_lines
+      end
+
+      def initialize(destination)
+        @destination = Pathname.new(destination)
+      end
+
+      private
+
+      # 把 templates/<template_dir>/foo.erb 渲染后写到 destination 下的 foo
+      def template(template_dir, relative_path, locals: {})
+        src = TEMPLATES_ROOT + template_dir + "#{relative_path}.erb"
+        dest = @destination + relative_path
+        render_and_write(src, dest, locals)
+      end
+
+      # 直接复制一个非模板文件（比如 .gitignore、style.css）
+      def copy_file(template_dir, relative_path, dest_relative_path = relative_path)
+        src = TEMPLATES_ROOT + template_dir + relative_path
+        dest = @destination + dest_relative_path
+        FileUtils.mkdir_p(dest.dirname)
+        FileUtils.cp(src, dest)
+        say "create", dest
+      end
+
+      def empty_directory(relative_path)
+        dest = @destination + relative_path
+        FileUtils.mkdir_p(dest)
+        say "create", "#{dest}/"
+      end
+
+      def render_and_write(src, dest, locals)
+        FileUtils.mkdir_p(dest.dirname)
+        content = ERB.new(src.read, trim_mode: "-").result(binding_for(locals))
+        dest.write(content)
+        say "create", dest
+      end
+
+      def binding_for(locals)
+        b = binding
+        locals.each { |k, v| b.local_variable_set(k, v) }
+        b
+      end
+
+      def say(action, path)
+        rel = Pathname.new(path).relative_path_from(Pathname.pwd) rescue path
+        puts "  #{action.rjust(8)}  #{rel}"
+      end
+    end
+  end
+end

data/lib/bindery/generators/book_generator.rb

@@ -0,0 +1,29 @@
+require_relative "base"
+
+module Bindery
+  module Generators
+    # bindery generate book <id> <title> [--author] [--dynasty] [--category]
+    class BookGenerator < Base
+      def self.call(id, title, author:, dynasty:, category:, project_root: Project.root!)
+        dest = Project.books_dir(project_root) + id
+        raise Bindery::Error, "书籍目录已存在: #{dest}" if dest.exist?
+
+        puts "创建书籍: #{id}"
+        new(dest).generate(id: id, title: title, author: author, dynasty: dynasty, category: category)
+        Bindery::Index.rebuild(project_root)
+        puts ""
+        puts "完成！接下来编辑 #{dest}/chapters/ 下的章节文件，然后："
+        puts "  bindery build #{id}"
+      end
+
+      def generate(id:, title:, author:, dynasty:, category:)
+        empty_directory("chapters")
+
+        template("book", "metadata.yaml", locals: {
+          id: id, title: title, author: author, dynasty: dynasty, category: category,
+        })
+        template("book", "chapters/01-chapter.md", locals: { title: title })
+      end
+    end
+  end
+end

data/lib/bindery/generators/project_generator.rb

@@ -0,0 +1,36 @@
+require_relative "base"
+
+module Bindery
+  module Generators
+    # bindery new <项目名>
+    # 生成一整套项目骨架：books/、templates/（样式+字体说明）、output/、
+    # config/bindery.yml（项目标记文件）、README、.gitignore、GitHub Actions
+    class ProjectGenerator < Base
+      def self.call(project_name)
+        dest = Pathname.pwd + project_name
+        if dest.exist?
+          raise Bindery::Error, "目录已存在: #{dest}"
+        end
+
+        puts "创建项目: #{project_name}"
+        new(dest).generate(project_name)
+        puts ""
+        puts "完成！接下来："
+        puts "  cd #{project_name}"
+        puts "  bindery generate book lunyu \"论语\" --author \"孔子及弟子\""
+        puts "  bindery build lunyu"
+      end
+
+      def generate(project_name)
+        empty_directory("books")
+        empty_directory("output/epub")
+
+        template("project", "config/bindery.yml", locals: { project_name: project_name })
+        template("project", "README.md", locals: { project_name: project_name })
+        copy_file("project", "gitignore", ".gitignore")
+        copy_file("project", "style.css", "templates/style.css")
+        copy_file("project", "workflow.yml", ".github/workflows/build.yml")
+      end
+    end
+  end
+end

data/lib/bindery/generators/templates/book/chapters/01-chapter.md.erb

@@ -0,0 +1,6 @@
+# 第一章
+
+《<%= title %>》正文从这里开始……
+
+在 chapters/ 目录下按顺序添加更多章节文件（如 02-xxx.md, 03-xxx.md），
+文件名的字典序决定了它们在成书中的先后顺序。

data/lib/bindery/generators/templates/book/metadata.yaml.erb

@@ -0,0 +1,9 @@
+id: <%= id.inspect %>
+title: <%= title.inspect %>
+author: <%= author.inspect %>
+lang: zh-CN
+dynasty: <%= dynasty.inspect %>
+category: <%= category.inspect %>
+rights: 公共领域
+publisher: 再读经典
+cover: cover.jpg

data/lib/bindery/generators/templates/project/README.md.erb

@@ -0,0 +1,46 @@
+# <%= project_name %>
+
+用 bindery 管理的公版经典书籍项目。Markdown 源文件 -> EPUB。
+
+## 常用命令
+
+```bash
+# 新建一本书
+bindery generate book <书籍ID> "<书名>" --author "<作者>"
+# 简写
+bindery g book <书籍ID> "<书名>"
+
+# 构建一本书
+bindery build <书籍ID>
+
+# 批量构建全部
+bindery build --all
+
+# 查看所有书籍状态
+bindery status
+```
+
+## 目录结构
+
+```
+<%= project_name %>/
+├── config/bindery.yml     # 项目标记文件，不要删除
+├── books/               # 每本书一个子目录
+├── templates/           # 全项目共用的 EPUB 样式
+├── output/epub/         # 构建产物
+└── books.json           # 自动生成的书目索引
+```
+
+## 环境依赖
+
+只需要系统装有 `pandoc`：
+
+```bash
+# Debian/Ubuntu
+apt-get install -y pandoc
+
+# macOS
+brew install pandoc
+```
+
+bindery 本身不依赖任何第三方 gem，只用 Ruby 标准库。

data/lib/bindery/generators/templates/project/config/bindery.yml.erb

@@ -0,0 +1,14 @@
+# bindery 项目配置文件
+# 这个文件的存在本身就是"项目根目录"的标记（类似 Rails 的 config/application.rb）
+# 在这个目录树下的任意子目录执行 bindery 命令，都能自动定位到项目根
+
+project_name: <%= project_name.inspect %>
+
+# 默认语言
+lang: zh-CN
+
+# 默认出版方（写入每本书的 metadata）
+publisher: 再读经典
+
+# 默认版权声明
+rights: 公共领域

data/lib/bindery/generators/templates/project/gitignore

@@ -0,0 +1,3 @@
+/output/
+books.json
+.DS_Store

data/lib/bindery/generators/templates/project/style.css

@@ -0,0 +1,30 @@
+body {
+  font-family: "Noto Serif CJK SC", "Songti SC", serif;
+  line-height: 1.8;
+  margin: 1em;
+}
+
+h1 {
+  font-size: 1.6em;
+  text-align: center;
+  margin-top: 2em;
+  margin-bottom: 1em;
+  border-bottom: 1px solid #ccc;
+  padding-bottom: 0.3em;
+}
+
+h2 {
+  font-size: 1.3em;
+  margin-top: 1.5em;
+}
+
+p {
+  text-indent: 2em;
+  margin: 0.5em 0;
+}
+
+blockquote {
+  margin: 1em 2em;
+  color: #444;
+  font-style: italic;
+}

data/lib/bindery/generators/templates/project/workflow.yml

@@ -0,0 +1,44 @@
+name: Build books
+
+on:
+  push:
+    paths:
+      - "books/**/*.md"
+      - "books/**/metadata.yaml"
+  workflow_dispatch: {}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install pandoc
+        run: sudo apt-get update && sudo apt-get install -y pandoc
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.2"
+
+      - name: Install bindery
+        run: gem install bindery-cli
+
+      - name: Build all books
+        run: bindery build --all
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: books-output
+          path: |
+            output/
+            books.json
+
+      - name: Commit updated books.json
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add books.json
+          git diff --cached --quiet || git commit -m "chore: update books.json [skip ci]"
+          git push

data/lib/bindery/index.rb

@@ -0,0 +1,31 @@
+require "json"
+require "time"
+
+module Bindery
+  # 扫描所有书籍，重新生成 books.json（供后续静态网站读取）
+  module Index
+    module_function
+
+    def rebuild(project_root = Project.root!)
+      books = Bindery::Book.all(project_root).select(&:valid?).map do |book|
+        {
+          "id"       => book.id,
+          "title"    => book.title,
+          "author"   => book.author,
+          "dynasty"  => book.metadata["dynasty"],
+          "category" => book.metadata["category"],
+          "epub"     => book.built?(project_root) ? "output/epub/#{book.id}.epub" : nil,
+        }
+      end
+
+      data = {
+        "generated_at" => Time.now.iso8601,
+        "count"        => books.size,
+        "books"        => books,
+      }
+
+      Project.index_file(project_root).write(JSON.pretty_generate(data))
+      data
+    end
+  end
+end

data/lib/bindery/project.rb

@@ -0,0 +1,44 @@
+require "pathname"
+
+module Bindery
+  # 负责在目录树中定位 bindery 项目根目录（含 config/bindery.yml 标记文件的目录）
+  # 用法和 Rails / Bundler 一样：在项目内任意子目录执行命令都能定位到项目根
+  module Project
+    MARKER = "config/bindery.yml"
+
+    module_function
+
+    def root(start_dir = Dir.pwd)
+      dir = Pathname.new(start_dir).expand_path
+      loop do
+        return dir if (dir + MARKER).file?
+        return nil if dir.root?
+        dir = dir.parent
+      end
+    end
+
+    def root!(start_dir = Dir.pwd)
+      root(start_dir) || raise(
+        Bindery::ProjectNotFoundError,
+        "找不到 bindery 项目（未发现 #{MARKER}）。请在项目目录内执行，" \
+        "或先用 `bindery new <项目名>` 创建一个新项目。"
+      )
+    end
+
+    def books_dir(project_root = root!)
+      project_root + "books"
+    end
+
+    def templates_dir(project_root = root!)
+      project_root + "templates"
+    end
+
+    def output_dir(project_root = root!)
+      project_root + "output"
+    end
+
+    def index_file(project_root = root!)
+      project_root + "books.json"
+    end
+  end
+end

data/lib/bindery/version.rb

@@ -0,0 +1,3 @@
+module Bindery
+  VERSION = "0.1.1"
+end

data/lib/bindery.rb

@@ -0,0 +1,9 @@
+require_relative "bindery/version"
+require_relative "bindery/errors"
+require_relative "bindery/project"
+require_relative "bindery/book"
+require_relative "bindery/builder"
+require_relative "bindery/index"
+require_relative "bindery/generators/project_generator"
+require_relative "bindery/generators/book_generator"
+require_relative "bindery/cli"

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: bindery-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Billow Wang
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: |
+  bindery 是手架工具：
+  `bindery new` 创建整套项目结构，
+  `bindery generate book` 为单本书生成骨架，
+  `bindery build` 调用 Pandoc 批量构建 EPUB。
+  仅依赖 Ruby 标准库，不引入任何第三方 gem。
+executables:
+- bindery
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- exe/bindery
+- lib/bindery.rb
+- lib/bindery/book.rb
+- lib/bindery/builder.rb
+- lib/bindery/cli.rb
+- lib/bindery/errors.rb
+- lib/bindery/generators/base.rb
+- lib/bindery/generators/book_generator.rb
+- lib/bindery/generators/project_generator.rb
+- lib/bindery/generators/templates/book/chapters/01-chapter.md.erb
+- lib/bindery/generators/templates/book/metadata.yaml.erb
+- lib/bindery/generators/templates/project/README.md.erb
+- lib/bindery/generators/templates/project/config/bindery.yml.erb
+- lib/bindery/generators/templates/project/gitignore
+- lib/bindery/generators/templates/project/style.css
+- lib/bindery/generators/templates/project/workflow.yml
+- lib/bindery/index.rb
+- lib/bindery/project.rb
+- lib/bindery/version.rb
+homepage: https://github.com/gamepunk/bindery-gem
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/gamepunk/bindery-gem
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: 把 Markdown 公版书批量构建为 EPUB 的项目脚手架工具
+test_files: []