jekyll-import 0.21.0 → 0.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0098ade7230382d4787c65ab3c17607680119727e1e9cdca587274d94e3e084
-  data.tar.gz: 8f1050dfa7170aa7b08462c0132ab959ffdcda31e8c469929ce123aecb64909a
+  metadata.gz: 6fcccee7603179ae5818e0ba75bb5ad0f0abafdedd2f9f214347d02634683ed1
+  data.tar.gz: 8a1852ed040f027a25cc97c318445b6782aa1134917dc4823f72e073c86fdbcc
 SHA512:
-  metadata.gz: f32b5ac48f88293a4703c7ece13d4a9886c598b4491fa9e8b750b02f4dfab405291c095355885f823a9b23551bc69e73015487371daa9fb6a9db7ec4783b88f0
-  data.tar.gz: 0ba737a7d8ff767eb1bcce6bffa8af357d6c66793b36e682edfcce05245e21dd0a12d5a3d250118ae9b00dc40857db50884d2365e2419a86efce7d97e0ac52af
+  metadata.gz: c52bfbe4d79d920dadcceccc0cfae985c85219befd093cda8d63f6e8604e99da9823604413814d286061c7a5b14da74b17f92ed27211e4e4cd51c15385e5fdcd
+  data.tar.gz: 3c5f1a75535b1e3ffdb274641ab17724e8b5587a1e266a02dd9b3a334954fe45e2dd8f99a69712e942ac86a9f987fa73a481248a3cba907ad42dc55ef0a8fecd

data/.rubocop.yml

@@ -0,0 +1,17 @@
+inherit_from: .rubocop_todo.yml
+
+require: rubocop-jekyll
+inherit_gem:
+  rubocop-jekyll: .rubocop.yml
+
+AllCops:
+  TargetRubyVersion: 2.4
+  Exclude:
+    - docs/**/*
+    - script/**/*
+    - test/**/*
+    - vendor/**/*
+    - Rakefile
+Style/MutableConstant:
+  Exclude:
+    - lib/jekyll-import/importers/typo.rb

data/README.markdown

@@ -1,6 +1,7 @@
 # jekyll-import
 
-[![Build Status](https://travis-ci.org/jekyll/jekyll-import.svg?branch=master)](https://travis-ci.org/jekyll/jekyll-import)
+[![Gem Version](https://img.shields.io/gem/v/jekyll-import.svg)](https://rubygems.org/gems/jekyll-import)
+[![Continuous Integration](https://github.com/jekyll/jekyll-import/actions/workflows/ci.yml/badge.svg)](https://github.com/jekyll/jekyll-import/actions/workflows/ci.yml)
 
 The new __Jekyll__ command for importing from various blogs to Jekyll format.
 
@@ -11,7 +12,7 @@ The new __Jekyll__ command for importing from various blogs to Jekyll format.
 ### Jekyll v2.x and higher
 
 1. Install the _rubygem_ with `gem install jekyll-import`.
-2. Run `jekyll import IMPORTER [options]`
+2. Run `jekyll-import IMPORTER [options]`
 
 ### Jekyll v1.x
 

data/exe/jekyll-import

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+STDOUT.sync = true
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+
+require 'jekyll-import'
+require 'jekyll/commands/import'
+require 'mercenary'
+
+Mercenary.program(:jekyll_import) do |p|
+  p.version JekyllImport::VERSION
+  p.description "Import from various blogs to Jekyll format."
+  p.syntax "jekyll-import <blog_engine> [options]"
+
+  # Create all the subcommands for the importers.
+  JekyllImport.add_importer_commands(p)
+
+  p.action do |args, _|
+    if args.empty?
+      Jekyll.logger.error "An importer subcommand is required."
+      puts p
+      abort
+    else
+      subcommand = args.first
+      unless p.has_command? subcommand
+        Jekyll.logger.abort_with "fatal: 'jekyll-import #{args.first}'" \
+          " could not be found."
+      end
+    end
+  end
+end

data/lib/jekyll/commands/import.rb

@@ -39,7 +39,7 @@ module Jekyll
               if args.empty?
                 Jekyll.logger.warn "You must specify an importer."
                 Jekyll.logger.info "Valid options are:"
-                importers.each { |i| Jekyll.logger.info "*", i.to_s }
+                importers.sort.each { |i| Jekyll.logger.info "*", i.to_s }
               end
             end
           end

data/lib/jekyll-import/importers/blogger.rb

@@ -5,9 +5,9 @@ module JekyllImport
     class Blogger < Importer
       def self.specify_options(c)
         c.option "source",                 "--source NAME",           "The XML file (blog-MM-DD-YYYY.xml) path to import"
-        c.option "no-blogger-info",        "--no-blogger-info",       "not to leave blogger-URL info (id and old URL) in the front matter (default: false)"
+        c.option "no-blogger-info",        "--no-blogger-info",       "not to leave blogger-URL info (id and old URL) in the front matter. (default: false)"
         c.option "replace-internal-link",  "--replace-internal-link", "replace internal links using the post_url liquid tag. (default: false)"
-        c.option "comments",               "--comments",              "import comments to _comments collection"
+        c.option "comments",               "--comments",              "import comments to _comments collection. (default: false)"
       end
 
       def self.validate(options)
@@ -194,7 +194,7 @@ module JekyllImport
 
                 FileUtils.mkdir_p(target_dir)
 
-                file_name = URI.decode("#{post_data[:filename]}.html")
+                file_name = URI::DEFAULT_PARSER.unescape("#{post_data[:filename]}.html")
                 File.open(File.join(target_dir, file_name), "w") do |f|
                   f.flock(File::LOCK_EX)
 

data/lib/jekyll-import/importers/csv.rb

@@ -12,8 +12,8 @@ module JekyllImport
       end
 
       def self.specify_options(c)
-        c.option "file",            "--file NAME",       'The CSV file to import (default: "posts.csv")'
-        c.option "no-front-matter", "--no-front-matter", "Do not add the default front matter to the post body"
+        c.option "file",            "--file NAME",       "The CSV file to import. (default: 'posts.csv')"
+        c.option "no-front-matter", "--no-front-matter", "Do not add the default front matter to the post body. (default: false)"
       end
 
       # Reads a csv with title, permalink, body, published_at, and filter.

data/lib/jekyll-import/importers/dotclear.rb

@@ -1,121 +1,180 @@
 # frozen_string_literal: true
 
-# Tested with dotClear 2.1.5
 module JekyllImport
   module Importers
     class Dotclear < Importer
-      def self.specify_options(c)
-        c.option "datafile", "--datafile PATH", "dotClear export file"
-        c.option "mediafolder", "--mediafolder PATH", "dotClear media export folder (media.zip inflated)"
-      end
+      class << self
+        def specify_options(c)
+          c.option "datafile",    "--datafile PATH",   "Dotclear export file."
+          c.option "mediafolder", "--mediafolder DIR", "Dotclear media export folder (unpacked media.zip)."
+        end
 
-      def self.require_deps
-        JekyllImport.require_with_fallback(%w(
-          rubygems
-          fileutils
-          safe_yaml
-          date
-          active_support
-          active_support/core_ext/string/inflections
-          csv
-          pp
-        ))
-      end
+        def require_deps
+          JekyllImport.require_with_fallback(%w())
+        end
 
-      def self.validate(opts)
-        abort "Specify a data file !" if opts["datafile"].nil? || opts["datafile"].empty?
-        abort "Specify a media folder !" if opts["mediafolder"].nil? || opts["mediafolder"].empty?
-      end
+        def validate(opts)
+          file_path = opts["datafile"]
+          log_undefined_flag_error("datafile") if file_path.nil? || file_path.empty?
 
-      def self.extract_headers_section(str)
-        str[1..-2].split(" ")[1].split(",")
-      end
-
-      def self.extract_data_section(str)
-        str.gsub(%r!^"!, "").gsub(%r!"$!, "").split('","')
-      end
+          file_path = File.expand_path(file_path)
+          if File.open(file_path, "rb", &:readline).start_with?("///DOTCLEAR|")
+            @data = read_export(file_path)
+            Jekyll.logger.info "Export File:", file_path
+          else
+            Jekyll.logger.abort_with "Import Error:", "#{file_path.inspect} is not a valid Dotclear export file!"
+          end
 
-      def self.process(opts)
-        options = {
-          :datafile    => opts.fetch("datafile", ""),
-          :mediafolder => opts.fetch("mediafolder", ""),
-        }
+          assets = @data["media"]
+          return if !assets || assets.empty?
 
-        FileUtils.mkdir_p("_posts")
-        FileUtils.mkdir_p("_drafts")
+          Jekyll.logger.info "", "Media files detected in export data."
 
-        type_data = ""
-        headers = {}
-        posts_and_drafts = {}
-        keywords = {}
+          media_dir = opts["mediafolder"]
+          log_undefined_flag_error("mediafolder") if media_dir.nil? || media_dir.empty?
 
-        File.readlines(options[:datafile]).each do |lineraw|
-          line = lineraw.strip.gsub(%r!\n$!, "")
+          media_dir = File.expand_path(media_dir)
+          log_invalid_media_dir_error(media_dir) if !File.directory?(media_dir) || Dir.empty?(media_dir)
+        end
 
-          next if line.empty?
+        def process(opts)
+          import_posts
+          import_assets(opts["mediafolder"])
+          Jekyll.logger.info "", "and, done!"
+        end
 
-          if line.start_with?("[") # post | media \ meta | comment...
-            type_data = line.split(" ").first[1..-1]
-            headers[type_data] = extract_headers_section(line)
-            next
+        private
+
+        # Parse backup sections into a Hash of arrays.
+        #
+        # Each section is of following shape:
+        #
+        #   [key alpha,beta,gamma,...]
+        #   lorem,ipsum,dolor,...
+        #   red,blue,green,...
+        #
+        # Returns Hash of shape:
+        #
+        #   {key => [{alpha => lorem,...}, {alpha => red,...}]}
+        #
+        def read_export(file)
+          ignored_sections = %w(category comment link setting)
+
+          File.read(file, :encoding => "utf-8").split("\n\n").each_with_object({}) do |section, data|
+            next unless %r!^\[(?<key>.*?) (?<header>.*)\]\n(?<rows>.*)!m =~ section
+            next if ignored_sections.include?(key)
+
+            headers = header.split(",")
+
+            data[key] = rows.each_line.with_object([]) do |line, bucket|
+              bucket << headers.zip(sanitize_line!(line)).to_h
+            end
+
+            data
           end
+        end
 
-          elts = extract_data_section(line)
-
-          if type_data == "post"
-            draft = (elts[headers[type_data].index("post_status")] != "1")
+        def register_post_tags
+          @data["meta"].each_with_object({}) do |entry, tags|
+            next unless entry["meta_type"] == "tag"
 
-            date_str = elts[headers[type_data].index("post_creadt")]
-            date_blank = (date_str.nil? || date_str.empty?)
-            date_str_formatted = date_blank ? Date.today : Date.parse(date_str).strftime("%Y-%m-%d")
-            title_param = elts[headers[type_data].index("post_title")].to_s.parameterize
+            post_id = entry["post_id"]
+            tags[post_id] ||= []
+            tags[post_id] << entry["meta_id"]
+          end
+        end
 
-            content = elts[headers[type_data].index("post_content_xhtml")].to_s
-            content = content.gsub('\"', '"').gsub('\n', "\n").gsub("/public/", "/assets/images/")
+        def log_undefined_flag_error(label)
+          Jekyll.logger.abort_with "Import Error:", "--#{label} flag cannot be undefined, null or empty!"
+        end
 
-            filepath = File.join(Dir.pwd, (draft ? "_drafts" : "_posts"), "#{date_str_formatted}-#{title_param}.html")
+        def log_invalid_media_dir_error(media_dir)
+          Jekyll.logger.error "Import Error:", "--mediafolder should be a non-empty directory."
+          Jekyll.logger.abort_with "", "Please check #{media_dir.inspect}."
+        end
 
-            entire_content_file = <<~POST_FILE
-              ---
-              layout: post
-              title: "#{elts[headers[type_data].index("post_title")]}"
-              date: #{elts[headers[type_data].index("post_creadt")]} +0100
-              tags: ABC
-              ---
+        def sanitize_line!(line)
+          line.strip!
+          line.split('","').tap do |items|
+            items[0].delete_prefix!('"')
+            items[-1].delete_suffix!('"')
+          end
+        end
 
-              #{content}
-            POST_FILE
+        # -
 
-            posts_and_drafts[elts[headers[type_data].index("post_id")]] = { :path => filepath, :content => entire_content_file }
-          elsif type_data == "media"
-            elts[headers[type_data].index("media_title")]
-            mediafilepath = elts[headers[type_data].index("media_file")]
+        REPLACE_MAP = {
+          '\"'                => '"',
+          '\r\n'              => "\n",
+          '\n'                => "\n",
+          "/dotclear/public/" => "/assets/dotclear/",
+          "/public/"          => "/assets/dotclear/",
+        }.freeze
 
-            src_path = File.join(options[:mediafolder], mediafilepath)
-            dst_path = File.join(Dir.pwd, "assets", "images", mediafilepath.to_s)
+        REPLACE_RE = Regexp.union(REPLACE_MAP.keys)
 
-            FileUtils.mkdir_p(File.dirname(dst_path))
-            FileUtils.cp(src_path, dst_path)
-          elsif type_data == "meta"
-            keywords[elts[headers[type_data].index("post_id")]] ||= []
-            keywords[elts[headers[type_data].index("post_id")]] << elts[headers[type_data].index("meta_id")]
-          elsif type_data == "link"
+        private_constant :REPLACE_MAP, :REPLACE_RE
 
-          elsif type_data == "setting"
+        # -
 
-          elsif type_data == "comment"
+        def adjust_post_contents!(content)
+          content.strip!
+          content.gsub!(REPLACE_RE, REPLACE_MAP)
+          content
+        end
 
+        def import_posts
+          tags = register_post_tags
+          posts = @data["post"]
+
+          FileUtils.mkdir_p("_drafts") unless posts.empty?
+          Jekyll.logger.info "Importing posts.."
+
+          posts.each do |post|
+            date, title = post.values_at("post_creadt", "post_title")
+            path = File.join("_drafts", Date.parse(date).strftime("%Y-%m-%d-") + Jekyll::Utils.slugify(title) + ".html")
+
+            excerpt = adjust_post_contents!(post["post_excerpt_xhtml"].to_s)
+            excerpt = nil if excerpt.empty?
+
+            # Unlike the paradigm in Jekyll-generated HTML, `post_content_xhtml` in the export data
+            # doesn't begin with `post_excerpt_xhtml`.
+            # Instead of checking whether the excerpt content exists elsewhere in the exported content
+            # string, always prepend excerpt onto content with an empty line in between.
+            content = [excerpt, post["post_content_xhtml"]].tap(&:compact!).join("\n\n")
+
+            front_matter_data = {
+              "layout"       => "post",
+              "title"        => title,
+              "date"         => date,
+              "lang"         => post["post_lang"],
+              "tags"         => tags[post["post_id"]],
+              "original_url" => post["post_url"], # URL as included in the export-file.
+              "excerpt"      => excerpt,
+            }.tap(&:compact!)
+
+            Jekyll.logger.info "Creating:", path
+            File.write(path, "#{YAML.dump(front_matter_data)}---\n\n#{adjust_post_contents!(content)}\n")
           end
         end
 
-        # POST-process : Change media path in posts and drafts
-        posts_and_drafts.each do |post_id, hsh|
-          keywords_str = keywords[post_id].to_a.join(", ")
-          content_file = hsh[:content]
-          content_file = content_file.gsub("tags: ABC", "tags: [#{keywords_str}]")
-
-          File.open(hsh[:path], "wb") do |f|
-            f.write(content_file)
+        def import_assets(src_dir)
+          assets = @data["media"]
+          FileUtils.mkdir_p("assets/dotclear") if assets && !assets.empty?
+          Jekyll.logger.info "Importing assets.."
+
+          assets.each do |asset|
+            file_path = File.join(src_dir, asset["media_file"])
+            if File.exist?(file_path)
+              dest_path = File.join("assets/dotclear", asset["media_file"])
+              FileUtils.mkdir_p(File.dirname(dest_path))
+
+              Jekyll.logger.info "Copying:", file_path
+              Jekyll.logger.info "To:", dest_path
+              FileUtils.cp_r file_path, dest_path
+            else
+              Jekyll.logger.info "Not found:", file_path
+            end
           end
         end
       end

data/lib/jekyll-import/importers/drupal_common.rb

@@ -16,16 +16,16 @@ module JekyllImport
         DEFAULTS = {
           "engine"   => "mysql",
           "password" => "",
-          "host"     => "localhost",
+          "host"     => "127.0.0.1",
           "prefix"   => "",
           "port"     => "3306",
           "types"    => %w(blog story article),
         }.freeze
 
         def specify_options(c)
-          c.option "engine",   "--engine [mysql|postgresql]", "Database engine (default: #{DEFAULTS["engine"].inspect})"
           c.option "dbname",   "--dbname DB",                 "Database name"
           c.option "user",     "--user USER",                 "Database user name"
+          c.option "engine",   "--engine [mysql|postgresql]", "Database engine (default: #{DEFAULTS["engine"].inspect})"
           c.option "password", "--password PW",               "Database user's password (default: #{DEFAULTS["password"].inspect})"
           c.option "host",     "--host HOST",                 "Database host name (default: #{DEFAULTS["host"].inspect})"
           c.option "port",     "--port PORT",                 "Database port name (default: #{DEFAULTS["port"].inspect})"
@@ -47,9 +47,9 @@ module JekyllImport
         end
 
         def process(options)
-          engine = options.fetch("engine", DEFAULTS["engine"])
           dbname = options.fetch("dbname")
           user   = options.fetch("user")
+          engine = options.fetch("engine",   DEFAULTS["engine"])
           pass   = options.fetch("password", DEFAULTS["password"])
           host   = options.fetch("host",     DEFAULTS["host"])
           port   = options.fetch("port",     DEFAULTS["port"])

data/lib/jekyll-import/importers/easyblog.rb

@@ -10,12 +10,12 @@ module JekyllImport
       end
 
       def self.specify_options(c)
-        c.option "dbname",   "--dbname",   "Database name"
-        c.option "user",     "--user",     "Database user name"
-        c.option "password", "--password", "Database user's password (default: '')"
-        c.option "host",     "--host",     "Database host name"
-        c.option "section",  "--section",  "Table prefix name"
-        c.option "prefix",   "--prefix",   "Table prefix name"
+        c.option "dbname",   "--dbname",   "Database name."
+        c.option "user",     "--user",     "Database user name."
+        c.option "password", "--password", "Database user's password. (default: '')"
+        c.option "host",     "--host",     "Database host name. (default: 'localhost')"
+        c.option "section",  "--section",  "Section ID. (default: '1')"
+        c.option "prefix",   "--prefix",   "Table prefix name. (default: 'jos_')"
       end
 
       def self.require_deps
@@ -32,7 +32,7 @@ module JekyllImport
         dbname  = options.fetch("dbname")
         user    = options.fetch("user")
         pass    = options.fetch("password", "")
-        host    = options.fetch("host", "localhost")
+        host    = options.fetch("host", "127.0.0.1")
         section = options.fetch("section", "1")
         table_prefix = options.fetch("prefix", "jos_")
 

data/lib/jekyll-import/importers/enki.rb

@@ -20,10 +20,10 @@ module JekyllImport
       end
 
       def self.specify_options(c)
-        c.option "dbname",   "--dbname",   "Database name"
-        c.option "user",     "--user",     "Database name"
-        c.option "password", "--password", 'Database name (default: "")'
-        c.option "host",     "--host",     "Database name"
+        c.option "dbname",   "--dbname",   "Database name."
+        c.option "user",     "--user",     "User name."
+        c.option "password", "--password", "Database password. (default: '')"
+        c.option "host",     "--host",     "Database host name. (default: 'localhost')"
       end
 
       def self.require_deps

data/lib/jekyll-import/importers/joomla.rb

@@ -10,13 +10,13 @@ module JekyllImport
       end
 
       def self.specify_options(c)
-        c.option "dbname",   "--dbname",   "Database name"
-        c.option "user",     "--user",     "Database user name"
-        c.option "password", "--password", "Database user's password (default: '')"
-        c.option "host",     "--host",     "Database host name"
-        c.option "port",     "--port",     "Database port"
-        c.option "section",  "--section",  "Table prefix name"
-        c.option "prefix",   "--prefix",   "Table prefix name"
+        c.option "dbname",   "--dbname",   "Database name."
+        c.option "user",     "--user",     "Database user name."
+        c.option "password", "--password", "Database user's password. (default: '')"
+        c.option "host",     "--host",     "Database host name. (default: 'localhost')"
+        c.option "port",     "--port",     "Database port. (default: '3306')"
+        c.option "section",  "--section",  "Section ID. (default: '1')"
+        c.option "prefix",   "--prefix",   "Table prefix name. (default: 'jos_')"
       end
 
       def self.require_deps
@@ -33,7 +33,7 @@ module JekyllImport
         dbname  = options.fetch("dbname")
         user    = options.fetch("user")
         pass    = options.fetch("password", "")
-        host    = options.fetch("host", "localhost")
+        host    = options.fetch("host", "127.0.0.1")
         port    = options.fetch("port", 3306).to_i
         section = options.fetch("section", "1")
         table_prefix = options.fetch("prefix", "jos_")

data/lib/jekyll-import/importers/joomla3.rb

@@ -10,13 +10,13 @@ module JekyllImport
       end
 
       def self.specify_options(c)
-        c.option "dbname",   "--dbname",   "Database name"
-        c.option "user",     "--user",     "Database user name"
-        c.option "password", "--password", "Database user's password (default: '')"
-        c.option "host",     "--host",     "Database host name"
-        c.option "port",     "--port",     "Database port"
-        c.option "category", "--category", "ID of the category"
-        c.option "prefix",   "--prefix",   "Table prefix name"
+        c.option "dbname",   "--dbname",   "Database name."
+        c.option "user",     "--user",     "Database user name."
+        c.option "password", "--password", "Database user's password. (default: '')"
+        c.option "host",     "--host",     "Database host name. (default: 'localhost')"
+        c.option "port",     "--port",     "Database port. (default: '3306')"
+        c.option "category", "--category", "ID of the category. (default: '0')"
+        c.option "prefix",   "--prefix",   "Table prefix name. (default: 'jos_')"
       end
 
       def self.require_deps
@@ -33,7 +33,7 @@ module JekyllImport
         dbname = options.fetch("dbname")
         user   = options.fetch("user")
         pass   = options.fetch("password", "")
-        host   = options.fetch("host", "localhost")
+        host   = options.fetch("host", "127.0.0.1")
         port   = options.fetch("port", 3306).to_i
         cid    = options.fetch("category", 0)
         table_prefix = options.fetch("prefix", "jos_")

data/lib/jekyll-import/importers/jrnl.rb

@@ -12,10 +12,10 @@ module JekyllImport
       end
 
       def self.specify_options(c)
-        c.option "file",        "--file FILENAME",      'Journal file (default: "~/journal.txt")'
-        c.option "time_format", "--time_format FORMAT", 'Time format of your journal (default: "%Y-%m-%d %H:%M")'
-        c.option "extension",   "--extension EXT",      'Output extension (default: "md")'
-        c.option "layout",      "--layout NAME",        'Output post layout (default: "post")'
+        c.option "file",        "--file FILENAME",      "Journal file. (default: '~/journal.txt')"
+        c.option "time_format", "--time_format FORMAT", "Time format of your journal. (default: '%Y-%m-%d %H:%M')"
+        c.option "extension",   "--extension EXT",      "Output extension. (default: 'md')"
+        c.option "layout",      "--layout NAME",        "Output post layout. (default: 'post')"
       end
 
       # Reads a jrnl file and creates a new post for each entry

data/lib/jekyll-import/importers/marley.rb

@@ -28,7 +28,7 @@ module JekyllImport
       end
 
       def self.specify_options(c)
-        c.option "marley_data_dir", "--marley_data_dir DIR", "The dir containing your marley data"
+        c.option "marley_data_dir", "--marley_data_dir DIR", "The dir containing your marley data."
       end
 
       def self.process(options)

data/lib/jekyll-import/importers/medium.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module JekyllImport
+  module Importers
+    class Medium < Importer
+      def self.specify_options(c)
+        c.option "username",       "--username NAME",  "Medium username"
+        c.option "canonical_link", "--canonical_link", "Copy original link as canonical_url to post (default: false)"
+        c.option "render_audio",   "--render_audio",   "Render <audio> element in posts for the enclosure URLs (default: false)"
+      end
+
+      def self.validate(options)
+        abort "Missing mandatory option --username." if options["username"].nil?
+      end
+
+      def self.require_deps
+        Importers::RSS.require_deps
+      end
+
+      # Medium posts and associated metadata are exported as an RSS Feed. Hence invoke our RSS Importer to create the
+      # Jekyll source directory.
+      #
+      # "Tags" attached to a Medium post are exported under the markup `<item><category>...</category></item>` in the
+      # export feed. Therefore, configure the RSS Importer to always look for tags in the `<category></category>` field
+      # of an RSS item.
+      def self.process(options)
+        Importers::RSS.process({
+          "source"         => "https://medium.com/feed/@#{options.fetch("username")}",
+          "render_audio"   => options.fetch("render_audio", false),
+          "canonical_link" => options.fetch("canonical_link", false),
+          "extract_tags"   => "category",
+        })
+      end
+    end
+  end
+end

data/lib/jekyll-import/importers/mephisto.rb

@@ -14,7 +14,7 @@ module JekyllImport
           COPY jekyll TO STDOUT WITH CSV HEADER;
           ROLLBACK;
         SQL
-        command = %(psql -h #{c[:host] || "localhost"} -c "#{sql.strip}" #{c[:database]} #{c[:username]} -o #{c[:filename] || "posts.csv"})
+        command = %(psql -h #{c[:host] || "127.0.0.1"} -c "#{sql.strip}" #{c[:database]} #{c[:username]} -o #{c[:filename] || "posts.csv"})
         Jekyll.logger.info "Executing:", command
         `#{command}`
         CSV.process
@@ -40,7 +40,7 @@ module JekyllImport
         c.option "dbname",   "--dbname DB",   "Database name"
         c.option "user",     "--user USER",   "Database user name"
         c.option "password", "--password PW", "Database user's password (default: '')"
-        c.option "host",     "--host HOST",   'Database host name (default: "localhost")'
+        c.option "host",     "--host HOST",   "Database host name (default: 'localhost')"
       end
 
       # This query will pull blog posts from all entries across all blogs. If
@@ -61,7 +61,7 @@ module JekyllImport
         dbname = options.fetch("dbname")
         user   = options.fetch("user")
         pass   = options.fetch("password", "")
-        host   = options.fetch("host", "localhost")
+        host   = options.fetch("host", "127.0.0.1")
 
         db = Sequel.mysql2(dbname, :user     => user,
                                    :password => pass,