HTML¶
-
class
astropy.io.ascii.
HTML
(htmldict={})[source] [edit on github]¶ Bases:
astropy.io.ascii.BaseReader
Read and write HTML tables.
In order to customize input and output, a dict of parameters may be passed to this class holding specific customizations.
htmldict : Dictionary of parameters for HTML input/output.
- css : Customized styling
- If present, this parameter will be included in a <style> tag and will define stylistic attributes of the output.
- table_id : ID for the input table
- If a string, this defines the HTML id of the table to be processed. If an integer, this specifies the index of the input table in the available tables. Unless this parameter is given, the reader will use the first table found in the input file.
- multicol : Use multi-dimensional columns for output
- The writer will output tuples as elements of multi-dimensional columns if this parameter is true, and if not then it will use the syntax 1.36583e-13 .. 1.36583e-13 for output. If not present, this parameter will be true by default.
- raw_html_cols : column name or list of names with raw HTML content
- This allows one to include raw HTML content in the column output, for instance to include link references in a table. This option requires that the bleach package be installed. Only whitelisted tags are allowed through for security reasons (see the raw_html_clean_kwargs arg).
- raw_html_clean_kwargs : dict of keyword args controlling HTML cleaning
- Raw HTML will be cleaned to prevent unsafe HTML from ending up in
the table output. This is done by calling
bleach.clean(data, **raw_html_clean_kwargs)
. For details on the available options (e.g. tag whitelist) see: http://bleach.readthedocs.io/en/latest/clean.html
- parser : Specific HTML parsing library to use
- If specified, this specifies which HTML parsing library BeautifulSoup should use as a backend. The options to choose from are ‘html.parser’ (the standard library parser), ‘lxml’ (the recommended parser), ‘xml’ (lxml’s XML parser), and ‘html5lib’. html5lib is a highly lenient parser and therefore might work correctly for unusual input if a different parser fails.
- jsfiles : list of js files to include when writing table.
- cssfiles : list of css files to include when writing table.
- js : js script to include in the body when writing table.
- table_class : css class for the table
Initialize classes for HTML reading and writing.
Methods Summary
fill_values
(col, col_str_iters)Return an iterator of the values with replacements based on fill_values read
(table)Read the table
in HTML format and return a resultingTable
.write
(table)Return data in table
converted to HTML as a list of strings.Methods Documentation
-
fill_values
(col, col_str_iters)[source] [edit on github]¶ Return an iterator of the values with replacements based on fill_values
-
read
(table)[source] [edit on github]¶ Read the
table
in HTML format and return a resultingTable
.
-
write
(table)[source] [edit on github]¶ Return data in
table
converted to HTML as a list of strings.