NEWS

daiR 1.1.0

Added two new functions to facilitate processor management: get_ids_by_type() and get_versions_by_type().
Added vignette on processor management.

Major revision.
Added several processor-related functions following an update of the Google Document AI REST API. These include list_processor_types(), create_processor(), enable_processor(), disable_processor(), and delete_processor().
Added get_text() and get_tables(), which replace text_from_dai_response(), text_from_dai_file(), tables_from_dai_response() and tables_from_dai_file().
Added get_entities() and draw_entities().
Removed dai_tab_sync() and dai_tab_async() following Google's discontinuation of the v1beta2 endpoint on 31 January 2024.
Modified the parameters of the draw*() functions for better consistency with other functions.
Renamed the .R files and regrouped the functions.
Added prettier messages using the cli package.

Added the function make_hocr to convert DAI output to hOCR files, thereby facilitating the creation of searchable PDFs.

Changed the build_token_df() and build_block_df() functions so they can take as input response objects from dai_sync() in addition to json files from dai_async().
Changed the build_token_df() and build_block_df() functions to include confidence scores in the dataframe, so as to enable filtering on confidence.

Changed the "draw_*" functions so they work with response objects (from dai_sync() and dai_sync_tab()) as well as with json files from dai_async_tab().
Changed the "draw_*" functions to allow customizing color and thickness of lines around bounding boxes.
Modified tables_from_dai_response() so that it handles response objects from dai_sync() with form parser processors.

Added three new functions relating to processors: get_processors(), get_processor_info(), and get_processor_versions().
Added parameter proc_v to dai_sync() and dai_async, allowing for specification of processor version.

Added two new functions: dai_notify() and merge_shards()
Modified text_from_dai_response() and text_from_dai_file() to allow saving the output straight to a text file.
Fixed a bug in dai_status() that caused an error when processing responses from the v1beta2 endpoint (dai_tab_async()).

Added new function (draw_blocks_new()) to inspect block bounding boxes after reprocessing.

Simplified the auth functions to avoid modifying the global environment. Tokens are no longer held in an internal .auth object. Removed dai_has_token(), dai_deauth(), and create_folder().

Revised draw_blocks(), draw_paragraphs(), draw_lines(), and draw_tokens() functions. These functions no longer require supplying a pdf file, as they get the images from a base64-encoded string in the json file.

New processing functions adapted to the new stable release of Document AI API (v1). The dai_sync()/dai_async() functions now access the new v1 endpoint, which has foreign language support. However, the v1 endpoint currently does not support table extraction, so the old processing functions (which access the v1beta2 endpoint) are kept under the new names dai_sync_tab() and dai_async_tab(). I expect this to be a temporary solution until DAI's capabilities are consolidated in a single endpoint, at which stage the *_tab() functions will be phased out.