NAME
App::Greple::tee - module permettant de remplacer le texte correspondant par le résultat de la commande externe
SYNOPSIS
greple -Mtee command -- ...VERSION
Version 1.02
DESCRIPTION
Le module -Mtee de Greple envoie les parties de texte correspondantes à la commande de filtrage donnée, et les remplace par le résultat de la commande. L'idée est dérivée de la commande appelée teip. C'est comme si on contournait des données partielles vers la commande de filtrage externe.
La commande de filtrage suit la déclaration du module (-Mtee) et se termine par deux tirets (--). Par exemple, la commande suivante appelle la commande tr avec les arguments a-z A-Z pour le mot correspondant dans les données.
greple -Mtee tr a-z A-Z -- '\w+' ...La commande ci-dessus convertit tous les mots correspondants des minuscules aux majuscules. En fait, cet exemple n'est pas très utile car greple peut faire la même chose plus efficacement avec l'option --cm.
Par défaut, la commande est exécutée en tant que processus unique, et toutes les données correspondantes sont envoyées au processus mélangées. Si le texte correspondant ne se termine pas par une nouvelle ligne, il est ajouté avant l'envoi et supprimé après la réception. Les données d'entrée et de sortie sont mises en correspondance ligne par ligne, de sorte que le nombre de lignes d'entrée et de sortie doit être identique.
En utilisant l'option --discrete, une commande individuelle est appelée pour chaque zone de texte correspondant. Les commandes suivantes permettent de faire la différence.
greple -Mtee cat -n -- copyright LICENSE
greple -Mtee cat -n -- copyright LICENSE --discreteIl n'est pas nécessaire que les lignes de données d'entrée et de sortie soient identiques lorsque l'option --discrete est utilisée.
OPTIONS
- --discrete
-
Lancez une nouvelle commande individuellement pour chaque pièce correspondante.
- --bulkmode
-
Avec l'option <--discrete>, chaque commande est exécutée à la demande. Cette option remplace tous les caractères de nouvelle ligne au milieu de chaque bloc par des caractères de retour chariot. <--bulkmode> option causes all conversions to be performed at once.
- --crmode
-
Cette option remplace tous les caractères de nouvelle ligne au milieu de chaque bloc par des caractères de retour chariot. Les retours chariot contenus dans le résultat de l'exécution de la commande sont ramenés au caractère de nouvelle ligne. Ainsi, les blocs composés de plusieurs lignes peuvent être traités par lots sans utiliser l'option --discrete.
- --fillup
-
Combiner une séquence de lignes non vides en une seule ligne avant de les passer à la commande de filtrage. Les caractères de nouvelle ligne entre les caractères de grande largeur sont supprimés, et les autres caractères de nouvelle ligne sont remplacés par des espaces.
- --squeeze
-
Combine deux ou plusieurs caractères de retour à la ligne consécutifs en un seul.
- -ML --offload command
-
L'option --offload de teip(1) est implémentée dans le module App::Greple::L (-ML).
greple -Mtee cat -n -- -ML --offload 'seq 10 20'Vous pouvez également utiliser le module -ML pour ne traiter que les lignes paires, comme suit.
greple -Mtee cat -n -- -ML 2::2
LEGACIES
L'option --blocs n'est plus nécessaire maintenant que l'option --stretch (-S) a été implémentée dans greple. Vous pouvez simplement procéder comme suit.
greple -Mtee cat -n -- --all -SE fooIl n'est pas recommandé d'utiliser l'option --blocks car elle pourrait être dépréciée à l'avenir.
- --blocks
-
Normalement, la zone correspondant au modèle de recherche spécifié est envoyée à la commande externe. Si cette option est spécifiée, ce n'est pas la zone correspondant au motif de recherche qui sera traitée, mais l'ensemble du bloc qui la contient.
Par exemple, pour envoyer à la commande externe des lignes contenant le motif
foo, vous devez spécifier le motif correspondant à la ligne entière :greple -Mtee cat -n -- '^.*foo.*\n' --allMais avec l'option --blocks, cela peut être fait aussi simplement que suit :
greple -Mtee cat -n -- foo --blocksAvec l'option --blocs, ce module se comporte plus comme l'option -g de teip(1). Sinon, le comportement est similaire à celui de teip(1) avec l'option -o.
N'utilisez pas l'option --blocks avec l'option --all, car le bloc sera la totalité des données.
WHY DO NOT USE TEIP
Tout d'abord, chaque fois que vous pouvez le faire avec la commande teip, utilisez-la. C'est un excellent outil et beaucoup plus rapide que greple.
Comme greple est conçu pour traiter des fichiers de documents, il possède de nombreuses fonctionnalités qui lui sont appropriées, comme les contrôles de la zone de correspondance. Il peut être intéressant d'utiliser greple pour profiter de ces fonctionnalités.
Par ailleurs, teip ne peut pas traiter plusieurs lignes de données comme une seule unité, alors que greple peut exécuter des commandes individuelles sur un fragment de données composé de plusieurs lignes.
EXAMPLE
La commande suivante trouvera des blocs de texte dans le document de style perlpod(1) inclus dans le fichier du module Perl.
greple --inside '^=(?s:.*?)(^=cut|\z)' --re '^([\w\pP].+\n)+' tee.pmVous pouvez les traduire par le service DeepL en exécutant la commande ci-dessus combinée avec le module -Mtee qui appelle la commande deepl comme ceci :
greple -Mtee deepl text --to JA - -- --fillup ...Le module dédié App::Greple::xlate::deepl est plus efficace dans ce but, cependant. En fait, l'indice d'implémentation du module tee vient du module xlate.
EXAMPLE 2
La prochaine commande trouvera une partie indentée dans le document LICENSE.
greple --re '^[ ]{2}[a-z][)] .+\n([ ]{5}.+\n)*' -C LICENSE
a) distribute a Standard Version of the executables and library files,
together with instructions (in the manual page or equivalent) on where to
get the Standard Version.
b) accompany the distribution with the machine-readable source of the Package
with your modifications.Vous pouvez reformater cette partie en utilisant le module tee avec la commande ansifold :
greple -Mtee ansifold -rsw40 --prefix ' ' -- --discrete --re ...
a) distribute a Standard Version of
the executables and library files,
together with instructions (in the
manual page or equivalent) on where
to get the Standard Version.
b) accompany the distribution with the
machine-readable source of the
Package with your modifications.L'option --discrete démarre plusieurs processus, ce qui allonge la durée d'exécution du processus. Vous pouvez donc utiliser l'option --separate '\r' avec ansifold qui produit une seule ligne en utilisant le caractère CR au lieu du caractère NL.
greple -Mtee ansifold -rsw40 --prefix ' ' --separate '\r' --Ensuite, convertissez le caractère CR en NL à l'aide de la commande tr(1) ou d'une autre commande.
... | tr '\r' '\n'EXAMPLE 3
Considérons une situation dans laquelle vous souhaitez rechercher des chaînes de caractères dans des lignes autres que l'en-tête. Par exemple, vous pouvez rechercher les noms d'images Docker de la commande docker image ls, mais laisser la ligne d'en-tête. Vous pouvez le faire à l'aide de la commande suivante.
greple -Mtee grep perl -- -ML 2: --discrete --allL'option -ML 2: récupère l'avant-dernière ligne et l'envoie à la commande grep perl. L'option --discrete est nécessaire car le nombre de lignes d'entrée et de sortie change, mais comme la commande n'est exécutée qu'une seule fois, il n'y a pas d'inconvénient en termes de performances.
Si vous essayez de faire la même chose avec la commande teip, teip -l 2- -- grep donnera une erreur parce que le nombre de lignes de sortie est inférieur au nombre de lignes d'entrée. Le résultat obtenu ne pose cependant aucun problème.
INSTALL
CPANMINUS
$ cpanm App::Greple::teeSEE ALSO
App::Greple::tee, https://github.com/kaz-utashiro/App-Greple-tee
https://github.com/greymd/teip
App::Greple, https://github.com/kaz-utashiro/greple
https://github.com/tecolicom/Greple
BUGS
L'option --fillup supprime les espaces entre les caractères Hangul lors de la concaténation de textes coréens.
AUTHOR
Kazumasa Utashiro
LICENSE
Copyright © 2023-2025 Kazumasa Utashiro.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.