552 lines
17 KiB
GDScript3
552 lines
17 KiB
GDScript3
|
# The MIT License (MIT)
|
||
|
#
|
||
|
# Copyright (c) 2018 George Marques
|
||
|
#
|
||
|
# Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
|
# of this software and associated documentation files (the "Software"), to deal
|
||
|
# in the Software without restriction, including without limitation the rights
|
||
|
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
|
# copies of the Software, and to permit persons to whom the Software is
|
||
|
# furnished to do so, subject to the following conditions:
|
||
|
#
|
||
|
# The above copyright notice and this permission notice shall be included in all
|
||
|
# copies or substantial portions of the Software.
|
||
|
#
|
||
|
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
|
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
|
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
|
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
|
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
|
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||
|
# SOFTWARE.
|
||
|
|
||
|
tool
|
||
|
extends Reference
|
||
|
|
||
|
# Reads a TMX file from a path and return a Dictionary with the same structure
|
||
|
# as the JSON map format
|
||
|
# Returns an error code if failed
|
||
|
func read_tmx(path):
|
||
|
var parser = XMLParser.new()
|
||
|
var err = parser.open(path)
|
||
|
if err != OK:
|
||
|
printerr("Error opening TMX file '%s'." % [path])
|
||
|
return err
|
||
|
|
||
|
while parser.get_node_type() != XMLParser.NODE_ELEMENT:
|
||
|
err = parser.read()
|
||
|
if err != OK:
|
||
|
printerr("Error parsing TMX file '%s' (around line %d)." % [path, parser.get_current_line()])
|
||
|
return err
|
||
|
|
||
|
if parser.get_node_name().to_lower() != "map":
|
||
|
printerr("Error parsing TMX file '%s'. Expected 'map' element.")
|
||
|
return ERR_INVALID_DATA
|
||
|
|
||
|
var data = attributes_to_dict(parser)
|
||
|
if not "infinite" in data:
|
||
|
data.infinite = false
|
||
|
data.type = "map"
|
||
|
data.tilesets = []
|
||
|
data.layers = []
|
||
|
|
||
|
err = parser.read()
|
||
|
if err != OK:
|
||
|
printerr("Error parsing TMX file '%s' (around line %d)." % [path, parser.get_current_line()])
|
||
|
return err
|
||
|
|
||
|
while err == OK:
|
||
|
if parser.get_node_type() == XMLParser.NODE_ELEMENT_END:
|
||
|
if parser.get_node_name() == "map":
|
||
|
break
|
||
|
elif parser.get_node_type() == XMLParser.NODE_ELEMENT:
|
||
|
if parser.get_node_name() == "tileset":
|
||
|
# Empty element means external tileset
|
||
|
if not parser.is_empty():
|
||
|
var tileset = parse_tileset(parser)
|
||
|
if typeof(tileset) != TYPE_DICTIONARY:
|
||
|
# Error happened
|
||
|
return err
|
||
|
data.tilesets.push_back(tileset)
|
||
|
else:
|
||
|
var tileset_data = attributes_to_dict(parser)
|
||
|
if not "source" in tileset_data:
|
||
|
printerr("Error parsing TMX file '%s'. Missing tileset source (around line %d)." % [path, parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
data.tilesets.push_back(tileset_data)
|
||
|
|
||
|
elif parser.get_node_name() == "layer":
|
||
|
var layer = parse_tile_layer(parser, data.infinite)
|
||
|
if typeof(layer) != TYPE_DICTIONARY:
|
||
|
printerr("Error parsing TMX file '%s'. Invalid tile layer data (around line %d)." % [path, parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
data.layers.push_back(layer)
|
||
|
|
||
|
elif parser.get_node_name() == "imagelayer":
|
||
|
var layer = parse_image_layer(parser)
|
||
|
if typeof(layer) != TYPE_DICTIONARY:
|
||
|
printerr("Error parsing TMX file '%s'. Invalid image layer data (around line %d)." % [path, parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
data.layers.push_back(layer)
|
||
|
|
||
|
elif parser.get_node_name() == "objectgroup":
|
||
|
var layer = parse_object_layer(parser)
|
||
|
if typeof(layer) != TYPE_DICTIONARY:
|
||
|
printerr("Error parsing TMX file '%s'. Invalid object layer data (around line %d)." % [path, parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
data.layers.push_back(layer)
|
||
|
|
||
|
elif parser.get_node_name() == "group":
|
||
|
var layer = parse_group_layer(parser, data.infinite)
|
||
|
if typeof(layer) != TYPE_DICTIONARY:
|
||
|
printerr("Error parsing TMX file '%s'. Invalid group layer data (around line %d)." % [path, parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
data.layers.push_back(layer)
|
||
|
|
||
|
elif parser.get_node_name() == "properties":
|
||
|
var prop_data = parse_properties(parser)
|
||
|
if typeof(prop_data) == TYPE_STRING:
|
||
|
return prop_data
|
||
|
|
||
|
data.properties = prop_data.properties
|
||
|
data.propertytypes = prop_data.propertytypes
|
||
|
|
||
|
err = parser.read()
|
||
|
|
||
|
return data
|
||
|
|
||
|
# Reads a TSX and return a tileset dictionary
|
||
|
# Returns an error code if fails
|
||
|
func read_tsx(path):
|
||
|
var parser = XMLParser.new()
|
||
|
var err = parser.open(path)
|
||
|
if err != OK:
|
||
|
printerr("Error opening TSX file '%s'." % [path])
|
||
|
return err
|
||
|
|
||
|
while parser.get_node_type() != XMLParser.NODE_ELEMENT:
|
||
|
err = parser.read()
|
||
|
if err != OK:
|
||
|
printerr("Error parsing TSX file '%s' (around line %d)." % [path, parser.get_current_line()])
|
||
|
return err
|
||
|
|
||
|
if parser.get_node_name().to_lower() != "tileset":
|
||
|
printerr("Error parsing TMX file '%s'. Expected 'map' element.")
|
||
|
return ERR_INVALID_DATA
|
||
|
|
||
|
var tileset = parse_tileset(parser)
|
||
|
|
||
|
return tileset
|
||
|
|
||
|
# Parses a tileset element from the XML and return a dictionary
|
||
|
# Return an error code if fails
|
||
|
func parse_tileset(parser):
|
||
|
var err = OK
|
||
|
var data = attributes_to_dict(parser)
|
||
|
data.tiles = {}
|
||
|
|
||
|
err = parser.read()
|
||
|
while err == OK:
|
||
|
if parser.get_node_type() == XMLParser.NODE_ELEMENT_END:
|
||
|
if parser.get_node_name() == "tileset":
|
||
|
break
|
||
|
|
||
|
elif parser.get_node_type() == XMLParser.NODE_ELEMENT:
|
||
|
if parser.get_node_name() == "tile":
|
||
|
var attr = attributes_to_dict(parser)
|
||
|
var tile_data = parse_tile_data(parser)
|
||
|
if typeof(tile_data) != TYPE_DICTIONARY:
|
||
|
# Error happened
|
||
|
return tile_data
|
||
|
if "properties" in tile_data and "propertytypes" in tile_data:
|
||
|
if not "tileproperties" in data:
|
||
|
data.tileproperties = {}
|
||
|
data.tilepropertytypes = {}
|
||
|
data.tileproperties[str(attr.id)] = tile_data.properties
|
||
|
data.tilepropertytypes[str(attr.id)] = tile_data.propertytypes
|
||
|
tile_data.erase("tileproperties")
|
||
|
tile_data.erase("tilepropertytypes")
|
||
|
data.tiles[str(attr.id)] = tile_data
|
||
|
|
||
|
elif parser.get_node_name() == "image":
|
||
|
var attr = attributes_to_dict(parser)
|
||
|
if not "source" in attr:
|
||
|
printerr("Error loading image tag. No source attribute found (around line %d)." % [parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
data.image = attr.source
|
||
|
if "width" in attr:
|
||
|
data.imagewidth = attr.width
|
||
|
if "height" in attr:
|
||
|
data.imageheight = attr.height
|
||
|
|
||
|
elif parser.get_node_name() == "properties":
|
||
|
var prop_data = parse_properties(parser)
|
||
|
if typeof(prop_data) != TYPE_DICTIONARY:
|
||
|
# Error happened
|
||
|
return prop_data
|
||
|
|
||
|
data.properties = prop_data.properties
|
||
|
data.propertytypes = prop_data.propertytypes
|
||
|
|
||
|
err = parser.read()
|
||
|
|
||
|
return data
|
||
|
|
||
|
|
||
|
# Parses the data of a single tile from the XML and return a dictionary
|
||
|
# Returns an error code if fails
|
||
|
func parse_tile_data(parser):
|
||
|
var err = OK
|
||
|
var data = {}
|
||
|
var obj_group = {}
|
||
|
if parser.is_empty():
|
||
|
return data
|
||
|
|
||
|
err = parser.read()
|
||
|
while err == OK:
|
||
|
|
||
|
if parser.get_node_type() == XMLParser.NODE_ELEMENT_END:
|
||
|
if parser.get_node_name() == "tile":
|
||
|
return data
|
||
|
elif parser.get_node_name() == "objectgroup":
|
||
|
data.objectgroup = obj_group
|
||
|
|
||
|
elif parser.get_node_type() == XMLParser.NODE_ELEMENT:
|
||
|
if parser.get_node_name() == "image":
|
||
|
# If there are multiple images in one tile we only use the last one.
|
||
|
var attr = attributes_to_dict(parser)
|
||
|
if not "source" in attr:
|
||
|
printerr("Error loading image tag. No source attribute found (around line %d)." % [parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
data.image = attr.source
|
||
|
data.imagewidth = attr.width
|
||
|
data.imageheight = attr.height
|
||
|
|
||
|
elif parser.get_node_name() == "objectgroup":
|
||
|
obj_group = attributes_to_dict(parser)
|
||
|
for attr in ["width", "height", "offsetx", "offsety"]:
|
||
|
if not attr in obj_group:
|
||
|
data[attr] = 0
|
||
|
if not "opacity" in data:
|
||
|
data.opacity = 1
|
||
|
if not "visible" in data:
|
||
|
data.visible = true
|
||
|
if parser.is_empty():
|
||
|
data.objectgroup = obj_group
|
||
|
|
||
|
elif parser.get_node_name() == "object":
|
||
|
if not "objects" in obj_group:
|
||
|
obj_group.objects = []
|
||
|
var obj = parse_object(parser)
|
||
|
if typeof(obj) != TYPE_DICTIONARY:
|
||
|
# Error happened
|
||
|
return obj
|
||
|
obj_group.objects.push_back(obj)
|
||
|
|
||
|
elif parser.get_node_name() == "properties":
|
||
|
var prop_data = parse_properties(parser)
|
||
|
data["properties"] = prop_data.properties
|
||
|
data["propertytypes"] = prop_data.propertytypes
|
||
|
|
||
|
err = parser.read()
|
||
|
|
||
|
return data
|
||
|
|
||
|
# Parses the data of a single object from the XML and return a dictionary
|
||
|
# Returns an error code if fails
|
||
|
static func parse_object(parser):
|
||
|
var err = OK
|
||
|
var data = attributes_to_dict(parser)
|
||
|
|
||
|
if not parser.is_empty():
|
||
|
err = parser.read()
|
||
|
while err == OK:
|
||
|
if parser.get_node_type() == XMLParser.NODE_ELEMENT_END:
|
||
|
if parser.get_node_name() == "object":
|
||
|
break
|
||
|
|
||
|
elif parser.get_node_type() == XMLParser.NODE_ELEMENT:
|
||
|
if parser.get_node_name() == "properties":
|
||
|
var prop_data = parse_properties(parser)
|
||
|
data["properties"] = prop_data.properties
|
||
|
data["propertytypes"] = prop_data.propertytypes
|
||
|
|
||
|
elif parser.get_node_name() == "point":
|
||
|
data.point = true
|
||
|
|
||
|
elif parser.get_node_name() == "ellipse":
|
||
|
data.ellipse = true
|
||
|
|
||
|
elif parser.get_node_name() == "polygon" or parser.get_node_name() == "polyline":
|
||
|
var points = []
|
||
|
var points_raw = parser.get_named_attribute_value("points").split(" ", false, 0)
|
||
|
|
||
|
for pr in points_raw:
|
||
|
points.push_back({
|
||
|
"x": float(pr.split(",")[0]),
|
||
|
"y": float(pr.split(",")[1]),
|
||
|
})
|
||
|
|
||
|
data[parser.get_node_name()] = points
|
||
|
|
||
|
err = parser.read()
|
||
|
|
||
|
return data
|
||
|
|
||
|
|
||
|
# Parses a tile layer from the XML and return a dictionary
|
||
|
# Returns an error code if fails
|
||
|
func parse_tile_layer(parser, infinite):
|
||
|
var err = OK
|
||
|
var data = attributes_to_dict(parser)
|
||
|
data.type = "tilelayer"
|
||
|
if not "x" in data:
|
||
|
data.x = 0
|
||
|
if not "y" in data:
|
||
|
data.y = 0
|
||
|
if infinite:
|
||
|
data.chunks = []
|
||
|
else:
|
||
|
data.data = []
|
||
|
|
||
|
var current_chunk = null
|
||
|
var encoding = ""
|
||
|
|
||
|
if not parser.is_empty():
|
||
|
err = parser.read()
|
||
|
|
||
|
while err == OK:
|
||
|
if parser.get_node_type() == XMLParser.NODE_ELEMENT_END:
|
||
|
if parser.get_node_name() == "layer":
|
||
|
break
|
||
|
elif parser.get_node_name() == "chunk":
|
||
|
data.chunks.push_back(current_chunk)
|
||
|
current_chunk = null
|
||
|
|
||
|
elif parser.get_node_type() == XMLParser.NODE_ELEMENT:
|
||
|
if parser.get_node_name() == "data":
|
||
|
var attr = attributes_to_dict(parser)
|
||
|
|
||
|
if "compression" in attr:
|
||
|
data.compression = attr.compression
|
||
|
|
||
|
if "encoding" in attr:
|
||
|
encoding = attr.encoding
|
||
|
if attr.encoding != "csv":
|
||
|
data.encoding = attr.encoding
|
||
|
|
||
|
if not infinite:
|
||
|
err = parser.read()
|
||
|
if err != OK:
|
||
|
return err
|
||
|
|
||
|
if attr.encoding != "csv":
|
||
|
data.data = parser.get_node_data().strip_edges()
|
||
|
else:
|
||
|
var csv = parser.get_node_data().split(",", false)
|
||
|
|
||
|
for v in csv:
|
||
|
data.data.push_back(int(v.strip_edges()))
|
||
|
|
||
|
elif parser.get_node_name() == "tile":
|
||
|
var gid = int(parser.get_named_attribute_value_safe("gid"))
|
||
|
if infinite:
|
||
|
current_chunk.data.push_back(gid)
|
||
|
else:
|
||
|
data.data.push_back(gid)
|
||
|
|
||
|
elif parser.get_node_name() == "chunk":
|
||
|
current_chunk = attributes_to_dict(parser)
|
||
|
current_chunk.data = []
|
||
|
if encoding != "":
|
||
|
err = parser.read()
|
||
|
if err != OK:
|
||
|
return err
|
||
|
if encoding != "csv":
|
||
|
current_chunk.data = parser.get_node_data().strip_edges()
|
||
|
else:
|
||
|
var csv = parser.get_node_data().split(",", false)
|
||
|
for v in csv:
|
||
|
current_chunk.data.push_back(int(v.strip_edges()))
|
||
|
|
||
|
elif parser.get_node_name() == "properties":
|
||
|
var prop_data = parse_properties(parser)
|
||
|
if typeof(prop_data) == TYPE_STRING:
|
||
|
return prop_data
|
||
|
|
||
|
data.properties = prop_data.properties
|
||
|
data.propertytypes = prop_data.propertytypes
|
||
|
|
||
|
err = parser.read()
|
||
|
|
||
|
return data
|
||
|
|
||
|
# Parses an object layer from the XML and return a dictionary
|
||
|
# Returns an error code if fails
|
||
|
func parse_object_layer(parser):
|
||
|
var err = OK
|
||
|
var data = attributes_to_dict(parser)
|
||
|
data.type = "objectgroup"
|
||
|
data.objects = []
|
||
|
|
||
|
if not parser.is_empty():
|
||
|
err = parser.read()
|
||
|
while err == OK:
|
||
|
if parser.get_node_type() == XMLParser.NODE_ELEMENT_END:
|
||
|
if parser.get_node_name() == "objectgroup":
|
||
|
break
|
||
|
if parser.get_node_type() == XMLParser.NODE_ELEMENT:
|
||
|
if parser.get_node_name() == "object":
|
||
|
data.objects.push_back(parse_object(parser))
|
||
|
elif parser.get_node_name() == "properties":
|
||
|
var prop_data = parse_properties(parser)
|
||
|
if typeof(prop_data) != TYPE_DICTIONARY:
|
||
|
# Error happened
|
||
|
return prop_data
|
||
|
data.properties = prop_data.properties
|
||
|
data.propertytypes = prop_data.propertytypes
|
||
|
|
||
|
err = parser.read()
|
||
|
|
||
|
return data
|
||
|
|
||
|
# Parses an image layer from the XML and return a dictionary
|
||
|
# Returns an error code if fails
|
||
|
func parse_image_layer(parser):
|
||
|
var err = OK
|
||
|
var data = attributes_to_dict(parser)
|
||
|
data.type = "imagelayer"
|
||
|
data.image = ""
|
||
|
|
||
|
if not parser.is_empty():
|
||
|
err = parser.read()
|
||
|
|
||
|
while err == OK:
|
||
|
if parser.get_node_type() == XMLParser.NODE_ELEMENT_END:
|
||
|
if parser.get_node_name().to_lower() == "imagelayer":
|
||
|
break
|
||
|
elif parser.get_node_type() == XMLParser.NODE_ELEMENT:
|
||
|
if parser.get_node_name().to_lower() == "image":
|
||
|
var image = attributes_to_dict(parser)
|
||
|
if not image.has("source"):
|
||
|
printerr("Missing source attribute in imagelayer (around line %d)." % [parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
data.image = image.source
|
||
|
|
||
|
elif parser.get_node_name() == "properties":
|
||
|
var prop_data = parse_properties(parser)
|
||
|
if typeof(prop_data) != TYPE_DICTIONARY:
|
||
|
# Error happened
|
||
|
return prop_data
|
||
|
data.properties = prop_data.properties
|
||
|
data.propertytypes = prop_data.propertytypes
|
||
|
|
||
|
err = parser.read()
|
||
|
|
||
|
return data
|
||
|
|
||
|
# Parses a group layer from the XML and return a dictionary
|
||
|
# Returns an error code if fails
|
||
|
func parse_group_layer(parser, infinite):
|
||
|
var err = OK
|
||
|
var result = attributes_to_dict(parser)
|
||
|
result.type = "group"
|
||
|
result.layers = []
|
||
|
|
||
|
if not parser.is_empty():
|
||
|
err = parser.read()
|
||
|
|
||
|
while err == OK:
|
||
|
if parser.get_node_type() == XMLParser.NODE_ELEMENT_END:
|
||
|
if parser.get_node_name().to_lower() == "group":
|
||
|
break
|
||
|
elif parser.get_node_type() == XMLParser.NODE_ELEMENT:
|
||
|
if parser.get_node_name() == "layer":
|
||
|
var layer = parse_tile_layer(parser, infinite)
|
||
|
if typeof(layer) != TYPE_DICTIONARY:
|
||
|
printerr("Error parsing TMX file. Invalid tile layer data (around line %d)." % [parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
result.layers.push_back(layer)
|
||
|
|
||
|
elif parser.get_node_name() == "imagelayer":
|
||
|
var layer = parse_image_layer(parser)
|
||
|
if typeof(layer) != TYPE_DICTIONARY:
|
||
|
printerr("Error parsing TMX file. Invalid image layer data (around line %d)." % [parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
result.layers.push_back(layer)
|
||
|
|
||
|
elif parser.get_node_name() == "objectgroup":
|
||
|
var layer = parse_object_layer(parser)
|
||
|
if typeof(layer) != TYPE_DICTIONARY:
|
||
|
printerr("Error parsing TMX file. Invalid object layer data (around line %d)." % [parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
result.layers.push_back(layer)
|
||
|
|
||
|
elif parser.get_node_name() == "group":
|
||
|
var layer = parse_group_layer(parser, infinite)
|
||
|
if typeof(layer) != TYPE_DICTIONARY:
|
||
|
printerr("Error parsing TMX file. Invalid group layer data (around line %d)." % [parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
result.layers.push_back(layer)
|
||
|
|
||
|
elif parser.get_node_name() == "properties":
|
||
|
var prop_data = parse_properties(parser)
|
||
|
if typeof(prop_data) == TYPE_STRING:
|
||
|
return prop_data
|
||
|
|
||
|
result.properties = prop_data.properties
|
||
|
result.propertytypes = prop_data.propertytypes
|
||
|
|
||
|
err = parser.read()
|
||
|
return result
|
||
|
|
||
|
# Parses properties data from the XML and return a dictionary
|
||
|
# Returns an error code if fails
|
||
|
static func parse_properties(parser):
|
||
|
var err = OK
|
||
|
var data = {
|
||
|
"properties": {},
|
||
|
"propertytypes": {},
|
||
|
}
|
||
|
|
||
|
if not parser.is_empty():
|
||
|
err = parser.read()
|
||
|
|
||
|
while err == OK:
|
||
|
if parser.get_node_type() == XMLParser.NODE_ELEMENT_END:
|
||
|
if parser.get_node_name() == "properties":
|
||
|
break
|
||
|
elif parser.get_node_type() == XMLParser.NODE_ELEMENT:
|
||
|
if parser.get_node_name() == "property":
|
||
|
var prop_data = attributes_to_dict(parser)
|
||
|
if not (prop_data.has("name") and prop_data.has("value")):
|
||
|
printerr("Missing information in custom properties (around line %d)." % [parser.get_current_line()])
|
||
|
return ERR_INVALID_DATA
|
||
|
|
||
|
data.properties[prop_data.name] = prop_data.value
|
||
|
if prop_data.has("type"):
|
||
|
data.propertytypes[prop_data.name] = prop_data.type
|
||
|
else:
|
||
|
data.propertytypes[prop_data.name] = "string"
|
||
|
|
||
|
err = parser.read()
|
||
|
|
||
|
return data
|
||
|
|
||
|
# Reads the attributes of the current element and return them as a dictionary
|
||
|
static func attributes_to_dict(parser):
|
||
|
var data = {}
|
||
|
for i in range(parser.get_attribute_count()):
|
||
|
var attr = parser.get_attribute_name(i)
|
||
|
var val = parser.get_attribute_value(i)
|
||
|
if val.is_valid_integer():
|
||
|
val = int(val)
|
||
|
elif val.is_valid_float():
|
||
|
val = float(val)
|
||
|
elif val == "true":
|
||
|
val = true
|
||
|
elif val == "false":
|
||
|
val = false
|
||
|
data[attr] = val
|
||
|
return data
|