panel/app/models/post.rb

# frozen_string_literal: true
require 'jekyll/utils'

# Esta clase representa un post en un sitio jekyll e incluye métodos
# para modificarlos y crear nuevos
#
# Cuando estamos editando un post, instanciamos este modelo y le
# asociamos el Jekyll::Document correspondiente.
#
# Cuando estamos creando un post, no creamos su Jekyll::Document
# hasta que se guardan los datos, porque para poder guardarlo
# necesitamos su front_matter completo.
#
# El front matter está duplicado.  El Post mantiene una copia de los
# datos y los sincroniza al momento de leer y de escribir el Document.
class Post
  attr_accessor :content, :front_matter
  attr_reader :post, :site, :errors, :old_post

  REJECT_FROM_DATA = %w[excerpt].freeze
  # datos que no tienen que terminar en el front matter
  REJECT_FROM_FRONT_MATTER = %w[date slug draft ext].freeze

  # Trabajar con posts.  Si estamos creando uno nuevo, el **site** y
  # el **front_matter** son necesarios, sino, **site** y **post**.
  # XXX chequear que se den las condiciones
  def initialize(site:, post: nil, front_matter: {})
    unless site.is_a?(Site)
      raise ArgumentError,
        I18n.t('errors.argument_error', argument: :site, class: Site)
    end

    unless post.nil? || post.is_a?(Jekyll::Document)
      raise ArgumentError,
        I18n.t('errors.argument_error', argument: :post,
          class: Jekyll::Document)
    end

    @site = site
    @post = post
    # los errores tienen que ser un hash para que 
    # ActiveModel pueda traer los errores normalmente
    @errors = {}

    # sincronizar los datos del document
    if new?
      @front_matter = {}
      update_attributes front_matter
    else
      load_front_matter!
      merge_with_front_matter! front_matter.stringify_keys
    end
  end

  # Limpiar los errores
  def reset_errors!
    @errors = {}
  end

  # El post es nuevo si no hay un documento asociado
  def new?
    @post.nil? || !File.exist?(@post.try(:path))
  end

  # Guarda los cambios.
  #
  # Recién cuando vamos a guardar creamos el Post, porque ya tenemos
  # todos los datos para escribir el archivo, que es la condición
  # necesaria para poder crearlo :P
  def save
    cleanup!

    return false unless valid?

    new_post if new?

    return unless write
    return unless detect_file_rename!

    # Vuelve a leer el post para tomar los cambios
    @post.read
    add_post_to_site!
    true
  end
  alias :save! :save

  def title
    get_front_matter 'title'
  end

  def date
    get_front_matter 'date'
  end

  def tags
    get_front_matter 'tags'
  end

  def categories
    get_front_matter 'categories'
  end
  alias :category :categories

  # Devuelve la ruta del post, si se cambió alguno de los datos,
  # generamos una ruta nueva para tener siempre la ruta actualizada.
  def path
    basename_changed? ? File.join(@site.path, '_posts', basename_from_front_matter) : @post.try(:path)
  end

  # TODO los slugs se pueden repetir, el identificador real sería
  # fecha+slug, pero se ve feo en las urls?
  def id
    get_front_matter 'slug'
  end
  alias :slug :id
  alias :to_s :id

  def basename_changed?
    @post.try(:basename) != basename_from_front_matter
  end

  def content
    @content ||= @post.try :content
  end

  # imita Model.update_attributes de ActiveRecord
  def update_attributes(attrs)
    # el cuerpo se maneja por separado
    @content = attrs.delete('content') if attrs.key? 'content'
    merge_with_front_matter! attrs.stringify_keys
  end

  # Requisitos para que el post sea válido
  def validate
    add_error validate: I18n.t('posts.errors.date') unless get_front_matter('date').is_a? Time
    add_error validate: I18n.t('posts.errors.title') if get_front_matter('title').blank?
    # TODO verificar que el id sea único
  end

  def valid?
    reset_errors!
    validate

    @errors.empty?
  end

  # Permite ordenar los posts
  def <=>(other)
    @post <=> other.post
  end

  private

  # Genera un post nuevo y lo agrega a la colección del sitio.
  def new_post
    opts = { site: @site.jekyll, collection: @site.jekyll.posts }
    @post = Jekyll::Document.new(path, opts)
  end

  # Solo agregar el post al sitio una vez que lo guardamos
  #
  # TODO no sería la forma correcta de hacerlo en Rails
  def add_post_to_site!
    @site.jekyll.posts.docs << @post
    @site.jekyll.posts.docs.sort!

    @site.posts << self unless @site.posts.include? self
    @site.posts.sort!
  end

  # Obtiene metadatos asegurándose que siempre trabajamos con strings
  def get_front_matter(name)
    @front_matter.dig(name.to_s)
  end

  # Los define, asegurandose que las llaves siempre son strings, para no
  # tener incompatibilidades con jekyll
  def set_front_matter(name, value)
    @front_matter[name.to_s] = value
  end

  # Cambiar el nombre del archivo si cambió el título o la fecha.
  # Como Jekyll no tiene métodos para modificar un Document, lo
  # engañamos eliminando la instancia de @post y recargando otra.
  def detect_file_rename!
    return true unless basename_changed?
    # No eliminamos el archivo a menos que ya exista el reemplazo!
    return false unless File.exist? path

    Rails.logger.info I18n.t('posts.logger.rm', path: path)
    FileUtils.rm @post.path
    replace_post!
  end

  # Reemplaza el post en el sitio por uno nuevo
  def replace_post!
    @old_post = @site.jekyll.posts.docs.delete @post

    new_post
  end

  # Obtiene el nombre del archivo a partir de los datos que le
  # pasemos
  def basename_from_front_matter
    date  = get_front_matter('date').strftime('%F')
    slug  = get_front_matter('slug')
    ext   = get_front_matter('ext')  || '.markdown'

    "#{date}-#{slug}#{ext}"
  end

  # Toma los datos del front matter local y los mueve a los datos
  # que van a ir al post.  Si hay símbolos se convierten a cadenas,
  # porque Jekyll trabaja con cadenas.  Se excluyen otros datos que no
  # van en el frontmatter
  def merge_with_front_matter!(params)
    @front_matter.merge! Hash[params.to_hash.map do |k, v|
      [k, v] unless REJECT_FROM_DATA.include? k
    end.compact]
  end

  # Carga una copia de los datos del post original excluyendo datos
  # que no nos interesan
  def load_front_matter!
    @front_matter = @post.data.reject do |key, _|
      REJECT_FROM_DATA.include? key
    end
  end

  def cleanup!
    things_to_arrays!
    date_to_time!
    clean_content!
    slugify_title!
  end

  # Aplica limpiezas básicas del contenido
  def clean_content!
    @content.try(:delete!, "\r")
  end

  # Guarda los cambios en el archivo destino
  def write
    r = File.open(path, File::RDWR | File::CREAT, 0o640) do |f|
      # Bloquear el archivo para que no sea accedido por otro
      # proceso u otra editora
      f.flock(File::LOCK_EX)

      # Empezar por el principio
      f.rewind

      # Escribir
      f.write(full_content)

      # Eliminar el resto
      f.flush
      f.truncate(f.pos)
    end

    return true if r.zero?

    add_error file: I18n.t('posts.errors.file')
    false
  end

  # Genera el post con front matter, menos los campos que no necesitamos
  # que estén en el front matter
  def full_content
    yaml = @front_matter.reject do |k,_|
      REJECT_FROM_FRONT_MATTER.include? k
    end

    "#{yaml.to_yaml}---\n\n#{@content}"
  end

  def add_error(hash)
    hash.each_pair do |k,i|
      if @errors.key?(k)
        @errors[k] = [@errors[k], i]
      else
        @errors[k] = i
      end
    end

    @errors
  end

  def date_to_time!
    unless @front_matter.dig(:date).is_a? Time
      @front_matter['date'] = @front_matter.dig('date').try(:to_time) || Time.now
    end
  end

  def things_to_arrays!
    [:tags,:categories].each do |c|
      thing = @front_matter.dig(c.to_s)
      next if thing.is_a? Array
      @front_matter[c.to_s] = thing.split(',').map(&:strip)
    end
  end

  def slugify_title!
    if get_front_matter('slug').blank?
      title = get_front_matter('title')
      @front_matter['slug'] = Jekyll::Utils.slugify(title)
    end
  end
end