Add a "Code Decompilation" notebook to showcase function inspection and decompilation.

docs/03_advanced_python/code_decompilation.ipynb

@@ -0,0 +1,112 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Advanced Python: Code Decompilation\n",
+    "\n",
+    "In this notebook, we will explore code decompilation using a function decorator and a code decompilation library. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Using a Decorator to Inspect Functions\n",
+    "\n",
+    "We will use Python's `dis` module to decrypt bytecode and inspect the characteristics of a function."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import dis\n",
+    "\n",
+    "def inspect_function(func):\n",
+    "    def wrapper(*args, **kwargs):\n",
+    "        # Access the function's code object\n",
+    "        code = func.__code__\n",
+    "        \n",
+    "        # Print some details about the function's code\n",
+    "        print(f\"Function name: {func.__name__}\")\n",
+    "        print(f\"Function arguments: {code.co_varnames}\")\n",
+    "        print(f\"Function constants: {code.co_consts}\")\n",
+    "        print(f\"Function bytecode:\")\n",
+    "        dis.dis(func)\n",
+    "        \n",
+    "        # Call the original function\n",
+    "        return func(*args, **kwargs)\n",
+    "    \n",
+    "    return wrapper\n",
+    "\n",
+    "@inspect_function\n",
+    "def sample_function(a, b):\n",
+    "    x = a + b\n",
+    "    return x * 2\n",
+    "\n",
+    "# Example usage\n",
+    "result = sample_function(2, 3)\n",
+    "print(\"Result:\", result)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Decompiling Functions\n",
+    "\n",
+    "For decompiling functions, we will use the `uncompyle6` library. This library allows us to obtain the source code from Python bytecode."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import uncompyle6\n",
+    "import io\n",
+    "\n",
+    "def decompile_function(func):\n",
+    "    code = func.__code__\n",
+    "    bytecode_stream = io.StringIO()\n",
+    "    uncompyle6.deparse_code(code, out=bytecode_stream)\n",
+    "    return bytecode_stream.getvalue()\n",
+    "\n",
+    "# Example function\n",
+    "def example_function(a, b):\n",
+    "    x = a + b\n",
+    "    return x * 2\n",
+    "\n",
+    "# Decompile the function\n",
+    "source_code = decompile_function(example_function)\n",
+    "print(source_code)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.8.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

docs/_toc.yml

@@ -275,6 +275,7 @@ parts:
       - file: 03_advanced_python/partial
       - file: 03_advanced_python/parallelization
       - file: 03_advanced_python/numba
+      - file: 03_advanced_python/code_decompilation
 
     - file: 15_gpu_acceleration/readme
       sections:
@@ -429,4 +430,3 @@ parts:
     - file: 01_introduction/glossary
 
     - file: imprint
-