Specter

June 6, 2016

Specter é uma biblioteca que trás uma maneira diferente de trabalhar com estruturas de dados aninhadas em Clojure. Ela faz uso dos chamados paths para fazer fazer transformações e consultas.

Essa proposta é muito interessante para deixar a tentação de recorrer à mutabilidate por ser mais fácil de se alterar um subset da estrutura, porque como Rich Hickey já nos ensinou, fácil não quer dizer simples.

A principal vantagem dos paths é que eles podem ser combinados com outros para expressar regras mais complexas mantendo a função de transformação intácta.

Considere que temos uma lista de maps que representam pessoas, e nesses maps, temos as keys :name identificando os nomes e :age as idades. Diante deste cenário, queremos incrementar as idades de todo mundo em um.

Para atingir este objetivo, usariamos a função core do clojure update em conjunto com map para executar essa transformação.

(map #(update % :age inc)
     [{:name "Carlos"
       :age 31}
      {:name "Julia"
       :age 25}
      {:name "Katia"
       :age 69}])
;; => ({:name "Carlos", :age 32} {:name "Julia", :age 26} {:name "Katia", :age 70})

Em comparação, com Specter:

(require '[com.rpl.specter :refer [transform ALL comp-paths]])

(transform [ALL :age]
           inc
           [{:name "Carlos"
             :age 31}
            {:name "Julia"
             :age 25}
            {:name "Katia"
             :age 69}])
;; => [{:name "Carlos", :age 32} {:name "Julia", :age 26} {:name "Katia", :age 70}]

Primeiro começamos fazendo require no namespace principal do Specter, com um refer das vars transform=e =ALL para o nosso namespace atual. A primeira var importada é uma função transform que recebe três argumentos, um vetor de paths, uma função para aplicar nos nós achados pelos paths e por final, a estrutura de dados a ser modificada.

Vamos nos concentrar no primeiro argumento da função, o que [ALL :age] quer dizer?

ALL é um path padrão do Specter, com ele queremos dizer que estamos interessados em todos os itens de uma coleção, o próximo path na lista é o :age que não é nada mais, nada menos que uma keyword, que são tratadas como funções quando usadas em maps, então se juntarmos esses dois elementos, estamos dizendo ao Specter que queremos aplicar a função inc em todos os valores de :age em cada elemento de uma coleção.

Se analisarmos o exemplo acima, podemos não enxergar muita vantagem na última abordagem, afinal de contas, usando Specter, nós escrevemos mais linhas de código, sem falar na dependência extra. Mas quando separamos a transformação das regras de estrutura, abrimos espaço para composição, tnato de paths quanto de funções.

Vamos aplicar isso em mais um exemplo, imagine que nessa mesma estrutura que estamos utilizando, nós precisemos incrementar a idade apenas das pessoas que tenham mais de 60 anos. O resultado seria:

(transform [ALL :age #(> % 60)]
           inc
           [{:name "Carlos"
             :age 31}
            {:name "Julia"
             :age 25}
            {:name "Katia"
             :age 69}])
;; => [{:name "Carlos", :age 31} {:name "Julia", :age 25} {:name "Katia", :age 70}]

A função de transformação continua a mesma, a estrutura continua a mesma, mas com apenas uma pequena função anônima no final do vetor de paths nós mudamos completamente o comportamento do nosso código, atingindo o resultado esperado sem muitas mudanças.

E o melhor de tudo, podemos compor esses paths e dar nome as nossas abstrações.

(def WITH-AGES-GREATER-THAN-60 (comp-paths ALL :age #(> % 60)))
(transform [WITH-AGES-GREATER-THAN-60]
           inc
           [{:name "Carlos"
             :age 31}
            {:name "Julia"
             :age 25}
            {:name "Katia"
             :age 69}])
;; => [{:name "Carlos", :age 31} {:name "Julia", :age 25} {:name "Katia", :age 70}]