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
209 Dec 28, 2022
59 Dec 14, 2022
327 Dec 27, 2022
12 Aug 26, 2022
84 Jan 04, 2023
121 Jan 01, 2023
17 Jun 19, 2022
105 Dec 06, 2022
31 Nov 18, 2022
37 Nov 10, 2022
2 Jan 11, 2022
2.7k Jan 04, 2023
1.9k Dec 28, 2022
836 Dec 26, 2022
17 May 16, 2022
2 Oct 10, 2022
13 Dec 12, 2022
2 Jan 04, 2022
35 Nov 25, 2022
5 Dec 20, 2022