bindery-cli 0.1.1 → 0.2.0

data/lib/bindery/validator.rb

@@ -0,0 +1,52 @@
+require "yaml"
+
+module Bindery
+  # 构建前校验：检查一本书是否具备构建条件
+  module Validator
+    module_function
+
+    # 硬性问题（会导致构建失败），返回字符串数组，空数组表示通过
+    def check(book, project_root: Project.root!)
+      issues = []
+
+      if book.metadata_file.file?
+        begin
+          meta = book.metadata
+          issues << "metadata.yaml 缺少 title" if meta["title"].to_s.strip.empty?
+        rescue Psych::SyntaxError, Bindery::Error => e
+          issues << "metadata.yaml 解析失败: #{e.message}"
+        end
+      else
+        issues << "缺少 metadata.yaml"
+      end
+
+      issues << "chapters/ 目录下没有任何 .md 文件" if book.all_chapters.empty?
+      issues << "未安装 pandoc（构建前请先安装）" unless pandoc_installed?
+
+      issues
+    end
+
+    # 软性警告（不影响构建，但建议修正），返回字符串数组
+    def warnings(book, project_root: Project.root!)
+      warns = []
+
+      cover = book.cover_path
+      if cover.nil?
+        warns << "缺少封面（可在书籍目录放置 cover.jpg）"
+      else
+        dims = Bindery::Image.dimensions(cover)
+        if dims.nil?
+          warns << "封面不是有效的 JPEG/PNG 图片"
+        elsif dims[0] < 600 || dims[1] < 800
+          warns << "封面尺寸偏小（#{dims[0]}×#{dims[1]}，建议至少 600×800）"
+        end
+      end
+
+      warns
+    end
+
+    def pandoc_installed?
+      system("pandoc", "--version", out: File::NULL, err: File::NULL)
+    end
+  end
+end

data/lib/bindery/version.rb

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

data/lib/bindery.rb

@@ -3,7 +3,13 @@ require_relative "bindery/errors"
 require_relative "bindery/project"
 require_relative "bindery/book"
 require_relative "bindery/builder"
+require_relative "bindery/image"
+require_relative "bindery/cover"
+require_relative "bindery/validator"
 require_relative "bindery/index"
+require_relative "bindery/server"
 require_relative "bindery/generators/project_generator"
 require_relative "bindery/generators/book_generator"
+require_relative "bindery/generators/chapter_generator"
+require_relative "bindery/generators/volume_generator"
 require_relative "bindery/cli"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bindery-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Billow Wang
@@ -10,9 +10,9 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: |
-  bindery 是手架工具：
-  `bindery new` 创建整套项目结构，
-  `bindery generate book` 为单本书生成骨架，
+  bindery 是脚手架工具：
+  `bindery init` 在当前目录初始化项目，
+  `bindery new book` 为单本书生成骨架（ID 自动生成），
   `bindery build` 调用 Pandoc 批量构建 EPUB。
   仅依赖 Ruby 标准库，不引入任何第三方 gem。
 executables:
@@ -27,9 +27,11 @@ files:
 - lib/bindery/book.rb
 - lib/bindery/builder.rb
 - lib/bindery/cli.rb
+- lib/bindery/cover.rb
 - lib/bindery/errors.rb
 - lib/bindery/generators/base.rb
 - lib/bindery/generators/book_generator.rb
+- lib/bindery/generators/chapter_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
@@ -38,14 +40,18 @@ files:
 - lib/bindery/generators/templates/project/gitignore
 - lib/bindery/generators/templates/project/style.css
 - lib/bindery/generators/templates/project/workflow.yml
+- lib/bindery/generators/volume_generator.rb
+- lib/bindery/image.rb
 - lib/bindery/index.rb
 - lib/bindery/project.rb
+- lib/bindery/server.rb
+- lib/bindery/validator.rb
 - lib/bindery/version.rb
-homepage: https://github.com/gamepunk/bindery-gem
+homepage: https://github.com/gamepunk/bindery-cli
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/gamepunk/bindery-gem
+  source_code_uri: https://github.com/gamepunk/bindery-cli
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: