Metadata-Version: 2.1
Name: imjoy-elfinder
Version: 0.1.60
Summary: A pyramid connector elfinder, specifically for working with jupyter server proxy.
Home-page: https://github.com/imjoy-team/imjoy-elfinder
Author: ImJoy-Team
License: MIT
Description: # ImJoy elFinder [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/imjoy-team/imjoy-elfinder/master?urlpath=elfinder) [![PyPI](https://img.shields.io/pypi/v/imjoy-elfinder.svg?style=popout)](https://pypi.org/project/imjoy-elfinder/) ![Version](https://img.shields.io/badge/dynamic/json.svg?color=success&label=latest&prefix=v&query=version&url=https://raw.githubusercontent.com/imjoy-team/imjoy-elfinder/master/imjoy_elfinder/VERSION) [![Test](https://github.com/imjoy-team/imjoy-elfinder/workflows/Test/badge.svg)](https://github.com/imjoy-team/imjoy-elfinder/actions)
        
        A web file browser for managing data on remote jupyter servers, specifically built for the [ImJoy](https://imjoy.io) project, an open source platform for deploying computational tools to the end user.
        
        The frontend is built with [elFinder](https://github.com/Studio-42/elfinder) and a Python backend server.
        
        ## What is elFinder
        
        elFinder is an open-source file manager for web, written in JavaScript using jQuery and jQuery UI, [the project](https://github.com/Studio-42/elfinder) is maintained by [Studio 42](https://github.com/Studio-42).
        
        [Try their online demo here](https://studio-42.github.io/elFinder/).
        
        ## Installation
        
        Python 3.5+ is required.
        
        ```sh
        pip install -U imjoy-elfinder
        ```
        
        ## Basic Usage
        
        In your terminal, run the following command:
        
        ```sh
        imjoy-elfinder --thumbnail
        ```
        
        (The thumbnail option enables thumbnail for images, it will create a folder named `.tmb` under your current folder, you can also disable that by remove the `--thumbnail` option.)
        
        You will then see the following message:
        
        ```sh
        ==========ImJoy elFinder server is running=========
        http://127.0.0.1:8765
        ```
        
        Depending on where you started the command, the file browser will show your current folder as root directory or HOME.
        
        In order to browse your own directory, you can manually set the root directory by passing `--root-dir=/PATH/TO/MY/FOLDER`.
        
        ![imjoy-elfinder-screenshot](example-data/imjoy-elfinder-screenshot.png)
        
        ## Use it with remote Jupyter notebook server
        
        If you don't have jupyter notebook, run:
        
        ```sh
        pip install -U jupyter
        ```
        
        Next, install ImJoy elFinder with jupyter server proxy extension:
        
        ```sh
        pip install -U imjoy-elfinder[jupyter]
        ```
        
        Now start Jupyter notebook as you would do normally, for example:
        
        ```sh
        jupyter notebook --ip=0.0.0.0
        ```
        
        You will get a web file browser at `http://YOUR_NOTEBOOK_URL/elfinder` (depending on what you get from your notebook, for example, the url can be `http://localhost:8000/elfinder`).
        
        ## Start a demo with MyBinder
        
        1. Start an instance on MyBinder: [https://mybinder.org/v2/gh/imjoy-team/imjoy-elfinder/master?urlpath=elfinder](https://mybinder.org/v2/gh/imjoy-team/imjoy-elfinder/master?urlpath=elfinder)
        
        2. You should be able to see a file browser.
        
        ## Security Considerations
        
        Please be aware that there is potential risk to use ImJoy elFinder locally or remotely over the internet.
        
        Here are some suggestions:
        
        1. Try to set root-dir to a folder containing the files you actually need, as minimal as possible, avoid exposing the entire file system.
        
        2. For remote servers, use it via the Jupyter proxy such that the access will be protected by jupyter token or password. also, do not turn off the authentication in Jupyter.
        
        3. For running it locally, we use allow-origin header (CORS) to protect access from a random website, for that to work, please use a modern browser and keep it updated.
        
        4. Update ImJoy elFinder regularly with 'pip install -U imjoy-elfinder', in case there is security updates.
        
        ## Development
        For developers, you can enable hot reloading by using `hupper`:
        
        ```bash
        hupper -m imjoy_elfinder
        ```
        
        You can also watch additional files by add `-w` (e.g.: `hupper -m imjoy_elfinder -w imjoy_elfinder/templates/elfinder/main.js`)
        
        ## License
        
        MIT
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Framework :: Pyramid 
Classifier: Topic :: Internet
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Provides-Extra: jupyter
