notion_to_md 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77ebe548eec487347104eabbac6911836cef0ec6e5ea350cb9a376ef8e07ce50
-  data.tar.gz: b2fd0700b53683daa6e59a729418139bbdee41da8184dad57eff0f2c17578dc7
+  metadata.gz: d326983d99843871779f5331bab84d734bc01c21aa90b4da0cc76f1dd092c95e
+  data.tar.gz: 4b6a34aebbe07df627d956e9918606385e5d3952c56522ee66f3e331f8522d24
 SHA512:
-  metadata.gz: e7f09feec62553d76c72e670aa4fa05d02e98f19e74352237c8c42a255960570f77ae530b3196be24a054fa8a55f744f0b0b96dfbfb1c5e7d06f71b1423bcdf6
-  data.tar.gz: '09a041dab71e1fea3796ca9193c6a5fdf385de1d7fc212373f2e7cec086568935c72171ba900c90001907fdd4e1667e819b69c28740c2e5fa18a4b17821facb3'
+  metadata.gz: 5e4990d98adf9eaff1dafc48285430b788de0bf4088b95ecd5f6c970fc850e015e9f148c79f0603647902b96b26465b01f88e9d86133472cc154a581c6f2e907
+  data.tar.gz: bb63c2a623265a153e7300ca9389bf1e75773373f8221eed41e4b7a11b33f801c26d8d033f3038ac93ead0586257e7874773c9a490de436a30ea79c4e5d5ca08

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/converter.rb

@@ -9,7 +9,16 @@ 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 Block.blank if block[:type] == 'paragraph' && block.dig(:paragraph, :text).empty?
 
@@ -26,7 +35,19 @@ module NotionToMd
       md.compact.join("\n\n")
     end
 
-    private
+    def parse_frontmatter
+      notion_page = Page.new(page: page)
+      frontmatter = notion_page.props.to_a.map { |k, v| "#{k}: #{v}" }.join("\n")
+      <<~CONTENT
+        ---
+        #{frontmatter}
+        ---
+      CONTENT
+    end
+
+    def page
+      @page ||= @notion.page(id: page_id)
+    end
 
     def page_blocks
       @page_blocks ||= @notion.block_children(id: page_id)

data/lib/notion_to_md/page.rb

@@ -0,0 +1,123 @@
+# 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)
+          multi_select = prop.multi_select.map(&:name).join(', ')
+          "[#{multi_select}]"
+        end
+
+        def select(prop)
+          prop['select'].name
+        end
+
+        def people(prop)
+          people = prop.people.map(&:name).join(', ')
+          "[#{people}]"
+        end
+
+        def files(prop)
+          files = prop.files.map { |f| "\"#{f.file.url}\"" }.join(', ')
+          "[#{files}]"
+        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/version.rb

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

data/lib/notion_to_md.rb

@@ -2,9 +2,12 @@
 
 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.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Enrique Arias
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-02-13 00:00:00.000000000 Z
+date: 2022-02-15 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
@@ -77,6 +91,7 @@ files:
 - 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