/
progressmonitor.php
208 lines (195 loc) · 5.45 KB
/
progressmonitor.php
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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
<?php
/**
* File containing the ezcConsoleProgressMonitor class.
*
* @package ConsoleTools
* @version 1.1
* @copyright Copyright (C) 2005, 2006 eZ systems as. All rights reserved.
* @license http://ez.no/licenses/new_bsd New BSD License
* @filesource
*/
/**
* Printing structured status information on the console.
*
* <code>
* // Construction
* $status = new ezcConsoleProgressMonitor( new ezcConsoleOutput(), 42 );
*
* // Run statusbar
* foreach ( $files as $file )
* {
* $res = $file->upload();
* // Add a status-entry to be printed.
* $status->addEntry( 'UPLOAD', $file->path );
* // Result like " 2.5% UPLOAD /var/upload/test.png"
* }
* </code>
*
*
* @package ConsoleTools
* @version 1.1
*/
class ezcConsoleProgressMonitor
{
/**
* Options
*
* @var ezcConsoleProgressMonitorOptions
*/
protected $options;
/**
* The ezcConsoleOutput object to use.
*
* @var ezcConsoleOutput
*/
protected $outputHandler;
/**
* Counter for the items already printed.
*
* @var int
*/
protected $counter = 0;
/**
* The number of entries to expect.
*
* @var int
*/
protected $max;
/**
* Creates a new progress monitor.
*
* @param ezcConsoleOutput $outHandler Handler to utilize for output
* @param int $max Number of items to expect
* @param array(string=>string) Options.
*
* @see ezcConsoleProgressMonitor::$options
*/
public function __construct( ezcConsoleOutput $outHandler, $max, array $options = array() )
{
$this->outputHandler = $outHandler;
$this->max = $max;
$this->options = new ezcConsoleProgressMonitorOptions( $options );
}
/**
* Property read access.
*
* @param string $key Name of the property.
* @return mixed Value of the property or null.
*
* @throws ezcBasePropertyNotFoundException
* If the the desired property is not found.
*/
public function __get( $key )
{
switch ( $key )
{
case 'options':
return $this->options;
break;
}
throw new ezcBasePropertyNotFoundException( $key );
}
/**
* Property write access.
*
* @param string $propertyName Name of the property.
* @param mixed $val The value for the property.
*
* @throws ezcBaseValueException
* If a the value for the property options is not an instance of
* ezcConsoleProgressMonitorOptions.
* @return void
*/
public function __set( $propertyName, $val )
{
switch ( $propertyName )
{
case 'options':
if ( !( $val instanceof ezcConsoleProgressMonitorOptions ) )
{
throw new ezcBaseValueException( $key, $val, 'instance of ezcConsoleProgressMonitorOptions' );
}
$this->options = $val;
return;
}
throw new ezcBasePropertyNotFoundException( $propertyName );
}
/**
* Property isset access.
*
* @param string $propertyName Name of the property.
* @return bool True is the property is set, otherwise false.
*/
public function __isset( $propertyName )
{
switch ( $propertyName )
{
case 'options':
return true;
}
return false;
}
/**
* Set new options.
* This method allows you to change the options of an progress monitor.
*
* @param ezcConsoleProgressMonitorOptions $options The options to set.
*
* @throws ezcBaseSettingNotFoundException
* If you tried to set a non-existent option value.
* @throws ezcBaseSettingValueException
* If the value is not valid for the desired option.
* @throws ezcBaseValueException
* If you submit neither an array nor an instance of
* ezcConsoleProgressMonitorOptions.
*/
public function setOptions( $options )
{
if ( is_array( $options ) )
{
$this->options->merge( $options );
}
else if ( $options instanceof ezcConsoleProgressMonitorOptions )
{
$this->options = $options;
}
else
{
throw new ezcBaseValueException( "options", $options, "instance of ezcConsoleProgressMonitorOptions" );
}
}
/**
* Returns the currently set options.
* Returns the currently set option array.
*
* @return ezcConsoleProgressMonitorOptions The options.
*/
public function getOptions()
{
return $this->options;
}
/**
* Print a status entry.
* Prints a new status entry to the console and updates the internal counter.
*
* @param string $tag The tag to print (second argument in the
* formatString).
* @param string $data The data to be printed in the status entry (third
* argument in the format string).
* @return void
*/
public function addEntry( $tag, $data )
{
$this->counter++;
$percentage = $this->counter / $this->max * 100;
$this->outputHandler->outputLine(
sprintf(
$this->options['formatString'],
$percentage,
$tag,
$data
)
);
}
}
?>