Dependencies en plugins beheren

In elk realistisch project heb je externe bibliotheken nodig om functionaliteit toe te voegen zonder alles vanaf nul te schrijven. Deze worden ook afhankelijkheden genoemd.

Buildtools zoals Leiningen en Deps.edn helpen je deze bibliotheken te beheren, zodat je ze eenvoudig automatisch kunt toevoegen, bijwerken en verwijderen.

Met Leiningen declareer je afhankelijkheden in het bestand project.clj. Ze komen in de vector :dependencies, die een lijst bevat van de bibliotheken die je project nodig heeft.

Elke afhankelijkheid is zelf een vector met de groeps-ID, artefact-ID en versie van de bibliotheek, bijvoorbeeld:

• [group-id/artifact-id "version"]

Om een externe bibliotheek zoals tick (een eenvoudige tijdbibliotheek) te gebruiken, voeg je deze eerst onder de sleutel :dependencies toe aan je bestand project.clj:

:dependencies [[org.clojure/clojure "1.11.1"]
               [tick "0.5.0-RC1"]]

Daarna kun je de bibliotheek in je namespace require en de functies ervan gebruiken. Probeer dit voorbeeld uit:

Met deps.edn declareer je afhankelijkheden in de toewijzing :deps. Dit bestand staat meestal in de hoofdmap van je project.

Elke vermelding in :deps koppelt een bibliotheeknaam aan een toewijzing met de bron ervan, meestal :mvn/version voor bibliotheken uit Maven Central:

• {library-name {:mvn/version "version"}}

Om dezelfde bibliotheek tick met deps.edn te gebruiken, voeg je deze als volgt toe aan je bestand deps.edn:

{:paths ["src"]
 :deps {tick/tick {:mvn/version "0.5.0-RC1"}}}

Met deze configuratie kan je code, bijvoorbeeld in src/my_app/core.clj, de bibliotheek vereisen en gebruiken. Probeer deze uit te voeren:

Wanneer je een bibliotheek toevoegt, is die vaak zelf afhankelijk van andere bibliotheken om correct te werken. Dit zijn transitieve afhankelijkheden.

Je buildtool haalt deze automatisch ook op. De bibliotheek tick kan bijvoorbeeld afhankelijk zijn van clojure.java.time, die dan ook wordt gedownload.

Zo hoef je niet handmatig elke vereiste bibliotheek voor je project bij te houden.

Soms moet je een transitieve afhankelijkheid uitsluiten. Meestal doe je dit om versieconflicten met andere bibliotheken te voorkomen of de totale omvang van je project te verkleinen.

In Leiningen kun je de sleutel :exclusions gebruiken binnen een afhankelijkheidsvector. Als je bijvoorbeeld clojure.java.time uit tick wilt uitsluiten:

Plug-ins breiden de functionaliteit van je buildtool zelf uit. Ze kunnen nieuwe taken toevoegen, processen automatiseren of integreren met andere ontwikkeltools.

Veelvoorkomende toepassingen zijn codeopmaak, statische analyse, implementatie of het uitvoeren van specifieke testsuites.

Plug-ins verschillen van gewone afhankelijkheden: ze werken op het buildproces van het project en leveren niet alleen bibliotheken voor de code van je toepassing.

Leiningen ondersteunt plug-ins die je onder de sleutel :plugins in je project.clj definieert. Bekijk bijvoorbeeld lein-ancient, waarmee je kunt controleren op verouderde afhankelijkheden.

Je voegt [lein-ancient "0.6.15"] toe aan je vector :plugins. Daarna kun je vanuit je terminal lein ancient check uitvoeren om te controleren of je bibliotheken up-to-date zijn.

Goed gedaan! In deze les hebben we behandeld:

• Hoe je externe bibliotheken (afhankelijkheden) toevoegt met zowel Leiningen project.clj als Deps.edn deps.edn.
• Het concept van transitieve afhankelijkheden en hoe deze automatisch worden beheerd.
• Hoe je specifieke transitieve afhankelijkheden in Leiningen uitsluit.
• De rol van plug-ins bij het uitbreiden van de functionaliteit van buildtools, los van gewone bibliotheken.

Goed beheer van afhankelijkheden en plug-ins is cruciaal voor het onderhouden van gezonde, efficiënte Clojure-projecten. Blijf nieuwe bibliotheken en tools ontdekken!