/ 
App-Greple-tee-1.02
River stage zero No dependents
/ App::Greple::tee

NAME

App::Greple::tee - module om gematchte tekst te vervangen door het externe opdrachtresultaat

SYNOPSIS

greple -Mtee command -- ...

VERSION

Version 1.02

DESCRIPTION

Greple's -Mtee module stuurt gematchte tekstdelen naar het gegeven filtercommando, en vervangt ze door het resultaat van het commando. Het idee is afgeleid van het commando teip. Het is als het omzeilen van gedeeltelijke gegevens naar het externe filtercommando.

Het filtercommando volgt op de moduleverklaring (-Mtee) en eindigt met twee streepjes (--). Bijvoorbeeld, het volgende commando roept commando tr op met a-z A-Z argumenten voor het gezochte woord in de gegevens.

greple -Mtee tr a-z A-Z -- '\w+' ...

Bovenstaand commando zet alle overeenkomende woorden om van kleine letters naar hoofdletters. Eigenlijk is dit voorbeeld zelf niet zo nuttig omdat greple hetzelfde effectiever kan doen met de optie --cm.

Standaard wordt de opdracht als een enkel proces uitgevoerd en worden alle gematchte gegevens door elkaar naar het proces gestuurd. Als de gematchte tekst niet eindigt met een newline, wordt deze toegevoegd voor het verzenden en verwijderd na het ontvangen. Invoer- en uitvoergegevens worden regel voor regel in kaart gebracht, dus het aantal regels invoer en uitvoer moet identiek zijn.

Met de optie --discrete wordt voor elk gematcht tekstgebied een afzonderlijk commando aangeroepen. Je kunt het verschil zien aan de hand van de volgende opdrachten.

greple -Mtee cat -n -- copyright LICENSE
greple -Mtee cat -n -- copyright LICENSE --discrete

Bij gebruik van de optie --discreet hoeven de regels invoer- en uitvoergegevens niet identiek te zijn.

OPTIONS

--discrete

Roep nieuw commando individueel op voor elk onderdeel.

--bulkmode

Met de optie <--discrete> wordt elk commando op verzoek uitgevoerd. De <--bulkmode> option causes all conversions to be performed at once.

--crmode

Deze optie vervangt alle newline-tekens in het midden van elk blok door carriage return-tekens. Carriage returns in het resultaat van het uitvoeren van de opdracht worden teruggezet naar het newline karakter. Zo kunnen blokken die uit meerdere regels bestaan in batches worden verwerkt zonder de optie --discrete te gebruiken.

--fillup

Combineer een reeks niet-blanke regels tot één regel voordat je ze doorgeeft aan de filteropdracht. Newline-tekens tussen tekens met een grote breedte worden verwijderd en andere newline-tekens worden vervangen door spaties.

--squeeze

Combineert twee of meer opeenvolgende newline-tekens tot één.

-ML --offload command

De optie --offload van teip(1) is geïmplementeerd in de andere module App::Greple::L (-ML).

greple -Mtee cat -n -- -ML --offload 'seq 10 20'

Je kunt de module -ML ook gebruiken om alleen even genummerde regels te verwerken, als volgt.

greple -Mtee cat -n -- -ML 2::2

LEGACIES

De optie -blokken is niet langer nodig nu de optie --stretch (-S) is geïmplementeerd in greple. Je kunt gewoon het volgende uitvoeren.

greple -Mtee cat -n -- --all -SE foo

Het wordt niet aangeraden om -blokken te gebruiken omdat deze optie in de toekomst mogelijk niet meer gebruikt zal worden.

--blocks

Normaal gesproken wordt het gebied dat overeenkomt met het opgegeven zoekpatroon naar de externe opdracht gestuurd. Als deze optie is opgegeven, wordt niet het gebied dat overeenkomt, maar het hele blok dat het bevat, verwerkt.

Om bijvoorbeeld regels met het patroon foo naar de externe opdracht te sturen, moet je het patroon opgeven dat overeenkomt met de hele regel:

greple -Mtee cat -n -- '^.*foo.*\n' --all

Maar met de optie -blokken kan het als volgt:

greple -Mtee cat -n -- foo --blocks

Met de -blokken optie gedraagt deze module zich meer als de -g optie van teip(1). Anders is het gedrag gelijkaardig aan teip(1) met de -o optie.

Gebruik de -blokken niet met de --all optie, aangezien het blok dan de volledige gegevens zijn.

WHY DO NOT USE TEIP

Allereerst, wanneer u het kunt doen met het commando -teip, gebruik het. Het is een uitstekend hulpmiddel en veel sneller dan greple.

Omdat greple is ontworpen om documentbestanden te verwerken, heeft het veel functies die daarvoor geschikt zijn, zoals controles van het matchgebied. Het kan de moeite waard zijn om greple te gebruiken om van die functies te profiteren.

Ook kan teip niet omgaan met meerdere regels gegevens als een enkele eenheid, terwijl greple individuele opdrachten kan uitvoeren op een gegevensbrok die uit meerdere regels bestaat.

EXAMPLE

Het volgende commando vindt tekstblokken in perlpod(1) stijldocument opgenomen in het Perl-modulebestand.

greple --inside '^=(?s:.*?)(^=cut|\z)' --re '^([\w\pP].+\n)+' tee.pm

U kunt ze vertalen door DeepL service door het bovenstaande commando uit te voeren in combinatie met -Mtee module die het commando deepl als volgt oproept:

greple -Mtee deepl text --to JA - -- --fillup ...

De speciale module App::Greple::xlate::deepl is echter effectiever voor dit doel. In feite kwam de implementatiehint van de module tee van de module xlate.

EXAMPLE 2

Het volgende commando vindt een ingesprongen deel in het LICENSE document.

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.

U kunt dit deel opnieuw formatteren door de module tee te gebruiken met het commando 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.

De --discrete optie zal meerdere processen starten, dus het proces zal langer duren om uit te voeren. Je kunt dus de optie --separate '\r' gebruiken met ansifold, die een enkele regel produceert met het karakter CR in plaats van NL.

greple -Mtee ansifold -rsw40 --prefix '     ' --separate '\r' --

Converteer vervolgens CR naar NL met tr(1) of iets dergelijks.

... | tr '\r' '\n'

EXAMPLE 3

Denk aan een situatie waarin je wilt grepen naar tekenreeksen buiten de kopregels. Bijvoorbeeld, je wilt zoeken naar Docker image namen van het docker image ls commando, maar laat de header regel staan. Je kunt dit doen met het volgende commando.

greple -Mtee grep perl -- -ML 2: --discrete --all

Optie -ML 2: haalt de voorlaatste regels op en stuurt ze naar het commando grep perl. De optie --discrete is nodig omdat het aantal regels invoer en uitvoer verandert, maar omdat het commando maar één keer wordt uitgevoerd, is er geen nadeel voor de prestaties.

Als je hetzelfde probeert te doen met het teip commando, zal teip -l 2- -- grep een foutmelding geven omdat het aantal uitvoerregels minder is dan het aantal invoerregels. Er is echter geen probleem met het verkregen resultaat.

INSTALL

CPANMINUS

$ cpanm App::Greple::tee

SEE 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

App::Greple::xlate

BUGS

De optie --fillup verwijdert spaties tussen Hangul-tekens bij het aaneenschakelen van Koreaanse tekst.

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.