find deps

encontrar-deps

O que?

find-deps ajuda você a encontrar dependências rapidamente por meio das APIs de pesquisa Clojars e Maven. Use-o através da linha de comando ou do REPL.

find-deps utiliza clj-fuzzy para refinar os resultados da pesquisa retornados das APIs do repositório. Ele também leva em consideração a atualização das dependências e a popularidade do ID do grupo da dependência. Esperamos que isso resulte sempre em uma sugestão quase perfeita!

Veja a seção Futuro abaixo para algumas ideias sobre onde isso pode ser feito. Em particular, seria ótimo permitir a pesquisa de arquivos deps.edn no github…

DR

Adicione uma dependência ao seu deps.edn atual tão facilmente quanto isto:

clj -A:find-deps -F:save priority-map

Registro de alterações

• Nota tirada em [2018-06-25 Seg 10:39]
• 25/06/2018
  • ocultar versões de snapshots por padrão em clojars (correções nº 2)
• 24/06/2018
  • fundiu a correção README de @pesterhazy
• 23/06/2018
  • bug corrigido em que não era possível salvar deps sem um deps.edn pré-existente
  • adicionado -F: sinalizador de formato cli para imprimir deps como opção de linha de comando para o binário `clojure`
• 17/06/2018
  • altere o sinalizador -S para -s para evitar conflito com o tools.deps cli
  • habilitar a tubulação de invocações juntas para produzir o mapa deps.edn mesclado
  • ativar o salvamento do mapa deps.edn com formato: save
  • renomeado: mesclado para: mesclado
• 16/06/2018
  • Confirmação inicial

Uso CLI

Para usar find-deps na linha de comando, crie um alias em seu mapa ~/.clojure/deps.edn:

{ :aliases { :find-deps { :extra-deps
                         {find-deps
                            { :git/url " https://github.com/hagmonk/find-deps " ,
                             :sha " 6fc73813aafdd2288260abb2160ce0d4cdbac8be " }},
                       :main-opts [ " -m " " find-deps.core " ]}}}

Você pode invocar find-deps com -h para ver as opções suportadas:

% clj -A:find-deps -h
find-deps

Usage: [options * ] [search-strings * ]

Options:
  -s, --sources SOURCES  :clojars:mvn  Concatenated source types
  -R, --rank METHOD      :fuzzy        Ranking method - :fuzzy, :regex
  -F, --format FORMAT    :deps         Format for printing results - :deps, :merge, :table, :save, :cli
  -l, --limit NUM        1             Limit per-search results to NUM
  -h, --help

Exemplos

Procure uma dependência como http-kit:

clj -A:find-deps http-kit

{ :deps {http-kit/http-kit { :mvn/version " 2.3.0 " }}}

Procure por múltiplas dependências:

clj -A:find-deps http-kit tools.logging priority-map

{ :deps
 {http-kit/http-kit { :mvn/version " 2.3.0 " },
  org.clojure/tools.logging { :mvn/version " 0.5.0-alpha " },
  org.clojure/data.priority-map { :mvn/version " 0.0.9 " }}}

Encadeie várias invocações usando diferentes argumentos de consulta:

clj -A:find-deps -s:mvn roaringbitmap | clj -A:find-deps -s:clojars -R:regex -l 5 io.pedestal

{ :deps
 {org.roaringbitmap/RoaringBitmap  { :mvn/version " 0.7.13 " },
  io.pedestal/pedestal.jetty       { :mvn/version " 0.5.3 " },
  io.pedestal/pedestal.tomcat      { :mvn/version " 0.5.3 " },
  io.pedestal/pedestal.log         { :mvn/version " 0.5.3 " },
  io.pedestal/pedestal.service     { :mvn/version " 0.5.3 " },
  io.pedestal/pedestal.interceptor { :mvn/version " 0.5.3 " }}}

Mesclar os resultados da pesquisa no deps.edn do projeto atual. Você também pode salvar esses resultados em deps.edn especificando :save .

clj -A:find-deps -F:merge http-kit tools.logging priority-map

{ :paths [ " src " ],
 :deps
 {org.clojure/clojure           { :mvn/version " 1.9.0 " },
  org.clojure/tools.logging     { :mvn/version " 0.5.0-alpha " },
  org.clojure/spec.alpha        { :mvn/version " 0.1.143 " },
  clj-fuzzy                     { :mvn/version " 0.4.1 " },
  http-kit                      { :mvn/version " 2.3.0 " },
  tools.deps.alpha
  { :git/url " https://github.com/clojure/tools.deps.alpha " ,
   :sha     " 884d7ae5b9c228ff795e4385291708102f1cd46d " },
  metosin/jsonista              { :mvn/version " 0.1.1 " },
  org.clojure/data.priority-map { :mvn/version " 0.0.9 " },
  inflections                   { :mvn/version " 0.13.0 " },
  http-kit/http-kit             { :mvn/version " 2.3.0 " }}
; ; ... snip
 }

Pesquisa de string retornando múltiplas correspondências em uma tabela:

clj -A:find-deps -F:table -l 10 " apache kafka "

|                              :lib | :version |
| -----------------------------------+---------- |
|      org.apache.kafka/kafka-tools |    1.1.0 |
|      org.apache.kafka/kafka_2.9.2 |  0.8.2.2 |
|      org.apache.kafka/kafka_2.9.1 |  0.8.2.2 |
|      org.apache.kafka/kafka_2.8.0 |  0.8.1.1 |
|      org.apache.kafka/kafka_2.8.2 |    0.8.1 |
|    org.apache.hadoop/hadoop-kafka |    3.1.0 |
|    org.apache.kafka/kafka-streams |    1.1.0 |
|    org.apache.kafka/kafka-clients |    1.1.0 |
|   org.apache.kafka/kafka-examples |    1.1.0 |
| org.apache.kafka/kafka-perf_2.8.0 |  0.8.1.1 |

Imprima uma invocação de linha de comando dos deps:

clj -A:find-deps -F:cli http-kit jsonista
clojure -Sdeps ' {:deps {http-kit/http-kit {:mvn/version "2.3.0"}, metosin/jsonista {:mvn/version "0.2.1"}}} '

API

O namespace find-deps.core contém vários auxiliares que você pode usar no REPL. Supondo que você tenha um alias para rebel-readline:

clj -A:rebel
[Rebel readline] Type :repl/help for online help info
user= > (use ' find-deps.core)
nil
user=> (print-deps "http-kit")

|              :lib | :version |
|-------------------+----------|
| http-kit/http-kit |    2.3.0 |
nil
user=> (deps "http-kit")
{:deps #:http-kit{http-kit #:mvn{:version "2.3.0"}}}

Consulte o namespace find-deps.core para obter mais ajudantes.

Futuro

• [] pesquise no github por arquivos deps.edn
• [] pesquise no github por arquivos project.clj
  • [] dependências de classificação de página com base no gráfico de dependência
  • [] recomendou outras dependências baseadas em cluster
• [] incorporar contagens de download no fator de ponderação
• [x] suporta gravação diretamente em deps.edn
• [] suporte add-lib
• [] adicionar suporte de validação ao analisador cli