tinykernel
A minimal Python kernel, so you can run Python in your Python.
All the clever stuff in this library is provided by Python's builtin ast module and compilation/exec/eval system, along with IPython's CachingCompiler which does some deep magic. tinykernel just brings them together with a little glue.
Install
With pip:
pip install tinykernel
With conda:
conda install -c fastai tinykernel
How to use
This library provides a single class, TinyKernel, which is a tiny persistent kernel for Python code:
k = TinyKernel()
Call it, passing Python code, to have the code executed in a separate Python environment:
k("a=1")
Expressions return the value of the expression:
k('a')
1
All variables are persisted across calls:
k("a+=1")
k('a')
2
Multi-line inputs are supported. If the last line is an expression, it is returned:
k("""import types
b = types.SimpleNamespace(foo=a)
b""")
namespace(foo=2)
The original source code is stored, so inspect.getsource works and, tracebacks have full details.
k("""def f(): pass # a comment
import inspect
inspect.getsource(f)""")
'def f(): pass # a comment\n'
When creating a TinyKernel, you can pass a dict of globals to initialize the environment:
k = TinyKernel(glb={'foo':'bar'})
k('foo*2')
'barbar'
Pass name to customize the string that appears in tracebacks ("kernel" by default):
k = TinyKernel(name='myapp')
code = '''def f():
return 1/0
print(f())'''
try: k(code)
except Exception as e: print(traceback.format_exc())
Traceback (most recent call last):
File "", line 5, in
try: k(code)
File "/home/jhoward/git/tinykernel/tinykernel/__init__.py", line 20, in __call__
if expr: return self._run(Expression(expr.value), nm, 'eval')
File "/home/jhoward/git/tinykernel/tinykernel/__init__.py", line 12, in _run
def _run(self, p, nm, mode='exec'): return eval(compiler(p, nm, mode), self.glb)
File "", line 3, in
print(f())
File "", line 2, in f
return 1/0
ZeroDivisionError: division by zero
Acknowledgements
Thanks to Christopher Prohm, Matthias Bussonnier, and Aaron Meurer for their helpful insights in this twitter thread.
118 Dec 19, 2022
139 Dec 29, 2022
![[ICCV 2021] Official Tensorflow Implementation for](https://github.com/HyeongseokSon1/KPAC/raw/main/assets/KPAC.jpg)
50 Dec 29, 2022
383 Dec 16, 2022
283 Dec 26, 2022
328 Dec 26, 2022
344 Dec 27, 2022
46 Sep 20, 2022
9 Sep 18, 2022
86 Dec 29, 2022
321 Dec 25, 2022
3 Dec 29, 2021
313 Dec 22, 2022
141 Dec 29, 2022
598 Jan 07, 2023
172 Dec 13, 2022
112 Jan 04, 2023
6.7k Jan 03, 2023
63 Jan 06, 2023
3 Aug 03, 2022
8 Oct 08, 2022
709 Jan 09, 2023
5.8k Jan 06, 2023
366 Nov 15, 2022
9 Dec 24, 2022
32 Sep 24, 2022
117 Dec 30, 2022
19 Dec 17, 2022
14 Oct 18, 2022