Eel python error

Describe the problem I install last version of eel. write few line of code and start project. cant import eel. I have issue with importing eel. I have Python3.8.5 version on my Windows PC. text fro...

Describe the problem
I install last version of eel. write few line of code and start project. cant import eel. I have issue with importing eel. I have Python3.8.5 version on my Windows PC.

text from my CMD
import eel
ModuleNotFoundError: No module named ‘eel’

there is my code
import eel
import pyowm

city = «Batumi, Georgia»

owm = pyowm.OWM(«b74a1f6f227b9d3e307f8eeef5f776c4»)
mgr = owm.weather_manager()

observation = mgr.weather_at_place(city)
w = observation.weather

temp = w.temperature(«celsius»)[«temp»]

print(«In » + city + «right now is » + stp(temp) + «temperature»)

Code snippet(s)
image
image

  • I know that if I don’t provide sample code that allows someone to quickly step into my shoes, I may not get the help I want or my issue may be closed.

Desktop (please complete the following information):

  • OS: [e.g. iOS]
  • Browser [e.g. chrome, safari]
  • Version [e.g. 22]

Smartphone (please complete the following information):

  • Device: [e.g. iPhone6]
  • OS: [e.g. iOS8.1]
  • Browser [e.g. stock browser, safari]
  • Version [e.g. 22]

NOTE:-

  1. if run eel without threading, it works just fine

  2. if i run threading without eel, it works just fine

  3. if i use Multiprocessing with eel, it works just fine

  4. i have tried uninstalling and reinstalling python several times, i have also tried uninstalling and reinstalling eel several times, but with no success so far…

i don’t know if its a problem with python or eel or both. Any help is appreciated

main.py

import eel
import threading
import time

eel.init("web")

# Start the index.html file
def main():
    eel.start("index.html")

o = 0
def main0():
    global o
    while True:
        time.sleep(1)
        print(o)
        o += 10

if __name__ == '__main__':
    threading.Thread(target = main0, args=()).start()
    threading.Thread(target = main, args=()).start()

/web/index.html

<h1>
  Hello World!
</h1>

Error:-

Exception in thread Thread-1:
Traceback (most recent call last):
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libthreading.py", line 973, in _bootstrap_inner
    self.run()
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libthreading.py", line 910, in run
    self._target(*self._args, **self._kwargs)
  File "C:UsersinvenDesktopuimain.py", line 10, in main
    eel.start("index.html")
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packageseel__init__.py", line 180, in start
    run_lambda()
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packageseel__init__.py", line 171, in run_lambda
    return btl.run(
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesbottle.py", line 3137, in run
    server.run(app)
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesbottle_websocketserver.py", line 17, in run
    server.serve_forever()
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgeventbaseserver.py", line 398, in serve_forever
    self.start()
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgeventbaseserver.py", line 336, in start
    self.init_socket()
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgeventpywsgi.py", line 1546, in init_socket
    self.update_environ()
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgeventpywsgi.py", line 1558, in update_environ
    name = socket.getfqdn(address[0])
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgevent_socketcommon.py", line 304, in getfqdn
    hostname, aliases, _ = gethostbyaddr(name)
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgevent_socketcommon.py", line 276, in gethostbyaddr
    return get_hub().resolver.gethostbyaddr(ip_address)
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgeventhub.py", line 841, in _get_resolver
    self._resolver = self.resolver_class(hub=self) # pylint:disable=not-callable
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgeventresolverthread.py", line 39, in __init__
    self.pool = hub.threadpool
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgeventhub.py", line 865, in _get_threadpool
    self._threadpool = self.threadpool_class(self.threadpool_size, hub=self)
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgeventhub.py", line 860, in threadpool_class
    return GEVENT_CONFIG.threadpool
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgevent_config.py", line 50, in getter
    return self.settings[setting_name].get()
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgevent_config.py", line 146, in get
    self.value = self.validate(self._default())
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgevent_config.py", line 248, in validate
    return self._import_one_of([self.shortname_map.get(x, x) for x in value])
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgevent_config.py", line 223, in _import_one_of
    return self._import_one(candidates[-1])
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgevent_config.py", line 237, in _import_one
    module = importlib.import_module(module)
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libimportlib__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1030, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1007, in _find_and_load
  File "<frozen importlib._bootstrap>", line 986, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 680, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 850, in exec_module
  File "<frozen importlib._bootstrap>", line 228, in _call_with_frames_removed
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libsite-packagesgeventthreadpool.py", line 748, in <module>
    class ThreadPoolExecutor(concurrent.futures.ThreadPoolExecutor):
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libconcurrentfutures__init__.py", line 49, in __getattr__
    from .thread import ThreadPoolExecutor as te
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libconcurrentfuturesthread.py", line 37, in <module>
    threading._register_atexit(_python_exit)
  File "C:UsersinvenAppDataLocalProgramsPythonPython39libthreading.py", line 1394, in _register_atexit
    raise RuntimeError("can't register atexit after shutdown")
RuntimeError: can't register atexit after shutdown

https://stackoverflow.com/questions/69041719/python-running-eel-with-multithreading-results-in-a-error

По адресу

не находит нужного файла, пробовал даже указывать полный адресс до eel.js, но не помогло.

Вот код (Html & js):

<!DOCTYPE html>
<html>
<head>
    <title>test aplication</title>
    <link rel="icon" type="image/png" href="icon.png">
    <script type="text/javascript" scr="C:UsersArtyrAppDataLocalProgramsPythonPython38-32Libsite-packageseeleel.js"></script>
</head>
<body>
    <textarea id="num1"></textarea>
    <textarea id="num2"></textarea>
    <textarea id="ans"></textarea>
    <button type="button" id="add" onclick="addition()">THIS IS BUTTON</button>

    <!--<script type="text/javascript" scr="D:ProjectsEelwebmain.js"></script>-->
    <script type="text/javascript">
        eel.expose(addition);
        function addition(){
            var data1 = document.getElementById('num1').value
            var data2 = document.getElementById('num2').value
            eel.add(data1, data2)(callBack)
        }

        function callBack(result){
            document.get.getElementById('ans').value = result
        }
    </script>
</body>
</html>

Код (python):

    import eel
    eel.init('web')

    @eel.expose
    def add(data1, data2):
        num1 = int(data1)
        num2 = int(data2)
        result = num1 + num2
        return result

    eel.start('index.html', size = (700, 700))

P.S: Я не предумывал, этот код, а взял его из одного гайда

Ответы (1 шт):

С:UsersArtyrAppDataLocalProgramsPythonPython38-32Libsite-packageseeleel.js — это не правильный путь.

Положите eel.js рядом с index.html и подключайте так:

<script type="text/javascript" scr="/eel.js"></script>

→ Ссылка

PyPI version
PyPi Downloads
Python
License

Total alerts
Language grade: JavaScript
Language grade: Python

Eel is a little Python library for making simple Electron-like offline HTML/JS GUI apps, with full access to Python capabilities and libraries.

Eel hosts a local webserver, then lets you annotate functions in Python so that they can be called from Javascript, and vice versa.

Eel is designed to take the hassle out of writing short and simple GUI applications. If you are familiar with Python and web development, probably just jump to this example which picks random file names out of the given folder (something that is impossible from a browser).

  • Eel
    • Intro
    • Install
    • Usage
      • Directory Structure
      • Starting the app
      • App options
        • Chrome/Chromium flags
      • Exposing functions
      • Eello, World!
      • Return values
        • Callbacks
        • Synchronous returns
    • Asynchronous Python
    • Building distributable binary with PyInstaller
    • Microsoft Edge

Intro

There are several options for making GUI apps in Python, but if you want to use HTML/JS (in order to use jQueryUI or Bootstrap, for example) then you generally have to write a lot of boilerplate code to communicate from the Client (Javascript) side to the Server (Python) side.

The closest Python equivalent to Electron (to my knowledge) is cefpython. It is a bit heavy weight for what I wanted.

Eel is not as fully-fledged as Electron or cefpython — it is probably not suitable for making full blown applications like Atom — but it is very suitable for making the GUI equivalent of little utility scripts that you use internally in your team.

For some reason many of the best-in-class number crunching and maths libraries are in Python (Tensorflow, Numpy, Scipy etc) but many of the best visualization libraries are in Javascript (D3, THREE.js etc). Hopefully Eel makes it easy to combine these into simple utility apps for assisting your development.

Join Eel’s users and maintainers on Discord, if you like.

Install

Install from pypi with pip:

pip install eel

To include support for HTML templating, currently using Jinja2:

pip install eel[jinja2]

Usage

Directory Structure

An Eel application will be split into a frontend consisting of various web-technology files (.html, .js, .css) and a backend consisting of various Python scripts.

All the frontend files should be put in a single directory (they can be further divided into folders inside this if necessary).

my_python_script.py     <-- Python scripts
other_python_module.py
static_web_folder/      <-- Web folder
  main_page.html
  css/
    style.css
  img/
    logo.png

Starting the app

Suppose you put all the frontend files in a directory called web, including your start page main.html, then the app is started like this;

import eel
eel.init('web')
eel.start('main.html')

This will start a webserver on the default settings (http://localhost:8000) and open a browser to http://localhost:8000/main.html.

If Chrome or Chromium is installed then by default it will open in that in App Mode (with the --app cmdline flag), regardless of what the OS’s default browser is set to (it is possible to override this behaviour).

App options

Additional options can be passed to eel.start() as keyword arguments.

Some of the options include the mode the app is in (e.g. ‘chrome’), the port the app runs on, the host name of the app, and adding additional command line flags.

As of Eel v0.12.0, the following options are available to start():

  • mode, a string specifying what browser to use (e.g. 'chrome', 'electron', 'edge', 'custom'). Can also be None or False to not open a window. Default: 'chrome'
  • host, a string specifying what hostname to use for the Bottle server. Default: 'localhost')
  • port, an int specifying what port to use for the Bottle server. Use 0 for port to be picked automatically. Default: 8000.
  • block, a bool saying whether or not the call to start() should block the calling thread. Default: True
  • jinja_templates, a string specifying a folder to use for Jinja2 templates, e.g. my_templates. Default: None
  • cmdline_args, a list of strings to pass to the command to start the browser. For example, we might add extra flags for Chrome; eel.start('main.html', mode='chrome-app', port=8080, cmdline_args=['--start-fullscreen', '--browser-startup-dialog']). Default: []
  • size, a tuple of ints specifying the (width, height) of the main window in pixels Default: None
  • position, a tuple of ints specifying the (left, top) of the main window in pixels Default: None
  • geometry, a dictionary specifying the size and position for all windows. The keys should be the relative path of the page, and the values should be a dictionary of the form {'size': (200, 100), 'position': (300, 50)}. Default: {}
  • close_callback, a lambda or function that is called when a websocket to a window closes (i.e. when the user closes the window). It should take two arguments; a string which is the relative path of the page that just closed, and a list of other websockets that are still open. Default: None
  • app, an instance of Bottle which will be used rather than creating a fresh one. This can be used to install middleware on the instance before starting eel, e.g. for session management, authentication, etc. If your app is not a Bottle instance, you will need to call eel.register_eel_routes(app) on your custom app instance.
  • shutdown_delay, timer configurable for Eel’s shutdown detection mechanism, whereby when any websocket closes, it waits shutdown_delay seconds, and then checks if there are now any websocket connections. If not, then Eel closes. In case the user has closed the browser and wants to exit the program. By default, the value of shutdown_delay is 1.0 second

Exposing functions

In addition to the files in the frontend folder, a Javascript library will be served at /eel.js. You should include this in any pages:

<script type="text/javascript" src="/eel.js"></script>

Including this library creates an eel object which can be used to communicate with the Python side.

Any functions in the Python code which are decorated with @eel.expose like this…

@eel.expose
def my_python_function(a, b):
    print(a, b, a + b)

…will appear as methods on the eel object on the Javascript side, like this…

console.log("Calling Python...");
eel.my_python_function(1, 2); // This calls the Python function that was decorated

Similarly, any Javascript functions which are exposed like this…

eel.expose(my_javascript_function);
function my_javascript_function(a, b, c, d) {
  if (a < b) {
    console.log(c * d);
  }
}

can be called from the Python side like this…

print('Calling Javascript...')
eel.my_javascript_function(1, 2, 3, 4)  # This calls the Javascript function

The exposed name can also be overridden by passing in a second argument. If your app minifies JavaScript during builds, this may be necessary to ensure that functions can be resolved on the Python side:

eel.expose(someFunction, "my_javascript_function");

When passing complex objects as arguments, bear in mind that internally they are converted to JSON and sent down a websocket (a process that potentially loses information).

Eello, World!

See full example in: examples/01 — hello_world

Putting this together into a Hello, World! example, we have a short HTML page, web/hello.html:

<!DOCTYPE html>
<html>
  <head>
    <title>Hello, World!</title>

    <!-- Include eel.js - note this file doesn't exist in the 'web' directory -->
    <script type="text/javascript" src="/eel.js"></script>
    <script type="text/javascript">
      eel.expose(say_hello_js); // Expose this function to Python
      function say_hello_js(x) {
        console.log("Hello from " + x);
      }

      say_hello_js("Javascript World!");
      eel.say_hello_py("Javascript World!"); // Call a Python function
    </script>
  </head>

  <body>
    Hello, World!
  </body>
</html>

and a short Python script hello.py:

import eel

# Set web files folder and optionally specify which file types to check for eel.expose()
#   *Default allowed_extensions are: ['.js', '.html', '.txt', '.htm', '.xhtml']
eel.init('web', allowed_extensions=['.js', '.html'])

@eel.expose                         # Expose this function to Javascript
def say_hello_py(x):
    print('Hello from %s' % x)

say_hello_py('Python World!')
eel.say_hello_js('Python World!')   # Call a Javascript function

eel.start('hello.html')             # Start (this blocks and enters loop)

If we run the Python script (python hello.py), then a browser window will open displaying hello.html, and we will see…

Hello from Python World!
Hello from Javascript World!

…in the terminal, and…

Hello from Javascript World!
Hello from Python World!

…in the browser console (press F12 to open).

You will notice that in the Python code, the Javascript function is called before the browser window is even started — any early calls like this are queued up and then sent once the websocket has been established.

Return values

While we want to think of our code as comprising a single application, the Python interpreter and the browser window run in separate processes. This can make communicating back and forth between them a bit of a mess, especially if we always had to explicitly send values from one side to the other.

Eel supports two ways of retrieving return values from the other side of the app, which helps keep the code concise.

To prevent hanging forever on the Python side, a timeout has been put in place for trying to retrieve values from
the JavaScript side, which defaults to 10000 milliseconds (10 seconds). This can be changed with the _js_result_timeout parameter to eel.init. There is no corresponding timeout on the JavaScript side.

Callbacks

When you call an exposed function, you can immediately pass a callback function afterwards. This callback will automatically be called asynchronously with the return value when the function has finished executing on the other side.

For example, if we have the following function defined and exposed in Javascript:

eel.expose(js_random);
function js_random() {
  return Math.random();
}

Then in Python we can retrieve random values from the Javascript side like so:

def print_num(n):
    print('Got this from Javascript:', n)

# Call Javascript function, and pass explicit callback function
eel.js_random()(print_num)

# Do the same with an inline lambda as callback
eel.js_random()(lambda n: print('Got this from Javascript:', n))

(It works exactly the same the other way around).

Synchronous returns

In most situations, the calls to the other side are to quickly retrieve some piece of data, such as the state of a widget or contents of an input field. In these cases it is more convenient to just synchronously wait a few milliseconds then continue with your code, rather than breaking the whole thing up into callbacks.

To synchronously retrieve the return value, simply pass nothing to the second set of brackets. So in Python we would write:

n = eel.js_random()()  # This immediately returns the value
print('Got this from Javascript:', n)

You can only perform synchronous returns after the browser window has started (after calling eel.start()), otherwise obviously the call will hang.

In Javascript, the language doesn’t allow us to block while we wait for a callback, except by using await from inside an async function. So the equivalent code from the Javascript side would be:

async function run() {
  // Inside a function marked 'async' we can use the 'await' keyword.

  let n = await eel.py_random()(); // Must prefix call with 'await', otherwise it's the same syntax
  console.log("Got this from Python: " + n);
}

run();

Asynchronous Python

Eel is built on Bottle and Gevent, which provide an asynchronous event loop similar to Javascript. A lot of Python’s standard library implicitly assumes there is a single execution thread — to deal with this, Gevent can «monkey patch» many of the standard modules such as time. This monkey patching is done automatically when you call import eel. If you need monkey patching you should import gevent.monkey and call gevent.monkey.patch_all() before you import eel. Monkey patching can interfere with things like debuggers so should be avoided unless necessary.

For most cases you should be fine by avoiding using time.sleep() and instead using the versions provided by gevent. For convenience, the two most commonly needed gevent methods, sleep() and spawn() are provided directly from Eel (to save importing time and/or gevent as well).

In this example…

import eel
eel.init('web')

def my_other_thread():
    while True:
        print("I'm a thread")
        eel.sleep(1.0)                  # Use eel.sleep(), not time.sleep()

eel.spawn(my_other_thread)

eel.start('main.html', block=False)     # Don't block on this call

while True:
    print("I'm a main loop")
    eel.sleep(1.0)                      # Use eel.sleep(), not time.sleep()

…we would then have three «threads» (greenlets) running;

  1. Eel’s internal thread for serving the web folder
  2. The my_other_thread method, repeatedly printing «I’m a thread»
  3. The main Python thread, which would be stuck in the final while loop, repeatedly printing «I’m a main loop»

Building distributable binary with PyInstaller

If you want to package your app into a program that can be run on a computer without a Python interpreter installed, you should use PyInstaller.

  1. Configure a virtualenv with desired Python version and minimum necessary Python packages
  2. Install PyInstaller pip install PyInstaller
  3. In your app’s folder, run python -m eel [your_main_script] [your_web_folder] (for example, you might run python -m eel hello.py web)
  4. This will create a new folder dist/
  5. Valid PyInstaller flags can be passed through, such as excluding modules with the flag: --exclude module_name. For example, you might run python -m eel file_access.py web --exclude win32com --exclude numpy --exclude cryptography
  6. When happy that your app is working correctly, add --onefile --noconsole flags to build a single executable file

Consult the documentation for PyInstaller for more options.

Microsoft Edge

For Windows 10 users, Microsoft Edge (eel.start(.., mode='edge')) is installed by default and a useful fallback if a preferred browser is not installed. See the examples:

  • A Hello World example using Microsoft Edge: examples/01 — hello_world-Edge/
  • Example implementing browser-fallbacks: examples/07 — CreateReactApp/eel_CRA.py

Eel

PyPI version PyPi Downloads Python License

Total alerts Language grade: JavaScript Language grade: Python

Eel is a little Python library for making simple Electron-like offline HTML/JS GUI apps, with full access to Python capabilities and libraries.

Eel hosts a local webserver, then lets you annotate functions in Python so that they can be called from Javascript, and vice versa.

Eel is designed to take the hassle out of writing short and simple GUI applications. If you are familiar with Python and web development, probably just jump to this example which picks random file names out of the given folder (something that is impossible from a browser).

  • Eel
    • Intro
    • Install
    • Usage
      • Directory Structure
      • Starting the app
      • App options
        • Chrome/Chromium flags
      • Exposing functions
      • Eello, World!
      • Return values
        • Callbacks
        • Synchronous returns
    • Asynchronous Python
    • Building distributable binary with PyInstaller
    • Microsoft Edge

Intro

There are several options for making GUI apps in Python, but if you want to use HTML/JS (in order to use jQueryUI or Bootstrap, for example) then you generally have to write a lot of boilerplate code to communicate from the Client (Javascript) side to the Server (Python) side.

The closest Python equivalent to Electron (to my knowledge) is cefpython. It is a bit heavy weight for what I wanted.

Eel is not as fully-fledged as Electron or cefpython — it is probably not suitable for making full blown applications like Atom — but it is very suitable for making the GUI equivalent of little utility scripts that you use internally in your team.

For some reason many of the best-in-class number crunching and maths libraries are in Python (Tensorflow, Numpy, Scipy etc) but many of the best visualization libraries are in Javascript (D3, THREE.js etc). Hopefully Eel makes it easy to combine these into simple utility apps for assisting your development.

Join Eel’s users and maintainers on Discord, if you like.

Install

Install from pypi with pip:

To include support for HTML templating, currently using Jinja2:

Usage

Directory Structure

An Eel application will be split into a frontend consisting of various web-technology files (.html, .js, .css) and a backend consisting of various Python scripts.

All the frontend files should be put in a single directory (they can be further divided into folders inside this if necessary).

my_python_script.py     <-- Python scripts
other_python_module.py
static_web_folder/      <-- Web folder
  main_page.html
  css/
    style.css
  img/
    logo.png

Starting the app

Suppose you put all the frontend files in a directory called web, including your start page main.html, then the app is started like this;

import eel
eel.init('web')
eel.start('main.html')

This will start a webserver on the default settings (http://localhost:8000) and open a browser to http://localhost:8000/main.html.

If Chrome or Chromium is installed then by default it will open in that in App Mode (with the --app cmdline flag), regardless of what the OS’s default browser is set to (it is possible to override this behaviour).

App options

Additional options can be passed to eel.start() as keyword arguments.

Some of the options include the mode the app is in (e.g. ‘chrome’), the port the app runs on, the host name of the app, and adding additional command line flags.

As of Eel v0.12.0, the following options are available to start():

  • mode, a string specifying what browser to use (e.g. 'chrome', 'electron', 'edge', 'custom'). Can also be None or False to not open a window. Default: 'chrome'
  • host, a string specifying what hostname to use for the Bottle server. Default: 'localhost')
  • port, an int specifying what port to use for the Bottle server. Use 0 for port to be picked automatically. Default: 8000.
  • block, a bool saying whether or not the call to start() should block the calling thread. Default: True
  • jinja_templates, a string specifying a folder to use for Jinja2 templates, e.g. my_templates. Default: None
  • cmdline_args, a list of strings to pass to the command to start the browser. For example, we might add extra flags for Chrome; eel.start('main.html', mode='chrome-app', port=8080, cmdline_args=['--start-fullscreen', '--browser-startup-dialog']). Default: []
  • size, a tuple of ints specifying the (width, height) of the main window in pixels Default: None
  • position, a tuple of ints specifying the (left, top) of the main window in pixels Default: None
  • geometry, a dictionary specifying the size and position for all windows. The keys should be the relative path of the page, and the values should be a dictionary of the form {'size': (200, 100), 'position': (300, 50)}. Default: {}
  • close_callback, a lambda or function that is called when a websocket to a window closes (i.e. when the user closes the window). It should take two arguments; a string which is the relative path of the page that just closed, and a list of other websockets that are still open. Default: None
  • app, an instance of Bottle which will be used rather than creating a fresh one. This can be used to install middleware on the instance before starting eel, e.g. for session management, authentication, etc.

Exposing functions

In addition to the files in the frontend folder, a Javascript library will be served at /eel.js. You should include this in any pages:

<script type="text/javascript" src="/eel.js"></script>

Including this library creates an eel object which can be used to communicate with the Python side.

Any functions in the Python code which are decorated with @eel.expose like this…

@eel.expose
def my_python_function(a, b):
    print(a, b, a + b)

…will appear as methods on the eel object on the Javascript side, like this…

console.log("Calling Python...");
eel.my_python_function(1, 2); // This calls the Python function that was decorated

Similarly, any Javascript functions which are exposed like this…

eel.expose(my_javascript_function);
function my_javascript_function(a, b, c, d) {
  if (a < b) {
    console.log(c * d);
  }
}

can be called from the Python side like this…

print('Calling Javascript...')
eel.my_javascript_function(1, 2, 3, 4)  # This calls the Javascript function

The exposed name can also be overridden by passing in a second argument. If your app minifies JavaScript during builds, this may be necessary to ensure that functions can be resolved on the Python side:

eel.expose(someFunction, "my_javascript_function");

When passing complex objects as arguments, bear in mind that internally they are converted to JSON and sent down a websocket (a process that potentially loses information).

Eello, World!

See full example in: examples/01 — hello_world

Putting this together into a Hello, World! example, we have a short HTML page, web/hello.html:

<!DOCTYPE html>
<html>
  <head>
    <title>Hello, World!</title>

    <!-- Include eel.js - note this file doesn't exist in the 'web' directory -->
    <script type="text/javascript" src="/eel.js"></script>
    <script type="text/javascript">
      eel.expose(say_hello_js); // Expose this function to Python
      function say_hello_js(x) {
        console.log("Hello from " + x);
      }

      say_hello_js("Javascript World!");
      eel.say_hello_py("Javascript World!"); // Call a Python function
    </script>
  </head>

  <body>
    Hello, World!
  </body>
</html>

and a short Python script hello.py:

import eel

# Set web files folder and optionally specify which file types to check for eel.expose()
#   *Default allowed_extensions are: ['.js', '.html', '.txt', '.htm', '.xhtml']
eel.init('web', allowed_extensions=['.js', '.html'])

@eel.expose                         # Expose this function to Javascript
def say_hello_py(x):
    print('Hello from %s' % x)

say_hello_py('Python World!')
eel.say_hello_js('Python World!')   # Call a Javascript function

eel.start('hello.html')             # Start (this blocks and enters loop)

If we run the Python script (python hello.py), then a browser window will open displaying hello.html, and we will see…

Hello from Python World!
Hello from Javascript World!

…in the terminal, and…

Hello from Javascript World!
Hello from Python World!

…in the browser console (press F12 to open).

You will notice that in the Python code, the Javascript function is called before the browser window is even started — any early calls like this are queued up and then sent once the websocket has been established.

Return values

While we want to think of our code as comprising a single application, the Python interpreter and the browser window run in separate processes. This can make communicating back and forth between them a bit of a mess, especially if we always had to explicitly send values from one side to the other.

Eel supports two ways of retrieving return values from the other side of the app, which helps keep the code concise.

To prevent hanging forever on the Python side, a timeout has been put in place for trying to retrieve values from the JavaScript side, which defaults to 10000 milliseconds (10 seconds). This can be changed with the _js_result_timeout parameter to eel.init. There is no corresponding timeout on the JavaScript side.

Callbacks

When you call an exposed function, you can immediately pass a callback function afterwards. This callback will automatically be called asynchrounously with the return value when the function has finished executing on the other side.

For example, if we have the following function defined and exposed in Javascript:

eel.expose(js_random);
function js_random() {
  return Math.random();
}

Then in Python we can retrieve random values from the Javascript side like so:

def print_num(n):
    print('Got this from Javascript:', n)

# Call Javascript function, and pass explicit callback function
eel.js_random()(print_num)

# Do the same with an inline lambda as callback
eel.js_random()(lambda n: print('Got this from Javascript:', n))

(It works exactly the same the other way around).

Synchronous returns

In most situations, the calls to the other side are to quickly retrieve some piece of data, such as the state of a widget or contents of an input field. In these cases it is more convenient to just synchronously wait a few milliseconds then continue with your code, rather than breaking the whole thing up into callbacks.

To synchronously retrieve the return value, simply pass nothing to the second set of brackets. So in Python we would write:

n = eel.js_random()()  # This immediately returns the value
print('Got this from Javascript:', n)

You can only perform synchronous returns after the browser window has started (after calling eel.start()), otherwise obviously the call with hang.

In Javascript, the language doesn’t allow us to block while we wait for a callback, except by using await from inside an async function. So the equivalent code from the Javascript side would be:

async function run() {
  // Inside a function marked 'async' we can use the 'await' keyword.

  let n = await eel.py_random()(); // Must prefix call with 'await', otherwise it's the same syntax
  console.log("Got this from Python: " + n);
}

run();

Asynchronous Python

Eel is built on Bottle and Gevent, which provide an asynchronous event loop similar to Javascript. A lot of Python’s standard library implicitly assumes there is a single execution thread — to deal with this, Gevent can «monkey patch» many of the standard modules such as time. This monkey patching is done automatically when you call import eel. If you need monkey patching you should import gevent.monkey and call gevent.monkey.patch_all() before you import eel. Monkey patching can interfere with things like debuggers so should be avoided unless necessary.

For most cases you should be fine by avoiding using time.sleep() and instead using the versions provided by gevent. For convenience, the two most commonly needed gevent methods, sleep() and spawn() are provided directly from Eel (to save importing time and/or gevent as well).

In this example…

import eel
eel.init('web')

def my_other_thread():
    while True:
        print("I'm a thread")
        eel.sleep(1.0)                  # Use eel.sleep(), not time.sleep()

eel.spawn(my_other_thread)

eel.start('main.html', block=False)     # Don't block on this call

while True:
    print("I'm a main loop")
    eel.sleep(1.0)                      # Use eel.sleep(), not time.sleep()

…we would then have three «threads» (greenlets) running;

  1. Eel’s internal thread for serving the web folder
  2. The my_other_thread method, repeatedly printing «I’m a thread»
  3. The main Python thread, which would be stuck in the final while loop, repeatedly printing «I’m a main loop»

Building distributable binary with PyInstaller

If you want to package your app into a program that can be run on a computer without a Python interpreter installed, you should use PyInstaller.

  1. Configure a virtualenv with desired Python version and minimum necessary Python packages
  2. Install PyInstaller pip install PyInstaller
  3. In your app’s folder, run python -m eel [your_main_script] [your_web_folder] (for example, you might run python -m eel hello.py web)
  4. This will create a new folder dist/
  5. Valid PyInstaller flags can be passed through, such as excluding modules with the flag: --exclude module_name. For example, you might run python -m eel file_access.py web --exclude win32com --exclude numpy --exclude cryptography
  6. When happy that your app is working correctly, add --onefile --noconsole flags to build a single executable file

Consult the documentation for PyInstaller for more options.

Microsoft Edge

For Windows 10 users, Microsoft Edge (eel.start(.., mode='edge')) is installed by default and a useful fallback if a preferred browser is not installed. See the examples:

  • A Hello World example using Microsoft Edge: examples/01 — hello_world-Edge/
  • Example implementing browser-fallbacks: examples/07 — CreateReactApp/eel_CRA.py

Понравилась статья? Поделить с друзьями:

Читайте также:

  • Ee fatal server error ee no screens found ee
  • Ee dvr connect device error 11307
  • Eds ошибка маз
  • Eds ошибка iveco
  • Edm hard error sts 80000010

  • 0 0 голоса
    Рейтинг статьи
    Подписаться
    Уведомить о
    guest

    0 комментариев
    Старые
    Новые Популярные
    Межтекстовые Отзывы
    Посмотреть все комментарии