| 1 | #/usr/bin/env perl | ||
| 2 | ############################################################################### | ||
| 3 | # | ||
| 4 | # @file Bench.pm | ||
| 5 | # | ||
| 6 | # @brief API::Eulerian::EDW Bench module used to get elapsed time of script stages. | ||
| 7 | # | ||
| 8 | # @author Thorillon Xavier:x.thorillon@eulerian.com | ||
| 9 | # | ||
| 10 | # @date 25/11/2021 | ||
| 11 | # | ||
| 12 | # @version 1.0 | ||
| 13 | # | ||
| 14 | ############################################################################### | ||
| 15 | # | ||
| 16 | # Setup perl package name | ||
| 17 | # | ||
| 18 | package API::Eulerian::EDW::Bench; | ||
| 19 | # | ||
| 20 | # Enforce compilor rules. | ||
| 21 | # | ||
| 22 | use strict; use warnings; | ||
| 23 | # | ||
| 24 | # Import API::Eulerian::EDW::Chrono | ||
| 25 | # | ||
| 26 | use API::Eulerian::EDW::Chrono; | ||
| 27 | # | ||
| 28 | # @brief Allocate and initialize a new API::Eulerian::EDW::Bench instance. | ||
| 29 | # | ||
| 30 | # @param $class - API::Eulerian::EDW::Bench class. | ||
| 31 | # | ||
| 32 | # @return API::Eulerian::EDW::Bench instance. | ||
| 33 | # | ||
| 34 | sub new | ||
| 35 | { | ||
| 36 | return bless( { | ||
| 37 | _SUITE => {}, | ||
| 38 | _LAST => undef, | ||
| 39 | _FIRST => undef, | ||
| 40 | }, shift ); | ||
| 41 | } | ||
| 42 | # | ||
| 43 | # @brief Start chronograph. | ||
| 44 | # | ||
| 45 | # @param $self - API::Eulerian::EDW::Bench instance. | ||
| 46 | # | ||
| 47 | sub start | ||
| 48 | { | ||
| 49 | shift->last( new API::Eulerian::EDW::Chrono() ); | ||
| 50 | } | ||
| 51 | # | ||
| 52 | # @brief Get/Set First Stage. | ||
| 53 | # | ||
| 54 | # @param $self - API::Eulerian::EDW::Bench instance. | ||
| 55 | # @param $first - First stage. | ||
| 56 | # | ||
| 57 | # @return First stage. | ||
| 58 | # | ||
| 59 | sub first | ||
| 60 | { | ||
| 61 | my ( $self, $first ) = @_; | ||
| 62 | $self->{ _FIRST } = $first if defined( $first ); | ||
| 63 | return $self->{ _FIRST }; | ||
| 64 | } | ||
| 65 | # | ||
| 66 | # @brief Get/Set Last stage. | ||
| 67 | # | ||
| 68 | # @param $self - API::Eulerian::EDW::Bench instance. | ||
| 69 | # @param $last - Last stage. | ||
| 70 | # | ||
| 71 | # @retun Last stage. | ||
| 72 | # | ||
| 73 | sub last | ||
| 74 | { | ||
| 75 | my ( $self, $last ) = @_; | ||
| 76 | my $first = $self->first(); | ||
| 77 | $self->{ _LAST } = $last if defined( $last ); | ||
| 78 | $self->first( $last ) if ! defined( $first ); | ||
| 79 | return $self->{ _LAST }; | ||
| 80 | } | ||
| 81 | # | ||
| 82 | # @brief Stop watching current Stage save elapsed time. | ||
| 83 | # | ||
| 84 | # @param $self - API::Eulerian::EDW::Bench instance. | ||
| 85 | # @param $name - Stage name. | ||
| 86 | # | ||
| 87 | # @return Stage. | ||
| 88 | # | ||
| 89 | sub stage | ||
| 90 | { | ||
| 91 | my ( $self, $name ) = @_; | ||
| 92 | $self->{ _SUITE }->{ $name } = $self->last()->elapsed(); | ||
| 93 | } | ||
| 94 | # | ||
| 95 | # @brief Dump Bench stages suites. | ||
| 96 | # | ||
| 97 | # @param $self - API::Eulerian::EDW::Bench instance. | ||
| 98 | # | ||
| 99 | sub dump | ||
| 100 | { | ||
| 101 | my ( $self ) = @_; | ||
| 102 | my %suite = %{$self->{ _SUITE }}; | ||
| 103 | |||
| 104 | foreach my $key ( keys %suite ) { | ||
| 105 | printf( "%15s : %s\n", $key, $suite{ $key } ); | ||
| 106 | } | ||
| 107 | printf( "%15s : %s\n", 'total', $self->first()->elapsed() ); | ||
| 108 | |||
| 109 | } | ||
| 110 | # | ||
| 111 | # Endup module properly | ||
| 112 | # | ||
| 113 | 1; | ||
| 114 | |||
| 115 | __END__ |