From 33f16f05278eaeeb7e03883df9f45e6895acd952 Mon Sep 17 00:00:00 2001 From: Nabil Freij Date: Mon, 25 Jul 2022 10:57:32 -0700 Subject: [PATCH 1/3] typehinting package --- docs/conf.py | 1 + hvpy/api_groups/jpeg2000/get_jp2_header.py | 7 ++--- hvpy/api_groups/jpeg2000/get_jp2_image.py | 16 +++++++----- hvpy/api_groups/jpeg2000/get_jpx.py | 26 +++++++++++-------- .../jpeg2000/get_jpx_closest_to_mid_point.py | 21 ++++++++------- .../official_clients/get_closest_image.py | 9 ++++--- .../official_clients/get_data_sources.py | 15 ++++++----- hvpy/core.py | 6 ++--- setup.cfg | 1 + 9 files changed, 59 insertions(+), 43 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 939661a..bbace13 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -15,6 +15,7 @@ extensions = [ "sphinx.ext.autodoc", "sphinx.ext.napoleon", + "sphinx_autodoc_typehints", "sphinx.ext.intersphinx", "sphinx.ext.todo", "sphinx.ext.coverage", diff --git a/hvpy/api_groups/jpeg2000/get_jp2_header.py b/hvpy/api_groups/jpeg2000/get_jp2_header.py index b432ccb..001bd81 100644 --- a/hvpy/api_groups/jpeg2000/get_jp2_header.py +++ b/hvpy/api_groups/jpeg2000/get_jp2_header.py @@ -10,10 +10,11 @@ class getJP2HeaderInputParameters(HvpyParameters): Attributes ---------- {Shared} - id : int + id Unique JP2 image identifier. - callback : str, optional - Wrap the response object in a function call of your choosing. + callback + Optionally, wrap the response object in a function call of your choosing. + Default is None (no wrapping). References ---------- diff --git a/hvpy/api_groups/jpeg2000/get_jp2_image.py b/hvpy/api_groups/jpeg2000/get_jp2_image.py index cc15876..6586f2f 100644 --- a/hvpy/api_groups/jpeg2000/get_jp2_image.py +++ b/hvpy/api_groups/jpeg2000/get_jp2_image.py @@ -13,14 +13,16 @@ class getJP2ImageInputParameters(HvpyParameters): Attributes ---------- {Shared} - date : datetime.datetime - Desired date/time of the JP2 image. - sourceId : int + date + Desired datetime of the JP2 image. + sourceId Unique image datasource identifier. - jpip : bool, optional - Returns a JPIP URI instead of the binary data of the image if set to `True`, defaults to `False`. - json : bool, optional - Returns the JSON if set to `True`, defaults to `False`. + jpip + Optionally, returns a JPIP URI instead of the binary data of the image if set to True. + Defaults to False. + json + Optionally, returns the JSON if set to `True`. + Defaults to False. References ---------- diff --git a/hvpy/api_groups/jpeg2000/get_jpx.py b/hvpy/api_groups/jpeg2000/get_jpx.py index 8cd967f..131a35c 100644 --- a/hvpy/api_groups/jpeg2000/get_jpx.py +++ b/hvpy/api_groups/jpeg2000/get_jpx.py @@ -14,20 +14,24 @@ class getJPXInputParameters(HvpyParameters): Attributes ---------- {Shared} - startTime : datetime.datetime + startTime Date/Time for the beginning of the JPX movie data. - endTime : datetime.datetime + endTime Date/Time for the end of the JPX movie data. - sourceId : int + sourceId Unique image datasource identifier. - linked : bool, optional - Generate a linked JPX file containing image pointers instead of data for each individual frame in the series. - verbose : bool, optional - If set to true, the JSON response will include timestamps for each frame in the resulting movie and any warning messages associated with the request, in addition to the JPX movie file URI. - jpip : bool, optional - Optionally return a JPIP URI string instead of the binary data of the movie itself, or instead of an HTTP URI in the JSON response (if verbose is set to true). - cadence : int, optional - The desired amount of time (in seconds) between each frame in the movie. + linked + Optionally, generate a linked JPX file containing image pointers instead of data for each individual frame in the series. + Defaults to True. + verbose + Optionally, if set to true, the JSON response will include timestamps for each frame in the resulting movie and any warning messages associated with the request, in addition to the JPX movie file URI. + Defaults to False. + jpip + Optionally, return a JPIP URI string instead of the binary data of the movie itself, or instead of an HTTP URI in the JSON response (if verbose is set to true). + Defaults to False. + cadence + Optionally, The desired amount of time (in seconds) between each frame in the movie. + Defaults to None (maximum cadence). References ---------- diff --git a/hvpy/api_groups/jpeg2000/get_jpx_closest_to_mid_point.py b/hvpy/api_groups/jpeg2000/get_jpx_closest_to_mid_point.py index 228df19..2f5dcbc 100644 --- a/hvpy/api_groups/jpeg2000/get_jpx_closest_to_mid_point.py +++ b/hvpy/api_groups/jpeg2000/get_jpx_closest_to_mid_point.py @@ -14,18 +14,21 @@ class getJPXClosestToMidPointInputParameters(HvpyParameters): Attributes ---------- {Shared} - startTimes : datetime.datetime + startTimes Comma separated timestamps for the beginning of the JPX movie data. - endTimes : datetime.datetime + endTimes Comma separated timestamps for the end of the JPX movie data. - sourceId : int + sourceId Unique image datasource identifier. - linked : bool, optional - Generate a linked JPX file containing image pointers instead of data for each individual frame in the series. - verbose : bool, optional - If set to true, the JSON response will include timestamps for each frame in the resulting movie and any warning messages associated with the request, in addition to the JPX movie file URI. - jpip : bool, optional - Optionally return a JPIP URI string instead of the binary data of the movie itself, or instead of an HTTP URI in the JSON response (if verbose is set to true). + linked + Optionally, generate a linked JPX file containing image pointers instead of data for each individual frame in the series. + Defaults to True. + verbose + Optionally,If set to true, the JSON response will include timestamps for each frame in the resulting movie and any warning messages associated with the request, in addition to the JPX movie file URI. + Defaults to False. + jpip + Optionally, return a JPIP URI string instead of the binary data of the movie itself, or instead of an HTTP URI in the JSON response (if verbose is set to true). + Defaults to False. References ---------- diff --git a/hvpy/api_groups/official_clients/get_closest_image.py b/hvpy/api_groups/official_clients/get_closest_image.py index 7887eb9..0351085 100644 --- a/hvpy/api_groups/official_clients/get_closest_image.py +++ b/hvpy/api_groups/official_clients/get_closest_image.py @@ -14,12 +14,13 @@ class getClosestImageInputParameters(HvpyParameters): Attributes ---------- {Shared} - date : datetime.datetime + date Date and time of the image. - sourceId : int + sourceId Unique image datasource identifier. - callback : str, optional - Wrap the response object in a function call of your choosing. + callback + Optionally, wrap the response object in a function call of your choosing. + Default is None (no wrapping). References ---------- diff --git a/hvpy/api_groups/official_clients/get_data_sources.py b/hvpy/api_groups/official_clients/get_data_sources.py index 61d8842..1376b8e 100644 --- a/hvpy/api_groups/official_clients/get_data_sources.py +++ b/hvpy/api_groups/official_clients/get_data_sources.py @@ -10,12 +10,15 @@ class getDataSourcesInputParameters(HvpyParameters): Attributes ---------- {Shared} - verbose : bool, optional - Output the hierarchical list of available datasources in a format that is compatible with the JHelioviewer desktop client, default is False. - enable : str, optional - Comma-separated list of observatories to enable. - callback : str, optional - Wrap the response object in a function call of your choosing. + verbose + Optionally, output the hierarchical list of available datasources in a format that is compatible with the JHelioviewer desktop client. + Default is False. + enable + Optionally, comma-separated list of observatories to enable. + Default is None (all observatories are enabled). + callback + Optionally, wrap the response object in a function call of your choosing. + Default is None (no wrapping). References ---------- diff --git a/hvpy/core.py b/hvpy/core.py index 770ff41..1220142 100644 --- a/hvpy/core.py +++ b/hvpy/core.py @@ -13,9 +13,9 @@ def parse_response(response: requests.Response, output_type: OutputType) -> Unio Parameters ---------- - response : requests.Response + response The response from the API call. - output_type : hvpy.io.OutputType + output_type The output type. Returns @@ -39,7 +39,7 @@ def execute_api_call(input_parameters: HvpyParameters) -> Union[bytes, str, Dict Parameters ---------- - input_parameters : hvpy.io.HvpyParameters + input_parameters The input parameters. Returns diff --git a/setup.cfg b/setup.cfg index 3c615f7..c6c5385 100644 --- a/setup.cfg +++ b/setup.cfg @@ -41,6 +41,7 @@ tests = pytest>=6.0 docs = sphinx + sphinx-autodoc-typehints sphinx-automodapi sunpy-sphinx-theme From 4942f0a483d16e4e2e9641a090afbd90488dcc75 Mon Sep 17 00:00:00 2001 From: Nabil Freij Date: Mon, 25 Jul 2022 11:25:20 -0700 Subject: [PATCH 2/3] try out a new theme --- docs/conf.py | 11 ++++++++--- setup.cfg | 2 +- 2 files changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index bbace13..bbd90e5 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -63,6 +63,11 @@ } # -- Options for HTML output --------------------------------------------------- -# The theme to use for HTML and HTML Help pages. See the documentation for -# a list of builtin themes. -from sunpy_sphinx_theme.conf import * # NOQA +# The theme to use for HTML and HTML Help pages. +html_theme = "sphinx_book_theme" +html_theme_options = { + "repository_url": "https://github.com/Helioviewer-Project/python-api/", + "use_repository_button": True, +} +html_title = "hvpy" +extra_navbar = "" diff --git a/setup.cfg b/setup.cfg index c6c5385..73b0676 100644 --- a/setup.cfg +++ b/setup.cfg @@ -43,7 +43,7 @@ docs = sphinx sphinx-autodoc-typehints sphinx-automodapi - sunpy-sphinx-theme + sphinx-book-theme [tool:pytest] testpaths = "hvpy" "docs" From 978080b941799c0990ea322541ce88c028446b73 Mon Sep 17 00:00:00 2001 From: Nabil Freij Date: Mon, 1 Aug 2022 13:51:38 -0700 Subject: [PATCH 3/3] update more doc strings --- docs/conf.py | 2 +- hvpy/api_groups/jpeg2000/get_jp2_header.py | 6 +- hvpy/api_groups/jpeg2000/get_jp2_image.py | 8 +- hvpy/api_groups/jpeg2000/get_jpx.py | 24 ++--- .../jpeg2000/get_jpx_closest_to_mid_point.py | 18 ++-- hvpy/api_groups/jpeg2000/get_status.py | 2 +- .../official_clients/get_closest_image.py | 4 +- .../official_clients/get_data_sources.py | 10 +- .../screenshots/download_screenshot.py | 6 +- .../api_groups/screenshots/take_screenshot.py | 99 ++++++++++++------- hvpy/facade.py | 12 +-- 11 files changed, 110 insertions(+), 81 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index bbd90e5..2da64cf 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -68,6 +68,6 @@ html_theme_options = { "repository_url": "https://github.com/Helioviewer-Project/python-api/", "use_repository_button": True, + "extra_navbar": "", } html_title = "hvpy" -extra_navbar = "" diff --git a/hvpy/api_groups/jpeg2000/get_jp2_header.py b/hvpy/api_groups/jpeg2000/get_jp2_header.py index 001bd81..e14c227 100644 --- a/hvpy/api_groups/jpeg2000/get_jp2_header.py +++ b/hvpy/api_groups/jpeg2000/get_jp2_header.py @@ -5,7 +5,7 @@ class getJP2HeaderInputParameters(HvpyParameters): """ - Handles the input parameters of the getJP2Header API. + Handles the input parameters of the ``getJP2Header`` API. Attributes ---------- @@ -13,8 +13,8 @@ class getJP2HeaderInputParameters(HvpyParameters): id Unique JP2 image identifier. callback - Optionally, wrap the response object in a function call of your choosing. - Default is None (no wrapping). + Wrap the response object in a function call of your choosing. + Default is `None` (no wrapping), optional. References ---------- diff --git a/hvpy/api_groups/jpeg2000/get_jp2_image.py b/hvpy/api_groups/jpeg2000/get_jp2_image.py index 6586f2f..8633d89 100644 --- a/hvpy/api_groups/jpeg2000/get_jp2_image.py +++ b/hvpy/api_groups/jpeg2000/get_jp2_image.py @@ -8,7 +8,7 @@ class getJP2ImageInputParameters(HvpyParameters): """ - Handles the input parameters of the getJP2Image API. + Handles the input parameters of the ``getJP2Image`` API. Attributes ---------- @@ -18,11 +18,11 @@ class getJP2ImageInputParameters(HvpyParameters): sourceId Unique image datasource identifier. jpip - Optionally, returns a JPIP URI instead of the binary data of the image if set to True. - Defaults to False. + Returns a JPIP URI instead of the binary data of the image if set to True. + Default is `False`, optional. json Optionally, returns the JSON if set to `True`. - Defaults to False. + Default is `False`, optional. References ---------- diff --git a/hvpy/api_groups/jpeg2000/get_jpx.py b/hvpy/api_groups/jpeg2000/get_jpx.py index 131a35c..7613b12 100644 --- a/hvpy/api_groups/jpeg2000/get_jpx.py +++ b/hvpy/api_groups/jpeg2000/get_jpx.py @@ -9,29 +9,31 @@ class getJPXInputParameters(HvpyParameters): """ - Handles the input parameters of the getJPX API. + Handles the input parameters of the ``getJPX`` API. Attributes ---------- {Shared} startTime - Date/Time for the beginning of the JPX movie data. + Datetime for the beginning of the JPX movie data. endTime - Date/Time for the end of the JPX movie data. + Datetime for the end of the JPX movie data. sourceId Unique image datasource identifier. linked - Optionally, generate a linked JPX file containing image pointers instead of data for each individual frame in the series. - Defaults to True. + Generate a linked JPX file containing image pointers instead of data for each individual frame in the series. + Default is `True`, optional. verbose - Optionally, if set to true, the JSON response will include timestamps for each frame in the resulting movie and any warning messages associated with the request, in addition to the JPX movie file URI. - Defaults to False. + if set to `True`, the JSON response will include timestamps for each frame in the resulting movie + and any warning messages associated with the request. + In addition to the JPX movie file URI. + Default is `False`, optional. jpip - Optionally, return a JPIP URI string instead of the binary data of the movie itself, or instead of an HTTP URI in the JSON response (if verbose is set to true). - Defaults to False. + Return a JPIP URI string instead of the binary data of the movie itself, or instead of an HTTP URI in the JSON response (if ``verbose`` is set to `True`). + Default is `False`, optional. cadence - Optionally, The desired amount of time (in seconds) between each frame in the movie. - Defaults to None (maximum cadence). + The desired amount of time (in seconds) between each frame in the movie. + Default is `None` (maximum cadence), optional. References ---------- diff --git a/hvpy/api_groups/jpeg2000/get_jpx_closest_to_mid_point.py b/hvpy/api_groups/jpeg2000/get_jpx_closest_to_mid_point.py index 2f5dcbc..213799c 100644 --- a/hvpy/api_groups/jpeg2000/get_jpx_closest_to_mid_point.py +++ b/hvpy/api_groups/jpeg2000/get_jpx_closest_to_mid_point.py @@ -9,26 +9,26 @@ class getJPXClosestToMidPointInputParameters(HvpyParameters): """ - Handles the input parameters of the getJPXClosestToMidPoint API. + Handles the input parameters of the ``getJPXClosestToMidPoint`` API. Attributes ---------- {Shared} startTimes - Comma separated timestamps for the beginning of the JPX movie data. + A list of datetimes for the beginning of the JPX movie data. endTimes - Comma separated timestamps for the end of the JPX movie data. + A list of datetimes for the end of the JPX movie data. sourceId Unique image datasource identifier. linked - Optionally, generate a linked JPX file containing image pointers instead of data for each individual frame in the series. - Defaults to True. + Generate a linked JPX file containing image pointers instead of data for each individual frame in the series. + Default is `True`, optional. verbose - Optionally,If set to true, the JSON response will include timestamps for each frame in the resulting movie and any warning messages associated with the request, in addition to the JPX movie file URI. - Defaults to False. + If set, the JSON response will include timestamps for each frame in the resulting movie and any warning messages associated with the request, in addition to the JPX movie file URI. + Default is `False`, optional. jpip - Optionally, return a JPIP URI string instead of the binary data of the movie itself, or instead of an HTTP URI in the JSON response (if verbose is set to true). - Defaults to False. + Return a JPIP URI string instead of the binary data of the movie itself, or instead of an HTTP URI in the JSON response (if ``verbose`` is set to `True`). + Default is `False`, optional. References ---------- diff --git a/hvpy/api_groups/jpeg2000/get_status.py b/hvpy/api_groups/jpeg2000/get_status.py index fe4c3ac..5796b7b 100644 --- a/hvpy/api_groups/jpeg2000/get_status.py +++ b/hvpy/api_groups/jpeg2000/get_status.py @@ -3,7 +3,7 @@ class getStatusInputParameters(HvpyParameters): """ - handles the input parameters of the getStatus API. + Handles the input parameters of the ``getStatus`` API. {Shared} References diff --git a/hvpy/api_groups/official_clients/get_closest_image.py b/hvpy/api_groups/official_clients/get_closest_image.py index 0351085..a056d3c 100644 --- a/hvpy/api_groups/official_clients/get_closest_image.py +++ b/hvpy/api_groups/official_clients/get_closest_image.py @@ -9,7 +9,7 @@ class getClosestImageInputParameters(HvpyParameters): """ - Handles the input parameters of the getClosestImage API. + Handles the input parameters of the ``getClosestImage`` API. Attributes ---------- @@ -20,7 +20,7 @@ class getClosestImageInputParameters(HvpyParameters): Unique image datasource identifier. callback Optionally, wrap the response object in a function call of your choosing. - Default is None (no wrapping). + Default is `None` (no wrapping), optional. References ---------- diff --git a/hvpy/api_groups/official_clients/get_data_sources.py b/hvpy/api_groups/official_clients/get_data_sources.py index 1376b8e..2940944 100644 --- a/hvpy/api_groups/official_clients/get_data_sources.py +++ b/hvpy/api_groups/official_clients/get_data_sources.py @@ -5,20 +5,20 @@ class getDataSourcesInputParameters(HvpyParameters): """ - Handles the input parameters of the getDataSources API. + Handles the input parameters of the ``getDataSources`` API. Attributes ---------- {Shared} verbose - Optionally, output the hierarchical list of available datasources in a format that is compatible with the JHelioviewer desktop client. - Default is False. + Output the hierarchical list of available datasources in a format that is compatible with the JHelioviewer desktop client. + Default is `False`, optional. enable Optionally, comma-separated list of observatories to enable. - Default is None (all observatories are enabled). + Default is `None` (all observatories are enabled), optional. callback Optionally, wrap the response object in a function call of your choosing. - Default is None (no wrapping). + Default is `None` (no wrapping), optional. References ---------- diff --git a/hvpy/api_groups/screenshots/download_screenshot.py b/hvpy/api_groups/screenshots/download_screenshot.py index 41cbbe3..a777ebd 100644 --- a/hvpy/api_groups/screenshots/download_screenshot.py +++ b/hvpy/api_groups/screenshots/download_screenshot.py @@ -3,13 +3,13 @@ class downloadScreenshotInputParameters(HvpyParameters): """ - Handles the input parameters of the downloadScreenshot API. + Handles the input parameters of the ``downloadScreenshot`` API. Attributes ---------- {Shared} - id: int - Unique screenshot identifier (provided by the response to a takeScreenshot request). + id + Unique screenshot identifier (provided by the response to a ``takeScreenshot`` request). References ---------- diff --git a/hvpy/api_groups/screenshots/take_screenshot.py b/hvpy/api_groups/screenshots/take_screenshot.py index 579f751..73785d7 100644 --- a/hvpy/api_groups/screenshots/take_screenshot.py +++ b/hvpy/api_groups/screenshots/take_screenshot.py @@ -9,51 +9,78 @@ class takeScreenshotInputParameters(HvpyParameters): """ - Handles the input parameters of the takeScreenshot API. + Handles the input parameters of the ``takeScreenshot`` API. Attributes ---------- {Shared} - date : datetime.datetime - Desired date/time of the image. - imageScale : float + date + Desired datetime of the image. + imageScale Image scale in arcseconds per pixel. - layers : str + layers Image datasource layer(s) to include in the screenshot. - eventLabels : bool - Optionally annotate each event marker with a text label. - events : str, optional - List feature/event types and FRMs to use to annoate the movie. Use the empty string to indicate that no feature/event annotations should be shown. - scale : bool, optional - Optionally overlay an image scale indicator. - scaleType : str, optional - Image scale indicator. - scaleX : int, optional + events + List feature/event types and FRMs to use to annotate the movie. + Use the empty string to indicate that no feature/event annotations should be shown. + Default is `None`, optional. + eventLabels + Annotate each event marker with a text label. + Default is `False`, optional. + scale + Overlay an image scale indicator. + Default is `False`, optional. + scaleType + The Image scale indicator. + Default is `None`, optional. + scaleX Horizontal offset of the image scale indicator in arcseconds with respect to the center of the Sun. - scaleY : int, optional + Default is `None`, optional. + scaleY Vertical offset of the image scale indicator in arcseconds with respect to the center of the Sun. - width : str, optional - Width of the field of view in pixels. (Used in conjunction width x0,`y0`, and height). - height : str, optional - Height of the field of view in pixels. (Used in conjunction width x0,`y0`, and width). - x0 : str, optional - The horizontal offset of the center of the field of view from the center of the Sun. Used in conjunction with y0, width, and height. - y0 : str, optional - The vertical offset of the center of the field of view from the center of the Sun. Used in conjunction with x0, width, and height. - x1 : str, optional - The horizontal offset of the top-left corner of the field of view with respect to the center of the Sun (in arcseconds). Used in conjunction with y1, x2, and y2. - y1 : str, optional - The vertical offset of the top-left corner of the field of view with respect to the center of the Sun (in arcseconds). Used in conjunction with x1, x2, and y2. - x2 : str, optional - The horizontal offset of the bottom-right corner of the field of view with respect to the center of the Sun (in arcseconds). Used in conjunction with x1, y1, and y2. - y2 : str, optional - The vertical offset of the bottom-right corner of the field of view with respect to the center of the Sun (in arcseconds). Used in conjunction with x1, y1, and x2. - display : bool, optional - Set to true to directly output binary PNG image data. Default is `False` (which outputs a JSON object). - watermark : bool, optional - Optionally overlay a watermark consisting of a Helioviewer logo and the datasource abbreviation(s) and timestamp(s) displayed in the screenshot. - callback : str, optional + Default is `None`, optional. + width + Width of the field of view in pixels. + Used in conjunction width ``x0``,``y0``, and ``height``. + Default is `None`, optional. + height + Height of the field of view in pixels. + Used in conjunction width ``x0``,``y0``, and ``width``. + Default is `None`, optional. + x0 + The horizontal offset of the center of the field of view from the center of the Sun. + Used in conjunction with ``y0``, ``width``, and ``height``. + Default is `None`, optional. + y0 + The vertical offset of the center of the field of view from the center of the Sun. + Used in conjunction with ``x0``, ``width``, and ``height``. + Default is `None`, optional. + x1 + The horizontal offset of the top-left corner of the field of view with respect to the center of the Sun (in arcseconds). + Used in conjunction with ``y1``, ``x2``, and ``y2``. + Default is `None`, optional. + y1 + The vertical offset of the top-left corner of the field of view with respect to the center of the Sun (in arcseconds). + Used in conjunction with ``x1``, ``x2``, and ``y2``. + Default is `None`, optional. + x2 + The horizontal offset of the bottom-right corner of the field of view with respect to the center of the Sun (in arcseconds). + Used in conjunction with ``x1``, ``y1``, and ``y2``. + Default is `None`, optional. + y2 + The vertical offset of the bottom-right corner of the field of view with respect to the center of the Sun (in arcseconds). + Used in conjunction with ``x1``, ``y1``, and ``x2``. + Default is `None`, optional. + display + Set to true to directly output binary PNG image data. + Default is `False` (which outputs a JSON object), optional. + watermark + Overlay a watermark consisting of a Helioviewer logo, the datasource abbreviation(s) and timestamp(s) displayed in the screenshot. + Default is `False`, optional. + Optional. + callback Wrap the response object in a function call of your choosing. + Default is `None` (no wrapping), optional. References ---------- diff --git a/hvpy/facade.py b/hvpy/facade.py index 4b26ea9..9b3cf21 100644 --- a/hvpy/facade.py +++ b/hvpy/facade.py @@ -74,7 +74,7 @@ def getJPXClosestToMidPoint( ) -> Union[bytes, str, Dict[str, Any]]: """ Generate and (optionally) download a custom JPX movie of the specified - datasource with one frame per pair of startTimes/endTimes parameters. + datasource with one frame per pair of start/endtimes given. Parameters ---------- @@ -165,9 +165,9 @@ def getClosestImage( callback: Optional[str] = None, ) -> Union[bytes, str, Dict[str, Any]]: """ - Find the image data that is closest to the requested date/time. Return the - associated metadata from the helioviewer database and the XML header of the - JPEG2000 image file. + Find the image data that is closest to the requested datetime. + + Return the associated metadata from the helioviewer database and the XML header of the JPEG2000 image file. Parameters ---------- @@ -284,8 +284,8 @@ def takeScreenshot( @add_shared_docstring(downloadScreenshotInputParameters) def downloadScreenshot(id: int) -> Union[bytes, str, Dict[str, Any]]: """ - Download a custom screenshot (that was generated using the `takeScreenshot` - API endpoint). + Download a custom screenshot that was generated using the + ``takeScreenshot`` API endpoint. Parameters ----------