Package: dtaledesktop
An interface for saving python scripts as permanent D-Tale launch points.Getting startedInstallation$pipinstalldtaledesktopRunning it from the command line:$dtaledesktopRunning it from a python script:import dtale_desktop

dtale_desktop.run()Motivationdtaledesktop simplifies the process of fetching data, cleaning/transforming it, and then performing exploratory data analysis. With dtaledesktop, that entire process is condensed into a single click.It does this by providing a dashboard GUI, and any python code which returns a pandas DataFrame can be saved to the dashboard as a widget. Users can then execute that code and explore the DataFrame indtaleorpandas-profilingby simply clicking one of the widget buttons. The code associated with that widget can also be edited directly from the dashboard, and upon doing so the dashboard is updated in real-time.Here's a simple example of using this workflow:launchdtaledesktopfrom a terminal. The dashboard automatically opens up in your web browser.click the 'Add Data Source' button, fill out the form like so, and click save:and bam! You now have a new 'Stocks' section on your dashboard. It will be there every time you launch dtaledesktop, and the python code can be edited directly from the dashboard:If at some point you decide you want to watch Apple too, all you need to do is click the "Settings" button and add "AAPL" to the list of stock symbols. It will immediately appear in the dashboard below TSLA.How it worksThe front end is written with react, using a mixture of ant-design and styled-components.The back end is written in python, and it actually consists of TWO apps which listen on separate ports. The main one is an asynchronous FastAPI application, and it responsible for communicating with the dashboard, interacting with the file system, and executing user-defined code for fetching/transforming data. It is able to do this by saving the submitted code as persistent files and then using importlib.util to build and then import the resulting modules. The second app is for running dtale instances, and it is a synchronous flask application.Developers/ContributingFirst, you'll want to clone the repo and install the python dependencies:$gitclonehttps://github.com/phillipdupuis/dtale-desktop.git
$cddtale-desktop
$pythonsetup.pydevelopThen you'll need to install the javascript dependencies and build the react app:$cddtale_desktop/frontend
$npminstall
$npmrunbuildAnd now you should be able to launch it like so:$pythondtale_desktop/app.pyIf you want to modify the front-end, do the following:Launch the python app in the normal wayChange the "proxy" setting infrontend/package.jsonto point at the host/port the python app is running on.npm startto launch the react app. It will run on a different port, but will proxy unknown requests to the python app.SettingsDisabling features:Environment VariableDescriptionDTALEDESKTOP_DISABLE_ADD_DATA_SOURCES"true" if the "Add Data Source" button should not be shown.DTALEDESKTOP_DISABLE_EDIT_DATA_SOURCES"true" if editing existing data sources should not be allowed.DTALEDESKTOP_DISABLE_EDIT_LAYOUT"true" if users should not be allowed to edit what sources are visible or what order they're in.DTALEDESKTOP_DISABLE_PROFILE_REPORTS"true" if the "Profile" option (which builds a pandas_profiling report) should not be shown. This is resource-intensive and currently a bit buggy.DTALEDESKTOP_DISABLE_OPEN_BROWSER"true" if browser should not open upon startupDTALEDESKTOP_DISABLE_DTALE_CELL_EDITS"true" if editing cells in dtale should be disabled.Routing requests:Environment VariableDescriptionDTALEDESKTOP_HOSThost it will run onDTALEDESKTOP_PORTport the main application will useDTALEDESKTOP_DTALE_PORTport the dtale application will useDTALEDESKTOP_ROOT_URLallows you to override how urls are built, which can be useful if you're running it as a service (ie not locally)DTALEDESKTOP_DTALE_ROOT_URLadded in order to support running dtaledesktop in k8s - by using different domain names for the main app and the dtale app, the ingress controller can use that (domain name) to determine which port requests should be sent to.DTALEDESKTOP_ENABLE_WEBSOCKET_CONNECTIONS"true" if real-time updates should be pushed to clients via websocket connection. This is only useful/necessary if you are running it as a service and multiple users can access it simultaneously.Loaders/file storage:Environment VariableDescriptionDTALEDESKTOP_ROOT_DIRthe location where all persistent data (loaders, cached data, etc.) will be stored. By default this is ~/.dtaledesktopDTALEDESKTOP_ADDITIONAL_LOADERS_DIRScomma-separated list of directory paths that should be scanned for data sources upon startupDTALEDESKTOP_EXCLUDE_DEFAULT_LOADERS"true" if the default loaders should not be included in the list of data sources. These are the loaders which look for json, csv, and excel files in your home directory.