neruda 0.2.4 → 0.2.6

data/lib/neruda/org_file.rb

@@ -1,299 +0,0 @@
-# frozen_string_literal: true
-
-require 'time'
-require 'fileutils'
-# neruda/config is required by htmlizer
-require 'neruda/org_file/htmlizer'
-require 'neruda/org_file/extracter'
-require 'neruda/org_file/class_methods'
-require 'neruda/index'
-require 'neruda/version'
-
-module Neruda
-  # Handles org files.
-  #
-  # This class is responsible for reading or writing existing or new org
-  # files, and formating their content to be used on the generated
-  # website.
-  class OrgFile
-    # @return [String] the title of the current org document, taken from
-    #   the ~#+title:~ header.
-    attr_reader :title
-
-    # @return [String] the subtitle of the current org document, taken
-    #   from the ~#+subtitle:~ header.
-    attr_reader :subtitle
-
-    # @return [DateTime] the date and time of the current org document,
-    #   taken from the ~#+date:~ header.
-    attr_reader :date
-
-    # @return [Boolean] wether a time has been extracted from the
-    #   current org document ~#+date:~ header.
-    attr_reader :notime
-
-    # The author of the current org document, taken from the ~#+author:~
-    #   header.
-    #
-    # If the current document doesn't have any authorship information,
-    # the one from the ~config.yml~ file will be used instead
-    #
-    # @return [String] the author name
-    attr_reader :author
-
-    # @return [Array] the keywords list of the current org document,
-    #   taken from the ~#+keywords:~ header.
-    attr_reader :keywords
-
-    # @return [String] the description of this org document, taken from
-    #   the ~#+description:~ header.
-    attr_reader :excerpt
-
-    # The locale of the current org document, taken from the
-    #   ~#+language:~ header.
-    #
-    # If the current document doesn't have any language information, the
-    # one from the ~config.yml~ file will be used instead, or "en" by
-    # default.
-    #
-    # @return [String] the document lang
-    attr_reader :lang
-
-    # @return [String] the relative path to the source of this document.
-    attr_reader :file
-
-    # @return [String] the relative path to the generated html file of
-    #   this document.
-    attr_reader :html_file
-
-    # @return [String] the url of this document, build from the ~domain~
-    #   settings and the above {#html_file @html_file} attribute.
-    attr_reader :url
-
-    # @return [String] the project owning this document.
-    attr_reader :project
-
-    extend Neruda::OrgFileClassMethods
-
-    include Neruda::OrgFileExtracter
-    include Neruda::OrgFileHtmlizer
-
-    # Prepares the file named by ~file_name~ for read and write
-    #   operations.
-    #
-    # If the file ~file_name~ does not exist, the new instance may be
-    # populated by data given in the ~opts~ parameter.
-    #
-    # @example
-    #     File.exist? './test.org'
-    #     => true
-    #     o = Neruda::OrgFile.new('./test.org')
-    #     => #<Neruda::OrgFile @file='./test.org'...>
-    #     o.title
-    #     => "This is an existing test file"
-    #     File.exist? '/tmp/does_not_exist.org'
-    #     => false
-    #     o = Neruda::OrgFile.new('/tmp/does_not_exist.org')
-    #     => #<Neruda::OrgFile @file='/tmp/does_not_exist.org'...>
-    #     o.title
-    #     => ""
-    #     File.exist? '/tmp/other.org'
-    #     => false
-    #     o = Neruda::OrgFile.new('/tmp/other.org', title: 'New file')
-    #     => #<Neruda::OrgFile @file='/tmp/other.org'...>
-    #     o.title
-    #     => "New file"
-    #
-    # @param file_name [String] path to the corresponding Org file
-    # @param opts [Hash] optional data to initialize new Org file
-    # @option opts [String] title ('') the title of the new Org file
-    # @option opts [String] author (system user or '') the author of the
-    #   document
-    # @option opts [Boolean] verbose (false) if the
-    #   {Neruda::OrgFileHtmlizer#publish publish} method should output
-    #   emacs process messages
-    # @option opts [String] project the project owning this file
-    #   must be stored
-    # @return [Neruda::OrgFile] the new instance of Neruda::OrgFile
-    def initialize(file_name, opts = {})
-      file_name = nil if file_name == ''
-      @file = file_name
-      @html_file = nil
-      @url = nil
-      @project = opts.delete :project
-      @options = opts
-      build_html_file_and_url
-      if @file && File.exist?(@file)
-        extract_data
-      else
-        init_empty_file
-      end
-    end
-
-    # Returns a String representation of the document date, which aims
-    #   to be used to sort several OrgFiles.
-    #
-    # The format used for the key is ~%Y%m%d%H%M%S~. If the current
-    # OrgFile instance does not have a date, this mehod return
-    # ~00000000000000~. If the current OrgFile instance does not have
-    # time information, the date is padded with zeros.
-    #
-    # @example with the org header ~#+date: <2019-07-03 Wed 20:52:49>~
-    #     org_file.date
-    #     => #<DateTime: 2019-07-03T20:52:49+02:00...>
-    #     org_file.timekey
-    #     => "20190703205349"
-    #
-    # @example with the org header ~#+date: <2019-07-03 Wed>~
-    #     org_file.date
-    #     => #<DateTime: 2019-07-03T00:00:00+02:00...>
-    #     org_file.timekey
-    #     => "20190703000000"
-    #
-    # @example with no date header in the org file
-    #     org_file.date
-    #     => nil
-    #     org_file.timekey
-    #     => "00000000000000"
-    #
-    # @return [String] the document key
-    def timekey
-      return '00000000000000' if @date.nil?
-      @date.strftime('%Y%m%d%H%M%S')
-    end
-
-    # Returns the current OrgFile instance DateTime as a String.
-    #
-    # This method accepts three values for the ~dateformat~ parameter:
-    #
-    # - ~:full~ (or ~:long~) :: outputs a complete date and time
-    #   representation, localized through R18n;
-    # - ~:short~ :: outputs a short date representation (without time),
-    #   localized with R18n;
-    # - ~:rfc3339~ :: outputs the RFC 3339 date and time representation,
-    #   used in atom feed.
-    #
-    # @param dateformat [Symbol] the format to use to convert DateTime
-    #   into String
-    # @param year [Boolean] wether or not the ~:full~ format must
-    #   contain the year
-    # @return [String] the document DateTime string representation
-    def datestring(dateformat = :full, year: true)
-      return '' if @date.nil?
-      return R18n.l @date.to_date if dateformat == :short
-      return @date.rfc3339 if dateformat == :rfc3339
-      locale = R18n.get.locale
-      long_fmt = R18n.t.neruda.index.full_date_format(
-        date: locale.format_date_full(@date, year)
-      )
-      unless @notime
-        long_fmt = R18n.t.neruda.index.full_date_with_time_format(
-          date: long_fmt, time: locale.time_format.delete('_').strip
-        )
-      end
-      locale.strftime(@date, long_fmt)
-    end
-
-    # Formats given ~string~ with values of the current OrgFile.
-    #
-    # This method expects to find percent-tags in the given ~string~ and
-    # replace them by their corresponding value.
-    #
-    # *** Format:
-    #
-    # - %a :: the raw author name
-    # - %A :: the HTML rendering of the author name, equivalent to
-    #         ~<span class="author">%a</span>~
-    # - %d :: the ~:short~ date HTML representation, equivalent
-    #         to ~<time datetime="%I">%i</time>~
-    # - %D :: the ~:full~ date and time HTML representation
-    # - %i :: the raw ~:short~ date and time
-    # - %I :: the raw ~:rfc3339~ date and time
-    # - %k :: the keywords separated by a comma
-    # - %K :: the HTML list rendering of the keywords
-    # - %l :: the lang of the document
-    # - %L :: the license information, taken from the
-    #         {Neruda::Config#settings}
-    # - %n :: the Neruda name and version
-    # - %N :: the Neruda name and version with a link to the project
-    #         home on the name
-    # - %s :: the subtitle of the document
-    # - %t :: the title of the document
-    # - %u :: the web path to the related published HTML document
-    # - %x :: the raw description (eXcerpt)
-    # - %X :: the description, enclosed in an HTML ~p~ tag, equivalent
-    #         to ~<p>%x</p>~
-    #
-    # @example
-    #     org_file.format("Article written by %a the %d")
-    #     => "Article written by Alice Smith the Wednesday 3rd July"
-    #
-    # @return [String] the given ~string~ after replacement occurs
-    # rubocop:disable Metrics/MethodLength
-    # rubocop:disable Layout/LineLength
-    def format(string)
-      string.gsub('%a', @author)
-            .gsub('%A', author_to_html)
-            .gsub('%d', date_to_html(:short))
-            .gsub('%D', date_to_html)
-            .gsub('%i', datestring(:short))
-            .gsub('%I', datestring(:rfc3339))
-            .gsub('%k', @keywords.join(', '))
-            .gsub('%K', keywords_to_html)
-            .gsub('%l', @lang)
-            .gsub('%L', (Neruda::Config.settings['license'] || '').gsub(/\s+/, ' ').strip)
-            .gsub('%n', "Neruda #{Neruda::VERSION}")
-            .gsub('%N', "<a href=\"https://git.umaneti.net/neruda/about/\">Neruda</a> #{Neruda::VERSION}")
-            .gsub('%s', @subtitle)
-            .gsub('%t', @title)
-            .gsub('%u', @html_file || '')
-            .gsub('%x', @excerpt)
-            .gsub('%X', "<p>#{@excerpt}</p>")
-    end
-    # rubocop:enable Layout/LineLength
-    # rubocop:enable Metrics/MethodLength
-
-    # Writes the current OrgFile content to the underlying file.
-    #
-    # The intermediate parent folders are created if necessary.
-    #
-    # @return [Integer] the length written (as returned by the
-    #   underlying ~IO.write~ method call)
-    def write
-      raise TypeError, 'no conversion from nil file name to path.' if @file.nil?
-      file_dir = File.dirname @file
-      FileUtils.mkdir_p file_dir unless Dir.exist? file_dir
-      IO.write @file, @content
-    end
-
-    private
-
-    def build_html_file_and_url
-      return if @file.nil?
-      @html_file = Neruda::OrgFile.target_for_source(
-        @file, @project, with_public_folder: false
-      )
-      @url = "#{Neruda::Config.settings['domain']}/#{@html_file}"
-    end
-
-    def init_empty_file
-      @title = @options[:title] || ''
-      @subtitle = ''
-      @date = DateTime.now
-      @notime = false
-      @author = @options[:author] || Neruda::Config.settings['author']
-      @keywords = []
-      @lang = @options[:lang] || Neruda::Config.settings['lang']
-      @excerpt = ''
-      body = @options[:content] || ''
-      @content = @options[:raw_content] || <<~ORG
-        #+title: #{@title}
-        #+date: <#{@date.strftime('%Y-%m-%d %a. %H:%M:%S')}>
-        #+author: #{@author}
-        #+language: #{@lang}
-
-        #{body}
-      ORG
-    end
-  end
-end

data/lib/neruda/preview.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-require 'webrick'
-require 'neruda/config'
-
-module Neruda # rubocop:disable Style/Documentation
-  # A tiny preview server, which main goal is to replace references to
-  # the target domain by localhost.
-  class PreviewServlet < WEBrick::HTTPServlet::AbstractServlet
-    include WEBrick::HTTPUtils
-
-    def do_GET(request, response) # rubocop:disable Naming/MethodName
-      file = local_path(request.path)
-      response.body = parse_body(file, "http://#{request.host}:#{request.port}")
-      response.status = 200
-      response.content_type = mime_type(file, DefaultMimeTypes)
-    end
-
-    private
-
-    def local_path(requested_path)
-      routes = Neruda::Config.settings.dig('preview', 'routes') || {}
-      return routes[requested_path] if routes.has_key? requested_path
-      local_path = Neruda::Config.settings['public_folder'] + requested_path
-      if File.directory? local_path
-        local_path = format(
-          '%<path>s/index.html', path: local_path.delete_suffix('/')
-        )
-      end
-      return local_path if File.exist? local_path
-      raise WEBrick::HTTPStatus::NotFound, 'Not found.'
-    end
-
-    def parse_body(local_path, local_host)
-      body = IO.read local_path
-      return body unless local_path.match?(/\.(?:ht|x)ml\z/)
-      domain = Neruda::Config.settings['domain']
-      return body if domain == ''
-      body.gsub(/"file:\/\//, format('"%<host>s', host: local_host))
-          .gsub(/"#{domain}/, format('"%<host>s', host: local_host))
-    end
-  end
-
-  class << self
-    def start_preview
-      # Inspired by ruby un.rb library, which allows normally to start a
-      # webrick server in one line: ruby -run -e httpd public_html -p 5000
-      port = Neruda::Config.settings.dig('preview', 'server_port') || 5000
-      s = WEBrick::HTTPServer.new(Port: port)
-      s.mount '/', Neruda::PreviewServlet
-      ['TERM', 'QUIT', 'INT'].each { |sig| trap(sig, proc { s.shutdown }) }
-      s.start
-    end
-  end
-end

data/lib/neruda/templater.rb

@@ -1,118 +0,0 @@
-# frozen_string_literal: true
-
-require 'nokogiri'
-require 'digest/md5'
-require 'neruda/org_file'
-
-module Neruda
-  # Insert custom part inside generated HTML files.
-  class Templater
-    def initialize(source, dom, opts = {})
-      @dom = dom
-      @org_file = source
-      @position = opts['type'] || 'after'
-      @content = extract_content opts
-      @element = @dom.css(opts['selector'])
-      digest = Digest::MD5.hexdigest(@content)
-      @check_line = " Neruda Template: #{digest} "
-    end
-
-    def apply
-      flag_head
-      content = @org_file.format(@content)
-      @element.each do |e|
-        insert_new_node_at e, content
-      end
-    end
-
-    def in_head?
-      @dom.xpath('//head').children.to_a.filter(&:comment?).each do |c|
-        return true if c.text == @check_line
-      end
-      false
-    end
-
-    class << self
-      def customize_output(file_name, source = nil)
-        templates_to_apply = filter_templates(file_name)
-        return if templates_to_apply.empty?
-        if source.nil?
-          sourcepath = Neruda::OrgFile.source_for_target(file_name)
-          source = Neruda::OrgFile.new(sourcepath)
-        end
-        dom = open_dom(file_name)
-        templates_to_apply.each do |t|
-          tpl = Neruda::Templater.new(source, dom, t)
-          next if tpl.in_head?
-          tpl.apply
-        end
-        write_dom(file_name, dom)
-      end
-
-      private
-
-      def filter_templates(file_name)
-        templates = Neruda::Config.settings['templates']
-        return [] if templates.nil? || templates.empty?
-        templates.filter { |t| check_required_keys(t, file_name) }
-      end
-
-      def open_dom(file_name)
-        file = File.new file_name, 'r'
-        dom = Nokogiri::HTML file
-        file.close
-        dom
-      end
-
-      def write_dom(file_name, dom)
-        file = File.new file_name, 'w'
-        dom.write_to file
-        file.close
-      end
-
-      def check_path(file_name, pathes)
-        pub_folder = Neruda::Config.settings['public_folder']
-        if pathes.is_a?(Array)
-          pathes.each do |tp|
-            return true if File.fnmatch?("#{pub_folder}#{tp}",
-                                         file_name, File::FNM_DOTMATCH)
-          end
-          return false
-        end
-        File.fnmatch?("#{pub_folder}#{pathes}",
-                      file_name, File::FNM_DOTMATCH)
-      end
-
-      def check_required_keys(opts, file_name)
-        return false unless opts.has_key?('selector')
-        return false unless opts.has_key?('content') || opts.has_key?('source')
-        return check_path(file_name, opts['path']) if opts.has_key?('path')
-        true
-      end
-    end
-
-    private
-
-    def flag_head
-      @dom.xpath('//head').first.prepend_child("<!--#{@check_line}-->\n")
-    end
-
-    def insert_new_node_at(elem, content)
-      case @position
-      when 'before'
-        elem.add_previous_sibling content
-      when 'replace'
-        elem.replace content
-      else
-        elem.add_next_sibling content
-      end
-    end
-
-    def extract_content(opts)
-      return opts['content'] if opts['content']
-      # If we don't have a content option, then we must have a source
-      # one.
-      @dom.css(opts['source']).unlink.to_s
-    end
-  end
-end

data/lib/neruda/utils.rb

@@ -1,214 +0,0 @@
-# frozen_string_literal: true
-
-require 'uri'
-require 'rainbow'
-require 'net/http'
-require 'r18n-core'
-require 'neruda/config'
-
-module Neruda
-  # Embeds usefull methods, mainly used in rake tasks.
-  module Utils
-    # @return [Hash] the possible throbber themes
-    THROBBER_FRAMES = {
-      'basic' => '-\|/',
-      'basicdots' => '⋯⋱⋮⋰',
-      'moon' => '🌑🌒🌓🌔🌕🌖🌗🌘',
-      'clock' => '🕛🕐🕑🕒🕓🕔🕕🕖🕗🕘🕙🕚',
-      'bricks' => '⣷⣯⣟⡿⢿⣻⣽⣾',
-      'points' => '·⁘∷⁛∷⁘',
-      'quadrant2' => '▙▛▜▟',
-      'default' => ['⠁ ⠂ ⠄ ⡀ ⠄ ⠂ ⠁', '⠂ ⠁ ⠂ ⠄ ⡀ ⠄ ⠂', '⠄ ⠂ ⠁ ⠂ ⠄ ⡀ ⠄',
-                    '⡀ ⠄ ⠂ ⠁ ⠂ ⠄ ⡀', '⠄ ⡀ ⠄ ⠂ ⠁ ⠂ ⠄', '⠂ ⠄ ⡀ ⠄ ⠂ ⠁ ⠂']
-    }.freeze
-
-    # @return [Hash] the possible ~pablo~ options and their
-    #   configuration
-    PABLO_OPTIONS = {
-      '-a' => { long: 'author' },
-      '-f' => { long: 'force', boolean: true },
-      '-h' => { long: 'help', boolean: true, meth: :on_tail },
-      '-l' => { long: 'lang', keyword: 'LOCALE' },
-      '-p' => { long: 'path' },
-      '-t' => { long: 'title' },
-      '-v' => { long: 'verbose', boolean: true, meth: :on_tail },
-      '-V' => { long: 'version', boolean: true, meth: :on_tail }
-    }.freeze
-
-    # @return [Hash] the possible ~pablo~ subcommands and their
-    #   configuration
-    PABLO_COMMANDS = {
-      'init' => { opts: ['-a', '-h', '-l', '-t', '-v'] },
-      'config' => { alias: 'init' },
-      'preview' => { opts: ['-h'] },
-      'open' => { opts: ['-a', '-h', '-l', '-p', '-t', '-v'] },
-      'edit' => { alias: 'open' },
-      'build' => { opts: ['-f', '-h'] },
-      'publish' => { opts: ['-h'] },
-      'help' => { opts: ['-h'] },
-      'basic' => { opts: ['-h', '-V'], label: '<command>' }
-    }.freeze
-
-    class << self
-      # Animates strings in the user console to alert him that something
-      #   is running in the background.
-      #
-      # The animation is chosen among a bunch of themes, with the
-      # configuration option ~throbber~ (retrieved via
-      # {Neruda::Config#settings}).
-      #
-      # @example
-      #     long_stuff = Thread.new { very_long_operation }
-      #     Neruda::Utils.throbber(long_stuff, 'Computing hard stuff:')
-      #
-      # @param thread [Thread] the long-running operation to decorate
-      # @param message [String] the message to display before the throbber
-      # @return [void]
-      def throbber(thread, message)
-        frames = select_throbber_frames
-        begin
-          run_and_decorate_thread thread, message, frames
-        rescue RuntimeError => e
-          throbber_error message
-          raise e
-        else
-          done = Rainbow('done'.ljust(frames[0].length)).green
-          puts "#{message} #{done}"
-        end
-      end
-
-      # Returns the short and long options specification for a given
-      #   short option.
-      #
-      # This method use the {Neruda::Utils::PABLO_OPTIONS} Hash to
-      # retrieve corresponding values.
-      #
-      # @example
-      #     spec = Neruda::Utils.decorate_option('-a')
-      #     => ['-a AUTHOR', '--author AUTHOR']
-      #
-      # @param short [String] the short option to decorate
-      # @return [Array] the short and long specification for an option
-      def decorate_option(short)
-        opt = Neruda::Utils::PABLO_OPTIONS[short]
-        long = "--#{opt[:long]}"
-        return [short, long] if opt[:boolean]
-        key = opt[:keyword] || opt[:long].upcase
-        [short + key, format('%<long>s %<key>s', long: long, key: key)]
-      end
-
-      # Returns the ~pablo~ help summary for a given command.
-      #
-      # @param command [String] the command for which a summary
-      #   should be given
-      # @return [String]
-      def summarize_command(command)
-        Neruda::Utils::PABLO_COMMANDS[command][:opts].map do |k|
-          short, long = Neruda::Utils.decorate_option(k)
-          opt = Neruda::Utils::PABLO_OPTIONS[k]
-          label = [short, long].join(', ')
-          line = [format('    %<opt>s', opt: label).ljust(30)]
-          if R18n.t.pablo.options[opt[:long]].translated?
-            line << R18n.t.pablo.options[opt[:long]]
-          end
-          line.join(' ')
-        end.join("\n")
-      end
-
-      # Returns a formatted list of available commands for ~pablo~.
-      #
-      # @return [String]
-      def list_commands
-        lines = []
-        Neruda::Utils::PABLO_COMMANDS.each do |cmd, opt|
-          next if cmd == 'basic'
-          line = ['   ', cmd.ljust(10)]
-          if opt.has_key? :alias
-            line << R18n.t.pablo.commands.alias(opt[:alias])
-          else
-            line << R18n.t.pablo.commands[cmd]
-          end
-          lines << line.join(' ')
-        end
-        lines.join("\n")
-      end
-
-      # Returns the real command name for a given command, which may be
-      #   an alias.
-      #
-      # @param command [String] the command to resolve
-      # @return [String]
-      def resolve_possible_alias(command)
-        return 'basic' unless Neruda::Utils::PABLO_COMMANDS.include?(command)
-        cmd_opt = Neruda::Utils::PABLO_COMMANDS[command]
-        return cmd_opt[:alias] if cmd_opt.has_key?(:alias)
-        command
-      end
-
-      # Try to discover the current host operating system.
-      #
-      # @return [String] either apple, windows or linux (default)
-      # :nocov:
-      def current_os
-        if ENV['OS'] == 'Windows_NT' || RUBY_PLATFORM.include?('cygwin')
-          return 'windows'
-        end
-        return 'apple' if RUBY_PLATFORM.include?('darwin')
-        'linux'
-      end
-      # :nocov:
-
-      # Download latest org-mode tarball.
-      #
-      # @return [String] the downloaded org-mode version
-      def download_org
-        # :nocov:
-        return if Neruda::Config.org_last_version.nil?
-        # :nocov:
-        tarball = "org-#{Neruda::Config.org_last_version}.tar.gz"
-        # Remove version number in dest file to allow easy rake file
-        # task naming
-        dest_file = 'tmp/org.tar.gz'
-        return if File.exist?(dest_file)
-        uri = URI("https://orgmode.org/#{tarball}")
-        # Will crash on purpose if anything goes wrong
-        Net::HTTP.start(uri.host, uri.port, :use_ssl => true) do |http|
-          http.request(Net::HTTP::Get.new(uri)) do |response|
-            File.open(dest_file, 'w') do |io|
-              response.read_body { |chunk| io.write chunk }
-            end
-          end
-        end
-      end
-
-      private
-
-      def throbber_error(message)
-        warn(
-          format(
-            "%<message>s %<label>s\n%<explanation>s",
-            message: message,
-            label: Rainbow(R18n.t.neruda.error.label).bold.red,
-            explanation: Rainbow(R18n.t.neruda.error.explanation).bold
-          )
-        )
-      end
-
-      def select_throbber_frames
-        model = Neruda::Config.settings['throbber'] || 'default'
-        model = 'default' unless Neruda::Utils::THROBBER_FRAMES.has_key?(model)
-        Neruda::Utils::THROBBER_FRAMES[model]
-      end
-
-      def run_and_decorate_thread(thread, message, frames)
-        thread.abort_on_exception = true
-        current = 0
-        while thread.alive?
-          sleep 0.1
-          print "#{message} #{frames[current % frames.length]}\r"
-          current += 1
-        end
-      end
-    end
-  end
-end