fronde 0.3.4 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59daab21a7ef37010f30971994ebda28af2c212528205e43c2dae18abe6c510f
-  data.tar.gz: 89fda0a99813459bdbd2291c91aebe44d3a6c2fb3a6faf4742b7e7036191e5e8
+  metadata.gz: 8691e788789cb725772213237a67731dc67ae77eeecc8d1d409e6779d94a22c8
+  data.tar.gz: d2f67191b421f902e1b41d7845fc07026843e227cfd3f70cdeff0f4d87e36b8e
 SHA512:
-  metadata.gz: de60c2c6254acbe48846e3af209106aeb1f7058a604491e27bbeef1bf32b2c78d1d17e320d47168f086b046ad368b888a5b6933eddf56b7f4471c824c6acaa14
-  data.tar.gz: 62f6c65db410960e4395bcbbff9bb1918886dfdb9a1c0b9c8f8871f61c285160c1a3edca901619b674b93bce80ba1cc45ce2de6ce74195c4c0f5a72292db1d70
+  metadata.gz: b8d3fa0a8bbfbcdecbf7a65ffc93b420876ddb27acf574a5a1a066b988ce2e039ff780b0a71bd6056f3a75b52072f4c37489135a6ead712e0a728f8385453de2
+  data.tar.gz: d2bd28e4fa15b156a83c61b79426f74e3e48534cfe483f92a03dd3d9a4a0675252843bb991bbb114f45421865b52e6b7f6f7dd500261cc0d8236063838f7baf4

data/bin/fronde

@@ -1,45 +1,30 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require 'optparse'
-require 'r18n-core'
-require 'fronde/utils'
-require 'fronde/version'
-require 'fronde/cli'
-
-R18n.default_places = File.expand_path('../locales', __dir__)
-R18n.set Fronde::Config.get('lang')
+require_relative '../lib/fronde/config'
+require_relative '../lib/fronde/version'
+require_relative '../lib/fronde/cli'
 
+require 'optparse'
 optparser = OptionParser.new
 optparser.version = Fronde::VERSION
 
-Fronde::Utils::FRONDE_OPTIONS.each do |k, opt|
-  optparser.send(opt[:meth] || :on, *Fronde::Utils.decorate_option(k))
+Fronde::CLI::OptParse::FRONDE_OPTIONS.each do |k, opt|
+  optparser.send(opt[:method] || :on, *Fronde::CLI::OptParse.decorate_option(k))
 end
 
-params = {}
-optparser.parse!(into: params)
+params = { verbose: false }
+begin
+  optparser.parse!(into: params)
+rescue OptionParser::InvalidArgument => e
+  warn e.message
+  params.merge!(help: true, recover_from_error: true)
+end
 
 if params[:version]
   warn optparser.ver
   exit
 end
 
-if ARGV[0] == 'help'
-  params[:help] = true
-  ARGV.shift
-end
-fronde = Fronde::CLI.new(params)
-command = "fronde_#{ARGV[0]}".to_sym
-cmd_err = !fronde.respond_to?(command)
-if params[:help] || cmd_err
-  cmd_err = false if params[:help] && !ARGV[0]
-  fronde.fronde_help(ARGV[0], error: cmd_err)
-end
-ARGV.shift
-
-init_cmds = [:fronde_init, :fronde_config, :fronde_update]
-unless File.exist?('config.yml') || init_cmds.include?(command)
-  fronde.fronde_init
-end
-fronde.send command
+fronde = Fronde::CLI::App.new(params)
+exit fronde.run(ARGV)

data/lib/ext/nil_time.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# A time emulator to handle cases where no time is available
+class NilTime
+  def strftime(*)
+    ''
+  end
+
+  def xmlschema(_ = 0)
+    ''
+  end
+
+  def l18n_short_date_string
+    ''
+  end
+
+  def l18n_long_date_string(*)
+    ''
+  end
+
+  def l18n_short_date_html
+    '<time></time>'
+  end
+  alias_method :l18n_long_date_html, :l18n_long_date_string
+end

data/lib/ext/r18n.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# Monkey patch to add a little helper
+module R18nPatch
+  refine R18n::Translation do
+    def full_datetime_format
+      date_fmt = fronde.index.full_date_format(
+        date: @locale.full_format
+      )
+      date_fmt = @locale.year_format.sub('_', date_fmt)
+      time_fmt = @locale.time_format.delete('_').strip
+      fronde.index.full_date_with_time_format(
+        date: date_fmt, time: time_fmt
+      )
+    end
+
+    # Returns the given Time instance as a localized long string.
+    #
+    # @param time [Time] the Time instance to format
+    # @param with_year [Boolean] whether or not the string must contain
+    #   the year
+    # @param with_time [Boolean] whether or not the string must contain
+    #   the time
+    # @return [String] the localized Time string representation
+    def long_date_string(time, with_year: true, with_time: true)
+      long_fmt = fronde.index.full_date_format(
+        date: @locale.format_date_full(time, year: with_year)
+      )
+      if with_time
+        long_fmt = fronde.index.full_date_with_time_format(
+          date: long_fmt, time: @locale.time_format.delete('_').strip
+        )
+      end
+      @locale.strftime(time, long_fmt)
+    end
+  end
+end

data/lib/ext/time.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative 'r18n'
+using R18nPatch
+
+# Monkey patch to add some helpers
+module TimePatch
+  refine Time do
+    # Returns the current Time instance as a localized short string.
+    #
+    # @return [String] the localized Time string representation
+    def l18n_short_date_string
+      R18n.l to_date
+    end
+
+    # Format the current Time as a HTML `time` tag showing a short date.
+    #
+    # @return [String] the HTML `time` tag
+    def l18n_short_date_html
+      "<time datetime=\"#{xmlschema}\">#{l18n_short_date_string}</time>"
+    end
+
+    # Returns the current Time instance as a localized long string.
+    #
+    # @param with_year [Boolean] whether or not the string must contain
+    #   the year
+    # @return [String] the localized Time string representation
+    def l18n_long_date_string(with_year: true)
+      R18n.t.long_date_string(self, with_year: with_year)
+    end
+
+    # Format the current Time as a HTML `time` tag showing a long date.
+    #
+    # @return [String] the HTML `time` tag
+    def l18n_long_date_html
+      "<time datetime=\"#{xmlschema}\">#{l18n_long_date_string}</time>"
+    end
+  end
+end

data/lib/ext/time_no_time.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'r18n'
+using R18nPatch
+
+using TimePatch
+
+# A time emulator to keep the fact that the time information was
+# missing, even if it behaves as a Time object for the given date.
+class TimeNoTime < Time
+  # Returns the current Time instance as a localized long string.
+  #
+  # @param with_year [Boolean] wether or not the string must contain the
+  #   year
+  # @return [String] the localized Time string representation
+  def l18n_long_date_string(with_year: true)
+    R18n.t.long_date_string(self, with_year: with_year, with_time: false)
+  end
+
+  def self.parse_no_time(string)
+    strptime("#{string} 00:00:00", '%Y-%m-%d %H:%M:%S')
+  end
+end

data/lib/fronde/cli/commands.rb

@@ -1,125 +1,118 @@
 # frozen_string_literal: true
 
+require_relative 'helpers'
+require_relative 'opt_parse'
+require_relative '../slug'
+require_relative '../org/file'
+
 module Fronde
-  # Fronde commands
-  module CLICommands
-    def fronde_update
-      update_config
-      @rake.options.build_all = true
-      @rake.invoke_task('org:upgrade')
-    end
-    alias_method :fronde_config, :fronde_update
-
-    def fronde_init
-      update_config
-      @rake.options.build_all = true
-      @rake.invoke_task('org:install')
-      return if File.exist? 'src/index.org'
-      Fronde::OrgFile.new('src/index.org', @options).write
-      fronde_open 'src/index.org'
-    end
+  module CLI
+    # Fronde commands
+    module Commands
+      def fronde_new
+        new_dir = @argv.first || 'my_fronde_website'
+        FileUtils.mkdir new_dir
+        Dir.chdir new_dir
+        Helpers.init_config_file @options
+        Fronde::CONFIG.reset # Correctly compute various path
+        Helpers.init_rakefile
+        init_rake
+        @rake['org:install'].invoke
+        @argv = ['src/index.org']
+        fronde_open
+      end
 
-    def fronde_build
-      @rake.options.build_all = true
-      task = 'site:build'
-      task = "#{task}[true]" if @options[:force]
-      @rake.invoke_task task
-    end
+      def fronde_update
+        Helpers.init_rakefile
+        init_rake
+        @rake.options.build_all = true
+        @rake['org:upgrade'].invoke
+        true
+      end
 
-    def fronde_preview
-      Thread.new do
-        sleep 1
-        port = Fronde::Config.get(['preview', 'server_port'], 5000)
-        uri = "http://127.0.0.1:#{port}/"
-        current_os = Fronde::Utils.current_os
-        case current_os
-        when 'windows'
-          system 'start', uri
-        when 'apple'
-          system 'open', uri
-        else
-          system 'gio', 'open', uri
+      def fronde_build
+        @rake.options.build_all = true
+        @rake['site:build'].invoke @options[:force]
+        true
+      end
+
+      def fronde_preview
+        Thread.new do
+          sleep 1
+          port = Fronde::CONFIG.get(%w[preview server_port], 5000)
+          Helpers.launch_app_for_uri "http://127.0.0.1:#{port}/"
         end
+        @rake['site:preview'].invoke
+        true
       end
-      @rake.invoke_task('site:preview')
-    end
 
-    def fronde_open(file_path = ARGV[0])
-      editor = ENV['EDITOR'] || ENV['VISUAL'] || 'emacs'
-      cmd = [editor]
-      if file_path.nil? || !File.file?(file_path)
-        # file_path may be updated with title given in options
-        file_path = create_new_file(file_path)
-        # Only move to the end of file for new file. Let the editor handle
-        # the best position for already existing files
-        cmd << '+6'
+      def fronde_open
+        editor = ENV['EDITOR'] || ENV['VISUAL'] || 'emacs'
+        cmd = [editor]
+        file_path = @argv.first || Dir.pwd
+        unless File.file?(file_path)
+          # file_path may be updated with title given in options
+          file_path = create_new_file(file_path)
+          # Only move to the end of file for new file. Let the editor handle
+          # the best position for already existing files
+          cmd << '+6'
+        end
+        cmd << file_path
+        system(*cmd)
       end
-      cmd << file_path
-      system(*cmd)
-    end
-    alias_method :fronde_edit, :fronde_open
 
-    def fronde_publish
-      @rake.invoke_task('sync:push')
-    end
+      def fronde_publish
+        @rake['sync:push'].invoke
+        true
+      end
 
-    def fronde_help(command = 'basic', error: false)
-      warn R18n.t.fronde.bin.error.no_command if error
-      cmd_opt = Fronde::Utils.command_options(command)
-      label = cmd_opt[:label] || command
-      warn format("%<label>s\n\n", label: R18n.t.fronde.bin.usage(label))
-      cmd = cmd_opt[:name] || command
-      if R18n.t.fronde.bin.commands[cmd].translated?
-        warn format("%<label>s\n\n", label: R18n.t.fronde.bin.commands[cmd])
+      def fronde_help
+        # Try to find command in next argv, otherwise fallback again.
+        @command = @argv.shift || 'basic' if @command == 'help'
+        cmd_opt = OptParse.command_options(@command)
+        label = cmd_opt[:label] || @command
+        output = [format_label(R18n.t.fronde.bin.usage(label))]
+        cmd = cmd_opt[:name] || @command
+        output << format_label(R18n.t.fronde.bin.commands[cmd])
+        output << OptParse.help_command_body(cmd)
+        warn output.join
+        true
       end
-      warn help_command_body(cmd).join("\n")
-      exit 1 if error
-      exit
-    end
 
-    private
+      private
 
-    def update_config
-      cnf = @options.merge
-      cnf.delete(:verbose)
-      cnf.transform_keys!(&:to_s)
-      Fronde::Config.save(Fronde::Config.settings.merge(cnf))
-    end
+      def format_label(label)
+        return '' if label == '' || label.is_a?(R18n::Untranslated)
 
-    def new_file_name(file_path)
-      file_path = File.expand_path(file_path || '')
-      return file_path if file_path[-4..] == '.org'
-      # file_path seems to be a dir path. Thus we have to create the new
-      # filename from its title
-      title = @options[:title]
-      # No title, nor a reliable file_path? Better abort
-      return nil if title.nil? || title == ''
-      filename = "#{Fronde::OrgFile.slug(title)}.org"
-      File.join file_path, filename
-    end
+        format("%<label>s\n\n", label: label)
+      end
+
+      def file_name_from_title
+        title = @options[:title] || R18n.t.fronde.bin.options.default_title
+        # No title, nor a reliable file_path? Better abort
+        raise R18n.t.fronde.error.bin.no_file if title == ''
 
-    def create_new_file(file_path)
-      filename = new_file_name(file_path)
-      if filename.nil?
-        warn R18n.t.fronde.bin.error.no_file
-        exit 1
+        "#{Fronde::Slug.slug(title)}.org"
       end
-      FileUtils.mkdir_p File.dirname(filename)
-      Fronde::OrgFile.new(filename, @options).write
-      filename
-    end
 
-    def help_command_body(command)
-      body = [
-        R18n.t.fronde.bin.options.cmd_title,
-        Fronde::Utils.summarize_command(command)
-      ]
-      return body unless command == 'basic'
-      body + [
-        '',
-        R18n.t.fronde.bin.commands.cmd_title,
-        Fronde::Utils.list_commands
-      ]
+      def new_file_name(file_path)
+        file_path = File.expand_path(file_path)
+
+        if file_path[-4..] == '.org' && !File.directory?(file_path)
+          return file_path
+        end
+
+        # file_path seems to be a dir path. Thus we have to create the new
+        # filename from its title
+        File.join file_path, file_name_from_title
+      end
+
+      def create_new_file(file_path)
+        filename = new_file_name(file_path)
+        FileUtils.mkdir_p File.dirname(filename)
+        Fronde::Org::File.new(filename, @options).write
+        filename
+      end
     end
   end
 end

data/lib/fronde/cli/data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'fronde/config'
+
+fronde_spec = Gem::Specification.find_by_name 'fronde'
+Dir.glob("#{fronde_spec.gem_dir}/lib/tasks/*.rake").each { |r| import r }
+
+task default: 'site:build'

data/lib/fronde/cli/data/config.yml

@@ -0,0 +1,13 @@
+---
+{%- if author %}
+author: {{ author }}
+{%- endif %}
+{%- if lang %}
+lang: {{ lang }}
+{%- endif %}
+sources:
+  - path: src
+    target: .
+{%- if output == 'gemini' %}
+    type: gemini
+{%- endif %}

data/lib/fronde/cli/data/gitignore

@@ -0,0 +1,6 @@
+.ruby-version
+Rakefile
+lib/
+public_gmi/
+public_html/
+var/

data/lib/fronde/cli/data/zsh_completion

@@ -0,0 +1,37 @@
+#compdef fronde
+#autoload
+
+{% for command in commands %}
+{%- for option in command.options %}
+{%- if forloop.first %}
+(( $+functions[__fronde_{{ command.name }}] )) ||
+__fronde_{{ command.name }}(){
+    _arguments \
+{%- endif %}
+        '({{ option.short }} {{ option.long }})'{{ '{' }}{{ option.short}},{{ option.long }}}
+        {%- if option.keyword %}':{{ option.keyword }}:'{% endif %}
+{%- if forloop.last %}
+{%- if command.name == 'open' %} \
+        '1:file:_files -g \*.org'
+{%- endif %}
+}
+{% else %} \{% endif %}
+{%- endfor %}{% endfor %}
+
+(( $+functions[__fronde_help] )) ||
+__fronde_help(){
+    _arguments \
+        "1:command:(({% for command in commands %}{{ command.name }}\:'{{ command.translation }}' {% endfor %}))"
+}
+
+local state
+
+_arguments -C \
+    '(-)-h[help]' \
+    '(-)-V[version]' \
+    "1:command:(({% for command in commands %}{{ command.name }}\:'{{ command.translation }}' {% endfor %}))" \
+    '*::arg:->args'
+
+if [ "$state" = args ]; then
+    _call_function ret __fronde_${words[1]}
+fi

data/lib/fronde/cli/helpers.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'uri'
+require 'net/http'
+require 'fileutils'
+
+module Fronde
+  module CLI
+    # Various utilitaries methods
+    module Helpers
+      def self.init_config_file(config)
+        return if File.exist? 'config.yml'
+
+        output = config[:output] || 'html'
+        output = 'gemini' if output == 'gmi'
+        data = { 'author' => config[:author],
+                 'lang' => config[:lang],
+                 'output' => output }
+        source = File.expand_path './data/config.yml', __dir__
+        template = Liquid::Template.parse(File.read(source))
+        File.write('config.yml', template.render(data))
+      end
+
+      def self.init_rakefile
+        FileUtils.cp(
+          File.expand_path('./data/Rakefile', __dir__),
+          'Rakefile'
+        )
+      end
+
+      def self.launch_app_for_uri(uri)
+        case current_os
+        when 'windows'
+          system 'start', uri
+        when 'apple'
+          system 'open', uri
+        else
+          system 'gio', 'open', uri
+        end
+      end
+
+      # Try to discover the current host operating system.
+      #
+      # @return [String] either apple, windows or linux (default)
+      def self.current_os
+        if ENV['OS'] == 'Windows_NT' || RUBY_PLATFORM.include?('cygwin')
+          return 'windows'
+        end
+        return 'apple' if RUBY_PLATFORM.include?('darwin')
+
+        'linux'
+      end
+    end
+  end
+end