notion_to_md 0.0.3 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e11590c90c4539c151d8c290f1175a76c331bcd4027832c055158ae11b3e396
-  data.tar.gz: 410e1b78ddb8f287b9b4a92b7e583910cccf6474d612b42c4a4933dad0d154b5
+  metadata.gz: ce6b39ba9cc39e1428bc8a654532d16b9ea99054e3fbd96cf30edd56cbed28a8
+  data.tar.gz: 6e38131568bb150a9ca7904f383fd8ade5721ccc5affe2949672b597b948ffe3
 SHA512:
-  metadata.gz: deeb77d21a3be57cb713b1c765b008b502d8c100bb103be99a88b50311c3895d3557f8c2909db1d8334616e223862fd6bf6e0b21c233237ab99698f7d008c466
-  data.tar.gz: 594bc21094683131274a3eb254ea9efad95a6d98839d219862bfd38b867aba43fb833ef3c9adb47dce55aa9a089ee16d806e049a356fedb1b5aee177746be8a1
+  metadata.gz: 3ccfa65a6877fd1bcdc9a36f72094cc8374934a2713abfc10441b23348b919818539c286469afad699f69594dc854a12f884299d2c335ff6cd9bc17d920bbcb6
+  data.tar.gz: fd638c9a53e8c6f6cf644e2e471fc7ecf8150bb1ef371d9f6f41215e4d1bd953d1929113c25dc703dd66647165adf84bbf9f7bddcb6494d8b0bcea5bd06f2741

data/README.md

@@ -40,7 +40,60 @@ md = notion_converter.convert
 
 And that's all. The `md` is a string variable containing the notion page formatted in markdown.
 
+
+### Front matter
+
+From version 0.2.0, notion_to_md supports front matter in markdown files.
+
+By default, the front matter section is not included to the document. To do so, provide the `:frontmatter` option set to `true` to `convert` method.
+
+```ruby
+NotionToMd::Converter.new(page_id: 'b91d5...').convert(frontmatter: tue)
+```
+
+Default notion properties are page `id`, `title`, `created_time`, `last_edited_time`, `icon`, `archived` and `cover`.
+
+```yml
+---
+id: e42383cd-4975-4897-b967-ce453760499f
+title: An amazing post
+cover: https://img.bank.sh/an_image.jpg
+created_time: 2022-01-23T12:31:00.000Z
+last_edited_time: 2022-01-23T12:31:00.000Z
+icon: 💥
+archived: false
+---
+```
+
+In addition to default properties, custom properties are also supported.
+Custom properties name is [parameterized](https://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-parameterize) and [underscorized](https://api.rubyonrails.org/classes/ActiveSupport/Inflector.html#method-i-underscore) before added to front matter.
+For example, two properties named `Multiple Options` and `Tags` will be transformed to `multiple_options` and `tags`, respectively.
+
+```yml
+---
+tags: tag1, tag2, tag3
+multiple_options: option1, option2
+---
+```
+
+The supported property types are:
+
+* `number`
+* `select`
+* `multi_select`
+* `date`
+* `people`
+* `files`
+* `checkbox`
+* `url`
+* `email`
+* `phone_number`
+
+`rich_text` as advanced types like `formula`, `relation` and `rollup` are not supported.
+
+Check notion documentation about [property values](https://developers.notion.com/reference/property-value-object#all-property-values) to know more.
+
 ## Test
 ```bash
-$ ruby -Ilib:test test/notion_to_md/converter_spec.rb
+rspec
 ```

data/lib/notion_to_md/block.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module NotionToMd
+  class Block
+    class << self
+      def paragraph(block)
+        convert_text(block)
+      end
+
+      def heading_1(block)
+        "# #{convert_text(block)}"
+      end
+
+      def heading_2(block)
+        "## #{convert_text(block)}"
+      end
+
+      def heading_3(block)
+        "### #{convert_text(block)}"
+      end
+
+      def callout(block)
+        icon = get_icon(block[:icon])
+        text = convert_text(block)
+        "#{icon} #{text}"
+      end
+
+      def quote(block)
+        "> #{convert_text(block)}"
+      end
+
+      def bulleted_list_item(block)
+        "- #{convert_text(block)}"
+      end
+
+      # TODO: numbered_list_item
+      def numbered_list_item(block)
+        Logger.info('numbered_list_item type not supported. Shown as bulleted_list_item.')
+        bulleted_list_item(block)
+      end
+
+      def to_do(block)
+        checked = block[:checked]
+        text = convert_text(block)
+
+        "- #{checked ? '[x]' : '[ ]'} #{text}"
+      end
+
+      def code(block)
+        language = block[:language]
+        text = convert_text(block)
+
+        "```#{language}\n\t#{text}\n```"
+      end
+
+      def embed(block)
+        url = block[:url]
+
+        "[#{url}](#{url})"
+      end
+
+      def image(block)
+        type = block[:type].to_sym
+        url = block.dig(type, :url)
+        caption = convert_caption(block)
+
+        "![](#{url})\n\n#{caption}"
+      end
+
+      def bookmark(block)
+        url = block[:url]
+        "[#{url}](#{url})"
+      end
+
+      def divider(_block)
+        '---'
+      end
+
+      def blank
+        '<br />'
+      end
+
+      def convert_text(block)
+        block[:text].map do |text|
+          content = Text.send(text[:type], text)
+          enrich_text_content(text, content)
+        end.join
+      end
+
+      def convert_caption(block)
+        convert_text(text: block[:caption])
+      end
+
+      def get_icon(block)
+        type = block[:type].to_sym
+        block[type]
+      end
+
+      def enrich_text_content(text, content)
+        enriched_content = add_link(text, content)
+        add_annotations(text, enriched_content)
+      end
+
+      def add_link(text, content)
+        href = text[:href]
+        return content if href.nil?
+
+        "[#{content}](#{href})"
+      end
+
+      def add_annotations(text, content)
+        annotations = text[:annotations].select { |_key, value| !!value }
+        annotations.keys.inject(content) do |enriched_content, annotation|
+          TextAnnotation.send(annotation.to_sym, enriched_content)
+        end
+      end
+    end
+  end
+end

data/lib/notion_to_md/converter.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require 'notion'
-require_relative './logger'
-require_relative './text_annotation'
-
 module NotionToMd
   class Converter
     attr_reader :page_id
@@ -13,14 +9,23 @@ module NotionToMd
       @page_id = page_id
     end
 
-    def convert
+    def convert(frontmatter: false)
+      <<~MD
+        #{parse_frontmatter if frontmatter}
+        #{parse_content}
+      MD
+    end
+
+    private
+
+    def parse_content
       md = page_blocks[:results].map do |block|
-        next blank if block[:type] == 'paragraph' && block.dig(:paragraph, :text).empty?
+        next Block.blank if block[:type] == 'paragraph' && block.dig(:paragraph, :text).empty?
 
         block_type = block[:type].to_sym
 
         begin
-          send(block_type, block[block_type])
+          Block.send(block_type, block[block_type])
         rescue StandardError
           Logger.info("Unsupported block type: #{block_type}")
           next nil
@@ -30,127 +35,24 @@ module NotionToMd
       md.compact.join("\n\n")
     end
 
-    private
-
-    def page_blocks
-      @page_blocks ||= @notion.block_children(id: page_id)
-    end
-
-    def paragraph(block)
-      convert_text(block)
-    end
-
-    def heading_1(block)
-      "# #{convert_text(block)}"
-    end
-
-    def heading_2(block)
-      "## #{convert_text(block)}"
+    def parse_frontmatter
+      notion_page = Page.new(page: page)
+      frontmatter = notion_page.props.to_a.map do |k, v|
+        "#{k}: #{v}"
+      end.join("\n")
+      <<~CONTENT
+        ---
+        #{frontmatter}
+        ---
+      CONTENT
     end
 
-    def heading_3(block)
-      "### #{convert_text(block)}"
-    end
-
-    def callout(block)
-      icon = get_icon(block[:icon])
-      text = convert_text(block)
-      "#{icon} #{text}"
-    end
-
-    def quote(block)
-      "> #{convert_text(block)}"
-    end
-
-    def bulleted_list_item(block)
-      "- #{convert_text(block)}"
-    end
-
-    # TODO: numbered_list_item
-    def numbered_list_item(block)
-      Logger.info('numbered_list_item type not supported. Shown as bulleted_list_item.')
-      bulleted_list_item(block)
-    end
-
-    def to_do(block)
-      checked = block[:checked]
-      text = convert_text(block)
-
-      "- #{checked ? '[x]' : '[ ]'} #{text}"
-    end
-
-    def code(block)
-      language = block[:language]
-      text = convert_text(block)
-
-      "```#{language}\n\t#{text}\n```"
+    def page
+      @page ||= @notion.page(id: page_id)
     end
 
-    def embed(block)
-      url = block[:url]
-
-      "[#{url}](#{url})"
-    end
-
-    def image(block)
-      type = block[:type].to_sym
-      url = block.dig(type, :url)
-      caption = convert_caption(block)
-
-      "![](#{url})\n\n#{caption}"
-    end
-
-    def bookmark(block)
-      url = block[:url]
-      "[#{url}](#{url})"
-    end
-
-    def divider(_block)
-      '---'
-    end
-
-    def equation(block)
-      equ = convert_text(block)
-      "$$ #{equ} $$"
-    end
-
-    def blank
-      '<br />'
-    end
-
-    def convert_text(block)
-      block[:text].map do |text|
-        content = text[:plain_text]
-        enrich_text_content(text, content)
-      end.join
-    end
-
-    def convert_caption(block)
-      convert_text(text: block[:caption])
-    end
-
-    def get_icon(block)
-      type = block[:type].to_sym
-      block[type]
-    end
-
-    def enrich_text_content(text, content)
-      enriched_content = add_link(text, content)
-      add_annotations(text, enriched_content)
-    end
-
-    def add_link(text, content)
-      href = text[:href]
-      return content if href.nil?
-
-      "[#{content}](#{href})"
-    end
-
-    def add_annotations(text, content)
-      annotations = text[:annotations].select { |_key, value| !!value }
-      annotations.keys.inject(content) do |enriched_content, annotation|
-        TextAnnotation.send(annotation.to_sym, enriched_content)
-      end
+    def page_blocks
+      @page_blocks ||= @notion.block_children(id: page_id)
     end
   end
 end

data/lib/notion_to_md/logger.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'logger'
-
 module NotionToMd
   class Logger
     @logger = ::Logger.new($stdout)

data/lib/notion_to_md/page.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module NotionToMd
+  class Page
+    attr_reader :page
+
+    def initialize(page:)
+      @page = page
+    end
+
+    def title
+      page.dig(:properties, :Name, :title).inject('') do |acc, slug|
+        acc + slug[:plain_text]
+      end
+    end
+
+    def cover
+      page.dig(:cover, :external, :url)
+    end
+
+    def icon
+      page.dig(:icon, :emoji)
+    end
+
+    def id
+      page[:id]
+    end
+
+    def created_time
+      DateTime.parse(page['created_time'])
+    end
+
+    def last_edited_time
+      DateTime.parse(page['last_edited_time'])
+    end
+
+    def url
+      page[:url]
+    end
+
+    def archived
+      page[:archived]
+    end
+
+    def props
+      @props ||= custom_props.deep_merge(default_props)
+    end
+
+    def custom_props
+      @custom_props ||= page.properties.each_with_object({}) do |prop, memo|
+        name = prop.first
+        value = prop.last # Notion::Messages::Message
+        type = value.type
+
+        next memo unless CustomProperty.respond_to?(type.to_sym)
+
+        memo[name.parameterize.underscore] = CustomProperty.send(type, value)
+      end.reject { |_k, v| v.presence.nil? }
+    end
+
+    def default_props
+      @default_props ||= {
+        'id' => id,
+        'title' => title,
+        'created_time' => created_time,
+        'cover' => cover,
+        'icon' => icon,
+        'last_edited_time' => last_edited_time,
+        'archived' => archived
+      }
+    end
+
+    class CustomProperty
+      class << self
+        def multi_select(prop)
+          prop.multi_select.map(&:name)
+        end
+
+        def select(prop)
+          prop['select'].name
+        end
+
+        def people(prop)
+          prop.people.map(&:name)
+        end
+
+        def files(prop)
+          prop.files.map { |f| f.file.url }
+        end
+
+        def phone_number(prop)
+          prop.phone_number
+        end
+
+        def number(prop)
+          prop.number
+        end
+
+        def email(prop)
+          prop.email
+        end
+
+        def checkbox(prop)
+          prop.checkbox.to_s
+        end
+
+        # date type properties not supported:
+        # - end
+        # - time_zone
+        def date(prop)
+          prop.date.start
+        end
+
+        def url(prop)
+          prop.url
+        end
+      end
+    end
+  end
+end

data/lib/notion_to_md/text.rb

@@ -0,0 +1,13 @@
+module NotionToMd
+  class Text
+    class << self
+      def text(text)
+        text[:plain_text]
+      end
+
+      def equation(text)
+        "$$ #{text[:plain_text]} $$"
+      end
+    end
+  end
+end

data/lib/notion_to_md/text_annotation.rb

@@ -18,12 +18,12 @@ module NotionToMd
         "**#{text}**"
       end
 
-      def striketrough(text)
+      def strikethrough(text)
         "~~#{text}~~"
       end
 
       def underline(text)
-        text
+        "<u>#{text}</u>"
       end
 
       def code(text)

data/lib/notion_to_md/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module NotionToMd
-  VERSION = '0.0.3'
+  VERSION = '0.2.1'
 end

data/lib/notion_to_md.rb

@@ -1,4 +1,13 @@
 # frozen_string_literal: true
 
+require 'notion'
+require 'logger'
+require 'active_support/inflector'
+require 'active_support/core_ext/object/blank'
 require_relative './notion_to_md/version'
 require_relative './notion_to_md/converter'
+require_relative './notion_to_md/logger'
+require_relative './notion_to_md/page'
+require_relative './notion_to_md/block'
+require_relative './notion_to_md/text'
+require_relative './notion_to_md/text_annotation'

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: notion_to_md
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.2.1
 platform: ruby
 authors:
 - Enrique Arias
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-12-31 00:00:00.000000000 Z
+date: 2022-02-26 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
 - !ruby/object:Gem::Dependency
   name: notion-ruby-client
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +52,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -60,8 +88,11 @@ extra_rdoc_files: []
 files:
 - README.md
 - lib/notion_to_md.rb
+- lib/notion_to_md/block.rb
 - lib/notion_to_md/converter.rb
 - lib/notion_to_md/logger.rb
+- lib/notion_to_md/page.rb
+- lib/notion_to_md/text.rb
 - lib/notion_to_md/text_annotation.rb
 - lib/notion_to_md/version.rb
 homepage: https://github.com/emoriarty/notion_to_md