Package: sbNative
SbNativeAn extention to python for debugging and such. Things that, wellShould Be NativeSbNative may be used forprivate projects.public projects (The SbNative repo must be referenced in a Readme in case the source code is available.)DO NOT DISTRIBUTE.ALL NON MENTIONED RIGHTS RESERVED.Chapter 1: debuggingAll of the necessary dependencies are located or imported in thedebugtools.pyfile.switchTerminalStacking. Terminal stacking is a method for compressing logged information into a single line if possible.
Ex:fromsbNative.debugtoolsimportlogfor_inrange(10):log("this module should be native!")leads to this result when not using terminal stacking:LOG: this module should be native! --> c:FILEPATH.py:5
LOG: this module should be native! --> c:FILEPATH.py:5
LOG: this module should be native! --> c:FILEPATH.py:5
LOG: this module should be native! --> c:FILEPATH.py:5
LOG: this module should be native! --> c:FILEPATH.py:5
LOG: this module should be native! --> c:FILEPATH.py:5
LOG: this module should be native! --> c:FILEPATH.py:5
LOG: this module should be native! --> c:FILEPATH.py:5
LOG: this module should be native! --> c:FILEPATH.py:5
LOG: this module should be native! --> c:FILEPATH.py:5which obviously is not very clean...
Instead, doing this:fromsbNative.debugtoolsimportlog,switchTerminalStackingswitchTerminalStacking()for_inrange(10):log("this module should be native!")leads to an arguably cleaner output:LOG: this module should be native! --> c:FILEPATH.py:7 [10x]log. Prints all the arguments given to
the console and the file + line of the call.
Supports more advanced logging when paired with thecleanReprclass decorator.
As shown above, it also claryfies that a value has been logged. Having a line at the end helps finding the log call and editing/removing it quickly. In many editors, (tested in VSCODE) you may CTRL+LEFTCLICK the line and it will redirect you to the file and corresponding line of the call.
Ex:LOG: this module should be native! --> c:/---/Desktop/test1.py:6The depth parameter controls how far the lookup goes into the callstack returning the filename and number after the-->. This is a feature for functions written by you, to redirect the user or yourself to the lineyourfunction was called at. Incrementing goes further into the callstack. Default: 2.ilog. "Info Log". Behaves mainly likelogOnly difference: the first argument will be used to represent what is being logged.isFromCall. Gets if a function with the namefuncNameis in the callstack.
Used by__clsReprto determine if it should add markers in the form oflignSplitSignwhere newlines can be added if the logging string is too long.cleanRepr. A decorator which makes the representation of your class as clean as possible. If you don't want specific class or instance variables to be included, you may specify their name as arguments for this function.getTerminalOutputs. Returns the terminal output content recorded while the function was running, and the result from the function in a tuple.
(TerminalOutput,FunctionResult)WARNING: THIS FUNCTION ALLOCATES THE RESULT TO YOUR DRIVE AND NOT MEMORY. PRINTING MAY BE VERY SLOW, DO NOT EVER USE IN PRODUCTION WITH HIGH WORKLOADS.timer. A simple decorator for timing the
execution time of a function or method.
Brags theilogfunction. (:tPlotArgsEnums or "Flags" to sort after the execution times of the functions or the arguments passed to the function.timePlotterWorks the same way as thetimerdecorator, tho it returns an object and the decorator is the functiontimePlotter.time.
The major difference is the ability to plot the times on a matplotlib graph. You can sort the time or arguments with the Enums fromtPlotArgs.
The reverse kwarg may only reverse the x axis.
The arguments or keyarguments that are supposed to be displayed on the plot have to be passed into thetrackArgs/trackKwargsparameters. For args, these have to be the indicies of the argument, for kwargs the name of the keyword-argument.
Decorate the function to be tracked with thetimermethod, and plot them with theshowone.
You may not use the same instance on multiple functions, otherwise, an error will be raised.Chapter 2: runtime utilitiesAll of the neccessary dependencies are located or imported in theruntimetools.pyfile.getPathRetrieves the path of the file it has been called in. Returns aPathobject from the built-inpathlibmodule.globaliseAllSubitemsAdds all the subitems of a module or folder containing a__init__.pyfile to the global scope, do not ever use this function if you are not desperate, the IDE wont recognise its behaviour.execWithExcTbExtends the built-inexecfunction, tho shows the exceptions when one is raised, with the appropriate format.runAndCastNOT IMPLEMENTED COMPLETELY YET.safeIterAllows iteration and removal of items inside the iterable simultaneously.bidirectionalDictOne may get the original key by the values, like in {"Richard":["Rick","Dick"]}
Using indexing or attribute getter with "Richard", "Rick" or "Dick" here will return "Richard"
When a value is given and whilst not contained in the dict, a KeyError will be risen.
Full Ex:d=runtimetools.BiDirectionaldict(Richard=["Dick","Rick"],Annamarie=["Marie","Anna","Ann"])print(d.Richard,d["Richard"])print(d.Rick,d["Rick"])print(d.Dick,d["Dick"])print(d.Annamarie,d["Annamarie"])print(d.Marie,d["Marie"])print(d.Anna,d["Anna"])print(d.Ann,d["Ann"])LanguageFormatterUsed to format information from a program readable structure to a more easily human readable format. All of these methods are static.enumerateCollectionTakes a collection like a list, tuple or anything else with a join method and converts the contents into a human readable enumeration.toAbbrNumberAbbriviates an Integer or float dynamically, using k; m; b; t, by default, which can be changed accordingly to the language unsing the abbriviations kw. The maxPrecisionAmt kw indicates the amount of digits of the output precision.AbbrNumToFloatThe exact counterpart totoAbbrNumberWATCH OUT FOR DIFFERENCES IN THEabbriviationsVARIABLE