spyder-remote-client

Spyder remote client to connect to Spyder kernels via zeroconf.


License
MIT
Install
pip install spyder-remote-client==0.0.21

Documentation

spyder-remote

GitHub Conda Supported Python versions

GitHub release (latest SemVer) GitHub commits since latest release (by date) CI CD GitHub issues GitHub pull requests

Client package Client Version on PyPI Client Version on Conda client feedstock PyPI - Client Downloads conda - Client Downloads

Server package Server on PyPI Server on Conda server feedstock PyPI - Server Downloads conda - Server Downloads

spyder-remote is a project to add the ability to spyder to recognize (over zeroconf) what machines are in the local network that can start a spyder-kernel to which spyder can then automatically and remotely connect.

Bundeled with this capability there is also the capability to manage conda environment on the remote host.

Eventhough spyder-remote is one project, it consists out of 2 parts (the spyder-remote-server and the spyder-remote-client) and thus also 2 packages that are released together under the same version number.

spyder-remote-client

Installation

The spyder-remote-client is simply installed over conda like so:

(base) me@mybox:~$ conda activate spyder
(spyder) me@mybox:~$ conda install spyder-remote-client

Note that spyder-remote-client depends on spyder (>=5), it will pull in also spyder if not available!

Description

This is a plugin to spyder (>=5), and it adds 2 entries in the IPython Console hamburger:

  • spyder-remote console

    Selecting this option will present us with a dialog like this:

    In a first stage Credentials and Conda disabled, and only the Remote Spyder Host QComboBox is active, and filled with all 'machines' discovered on the zeroconf network. (Note: we display the pretty names that come from the zeroconf network, it is supposed to be 'talking' names ... in UTF-8 !) Once a host is selected, the Credentials section will enable, proposing the local user name (in our usecase this is 👍), and by default the password comes from the keyring - placeholer text -) Once that is cleared (by default nothing needs to be done), one can select which conda environment for the user on the remote host will be used. This is a QComboBox because we know this info (from the remote host). The Requirements is the finishing touch, if your project (local) has a requirements directory in the project root, one can chose whech one (or none) of these to apply to the remote conda environment! 😍 The feedback line guides the user, but there is only very few use-cases for this one (for exemple when the user & password don't allow access to the remote host) Note that the remote host can have a guest account set up, in such case we need to be able to tell the user this ... maybe over the feedback line ?!?)

  • spyder-remote management

    Here the idea is that one can quickly create/configure a remote environment. Basically I am hoping to add this functionality to the above described Dialog (that is what the two ... QToolButton's are doing there. In such a case we can get ride of this spyder-remote management entry as the funtionality is already in the spyder-remote console entry point. Note that if we do things over requirements we don't need an elaborate system for this (read: a library with all individual conda commands 😛)

This package is to be implemented in pure Python(iow: noarch), so bringing it to Windows, macOS and Linux will be straight forward.

spyder-remote-server

Installation

The spyder-remote-server is installed with conda like so:

(base) me@mybox:~$ conda install spyder-remote-server
(base) me@mybox:~$ sudo spyder-remote-server --install

Note that spyder-remote-server is to be installed in base (anything else should fail)

So the spyder-remote-server conda-package installs the spyder-remote-server (Python) script. This script has the following arguments:

  • --install ➜ installs the daemon
  • --uninstall ➜ uninstalls the daemon
  • --guest [guest_account] ➜ only to be used with --install, and it will also add a guest account to the system (with the same password as the account) and add this info also to the /etc/spyder-remote.conf file.
  • --cores [#] ➜ only to be used with install, and it will set the maximum numbers of consoles this machine will provide. (see section on spyder-remote.conf)

Description

To begin with we will only implement the spyder-remote-server for Linux. (In a later stage we can add macOS and Windows)

The spyder-remote-server script will install/uninstall the 'publisher' in the systemd of the Linux system. (/ect/spyder-remote.conf, systemctl), the install script thus need to check if the user is 'root' and if the conda