pretty_array 1.0.0
Pretty D Arrays
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
pretty_d_array
Pretty printing multidimensional D arrays.
This small package uses awesome mir-algorithm library as a dependency.
Simply put, it is a small dub package that turns your D arrays from this:
[[[1, 2, 3, 4, 5, 6, 7, 8], [9, 10, 11, 12, 13, 14, 15, 16], [17, 18, 19, 20, 21, 22, 23, 24], [25, 26, 27, 28, 29, 30, 31, 32], [33, 34, 35, 36, 37, 38, 39, 40], [41, 42, 43, 44, 45, 46, 47, 48], [49, 50, 51, 52, 53, 54, 55, 56]],
[[57, 58, 59, 60, 61, 62, 63, 64], [65, 66, 67, 68, 69, 70, 71, 72], [73, 74, 75, 76, 77, 78, 79, 80], [81, 82, 83, 84, 85, 86, 87, 88], [89, 90, 91, 92, 93, 94, 95, 96], [97, 98, 99, 100, 101, 102, 103, 104], [105, 106, 107, 108, 109, 110, 111, 112]]]
into this
┌ ┐
│┌ ┐│
││ 1 2 3 4 5 6 7 8││
││ 9 10 11 12 13 14 15 16││
││ 17 18 19 20 21 22 23 24││
││ 25 26 27 28 29 30 31 32││
││ 33 34 35 36 37 38 39 40││
││ 41 42 43 44 45 46 47 48││
││ 49 50 51 52 53 54 55 56││
│└ ┘│
│┌ ┐│
││ 57 58 59 60 61 62 63 64││
││ 65 66 67 68 69 70 71 72││
││ 73 74 75 76 77 78 79 80││
││ 81 82 83 84 85 86 87 88││
││ 89 90 91 92 93 94 95 96││
││ 97 98 99 100 101 102 103 104││
││105 106 107 108 109 110 111 112││
│└ ┘│
└ ┘
I think it's much easier to reason about array structure using such simplified form. Let's see a code example.
import pretty_array;
import std.stdio;
import std.array;
import std.range : chunks;
void main() {
auto arr = [10.4, 200.14, -40.203, 0.00523, 5, 2.56, 39.901, 56.12, 2.5, 1.2, -0.22103, 89091, 3, 5, 1, 0];
auto arr3D = darr.chunks(4).array.chunks(2).array; // convert it to [2 x 2 x 4] array
arr3D.prettyArr.writeln;
}
┌ ┐
│┌ ┐│
││10.4 200.14 -40.203 0.00523││
││ 5 2.56 39.901 56.12││
│└ ┘│
│┌ ┐│
││ 2.5 1.2 -0.22103 89091││
││ 3 5 1 0││
│└ ┘│
└ ┘
prettyArr
also truncates big enough arrays to save screen space. You can configure max number of elements allowed before truncation.
auto bigArr = [300, 600].iota.int!(1).fuze;
bigArr.prettyArr.writeln;
Will truncate the array into the following.
┌ ┐
│ 1 2 3 ░ 598 599 600│
│ 601 602 603 ░ 1198 1199 1200│
│ 1201 1202 1203 ░ 1798 1799 1800│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│178201 178202 178203 ░ 178798 178799 178800│
│178801 178802 178803 ░ 179398 179399 179400│
│179401 179402 179403 ░ 179998 179999 180000│
└ ┘
pretty_array
package contains
prettyArr
-- a function that converts an array into a pretty string.PrettyArrConfig
-- array formatting configuration.
Formatting Configuration
You can configure some of the default formatting parameters via PrettyArrConfig
.
edgeItems
-- number of items preceding and following the truncation symbol (defaults to 3).lineWidth
-- max line width allowed without truncation (defaults to 120).precision
-- precision of floating point representations (defaults to 6).suppressExp
-- suppress scientific notation (defaults to true).threshold
-- max array size allowed without truncation (default is 1000 elements).
Here are couple of usage examples.
auto a = [[0.000023, 1.234023, 13.443333], [479.311231, -100.001001, -0.412223]];
PrettyArrConfig.precision = 2;
a.prettyArr.writeln;
Will reduce the default floating precision from 6 to 2.
┌ ┐
│ 0.00 1.23 13.44│
│479.31 -100.00 -0.41│
└ ┘
You can also enable scientific notation via e suffix.
auto a = [[0.000023, 1.234023, 13.443333], [479.311231, -100.001001, -0.412223]];
PrettyArrConfig.suppressExp = false;
a.prettyArr.writeln;
┌ ┐
│2.300000e-05 1.234023e+00 1.344333e+01│
│4.793112e+02 -1.000010e+02 -4.122230e-01│
└ ┘
Configuring Special Symbols
If for some reason you don't like the awesome truncation symbol ░
, or pretty array frames, you can always edit them in the source code.
Search pretty_array.d
for
private enum Frame : string
{
ltAngle = "┌",
lbAngle = "└",
rtAngle = "┐",
rbAngle = "┘",
vBar = "│",
newline = "\n",
dash = "─",
dot = "·",
space = " ",
truncStr = "░" // TIP: length of this string is 3!
}
However, keep in mind that you'll have to modify truncLen - 3
in getMaxStrLenAndMaxRow
template by setting -3
modifier to the length of your new truncation symbol.
- 1.0.0 released 4 years ago
- tastyminerals/pretty-d-array
- MIT
- Authors:
- Dependencies:
- mir-algorithm
- Versions:
-
1.0.3 2022-May-01 1.0.2 2021-Nov-08 1.0.1 2020-Jun-18 1.0.0 2020-Jun-11 ~master 2022-May-01 - Download Stats:
-
-
0 downloads today
-
0 downloads this week
-
0 downloads this month
-
0 downloads total
-
- Score:
- 1.3
- Short URL:
- pretty_array.dub.pm