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
26 Nov 16, 2022
67 Dec 20, 2022
590 Dec 26, 2022
5 Jan 18, 2022
1.2k Dec 30, 2022
4 Dec 17, 2021
244 Jan 09, 2023
783 Jan 04, 2023
12 Jan 02, 2023
3 Sep 16, 2022
15 May 28, 2022
336 Dec 09, 2022
3 Oct 11, 2022
66 Nov 02, 2022
10 Dec 05, 2022
11 Mar 14, 2022
8 Dec 19, 2022
0 Apr 02, 2021
141 Dec 26, 2022
62 Dec 21, 2022