SwiftLint est le meilleur outil pour appliquer les normes de codage et les meilleures pratiques. Il est livré avec des règles prédéfinies qui peuvent être personnalisées pour répondre aux besoins de chaque projet. Cependant, il arrive que les règles intégrées ne répondent pas aux exigences du projet. Dans de tels cas, nous écrivons des expressions régulières pour combler le vide.  Bien que regex soit un outil puissant, la création de règles complexes peut être difficile, voire impossible. C'est là qu'interviennent les règles natives SwiftLint. Elles ressemblent aux règles fournies avec SwiftLint - elles sont écrites en Swift, efficaces et peuvent détecter plus de violations que les regex.   https://twitter.com/simjp/status/1558168307756318720?s=20&embedable=true  Le projet final peut être trouvé à  https://github.com/jpsim/swiftlint-bazel-example  Configuration du projet  Installez Bazel s'il n'est pas installé.   brew list --formula | grep -q "bazel" || brew install bazel  Commencez par créer un nouveau répertoire.   mkdir MySwiftLintRules && cd MySwiftLintRules  Ensuite, configurez un nouvel espace de travail Bazel. Cela implique de créer plusieurs fichiers et d'activer bzlmod :   touch .bazelrc WORKSPACE MODULE.bazel BUILD && echo "common --enable_bzlmod" > .bazelrc  Ajouter le code passe-partout au  MODULE.bazel   module( name = "swiftlint-bazel-example", version = "0.0.0", compatibility_level = 1 ) bazel_dep(name = "swiftlint", version = "0.51.0", repo_name = "SwiftLint") extra_rules = use_extension("@SwiftLint//bazel:extensions.bzl", "extra_rules") extra_rules.setup(srcs = "@swiftlint-bazel-example//swiftlint_extra_rules:extra_rules") bazel_dep(name = "rules_xcodeproj", version = "1.4.0")  Ajoutez le code passe-partout au fichier   . Cela ajoutera la prise en charge de Xcode pour notre projet Bazel. BUILD   load("@rules_xcodeproj//xcodeproj:defs.bzl", "xcodeproj") xcodeproj( name = "swiftlint_xcodeproj", project_name = "SwiftLint", tags = ["manual"], top_level_targets = [ "@SwiftLint//:swiftlint", "@SwiftLint//Tests:ExtraRulesTests", ], )  Créez un répertoire pour stocker le code source de vos règles.   mkdir swiftlint_extra_rules && touch swiftlint_extra_rules/Rules.swift && touch swiftlint_extra_rules/BUILD  Et pour la dernière fois, collez le code passe-partout dans le fichier  swiftlint_extra_rules/BUILD   filegroup( name = "extra_rules", srcs = glob(["**/*.swift"]), visibility = ["//visibility:public"], )  À ce stade, vous devriez pouvoir créer SwiftLint à l'aide de la commande   . bazel build  Développer des règles avec Xcode  Nous avons ajouté la dépendance   à notre projet pour faciliter le développement de vos règles personnalisées. Alors, générons notre projet : rules_xcodeproj   bazel run swiftlint_xcodeproj && open SwiftLint.xcodeproj -a Xcode  Maintenant, nous pouvons construire et déboguer le schéma   . Vous pouvez utiliser cette application comme d'habitude avec le binaire Swiftlint installé à partir de l'homebrew. swiftlint  Essayez de l'exécuter sur votre projet : cliquez sur le nom du schéma dans la   , cliquez sur "Modifier le schéma…", et définissez le "Répertoire de travail" dans l'onglet "Options" sur le chemin où vous souhaitez exécuter SwiftLint. barre d'outils de la fenêtre de votre projet  Pour plus d'informations sur le développement de règles SwiftLint natives, consultez   de SwiftLint CONTRIBUTING.md  Ajout d'une règle personnalisée  Dans cet exemple, nous créons la "règle var interdite", comme indiqué dans le didacticiel vidéo sur   . https://vimeo.com/819268038  Copiez et collez ce code dans le fichier   , puis exécutez le schéma   dans Xcode. Rules.swift swiftlint   import SwiftSyntax // This function should return an array containing all of your custom rules func extraRules() -> [Rule.Type] { [ForbiddenVarRule.self] } struct ForbiddenVarRule: ConfigurationProviderRule, SwiftSyntaxRule { var configuration = SeverityConfiguration(.error) init() {} static let description = RuleDescription( identifier: "forbidden_var", name: "Forbidden Var", description: "Variables should not be called 'forbidden'", kind: .idiomatic, nonTriggeringExamples: [ Example("let notForbidden = 0") ], triggeringExamples: [ Example("let ↓forbidden = 0") ] ) func makeVisitor(file: SwiftLintFile) -> ViolationsSyntaxVisitor { Visitor(viewMode: .sourceAccurate) } } private extension ForbiddenVarRule { final class Visitor: ViolationsSyntaxVisitor { override func visitPost(_ node: IdentifierPatternSyntax) { if node.identifier.text == "forbidden" { violations.append(node.identifier.positionAfterSkippingLeadingTrivia) } } } }  Et c'est tout! Vous avez créé une règle SwiftLint personnalisée et l'avez intégrée dans votre projet Swift à l'aide de Bazel. Avec cette configuration, vous pouvez créer et tester autant de règles personnalisées que nécessaire, ce qui vous aide à vous assurer que votre code reste cohérent et conforme aux normes de codage de votre équipe.  Bonne peluche !

Read My Stories

Cet audio est produit dans la langue originale de l'histoire !

Adoptez la puissance des règles SwiftLint personnalisées et dites adieu à Regex

About Author

COMMENTAIRES

ÉTIQUETTES

CET ARTICLE A ÉTÉ PARU DANS

Related Stories

La fuite de l'invite du système Claude Sonnet 3.5 : une analyse médico-légale

Guide de l'architecte pour créer une architecture de référence pour un datalake IA/ML

Les couches invisibles : pourquoi les entretiens avec les utilisateurs sont un atout irremplaçable

HackerNoon Decoded: The Top 10 Countries Where HackerNoon Is the Most Active

La fuite de l'invite du système Claude Sonnet 3.5 : une analyse médico-légale

Guide de l'architecte pour créer une architecture de référence pour un datalake IA/ML

Les couches invisibles : pourquoi les entretiens avec les utilisateurs sont un atout irremplaçable

HackerNoon Decoded: The Top 10 Countries Where HackerNoon Is the Most Active

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps