Documentation

Import File

Overview

"importfile" is the command line tool that, when run, opens a pop-up window prompting the user to browse and select file(s) from their computer to be uploaded.  If a filename is provided for the imported file the pop-up window can alternatively be used to paste text from the user clipboard.  This is most useful in workspace tools which do not allow text to be directly pasted to terminals or other applications.

You can use this command to transfer one or more files from your desktop to your tool session via a web browser.  This command causes a web page to pop up prompting you for various files on your desktop. Choose one or more files and submit the form.  The selected files will be uploaded to your tool session and saved with the file names specified on the command line. You must have popups enabled for this to work properly.

Implementation

This script should be implemented as a background process in a non-rappture tool.  Typically a pipe is used to run this script off the main process of the tool.  The piped process should be monitored by the tool code for a response upon completion of the user's file upload.  The script will continue to wait for a file to be uploaded indefinitely.  Please code appropriately for this.

Help text

USAGE: /usr/bin/importfile [-f|--for text] [-l|--label text] file file ...

  options:
    -h or --help
      Prints this help message.

    -f or --for <text>
      Short explanation of what the data will be used for; for
      example, "for CNTBands 2.0".  If given, this text is inserted
      into the upload form to help explain what it will be used for.

    -l or --label <text>
      Prompt for subsequent file arguments using this label string.
      The default label just uses the file name.

    -m or --mode acsii|binary|auto
      In "binary" mode, files are transferred exactly as-is.  In
      "ascii" mode, control-M characters are removed, which helps
      when loading Windows files into the Linux environment.  The
      default is "auto", which removes control-M from text files
      but leaves binary files intact.

    -p or --provenance
      Print more verbose results showing the provenance information
      for all files uploaded.  Instead of a series of space-separated
      file names, this produces one line for each file showing the
      final file name and where it came from, which is either the
      file name on the user's desktop or @CLIPBOARD meaning that the
      user pasted information into the text entry area.  For example:
         foo.tgz <= gui15.tar.gz
         bar.txt <= @CLIPBOARD

    --
      Remaining arguments are treated as file names, even if they
      start with a -.

    file
      Uploaded file will be saved in this file name within your
      tool session. If file is @@ then the file is given the same
      name it had before it was uploaded. If no file arguments
      are included, the default is "@@", meaning upload a single
      file and use the name it had on the desktop.

You can use this command to transfer one or more files from your
desktop to your tool session via a web browser.  This command causes
a web page to pop up prompting you for various files on your desktop.
Choose one or more files and submit the form.  The files will be
uploaded to your tool session and saved in the file names specified
on the command line.

This command returns a list of names for files actually uploaded.
 

Last modified:

  • Copyright © 2022 Hubzero
  • Powered by Hubzero®