[](https://github.com/kaz-utashiro/greple-frame/actions) [](https://metacpan.org/release/App-Greple-frame)
# NAME
App::Greple::frame - Greple frame output module
# SYNOPSIS
greple -Mframe --frame ...
# DESCRIPTION
Greple -Mframe module provide a capability to put surrounding frames
for each blocks.
`top`, `middle` and `bottom` frames are printed for blocks.
By default **--join-blocks** option is enabled to collect consecutive
lines into a single block. If you don't like this, override it by
**--no-join-blocks** option.
# OPTIONS
- **--frame**
Set frame and fold long lines with frame-friendly prefix string.
Folding width is taken from the terminal. Or you can specify the
width by calling **set** function with module option.
- **--set-frame-width**=_#_
Set frame width. You have to put this option before **--frame**
option. See **set** function in ["FUNCTION"](#function) section.
# FUNCTION
- **set**(**width**=_n_)
Set terminal width to _n_. Use like this:
greple -Mframe::set(width=80) ...
greple -Mframe::set=width=80 ...
If non-digit character is found in the value part, it is considered as
a Reverse Polish Notation, starting terminal width pushed on the
stack. RPN `2/3-` means `terminal-width / 2 - 3`.
You can use like this:
greple -Mframe::set=width=2/3- --frame --uc '(\w+::)+\w+' --git | ansicolumn -PC2
# SEE ALSO
[App::ansifold](https://metacpan.org/pod/App%3A%3Aansifold)
[Math::RPN](https://metacpan.org/pod/Math%3A%3ARPN)
# AUTHOR
Kazumasa Utashiro
# LICENSE
Copyright 2022 Kazumasa Utashiro.
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.
