You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

document_app.py 22KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595
  1. #
  2. # Copyright 2024 The InfiniFlow Authors. All Rights Reserved.
  3. #
  4. # Licensed under the Apache License, Version 2.0 (the "License");
  5. # you may not use this file except in compliance with the License.
  6. # You may obtain a copy of the License at
  7. #
  8. # http://www.apache.org/licenses/LICENSE-2.0
  9. #
  10. # Unless required by applicable law or agreed to in writing, software
  11. # distributed under the License is distributed on an "AS IS" BASIS,
  12. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. # See the License for the specific language governing permissions and
  14. # limitations under the License
  15. #
  16. import os.path
  17. import pathlib
  18. import re
  19. import flask
  20. from flask import request
  21. from flask_login import login_required, current_user
  22. from deepdoc.parser.html_parser import RAGFlowHtmlParser
  23. from rag.nlp import search
  24. from api.db import FileType, TaskStatus, ParserType, FileSource
  25. from api.db.db_models import File, Task
  26. from api.db.services.file2document_service import File2DocumentService
  27. from api.db.services.file_service import FileService
  28. from api.db.services.task_service import queue_tasks
  29. from api.db.services.user_service import UserTenantService
  30. from api.db.services import duplicate_name
  31. from api.db.services.knowledgebase_service import KnowledgebaseService
  32. from api.db.services.task_service import TaskService
  33. from api.db.services.document_service import DocumentService, doc_upload_and_parse
  34. from api.utils.api_utils import (
  35. server_error_response,
  36. get_data_error_result,
  37. validate_request,
  38. )
  39. from api.utils import get_uuid
  40. from api import settings
  41. from api.utils.api_utils import get_json_result
  42. from rag.utils.storage_factory import STORAGE_IMPL
  43. from api.utils.file_utils import filename_type, thumbnail, get_project_base_directory
  44. from api.utils.web_utils import html2pdf, is_valid_url
  45. from api.constants import IMG_BASE64_PREFIX
  46. @manager.route('/upload', methods=['POST']) # noqa: F821
  47. @login_required
  48. @validate_request("kb_id")
  49. def upload():
  50. kb_id = request.form.get("kb_id")
  51. if not kb_id:
  52. return get_json_result(
  53. data=False, message='Lack of "KB ID"', code=settings.RetCode.ARGUMENT_ERROR)
  54. if 'file' not in request.files:
  55. return get_json_result(
  56. data=False, message='No file part!', code=settings.RetCode.ARGUMENT_ERROR)
  57. file_objs = request.files.getlist('file')
  58. for file_obj in file_objs:
  59. if file_obj.filename == '':
  60. return get_json_result(
  61. data=False, message='No file selected!', code=settings.RetCode.ARGUMENT_ERROR)
  62. e, kb = KnowledgebaseService.get_by_id(kb_id)
  63. if not e:
  64. raise LookupError("Can't find this knowledgebase!")
  65. err, _ = FileService.upload_document(kb, file_objs, current_user.id)
  66. if err:
  67. return get_json_result(
  68. data=False, message="\n".join(err), code=settings.RetCode.SERVER_ERROR)
  69. return get_json_result(data=True)
  70. @manager.route('/web_crawl', methods=['POST']) # noqa: F821
  71. @login_required
  72. @validate_request("kb_id", "name", "url")
  73. def web_crawl():
  74. kb_id = request.form.get("kb_id")
  75. if not kb_id:
  76. return get_json_result(
  77. data=False, message='Lack of "KB ID"', code=settings.RetCode.ARGUMENT_ERROR)
  78. name = request.form.get("name")
  79. url = request.form.get("url")
  80. if not is_valid_url(url):
  81. return get_json_result(
  82. data=False, message='The URL format is invalid', code=settings.RetCode.ARGUMENT_ERROR)
  83. e, kb = KnowledgebaseService.get_by_id(kb_id)
  84. if not e:
  85. raise LookupError("Can't find this knowledgebase!")
  86. blob = html2pdf(url)
  87. if not blob:
  88. return server_error_response(ValueError("Download failure."))
  89. root_folder = FileService.get_root_folder(current_user.id)
  90. pf_id = root_folder["id"]
  91. FileService.init_knowledgebase_docs(pf_id, current_user.id)
  92. kb_root_folder = FileService.get_kb_folder(current_user.id)
  93. kb_folder = FileService.new_a_file_from_kb(kb.tenant_id, kb.name, kb_root_folder["id"])
  94. try:
  95. filename = duplicate_name(
  96. DocumentService.query,
  97. name=name + ".pdf",
  98. kb_id=kb.id)
  99. filetype = filename_type(filename)
  100. if filetype == FileType.OTHER.value:
  101. raise RuntimeError("This type of file has not been supported yet!")
  102. location = filename
  103. while STORAGE_IMPL.obj_exist(kb_id, location):
  104. location += "_"
  105. STORAGE_IMPL.put(kb_id, location, blob)
  106. doc = {
  107. "id": get_uuid(),
  108. "kb_id": kb.id,
  109. "parser_id": kb.parser_id,
  110. "parser_config": kb.parser_config,
  111. "created_by": current_user.id,
  112. "type": filetype,
  113. "name": filename,
  114. "location": location,
  115. "size": len(blob),
  116. "thumbnail": thumbnail(filename, blob)
  117. }
  118. if doc["type"] == FileType.VISUAL:
  119. doc["parser_id"] = ParserType.PICTURE.value
  120. if doc["type"] == FileType.AURAL:
  121. doc["parser_id"] = ParserType.AUDIO.value
  122. if re.search(r"\.(ppt|pptx|pages)$", filename):
  123. doc["parser_id"] = ParserType.PRESENTATION.value
  124. if re.search(r"\.(eml)$", filename):
  125. doc["parser_id"] = ParserType.EMAIL.value
  126. DocumentService.insert(doc)
  127. FileService.add_file_from_kb(doc, kb_folder["id"], kb.tenant_id)
  128. except Exception as e:
  129. return server_error_response(e)
  130. return get_json_result(data=True)
  131. @manager.route('/create', methods=['POST']) # noqa: F821
  132. @login_required
  133. @validate_request("name", "kb_id")
  134. def create():
  135. req = request.json
  136. kb_id = req["kb_id"]
  137. if not kb_id:
  138. return get_json_result(
  139. data=False, message='Lack of "KB ID"', code=settings.RetCode.ARGUMENT_ERROR)
  140. try:
  141. e, kb = KnowledgebaseService.get_by_id(kb_id)
  142. if not e:
  143. return get_data_error_result(
  144. message="Can't find this knowledgebase!")
  145. if DocumentService.query(name=req["name"], kb_id=kb_id):
  146. return get_data_error_result(
  147. message="Duplicated document name in the same knowledgebase.")
  148. doc = DocumentService.insert({
  149. "id": get_uuid(),
  150. "kb_id": kb.id,
  151. "parser_id": kb.parser_id,
  152. "parser_config": kb.parser_config,
  153. "created_by": current_user.id,
  154. "type": FileType.VIRTUAL,
  155. "name": req["name"],
  156. "location": "",
  157. "size": 0
  158. })
  159. return get_json_result(data=doc.to_json())
  160. except Exception as e:
  161. return server_error_response(e)
  162. @manager.route('/list', methods=['GET']) # noqa: F821
  163. @login_required
  164. def list_docs():
  165. kb_id = request.args.get("kb_id")
  166. if not kb_id:
  167. return get_json_result(
  168. data=False, message='Lack of "KB ID"', code=settings.RetCode.ARGUMENT_ERROR)
  169. tenants = UserTenantService.query(user_id=current_user.id)
  170. for tenant in tenants:
  171. if KnowledgebaseService.query(
  172. tenant_id=tenant.tenant_id, id=kb_id):
  173. break
  174. else:
  175. return get_json_result(
  176. data=False, message='Only owner of knowledgebase authorized for this operation.',
  177. code=settings.RetCode.OPERATING_ERROR)
  178. keywords = request.args.get("keywords", "")
  179. page_number = int(request.args.get("page", 1))
  180. items_per_page = int(request.args.get("page_size", 15))
  181. orderby = request.args.get("orderby", "create_time")
  182. desc = request.args.get("desc", True)
  183. try:
  184. docs, tol = DocumentService.get_by_kb_id(
  185. kb_id, page_number, items_per_page, orderby, desc, keywords)
  186. for doc_item in docs:
  187. if doc_item['thumbnail'] and not doc_item['thumbnail'].startswith(IMG_BASE64_PREFIX):
  188. doc_item['thumbnail'] = f"/v1/document/image/{kb_id}-{doc_item['thumbnail']}"
  189. return get_json_result(data={"total": tol, "docs": docs})
  190. except Exception as e:
  191. return server_error_response(e)
  192. @manager.route('/infos', methods=['POST']) # noqa: F821
  193. @login_required
  194. def docinfos():
  195. req = request.json
  196. doc_ids = req["doc_ids"]
  197. for doc_id in doc_ids:
  198. if not DocumentService.accessible(doc_id, current_user.id):
  199. return get_json_result(
  200. data=False,
  201. message='No authorization.',
  202. code=settings.RetCode.AUTHENTICATION_ERROR
  203. )
  204. docs = DocumentService.get_by_ids(doc_ids)
  205. return get_json_result(data=list(docs.dicts()))
  206. @manager.route('/thumbnails', methods=['GET']) # noqa: F821
  207. # @login_required
  208. def thumbnails():
  209. doc_ids = request.args.get("doc_ids").split(",")
  210. if not doc_ids:
  211. return get_json_result(
  212. data=False, message='Lack of "Document ID"', code=settings.RetCode.ARGUMENT_ERROR)
  213. try:
  214. docs = DocumentService.get_thumbnails(doc_ids)
  215. for doc_item in docs:
  216. if doc_item['thumbnail'] and not doc_item['thumbnail'].startswith(IMG_BASE64_PREFIX):
  217. doc_item['thumbnail'] = f"/v1/document/image/{doc_item['kb_id']}-{doc_item['thumbnail']}"
  218. return get_json_result(data={d["id"]: d["thumbnail"] for d in docs})
  219. except Exception as e:
  220. return server_error_response(e)
  221. @manager.route('/change_status', methods=['POST']) # noqa: F821
  222. @login_required
  223. @validate_request("doc_id", "status")
  224. def change_status():
  225. req = request.json
  226. if str(req["status"]) not in ["0", "1"]:
  227. return get_json_result(
  228. data=False,
  229. message='"Status" must be either 0 or 1!',
  230. code=settings.RetCode.ARGUMENT_ERROR)
  231. if not DocumentService.accessible(req["doc_id"], current_user.id):
  232. return get_json_result(
  233. data=False,
  234. message='No authorization.',
  235. code=settings.RetCode.AUTHENTICATION_ERROR)
  236. try:
  237. e, doc = DocumentService.get_by_id(req["doc_id"])
  238. if not e:
  239. return get_data_error_result(message="Document not found!")
  240. e, kb = KnowledgebaseService.get_by_id(doc.kb_id)
  241. if not e:
  242. return get_data_error_result(
  243. message="Can't find this knowledgebase!")
  244. if not DocumentService.update_by_id(
  245. req["doc_id"], {"status": str(req["status"])}):
  246. return get_data_error_result(
  247. message="Database error (Document update)!")
  248. status = int(req["status"])
  249. settings.docStoreConn.update({"doc_id": req["doc_id"]}, {"available_int": status},
  250. search.index_name(kb.tenant_id), doc.kb_id)
  251. return get_json_result(data=True)
  252. except Exception as e:
  253. return server_error_response(e)
  254. @manager.route('/rm', methods=['POST']) # noqa: F821
  255. @login_required
  256. @validate_request("doc_id")
  257. def rm():
  258. req = request.json
  259. doc_ids = req["doc_id"]
  260. if isinstance(doc_ids, str):
  261. doc_ids = [doc_ids]
  262. for doc_id in doc_ids:
  263. if not DocumentService.accessible4deletion(doc_id, current_user.id):
  264. return get_json_result(
  265. data=False,
  266. message='No authorization.',
  267. code=settings.RetCode.AUTHENTICATION_ERROR
  268. )
  269. root_folder = FileService.get_root_folder(current_user.id)
  270. pf_id = root_folder["id"]
  271. FileService.init_knowledgebase_docs(pf_id, current_user.id)
  272. errors = ""
  273. for doc_id in doc_ids:
  274. try:
  275. e, doc = DocumentService.get_by_id(doc_id)
  276. if not e:
  277. return get_data_error_result(message="Document not found!")
  278. tenant_id = DocumentService.get_tenant_id(doc_id)
  279. if not tenant_id:
  280. return get_data_error_result(message="Tenant not found!")
  281. b, n = File2DocumentService.get_storage_address(doc_id=doc_id)
  282. TaskService.filter_delete([Task.doc_id == doc_id])
  283. if not DocumentService.remove_document(doc, tenant_id):
  284. return get_data_error_result(
  285. message="Database error (Document removal)!")
  286. f2d = File2DocumentService.get_by_document_id(doc_id)
  287. FileService.filter_delete([File.source_type == FileSource.KNOWLEDGEBASE, File.id == f2d[0].file_id])
  288. File2DocumentService.delete_by_document_id(doc_id)
  289. STORAGE_IMPL.rm(b, n)
  290. except Exception as e:
  291. errors += str(e)
  292. if errors:
  293. return get_json_result(data=False, message=errors, code=settings.RetCode.SERVER_ERROR)
  294. return get_json_result(data=True)
  295. @manager.route('/run', methods=['POST']) # noqa: F821
  296. @login_required
  297. @validate_request("doc_ids", "run")
  298. def run():
  299. req = request.json
  300. for doc_id in req["doc_ids"]:
  301. if not DocumentService.accessible(doc_id, current_user.id):
  302. return get_json_result(
  303. data=False,
  304. message='No authorization.',
  305. code=settings.RetCode.AUTHENTICATION_ERROR
  306. )
  307. try:
  308. for id in req["doc_ids"]:
  309. info = {"run": str(req["run"]), "progress": 0}
  310. if str(req["run"]) == TaskStatus.RUNNING.value and req.get("delete", False):
  311. info["progress_msg"] = ""
  312. info["chunk_num"] = 0
  313. info["token_num"] = 0
  314. DocumentService.update_by_id(id, info)
  315. tenant_id = DocumentService.get_tenant_id(id)
  316. if not tenant_id:
  317. return get_data_error_result(message="Tenant not found!")
  318. e, doc = DocumentService.get_by_id(id)
  319. if not e:
  320. return get_data_error_result(message="Document not found!")
  321. if req.get("delete", False):
  322. TaskService.filter_delete([Task.doc_id == id])
  323. if settings.docStoreConn.indexExist(search.index_name(tenant_id), doc.kb_id):
  324. settings.docStoreConn.delete({"doc_id": id}, search.index_name(tenant_id), doc.kb_id)
  325. if str(req["run"]) == TaskStatus.RUNNING.value:
  326. e, doc = DocumentService.get_by_id(id)
  327. doc = doc.to_dict()
  328. doc["tenant_id"] = tenant_id
  329. bucket, name = File2DocumentService.get_storage_address(doc_id=doc["id"])
  330. queue_tasks(doc, bucket, name)
  331. return get_json_result(data=True)
  332. except Exception as e:
  333. return server_error_response(e)
  334. @manager.route('/rename', methods=['POST']) # noqa: F821
  335. @login_required
  336. @validate_request("doc_id", "name")
  337. def rename():
  338. req = request.json
  339. if not DocumentService.accessible(req["doc_id"], current_user.id):
  340. return get_json_result(
  341. data=False,
  342. message='No authorization.',
  343. code=settings.RetCode.AUTHENTICATION_ERROR
  344. )
  345. try:
  346. e, doc = DocumentService.get_by_id(req["doc_id"])
  347. if not e:
  348. return get_data_error_result(message="Document not found!")
  349. if pathlib.Path(req["name"].lower()).suffix != pathlib.Path(
  350. doc.name.lower()).suffix:
  351. return get_json_result(
  352. data=False,
  353. message="The extension of file can't be changed",
  354. code=settings.RetCode.ARGUMENT_ERROR)
  355. for d in DocumentService.query(name=req["name"], kb_id=doc.kb_id):
  356. if d.name == req["name"]:
  357. return get_data_error_result(
  358. message="Duplicated document name in the same knowledgebase.")
  359. if not DocumentService.update_by_id(
  360. req["doc_id"], {"name": req["name"]}):
  361. return get_data_error_result(
  362. message="Database error (Document rename)!")
  363. informs = File2DocumentService.get_by_document_id(req["doc_id"])
  364. if informs:
  365. e, file = FileService.get_by_id(informs[0].file_id)
  366. FileService.update_by_id(file.id, {"name": req["name"]})
  367. return get_json_result(data=True)
  368. except Exception as e:
  369. return server_error_response(e)
  370. @manager.route('/get/<doc_id>', methods=['GET']) # noqa: F821
  371. # @login_required
  372. def get(doc_id):
  373. try:
  374. e, doc = DocumentService.get_by_id(doc_id)
  375. if not e:
  376. return get_data_error_result(message="Document not found!")
  377. b, n = File2DocumentService.get_storage_address(doc_id=doc_id)
  378. response = flask.make_response(STORAGE_IMPL.get(b, n))
  379. ext = re.search(r"\.([^.]+)$", doc.name)
  380. if ext:
  381. if doc.type == FileType.VISUAL.value:
  382. response.headers.set('Content-Type', 'image/%s' % ext.group(1))
  383. else:
  384. response.headers.set(
  385. 'Content-Type',
  386. 'application/%s' %
  387. ext.group(1))
  388. return response
  389. except Exception as e:
  390. return server_error_response(e)
  391. @manager.route('/change_parser', methods=['POST']) # noqa: F821
  392. @login_required
  393. @validate_request("doc_id", "parser_id")
  394. def change_parser():
  395. req = request.json
  396. if not DocumentService.accessible(req["doc_id"], current_user.id):
  397. return get_json_result(
  398. data=False,
  399. message='No authorization.',
  400. code=settings.RetCode.AUTHENTICATION_ERROR
  401. )
  402. try:
  403. e, doc = DocumentService.get_by_id(req["doc_id"])
  404. if not e:
  405. return get_data_error_result(message="Document not found!")
  406. if doc.parser_id.lower() == req["parser_id"].lower():
  407. if "parser_config" in req:
  408. if req["parser_config"] == doc.parser_config:
  409. return get_json_result(data=True)
  410. else:
  411. return get_json_result(data=True)
  412. if ((doc.type == FileType.VISUAL and req["parser_id"] != "picture")
  413. or (re.search(
  414. r"\.(ppt|pptx|pages)$", doc.name) and req["parser_id"] != "presentation")):
  415. return get_data_error_result(message="Not supported yet!")
  416. e = DocumentService.update_by_id(doc.id,
  417. {"parser_id": req["parser_id"], "progress": 0, "progress_msg": "",
  418. "run": TaskStatus.UNSTART.value})
  419. if not e:
  420. return get_data_error_result(message="Document not found!")
  421. if "parser_config" in req:
  422. DocumentService.update_parser_config(doc.id, req["parser_config"])
  423. if doc.token_num > 0:
  424. e = DocumentService.increment_chunk_num(doc.id, doc.kb_id, doc.token_num * -1, doc.chunk_num * -1,
  425. doc.process_duation * -1)
  426. if not e:
  427. return get_data_error_result(message="Document not found!")
  428. tenant_id = DocumentService.get_tenant_id(req["doc_id"])
  429. if not tenant_id:
  430. return get_data_error_result(message="Tenant not found!")
  431. if settings.docStoreConn.indexExist(search.index_name(tenant_id), doc.kb_id):
  432. settings.docStoreConn.delete({"doc_id": doc.id}, search.index_name(tenant_id), doc.kb_id)
  433. return get_json_result(data=True)
  434. except Exception as e:
  435. return server_error_response(e)
  436. @manager.route('/image/<image_id>', methods=['GET']) # noqa: F821
  437. # @login_required
  438. def get_image(image_id):
  439. try:
  440. arr = image_id.split("-")
  441. if len(arr) != 2:
  442. return get_data_error_result(message="Image not found.")
  443. bkt, nm = image_id.split("-")
  444. response = flask.make_response(STORAGE_IMPL.get(bkt, nm))
  445. response.headers.set('Content-Type', 'image/JPEG')
  446. return response
  447. except Exception as e:
  448. return server_error_response(e)
  449. @manager.route('/upload_and_parse', methods=['POST']) # noqa: F821
  450. @login_required
  451. @validate_request("conversation_id")
  452. def upload_and_parse():
  453. if 'file' not in request.files:
  454. return get_json_result(
  455. data=False, message='No file part!', code=settings.RetCode.ARGUMENT_ERROR)
  456. file_objs = request.files.getlist('file')
  457. for file_obj in file_objs:
  458. if file_obj.filename == '':
  459. return get_json_result(
  460. data=False, message='No file selected!', code=settings.RetCode.ARGUMENT_ERROR)
  461. doc_ids = doc_upload_and_parse(request.form.get("conversation_id"), file_objs, current_user.id)
  462. return get_json_result(data=doc_ids)
  463. @manager.route('/parse', methods=['POST']) # noqa: F821
  464. @login_required
  465. def parse():
  466. url = request.json.get("url") if request.json else ""
  467. if url:
  468. if not is_valid_url(url):
  469. return get_json_result(
  470. data=False, message='The URL format is invalid', code=settings.RetCode.ARGUMENT_ERROR)
  471. download_path = os.path.join(get_project_base_directory(), "logs/downloads")
  472. os.makedirs(download_path, exist_ok=True)
  473. from seleniumwire.webdriver import Chrome, ChromeOptions
  474. options = ChromeOptions()
  475. options.add_argument('--headless')
  476. options.add_argument('--disable-gpu')
  477. options.add_argument('--no-sandbox')
  478. options.add_argument('--disable-dev-shm-usage')
  479. options.add_experimental_option('prefs', {
  480. 'download.default_directory': download_path,
  481. 'download.prompt_for_download': False,
  482. 'download.directory_upgrade': True,
  483. 'safebrowsing.enabled': True
  484. })
  485. driver = Chrome(options=options)
  486. driver.get(url)
  487. res_headers = [r.response.headers for r in driver.requests if r and r.response]
  488. if len(res_headers) > 1:
  489. sections = RAGFlowHtmlParser().parser_txt(driver.page_source)
  490. driver.quit()
  491. return get_json_result(data="\n".join(sections))
  492. class File:
  493. filename: str
  494. filepath: str
  495. def __init__(self, filename, filepath):
  496. self.filename = filename
  497. self.filepath = filepath
  498. def read(self):
  499. with open(self.filepath, "rb") as f:
  500. return f.read()
  501. r = re.search(r"filename=\"([^\"]+)\"", str(res_headers))
  502. if not r or not r.group(1):
  503. return get_json_result(
  504. data=False, message="Can't not identify downloaded file", code=settings.RetCode.ARGUMENT_ERROR)
  505. f = File(r.group(1), os.path.join(download_path, r.group(1)))
  506. txt = FileService.parse_docs([f], current_user.id)
  507. return get_json_result(data=txt)
  508. if 'file' not in request.files:
  509. return get_json_result(
  510. data=False, message='No file part!', code=settings.RetCode.ARGUMENT_ERROR)
  511. file_objs = request.files.getlist('file')
  512. txt = FileService.parse_docs(file_objs, current_user.id)
  513. return get_json_result(data=txt)