FIREFLY-1623: Add url param to show_table (and fits)

Also add it to documentation

Author: jaladh-singhal

docs/usage/displaying-images.rst

@@ -221,3 +221,15 @@ It is possible to create a 3-color composite image using a list of dictionaries
     fc.show_fits_3color(threeC,
     plot_id='wise_m101',
     viewer_id='3C')
+
+
+Displaying Image from a URL
+---------------------------
+
+If you have the URL of an image, you can pass it directly instead of 
+downloading it and then uploading it to firefly:
+
+.. code-block:: py
+
+    image_url = 'http://irsa.ipac.caltech.edu/ibe/data/wise/allsky/4band_p1bm_frm/6a/02206a/149/02206a149-w1-int-1b.fits?center=70,20&size=200pix'
+    fc.show_fits(url=image_url, plot_id='wise-allsky', title='WISE all-sky')

docs/usage/viewing-tables.rst

@@ -26,3 +26,10 @@ the table overlaid on the image, `is_catalog=False` can be specified:
 
     fc.show_table(file_on_server=tval, tbl_id='2mass-tbl', is_catalog=False)
 
+If you have the URL of a table, you can pass it directly instead of 
+downloading it and then uploading it to firefly:
+
+.. code-block:: py
+
+    table_url = "http://irsa.ipac.caltech.edu/TAP/sync?FORMAT=IPAC_TABLE&QUERY=SELECT+*+FROM+fp_psc+WHERE+CONTAINS(POINT('J2000',ra,dec),CIRCLE('J2000',70.0,20.0,0.1))=1"
+    fc.show_table(url=table_url, tbl_id='2mass-point-source-catalog')

firefly_client/firefly_client.py

@@ -732,6 +732,8 @@ def show_fits(self, file_on_server=None, plot_id=None, viewer_id=None, **additio
                 Display only a particular image extension from the file (zero-based index).
             **Title** : `str`, optional
                 Title to display with the image.
+            **url** : `str`, optional
+                URL of the fits image file, if it's not a local file you can upload.
 
         Returns
         -------
@@ -803,18 +805,20 @@ def show_fits_3color(self, three_color_params, plot_id=None, viewer_id=None):
         warning and r.update({'warning': warning})
         return r
 
-    def show_table(self, file_on_server=None, tbl_id=None, title=None, page_size=100, is_catalog=True,
+    def show_table(self, file_on_server=None, url=None, tbl_id=None, title=None, page_size=100, is_catalog=True,
                    meta=None, target_search_info=None, options=None, table_index=None,
                    column_spec=None, filters=None, visible=True):
         """
         Show a table.
 
         Parameters
         ----------
-        file_on_server : `str`
+        file_on_server : `str`, optional
             The name of the file on the server.
             If you use `upload_file()`, then it is the return value of the method. Otherwise it is a file that
             Firefly has direct access to.
+        url : `str`, optional
+            URL of the table file, if it's not a local file you can upload.
         tbl_id : `str`, optional
             A table ID. It will be created automatically if not specified.
         title : `str`, optional
@@ -872,28 +876,32 @@ def show_table(self, file_on_server=None, tbl_id=None, title=None, page_size=100
             A string specifying filters. Column names must be quoted.
             For example, '("coord_dec" > -0.478) and ("parent" > 0)'.
         visible: `bool`, optional
-            If false, only load the table to Firefly but don't show it in the UI
+            If false, only load the table to Firefly but don't show it in the UI.
+            Similar to `fetch_table()`
 
         Returns
         -------
         out : `dict`
             Status of the request, like {'success': True}.
 
-        .. note:: `file_on_server` and `target_search_info` are exclusively required.
+        .. note:: `url`, `file_on_server`, and `target_search_info` are exclusively required.
+            If more than one of these 3 parameters are passed, precedence order is:
+            `url` > `file_on_server` > `target_search_info`
         """
 
         if not tbl_id:
             tbl_id = gen_item_id('Table')
         if not title:
-            title = tbl_id if file_on_server else target_search_info.get('catalog', tbl_id)
+            title = tbl_id if file_on_server or url else target_search_info.get('catalog', tbl_id)
 
         meta_info = {'title': title, 'tbl_id': tbl_id}
         meta and meta_info.update(meta)
 
         tbl_req = {'startIdx': 0, 'pageSize': page_size, 'tbl_id': tbl_id}
-        if file_on_server:
+        if file_on_server or url:
             tbl_type = 'table' if not is_catalog else 'catalog'
-            tbl_req.update({'source': file_on_server, 'tblType': tbl_type,
+            source = url if url else file_on_server
+            tbl_req.update({'source': source, 'tblType': tbl_type,
                             'id': 'IpacTableFromSource'})
             table_index and tbl_req.update({'tbl_index': table_index})
         elif target_search_info:
@@ -941,7 +949,6 @@ def fetch_table(self, file_on_server, tbl_id=None, title=None, page_size=1, tabl
         out : `dict`
             Status of the request, like {'success': True}.
         """
-
         if not tbl_id:
             tbl_id = gen_item_id('Table')
         if not title: