dnd-firefly

dnd_firefly

Programmatically load file either drag-and-drop or via URL into Firefly Viewer

Overview

dnd_firefly is a command-line tool that allows you to programmatically upload local files to the Firefly Viewer (IRSA Viewer tool) by simulating a drag-and-drop action or loading from a URL.

This tool is particularly useful for automating data uploads and integrating with scripts or workflows that interact with the Firefly Viewer. This tools complements the existing URL API by enabling support for the Upload feature in scenarios where direct access is not yet available.

Firefly

Firefly is an open-source web-based UI library for astronomical data archive access and visualization developed at Caltech. The development was started in the context of archive-specific applications at the NASA/IPAC Infrared Science Archive (IRSA), and was then generalized to serve data from many different archives at IRSA (and beyond). It was open sourced in 2015, hosted at GitHub.

See details in the GitHub repository and how to install locally.

Compatibility

dnd_firefly tool makes use of IRSA Viewer and is compatible since release 2023.3 (Drag-n-drop introduced - FIREFLY-1310.

Features

• Automate File Uploads: Upload files to the Firefly Viewer without manual intervention.
• Simulate Drag-and-Drop: Programmatically simulate the drag-and-drop action to upload local files or from URL.
• Easy Integration: Integrate seamlessly with existing data processing pipelines or scripts.

Installation

You can install dnd_firefly directly from PyPI using pip:

pip install dnd_firefly

PyPi: https://pypi.org/project/dnd-firefly/

Note: dnd_firefly requires Python 3.11 or higher.

Requirements

• Python 3.11+
• Google Chrome Browser: Ensure that the latest version of Chrome is installed on your system.

How It Works

The tool uses Selenium WebDriver to automate a Chrome browser session. It opens the Firefly Viewer and simulates the drag-and-drop action to upload your specified file or load from URL.

Selenium Manager: Starting from Selenium 4.6.0, Selenium includes Selenium Manager, which automatically manages the browser driver required for automation. If you have Chrome installed, Selenium will handle the rest.

Usage

The dnd_firefly tool accepts one argument: the path to the local file or URL you want to upload to the Firefly Viewer.

Command-Line Usage

For local files:

dnd_firefly /path/to/your/file.tbl

Replace /path/to/your/file.tbl with the actual path to your local file.

For URL:

dnd_firefly <http|https>://.../file.tbl

Replace <http|https>://.../file.tbl with the URL.

Example

To upload a file named WISE-allwise_p3as_psd-Cone_100asec.tbl located in your Downloads folder, run:

dnd_firefly ~/Downloads/WISE-allwise_p3as_psd-Cone_100asec.tbl

Example of VOTable with 2 tables via URL:

dnd_firefly https://raw.githubusercontent.com/ejoliet/playground/refs/heads/master/data/table_IRS_Enh-Spectra-1.vot

Troubleshooting

• Selenium Exceptions: If you encounter errors related to Selenium WebDriver, ensure that you have the latest version of Chrome installed and that your Selenium version is up to date.
• Internet Access: Selenium Manager requires internet access to download the appropriate WebDriver. If you're in an environment with restricted internet access, you may need to manually set up the WebDriver. Refer to the Selenium documentation for more details.
• File Path / URL Issues: Ensure that the file path or URL you provide is correct and that the file exists.

Advanced Usage (Optional)

If you need to use a different browser or have specific requirements, you can manually set up the WebDriver.

Manual WebDriver Setup

1. Download ChromeDriver:

   • Visit the ChromeDriver Downloads page.
   • Download the version that matches your installed Chrome browser version.

2. Install ChromeDriver:

   • Place the chromedriver executable in a directory that's in your system's PATH, or specify its location in the code.

Note: Manual setup is only necessary if Selenium Manager is unable to manage the WebDriver automatically.

Contributing

Contributions are welcome! Please visit the GitHub repository to report issues or submit pull requests.