AREPL automatically evaluates python code in real-time as you type
AREPL is availible for free on the vscode marketplace
First, make sure you have python 3 installed.
Open a python file and right click on the editor title for AREPL launch options.
Or run AREPL through the command search: control-shift-p
or use the shortcuts: control-shift-a
(current doc) / control-shift-q
(new doc)
-
Real-time evaluation: no need to run - AREPL evaluates your code automatically. You can control this (or even turn it off) in the settings
-
Variable display: The final state of your local variables are displayed in a collapsible JSON format
-
Error display: The instant you make a mistake an error with stack trace is shown
-
Settings: AREPL offers many settings to fit your user experience. Customize the look and feel, debounce time, python options, and more!
Dumping
If you want to dump local variables or dump variables at a specific point in your program you can use the dump function:
from arepldump import dump
def milesToKilometers(miles):
kilometers = miles*1.60934
dump() # dumps all the vars in your function
# or dump when function is called for a second time
dump(None,1)
milesToKilometers(2*2)
milesToKilometers(3*3)
for char in ['a','b','c']:
dump(char,2) # dump a var at a specific iteration
a=1
dump(a) # dump specific vars at any point in your program
a=2
STDIN
see https://github.com/Almenon/AREPL-vscode/wiki/Using-AREPL-with-input
HOWDOI
You can use howdoi with arepl:
From the terminal / command line:
pip install howdoi
Then in arepl you can use howdoi to get answers to your questions. For example:
howdoi('calculate fibbonaci in python')
will give you a function to calcualate a fibonaci number
GUIS
see https://github.com/Almenon/AREPL-vscode/wiki/Using-AREPL-with-GUI's
#$save
If you want to avoid a section of code being executed in real-time (due to it being slow or calling external resources) you can use #$save. For example:
def largest_prime_factor(n):
i = 2
while i * i <= n:
if n % i:
i += 1
else:
n //= i
return n
# this takes a looonnggg time to execute
result = largest_prime_factor(8008514751439999)
#$save
print("but now that i saved i am back to real-time execution")
import random
x = random.random()
#$save
print(x) # this number will not change when editing below the #$save line
Please note that #$save does not work with certain types, like generators. If #$save fails in pickling the code state file an issue so I can look into it.
Alternatively, you can use the areplStore variable to store data in between runs.
Variable Representation
I have overridden the display of some types (like datetime) to be more readable to humans.
If you want a type to be displayed in a particular manner just file an issue
More Stuff: Check out the wiki!
See the wiki page on getting started. Contributions welcome!