invocation-tree 0.0.5__tar.gz → 0.0.8__tar.gz

{invocation_tree-0.0.5/invocation_tree.egg-info → invocation_tree-0.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: invocation_tree
-Version: 0.0.5
+Version: 0.0.8
 Summary: Generate an invocation tree of functions calls.
 Home-page: https://github.com/bterwijn/invocation_tree
 Author: Bas Terwijn
@@ -29,7 +29,7 @@ The [invocation_tree](https://pypi.org/project/invocation-tree/) package is desi
 
 ```python
 import invocation_tree as invo_tree
-import math 
+from decimal import Decimal, ROUND_HALF_UP
 
 def main():
     students = {'Ann':[7.5, 8.0], 
@@ -42,11 +42,12 @@ def main():
 
 def compute_average(grades):
     average = sum(grades)/len(grades)
-    return my_round(average, 1)
+    return half_up_round(average, 1)
     
-def my_round(value, digits=0):
-    shift = 10 ** digits
-    return math.floor(value * shift + 0.5) / shift
+def half_up_round(value, digits=0):
+    """ High-precision half-up rounding of 'value' to a specified number of 'digits'. """
+    return float(Decimal(str(value)).quantize(Decimal(f"1e-{digits}"),
+                                              rounding=ROUND_HALF_UP))
 
 def passing_students(averages):
     return [student 
@@ -67,13 +68,11 @@ Each node in the tree represents a function call, and the node's color indicates
 
 For every function, the package displays its **local variables** and **return value**. Changes to these values over time are highlighted using bold text and gray shading to make them easy to track.
 
-The [invocation_tree](https://pypi.org/project/invocation-tree/) package visualizes function calls at **different moments in time**. If you want a more detailed visualization of your data at the current time, check out the [memory_graph](https://pypi.org/project/memory-graph/) package.
-
 ## Blocking ##
 The program blocks execution at every function call and return statement, printing the current location in the source code. Press the <Enter> key to continue execution. To block at every line of the program (like in a debugger tool) and only where a change of value occured, use instead:
 
 ```python
-    tree = invo_tree.blocking_each_line()
+    tree = invo_tree.blocking_each_change()
 ```
 
 # Debugger #
@@ -167,21 +166,23 @@ tree = invo_tree.Invocation_Tree()
 
 For convenience we provide these functions to set common configurations:
 
-- **invo_tree.blocking(filename)**, for blocking on function call and return
-- **invo_tree.blocking_each_line(filename)**, for blocking on each line of the program
+- **invo_tree.blocking(filename)**, blocks on function call and return
+- **invo_tree.blocking_each_change(filename)**, blocks on each change of value
 - **invo_tree.debugger(filename)**, for use in debugger tool (open <filename> manually)
-- **invo_tree.gif(filename)**, for generating many output files on function call and return for gif creation
-- **invo_tree.gif_each_line(filename)**, for generating many output files on each line for gif creation
+- **invo_tree.gif(filename)**, generates many output files on function call and return for gif creation
+- **invo_tree.gif_each_change(filename)**, generates many output files on each change of value for gif creation
 
 # Troubleshooting #
-
 - Adobe Acrobat Reader [doesn't refresh a PDF file](https://superuser.com/questions/337011/windows-pdf-viewer-that-auto-refreshes-pdf-when-compiling-with-pdflatex) when it changes on disk and blocks updates which results in an `Could not open 'somefile.pdf' for writing : Permission denied` error. One solution is to install a PDF reader that does refresh ([Evince](https://www.fosshub.com/Evince.html), [Okular](https://okular.kde.org/), [SumatraPDF](https://www.sumatrapdfreader.org/), ...) and set it as the default PDF reader. Another solution is to save the tree to a different [Graphviz Output Format](https://graphviz.org/docs/outputs/).
 
-## Author ##
+## Memory_Graph Package ##
+The [invocation_tree](https://pypi.org/project/invocation-tree/) package visualizes function calls at different moments in time. If instead you want a detailed visualization of your data at the current time, check out the [memory_graph](https://pypi.org/project/memory-graph/) package.
+
+# Author #
 Bas Terwijn
 
-## Inspiration ##
+# Inspiration #
 Inspired by [rcviz](https://github.com/carlsborg/rcviz).
 
-## Supported by ##
+# Supported by #
 <img src="https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/uva.png" alt="University of Amsterdam" width="600">

{invocation_tree-0.0.5 → invocation_tree-0.0.8}/README.md

@@ -10,7 +10,7 @@ The [invocation_tree](https://pypi.org/project/invocation-tree/) package is desi
 
 ```python
 import invocation_tree as invo_tree
-import math 
+from decimal import Decimal, ROUND_HALF_UP
 
 def main():
     students = {'Ann':[7.5, 8.0], 
@@ -23,11 +23,12 @@ def main():
 
 def compute_average(grades):
     average = sum(grades)/len(grades)
-    return my_round(average, 1)
+    return half_up_round(average, 1)
     
-def my_round(value, digits=0):
-    shift = 10 ** digits
-    return math.floor(value * shift + 0.5) / shift
+def half_up_round(value, digits=0):
+    """ High-precision half-up rounding of 'value' to a specified number of 'digits'. """
+    return float(Decimal(str(value)).quantize(Decimal(f"1e-{digits}"),
+                                              rounding=ROUND_HALF_UP))
 
 def passing_students(averages):
     return [student 
@@ -48,13 +49,11 @@ Each node in the tree represents a function call, and the node's color indicates
 
 For every function, the package displays its **local variables** and **return value**. Changes to these values over time are highlighted using bold text and gray shading to make them easy to track.
 
-The [invocation_tree](https://pypi.org/project/invocation-tree/) package visualizes function calls at **different moments in time**. If you want a more detailed visualization of your data at the current time, check out the [memory_graph](https://pypi.org/project/memory-graph/) package.
-
 ## Blocking ##
 The program blocks execution at every function call and return statement, printing the current location in the source code. Press the <Enter> key to continue execution. To block at every line of the program (like in a debugger tool) and only where a change of value occured, use instead:
 
 ```python
-    tree = invo_tree.blocking_each_line()
+    tree = invo_tree.blocking_each_change()
 ```
 
 # Debugger #
@@ -148,21 +147,23 @@ tree = invo_tree.Invocation_Tree()
 
 For convenience we provide these functions to set common configurations:
 
-- **invo_tree.blocking(filename)**, for blocking on function call and return
-- **invo_tree.blocking_each_line(filename)**, for blocking on each line of the program
+- **invo_tree.blocking(filename)**, blocks on function call and return
+- **invo_tree.blocking_each_change(filename)**, blocks on each change of value
 - **invo_tree.debugger(filename)**, for use in debugger tool (open <filename> manually)
-- **invo_tree.gif(filename)**, for generating many output files on function call and return for gif creation
-- **invo_tree.gif_each_line(filename)**, for generating many output files on each line for gif creation
+- **invo_tree.gif(filename)**, generates many output files on function call and return for gif creation
+- **invo_tree.gif_each_change(filename)**, generates many output files on each change of value for gif creation
 
 # Troubleshooting #
-
 - Adobe Acrobat Reader [doesn't refresh a PDF file](https://superuser.com/questions/337011/windows-pdf-viewer-that-auto-refreshes-pdf-when-compiling-with-pdflatex) when it changes on disk and blocks updates which results in an `Could not open 'somefile.pdf' for writing : Permission denied` error. One solution is to install a PDF reader that does refresh ([Evince](https://www.fosshub.com/Evince.html), [Okular](https://okular.kde.org/), [SumatraPDF](https://www.sumatrapdfreader.org/), ...) and set it as the default PDF reader. Another solution is to save the tree to a different [Graphviz Output Format](https://graphviz.org/docs/outputs/).
 
-## Author ##
+## Memory_Graph Package ##
+The [invocation_tree](https://pypi.org/project/invocation-tree/) package visualizes function calls at different moments in time. If instead you want a detailed visualization of your data at the current time, check out the [memory_graph](https://pypi.org/project/memory-graph/) package.
+
+# Author #
 Bas Terwijn
 
-## Inspiration ##
+# Inspiration #
 Inspired by [rcviz](https://github.com/carlsborg/rcviz).
 
-## Supported by ##
+# Supported by #
 <img src="https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/uva.png" alt="University of Amsterdam" width="600">

{invocation_tree-0.0.5 → invocation_tree-0.0.8}/images/students.py

@@ -1,5 +1,5 @@
 import invocation_tree as invo_tree
-import math 
+from decimal import Decimal, ROUND_HALF_UP
 
 def main():
     students = {'Ann':[7.5, 8.0], 
@@ -12,11 +12,12 @@ def main():
 
 def compute_average(grades):
     average = sum(grades)/len(grades)
-    return my_round(average, 1)
+    return half_up_round(average, 1)
     
-def my_round(value, digits=0):
-    shift = 10 ** digits
-    return math.floor(value * shift + 0.5) / shift
+def half_up_round(value, digits=0):
+    """ High-precision half-up rounding of 'value' to a specified number of 'digits'. """
+    return float(Decimal(str(value)).quantize(Decimal(f"1e-{digits}"),
+                                              rounding=ROUND_HALF_UP))
 
 def passing_students(avg):
     return [student 

{invocation_tree-0.0.5 → invocation_tree-0.0.8}/invocation_tree/__init__.py

@@ -7,7 +7,7 @@ import html
 import sys
 import difflib 
 
-__version__ = "0.0.5"
+__version__ = "0.0.8"
 __author__ = 'Bas Terwijn'
 
 def highlight_diff(str1, str2):
@@ -264,7 +264,7 @@ class Invocation_Tree:
 def blocking(filename='tree.pdf'):
     return Invocation_Tree(filename=filename)
 
-def blocking_each_line(filename='tree.pdf'):
+def blocking_each_change(filename='tree.pdf'):
     return Invocation_Tree(filename=filename, each_line=True)
 
 def debugger(filename='tree.pdf'):
@@ -273,5 +273,5 @@ def debugger(filename='tree.pdf'):
 def gif(filename='tree.png'):
     return Invocation_Tree(filename=filename, show=False, block=False, gifcount=0)
 
-def gif_each_line(filename='tree.png'):
+def gif_each_change(filename='tree.png'):
     return Invocation_Tree(filename=filename, show=False, block=False, gifcount=0, each_line=True)

{invocation_tree-0.0.5 → invocation_tree-0.0.8/invocation_tree.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: invocation_tree
-Version: 0.0.5
+Version: 0.0.8
 Summary: Generate an invocation tree of functions calls.
 Home-page: https://github.com/bterwijn/invocation_tree
 Author: Bas Terwijn
@@ -29,7 +29,7 @@ The [invocation_tree](https://pypi.org/project/invocation-tree/) package is desi
 
 ```python
 import invocation_tree as invo_tree
-import math 
+from decimal import Decimal, ROUND_HALF_UP
 
 def main():
     students = {'Ann':[7.5, 8.0], 
@@ -42,11 +42,12 @@ def main():
 
 def compute_average(grades):
     average = sum(grades)/len(grades)
-    return my_round(average, 1)
+    return half_up_round(average, 1)
     
-def my_round(value, digits=0):
-    shift = 10 ** digits
-    return math.floor(value * shift + 0.5) / shift
+def half_up_round(value, digits=0):
+    """ High-precision half-up rounding of 'value' to a specified number of 'digits'. """
+    return float(Decimal(str(value)).quantize(Decimal(f"1e-{digits}"),
+                                              rounding=ROUND_HALF_UP))
 
 def passing_students(averages):
     return [student 
@@ -67,13 +68,11 @@ Each node in the tree represents a function call, and the node's color indicates
 
 For every function, the package displays its **local variables** and **return value**. Changes to these values over time are highlighted using bold text and gray shading to make them easy to track.
 
-The [invocation_tree](https://pypi.org/project/invocation-tree/) package visualizes function calls at **different moments in time**. If you want a more detailed visualization of your data at the current time, check out the [memory_graph](https://pypi.org/project/memory-graph/) package.
-
 ## Blocking ##
 The program blocks execution at every function call and return statement, printing the current location in the source code. Press the <Enter> key to continue execution. To block at every line of the program (like in a debugger tool) and only where a change of value occured, use instead:
 
 ```python
-    tree = invo_tree.blocking_each_line()
+    tree = invo_tree.blocking_each_change()
 ```
 
 # Debugger #
@@ -167,21 +166,23 @@ tree = invo_tree.Invocation_Tree()
 
 For convenience we provide these functions to set common configurations:
 
-- **invo_tree.blocking(filename)**, for blocking on function call and return
-- **invo_tree.blocking_each_line(filename)**, for blocking on each line of the program
+- **invo_tree.blocking(filename)**, blocks on function call and return
+- **invo_tree.blocking_each_change(filename)**, blocks on each change of value
 - **invo_tree.debugger(filename)**, for use in debugger tool (open <filename> manually)
-- **invo_tree.gif(filename)**, for generating many output files on function call and return for gif creation
-- **invo_tree.gif_each_line(filename)**, for generating many output files on each line for gif creation
+- **invo_tree.gif(filename)**, generates many output files on function call and return for gif creation
+- **invo_tree.gif_each_change(filename)**, generates many output files on each change of value for gif creation
 
 # Troubleshooting #
-
 - Adobe Acrobat Reader [doesn't refresh a PDF file](https://superuser.com/questions/337011/windows-pdf-viewer-that-auto-refreshes-pdf-when-compiling-with-pdflatex) when it changes on disk and blocks updates which results in an `Could not open 'somefile.pdf' for writing : Permission denied` error. One solution is to install a PDF reader that does refresh ([Evince](https://www.fosshub.com/Evince.html), [Okular](https://okular.kde.org/), [SumatraPDF](https://www.sumatrapdfreader.org/), ...) and set it as the default PDF reader. Another solution is to save the tree to a different [Graphviz Output Format](https://graphviz.org/docs/outputs/).
 
-## Author ##
+## Memory_Graph Package ##
+The [invocation_tree](https://pypi.org/project/invocation-tree/) package visualizes function calls at different moments in time. If instead you want a detailed visualization of your data at the current time, check out the [memory_graph](https://pypi.org/project/memory-graph/) package.
+
+# Author #
 Bas Terwijn
 
-## Inspiration ##
+# Inspiration #
 Inspired by [rcviz](https://github.com/carlsborg/rcviz).
 
-## Supported by ##
+# Supported by #
 <img src="https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/uva.png" alt="University of Amsterdam" width="600">

{invocation_tree-0.0.5 → invocation_tree-0.0.8}/invocation_tree.egg-info/SOURCES.txt

@@ -9,7 +9,6 @@ images/create_images.sh~
 images/factorial.gif
 images/factorial.py
 images/factorial.py~
-images/factorial0.png
 images/factorial1.png
 images/factorial2.png
 images/factorial3.png
@@ -24,7 +23,6 @@ images/invocation_tree0.pdf
 images/permutations.gif
 images/permutations.py
 images/permutations.py~
-images/permutations0.png
 images/permutations1.png
 images/permutations10.png
 images/permutations11.png
@@ -43,7 +41,6 @@ images/student.gif
 images/students.gif
 images/students.py
 images/students.py~
-images/students0.png
 images/students1.png
 images/students10.png
 images/students11.png

{invocation_tree-0.0.5 → invocation_tree-0.0.8}/setup.py

@@ -11,7 +11,7 @@ long_description_from_readme = (this_directory / "README.md").read_text()
 
 setup(
     name = 'invocation_tree',
-    version = '0.0.5',
+    version = '0.0.8',
     description = 'Generate an invocation tree of functions calls.',
     long_description = long_description_from_readme,
     long_description_content_type = 'text/markdown',