find deps

trouver-deps

Quoi?

find-deps vous aide à trouver rapidement les dépendances via les API de recherche Clojars et Maven. Utilisez-le via la ligne de commande ou depuis le REPL.

find-deps utilise clj-fuzzy pour affiner les résultats de recherche renvoyés par les API du référentiel. Cela prend également en compte la fraîcheur des dépendances et la popularité de l'ID de groupe de la dépendance. Nous espérons que cela aboutira à une suggestion presque parfaite à chaque fois !

Consultez la section Avenir ci-dessous pour quelques idées sur les domaines dans lesquels cela peut être pris. En particulier, ce serait bien d’activer la recherche de fichiers deps.edn sur github…

TL;DR

Ajoutez une dépendance à votre deps.edn actuel aussi facilement que ceci :

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

Journal des modifications

• Note prise le [2018-06-25 lun 10:39]
• 2018-06-25
  • masquer les versions d'instantanés par défaut dans les clojars (correctifs n°2)
• 2018-06-24
  • fusion du correctif README de @pesterhazy
• 2018-06-23
  • correction d'un bug où il n'était pas possible de sauvegarder des dépôts sans un deps.edn préexistant
  • ajout de l'indicateur de format -F:cli pour imprimer deps comme option de ligne de commande dans le binaire `clojure`
• 2018-06-17
  • remplacez l'indicateur -S par -s pour éviter tout conflit avec tools.deps cli
  • permettre de regrouper les invocations pour produire une carte deps.edn fusionnée
  • activer la sauvegarde de la carte deps.edn au format : save
  • renommé :merged en :merge
• 2018-06-16
  • Engagement initial

Utilisation de la CLI

Pour utiliser find-deps depuis la ligne de commande, créez un alias dans votre map ~/.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 " ]}}}

Vous pouvez appeler find-deps avec -h pour voir les options prises en charge :

% 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

Exemples

Recherchez une dépendance telle que http-kit :

clj -A:find-deps http-kit

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

Recherchez plusieurs dépendances :

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 " }}}

Enchaînez plusieurs appels en utilisant différents arguments de requête :

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 " }}}

Fusionnez les résultats de la recherche dans le deps.edn du projet actuel. Vous pouvez également enregistrer ces résultats dans deps.edn en spécifiant :save à la place.

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
 }

Recherche de chaîne renvoyant plusieurs correspondances dans un tableau :

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 |

Imprimez une invocation en ligne de commande des 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

L'espace de noms find-deps.core contient un certain nombre d'assistants que vous pouvez utiliser à partir du REPL. En supposant que vous ayez un alias pour 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"}}}

Voir l'espace de noms find-deps.core pour plus d'aides.

Avenir

• [ ] recherchez sur github les fichiers deps.edn
• [ ] recherchez sur github les fichiers project.clj
  • [ ] classement des pages basé sur le graphique de dépendance
  • [ ] a recommandé d'autres dépendances basées sur le clustering
• [ ] incorporer le nombre de téléchargements dans le facteur de pondération
• [x] prise en charge de l'écriture directement dans deps.edn
• [ ] prend en charge add-lib
• [ ] ajouter la prise en charge de la validation à l'analyseur cli