Metadata-Version: 2.1
Name: sshkernel
Version: 0.6.2
Summary: SSH Kernel
Home-page: UNKNOWN
Author: UENO, Masaru
Author-email: ueno.masaru@fujitsu.com
License: BSD 3-clause "New" or "Revised License"
Description: # SSH Kernel
        
        SSH Kernel is a Jupyter kernel specialized in executing commands remotely
        with [paramiko](http://www.paramiko.org/) SSH client.
        
        ![](doc/screenshot.png)
        
        ## Major requirements
        
        * Python3.5+
        * IPython 7.0+
        
        ## Installation
        
        ```
        pip install -U sshkernel
        python -m sshkernel install [--user|--sys-prefix]
        # Type `python -m sshkernel install --help` for more information.
        ```
        
        To uninstall:
        
        ```
        jupyter kernelspec remove ssh
        pip uninstall sshkernel
        ```
        
        ## Getting Started
        
        Basic examples of using SSH Kernel.
        
        * [Getting Started](examples/getting-started.ipynb)
        * [Getting Started (in Japanese)](examples/getting-started-ja.ipynb)
        
        ## Configuration
        
        SSH Kernel obtains configuration data from `~/.ssh/config` file to connect servers.
        
        Possible keywords are as follows:
        
        * HostName
        * User
        * Port
        * IdentityFile
        
        ### Notes about private keys
        
        * As private key files in `~/.ssh/` are discoverable, you do not necessarily specify `IdentityFile`
        * If you use a ed25519 key, please generate with or convert into old PEM format
            * e.g. `ssh-keygen -m PEM -t ed25519 ...`
            * This is because `paramiko` library doesn't support latest format "RFC4716"
        
        ### Configuration examples
        
        Example1:
        
        ```
        [~/.ssh/config]
        Host myserver
          HostName myserver.example.com
          User admin
          Port 2222
          IdentityFile ~/.ssh/id_rsa_myserver
        ```
        
        Example2:
        
        ```
        [~/.ssh/config]
        Host another-server
          HostName 192.0.2.1
        ```
        
        Minimal example:
        
        ```
        [~/.ssh/config]
        
        # If you specify a FQDN / IP address, same login user, and discoverable private key,
        # no configuration needed
        ```
        
        See also a tutorial above in detail.
        
        ## Limitations
        
        * As Jupyter Notebook has limitation to handle `stdin`,
          you may need to change some server configuration and commands to avoid *interactive input*.
          * e.g. use publickey-authentication instead of password, enable NOPASSWD for sudo, use `expect`
        * Some shell variables are different from normal interactive shell
          * e.g. `$?`, `$$`
        
        ## LICENSE
        
        This software is released under the terms of the Modified BSD License.
        
Platform: any
Classifier: Framework :: IPython
Classifier: Framework :: Jupyter
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Shells
Description-Content-Type: text/markdown
Provides-Extra: dev
