Classi & Moduli

• Preferire i moduli alle classi con i soli metodi della classe.

• Le classi dovrebbero essere usate solo quando ha senso creare istanze da esse. Preferire extend self a module_function.

# bad
module SomeModule
  module_function

  def some_method
  end

  def some_other_method
  end
end

# good
module SomeModule
  extend self

  def some_method
  end

  def some_other_method
  end
end

• Quando si definiscono i metodi di una classe, utilizzare il blocco class << self piuttosto che def self. e raggrupparli in un unico blocco.

# bad
class SomeClass
  def self.method1
  end

  def method2
  end

  private

  def method3
  end

  def self.method4 # this is actually not private
  end
end

# good
class SomeClass
  class << self
    def method1
    end

    private

    def method4
    end
  end

  def method2
  end

  private

  def method3
  end
enby

• Rispettare il principio di sostituzione di Liskov quando si progettano le gerarchie di classi.

• Usare attr_accessor, attr_reader e attr_writer per definire accessori e mutatori banali.

# bad
class Person
  def initialize(first_name, last_name)
    @first_name = first_name
    @last_name = last_name
  end

  def first_name
    @first_name
  end

  def last_name
    @last_name
  end
end

# good
class Person
  attr_reader :first_name, :last_name

  def initialize(first_name, last_name)
    @first_name = first_name
    @last_name = last_name
  end
end

• Preferire attr_reader e attr_accessor ad attr.

• Evitare le variabili di classe (@@).

• Preferire alias_method a alias.

• Indentare i metodi public, protected e private tanto quanto le definizioni dei metodi a cui si applicano. Lasciare una riga vuota sopra il modificatore di visibilità e una riga vuota sotto di esso.

class SomeClass
  def public_method
    # ...
  end

  private

  def private_method
    # ...
  end

  def another_private_method
    # ...
  end
end