@@ -5650,7 +5650,7 @@ <h1>progress</h1>
56505650
56515651
56525652< h2 id ="spotpython.utils.progress.progress_bar " class ="doc doc-heading ">
5653- < code class ="highlight language-python "> < span class ="n "> progress_bar</ span > < span class ="p "> (</ span > < span class ="n "> progress</ span > < span class ="p "> ,</ span > < span class ="n "> bar_length</ span > < span class ="o "> =</ span > < span class ="mi "> 10</ span > < span class ="p "> ,</ span > < span class ="n "> message</ span > < span class ="o "> =</ span > < span class ="s1 "> 'spotpython tuning:'</ span > < span class ="p "> ,</ span > < span class ="n "> y</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="p "> ,</ span > < span class ="n "> filename</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="p "> )</ span > </ code >
5653+ < code class ="highlight language-python "> < span class ="n "> progress_bar</ span > < span class ="p "> (</ span > < span class ="n "> progress</ span > < span class ="p "> ,</ span > < span class ="n "> success_rate </ span > < span class =" p " > , </ span > < span class =" n " > bar_length</ span > < span class ="o "> =</ span > < span class ="mi "> 10</ span > < span class ="p "> ,</ span > < span class ="n "> message</ span > < span class ="o "> =</ span > < span class ="s1 "> 'spotpython tuning:'</ span > < span class ="p "> ,</ span > < span class ="n "> y</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="p "> ,</ span > < span class ="n "> filename</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="p "> )</ span > </ code >
56545654
56555655< a href ="#spotpython.utils.progress.progress_bar " class ="headerlink " title ="Permanent link "> ¶</ a > </ h2 >
56565656
@@ -5689,6 +5689,22 @@ <h2 id="spotpython.utils.progress.progress_bar" class="doc doc-heading">
56895689 < em > required</ em >
56905690 </ td >
56915691 </ tr >
5692+ < tr class ="doc-section-item ">
5693+ < td >
5694+ < code > success_rate</ code >
5695+ </ td >
5696+ < td >
5697+ < code > < span title ="float "> float</ span > </ code >
5698+ </ td >
5699+ < td >
5700+ < div class ="doc-md-description ">
5701+ < p > a float between 0 and 1 representing the success rate</ p >
5702+ </ div >
5703+ </ td >
5704+ < td >
5705+ < em > required</ em >
5706+ </ td >
5707+ </ tr >
56925708 < tr class ="doc-section-item ">
56935709 < td >
56945710 < code > bar_length</ code >
@@ -5779,7 +5795,9 @@ <h2 id="spotpython.utils.progress.progress_bar" class="doc doc-heading">
57795795< span class ="normal "> 37</ span >
57805796< span class ="normal "> 38</ span >
57815797< span class ="normal "> 39</ span >
5782- < span class ="normal "> 40</ span > </ pre > </ div > </ td > < td class ="code "> < div > < pre > < span > </ span > < code > < span class ="k "> def</ span > < span class ="w "> </ span > < span class ="nf "> progress_bar</ span > < span class ="p "> (</ span > < span class ="n "> progress</ span > < span class ="p "> :</ span > < span class ="nb "> float</ span > < span class ="p "> ,</ span > < span class ="n "> bar_length</ span > < span class ="p "> :</ span > < span class ="nb "> int</ span > < span class ="o "> =</ span > < span class ="mi "> 10</ span > < span class ="p "> ,</ span > < span class ="n "> message</ span > < span class ="p "> :</ span > < span class ="nb "> str</ span > < span class ="o "> =</ span > < span class ="s2 "> "spotpython tuning:"</ span > < span class ="p "> ,</ span > < span class ="n "> y</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="p "> ,</ span > < span class ="n "> filename</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="p "> )</ span > < span class ="o "> -></ span > < span class ="kc "> None</ span > < span class ="p "> :</ span >
5798+ < span class ="normal "> 40</ span >
5799+ < span class ="normal "> 41</ span >
5800+ < span class ="normal "> 42</ span > </ pre > </ div > </ td > < td class ="code "> < div > < pre > < span > </ span > < code > < span class ="k "> def</ span > < span class ="w "> </ span > < span class ="nf "> progress_bar</ span > < span class ="p "> (</ span > < span class ="n "> progress</ span > < span class ="p "> :</ span > < span class ="nb "> float</ span > < span class ="p "> ,</ span > < span class ="n "> success_rate</ span > < span class ="p "> :</ span > < span class ="nb "> float</ span > < span class ="p "> ,</ span > < span class ="n "> bar_length</ span > < span class ="p "> :</ span > < span class ="nb "> int</ span > < span class ="o "> =</ span > < span class ="mi "> 10</ span > < span class ="p "> ,</ span > < span class ="n "> message</ span > < span class ="p "> :</ span > < span class ="nb "> str</ span > < span class ="o "> =</ span > < span class ="s2 "> "spotpython tuning:"</ span > < span class ="p "> ,</ span > < span class ="n "> y</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="p "> ,</ span > < span class ="n "> filename</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="p "> )</ span > < span class ="o "> -></ span > < span class ="kc "> None</ span > < span class ="p "> :</ span >
57835801< span class ="w "> </ span > < span class ="sd "> """</ span >
57845802< span class ="sd "> Displays or updates a console progress bar.</ span >
57855803
@@ -5788,6 +5806,8 @@ <h2 id="spotpython.utils.progress.progress_bar" class="doc doc-heading">
57885806< span class ="sd "> a float between 0 and 1. Any int will be converted to a float.</ span >
57895807< span class ="sd "> A value under 0 represents a halt.</ span >
57905808< span class ="sd "> A value at 1 or bigger represents 100%.</ span >
5809+ < span class ="sd "> success_rate (float):</ span >
5810+ < span class ="sd "> a float between 0 and 1 representing the success rate</ span >
57915811< span class ="sd "> bar_length (int):</ span >
57925812< span class ="sd "> length of the progress bar</ span >
57935813< span class ="sd "> message (str):</ span >
@@ -5808,7 +5828,7 @@ <h2 id="spotpython.utils.progress.progress_bar" class="doc doc-heading">
58085828 < span class ="n "> progress</ span > < span class ="o "> =</ span > < span class ="mi "> 1</ span >
58095829 < span class ="n "> status</ span > < span class ="o "> =</ span > < span class ="s2 "> "Done...</ span > < span class ="se "> \r\n</ span > < span class ="s2 "> "</ span >
58105830 < span class ="n "> block</ span > < span class ="o "> =</ span > < span class ="nb "> int</ span > < span class ="p "> (</ span > < span class ="nb "> round</ span > < span class ="p "> (</ span > < span class ="n "> bar_length</ span > < span class ="o "> *</ span > < span class ="n "> progress</ span > < span class ="p "> ))</ span >
5811- < span class ="n "> text</ span > < span class ="o "> =</ span > < span class ="sa "> f</ span > < span class ="s2 "> "</ span > < span class ="si "> {</ span > < span class ="n "> message</ span > < span class ="si "> }</ span > < span class ="s2 "> [</ span > < span class ="si "> {</ span > < span class ="s1 "> '#'</ span > < span class ="w "> </ span > < span class ="o "> *</ span > < span class ="w "> </ span > < span class ="n "> block</ span > < span class ="w "> </ span > < span class ="o "> +</ span > < span class ="w "> </ span > < span class ="s1 "> '-'</ span > < span class ="w "> </ span > < span class ="o "> *</ span > < span class ="w "> </ span > < span class ="p "> (</ span > < span class ="n "> bar_length</ span > < span class ="w "> </ span > < span class ="o "> -</ span > < span class ="w "> </ span > < span class ="n "> block</ span > < span class ="p "> )</ span > < span class ="si "> }</ span > < span class ="s2 "> ] </ span > < span class ="si "> {</ span > < span class ="n "> progress</ span > < span class ="w "> </ span > < span class ="o "> *</ span > < span class ="w "> </ span > < span class ="mi "> 100</ span > < span class ="si "> :</ span > < span class ="s2 "> .2f</ span > < span class ="si "> }</ span > < span class ="s2 "> % </ span > < span class ="si "> {</ span > < span class ="n "> status</ span > < span class ="si "> }</ span > < span class ="se "> \r\n</ span > < span class ="s2 "> "</ span >
5831+ < span class ="n "> text</ span > < span class ="o "> =</ span > < span class ="sa "> f</ span > < span class ="s2 "> "</ span > < span class ="si "> {</ span > < span class ="n "> message</ span > < span class ="si "> }</ span > < span class ="s2 "> [</ span > < span class ="si "> {</ span > < span class ="s1 "> '#'</ span > < span class ="w "> </ span > < span class ="o "> *</ span > < span class ="w "> </ span > < span class ="n "> block</ span > < span class ="w "> </ span > < span class ="o "> +</ span > < span class ="w "> </ span > < span class ="s1 "> '-'</ span > < span class ="w "> </ span > < span class ="o "> *</ span > < span class ="w "> </ span > < span class ="p "> (</ span > < span class ="n "> bar_length</ span > < span class ="w "> </ span > < span class ="o "> -</ span > < span class ="w "> </ span > < span class ="n "> block</ span > < span class ="p "> )</ span > < span class ="si "> }</ span > < span class ="s2 "> ] </ span > < span class ="si "> {</ span > < span class ="n "> progress</ span > < span class ="w "> </ span > < span class ="o "> *</ span > < span class ="w "> </ span > < span class ="mi "> 100</ span > < span class ="si "> :</ span > < span class ="s2 "> .2f</ span > < span class ="si "> }</ span > < span class ="s2 "> %. Success rate: </ span > < span class ="si "> {</ span > < span class ="n "> success_rate</ span > < span class ="w "> </ span > < span class ="o "> *</ span > < span class ="w "> </ span > < span class ="mi "> 100</ span > < span class ="si "> :</ span > < span class ="s2 "> .2f</ span > < span class ="si "> }</ span > < span class ="s2 "> % </ span > < span class ="si "> {</ span > < span class ="n "> status</ span > < span class ="si "> }</ span > < span class ="se "> \r\n</ span > < span class ="s2 "> "</ span >
58125832 < span class ="k "> if</ span > < span class ="n "> filename</ span > < span class ="ow "> is</ span > < span class ="ow "> not</ span > < span class ="kc "> None</ span > < span class ="p "> :</ span >
58135833 < span class ="n "> file</ span > < span class ="o "> .</ span > < span class ="n "> write</ span > < span class ="p "> (</ span > < span class ="n "> text</ span > < span class ="p "> )</ span >
58145834 < span class ="n "> file</ span > < span class ="o "> .</ span > < span class ="n "> flush</ span > < span class ="p "> ()</ span >
0 commit comments