Pyhelpers

(*13 June 2022*)

Notable [changes](https://github.com/mikeqfu/pyhelpers/compare/1.3.3...1.3.4) since [1.3.3](https://pypi.org/project/pyhelpers/1.3.3/):

- Enabled [direct access](https://github.com/mikeqfu/pyhelpers/commit/756e613b7fffdd0a808de8d7c2e362b8829ac1c1) to all modules through importing *pyhelpers*, and all functions/classes in each module through importing *pyhelpers.<module_name>*.
- Improved the following function/class (with bug fixes):
- [find_similar_str()](https://github.com/mikeqfu/pyhelpers/commit/3e012426a6018d38d273196f1d2c043a34c33756) in the module [text](https://github.com/mikeqfu/pyhelpers/blob/b2e9d9fa50b2947263d93d1a3e995d39866e4a39/pyhelpers/text.py);
- [PostgreSQL](https://github.com/mikeqfu/pyhelpers/commit/7e2797de9345dc18aced8229126a6b2af766c78c) in the module [dbms](https://github.com/mikeqfu/pyhelpers/blob/b2e9d9fa50b2947263d93d1a3e995d39866e4a39/pyhelpers/dbms.py).

**For more information and detailed specifications, check out [PyHelpers 1.3.4 documentation](https://pyhelpers.readthedocs.io/en/1.3.4/).**

(*12 May 2022*)

Notable [changes](https://github.com/mikeqfu/pyhelpers/compare/1.3.2...1.3.3) since [1.3.2](https://pypi.org/project/pyhelpers/1.3.2/):

- Improved the following class/functions with bug fixes:
- [PostgreSQL](https://github.com/mikeqfu/pyhelpers/commit/989b64b154fee576068dd445146c9bfe575221e6) in the module [dbms](https://github.com/mikeqfu/pyhelpers/blob/85b09c37acc0d0aa96fd2e80e406d537d0a14490/pyhelpers/dbms.py);
- [save_data()](https://github.com/mikeqfu/pyhelpers/commit/43cbe93f274389996848c3e7463e821c33775d32) and [save_svg_as_emf()](https://github.com/mikeqfu/pyhelpers/commit/7a617d0c1239c6cb75b4d43ab4567a46301e4bef) in the module [store](https://github.com/mikeqfu/pyhelpers/blob/85b09c37acc0d0aa96fd2e80e406d537d0a14490/pyhelpers/store.py);
- [delete_dir()](https://github.com/mikeqfu/pyhelpers/commit/6aef421d6ab724983ac59678b37aae5a6dd3e6a0) in the module [dir](https://github.com/mikeqfu/pyhelpers/blob/85b09c37acc0d0aa96fd2e80e406d537d0a14490/pyhelpers/dir.py);
- [euclidean_distance_between_texts()](https://github.com/mikeqfu/pyhelpers/commit/a6a0910b1b175ce6a4bb60321d691443f4ca5aaa#diff-07b6d8c6102940f884435a3670eb5007494d5c51b4deb718ba79c3b267825127R401) and [cosine_similarity_between_texts()](https://github.com/mikeqfu/pyhelpers/commit/a6a0910b1b175ce6a4bb60321d691443f4ca5aaa#diff-07b6d8c6102940f884435a3670eb5007494d5c51b4deb718ba79c3b267825127R431) in the module [text](https://github.com/mikeqfu/pyhelpers/blob/85b09c37acc0d0aa96fd2e80e406d537d0a14490/pyhelpers/text.py).
- Add a new class [MSSQL](https://github.com/mikeqfu/pyhelpers/commit/f2ab9928c413d16630fd898ee49a8dcb2f10fd76) to the module [dbms](https://github.com/mikeqfu/pyhelpers/blob/85b09c37acc0d0aa96fd2e80e406d537d0a14490/pyhelpers/dbms.py).

**For more information and detailed specifications, check out [PyHelpers 1.3.3 documentation](https://pyhelpers.readthedocs.io/en/1.3.3/).**

(*14 March 2022*)

Notable [changes](https://github.com/mikeqfu/pyhelpers/compare/1.3.1...1.3.2) since [1.3.1](https://pypi.org/project/pyhelpers/1.3.1/):

- Added the following new functions:
- [xlsx_to_csv()](https://github.com/mikeqfu/pyhelpers/commit/7871eadbe0358ec1c48430fa9f671e5d93741343) to the module [store](https://github.com/mikeqfu/pyhelpers/blob/79a979462b492b5529448ae53291cc5555ced43f/pyhelpers/store.py);
- [np_shift()](https://github.com/mikeqfu/pyhelpers/commit/e41df8b9da04f571bd53ac3df79a9de27a53521a) to the module [ops](https://github.com/mikeqfu/pyhelpers/blob/79a979462b492b5529448ae53291cc5555ced43f/pyhelpers/ops.py);
- [project_point_to_line()](https://github.com/mikeqfu/pyhelpers/commit/e0b74756e6dba5697da758655d46f9cafeb1bbc7#diff-dc4a0e4af0eb0e5a833d868a38bde78a7c5736be4021d9ddf03b97c6f0cc8af8R326-R376) and [find_shortest_path()](https://github.com/mikeqfu/pyhelpers/commit/e0b74756e6dba5697da758655d46f9cafeb1bbc7#diff-dc4a0e4af0eb0e5a833d868a38bde78a7c5736be4021d9ddf03b97c6f0cc8af8R679-R785) to the module [geom](https://github.com/mikeqfu/pyhelpers/blob/79a979462b492b5529448ae53291cc5555ced43f/pyhelpers/geom.py).

**For more information and detailed specifications, check out [PyHelpers 1.3.2 documentation](https://pyhelpers.readthedocs.io/en/1.3.2/).**

(*10 February 2022*)

Notable [changes](https://github.com/mikeqfu/pyhelpers/compare/1.3.0...1.3.1) since [1.3.0](https://pypi.org/project/pyhelpers/1.3.0/):

- [Changed LICENSE to GPLv3+](https://github.com/mikeqfu/pyhelpers/commit/347ade14cd2c56ef1ed017a535a2be8172b3569c).
- Renamed the following functions:
- [~~save()~~](https://github.com/mikeqfu/pyhelpers/commit/7002573fb3530b55ac84b1a35c568200aa58a0ec#diff-5be4770b2702d34ea60ff69d076c06b6311d2de302323f4313f5829f857e7607L105) to [save_data()](https://github.com/mikeqfu/pyhelpers/commit/7002573fb3530b55ac84b1a35c568200aa58a0ec#diff-5be4770b2702d34ea60ff69d076c06b6311d2de302323f4313f5829f857e7607R765) in the module [store](https://github.com/mikeqfu/pyhelpers/blob/d882fb31b1ffc41433f32b4b18f62e7840348aa7/pyhelpers/store.py);
- [~~get_user_agent_strings()~~](https://github.com/mikeqfu/pyhelpers/commit/3e63df02271e8a9cedce0e1ebdfc36d517688249#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aL1601) to [load_user_agent_strings()](https://github.com/mikeqfu/pyhelpers/commit/3e63df02271e8a9cedce0e1ebdfc36d517688249#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aR1601) in the module [ops](https://github.com/mikeqfu/pyhelpers/blob/d882fb31b1ffc41433f32b4b18f62e7840348aa7/pyhelpers/ops.py).
- Improved the functions:
- [remove_punctuation()](https://github.com/mikeqfu/pyhelpers/commit/926766a1be452644323c07b3e57e2409f99fa236#diff-07b6d8c6102940f884435a3670eb5007494d5c51b4deb718ba79c3b267825127R68), [find_similar_str()](https://github.com/mikeqfu/pyhelpers/commit/926766a1be452644323c07b3e57e2409f99fa236#diff-07b6d8c6102940f884435a3670eb5007494d5c51b4deb718ba79c3b267825127R190) and [convert_md_to_rst()](https://github.com/mikeqfu/pyhelpers/commit/8929bca83edfaf057affb05f55f0814853248bc0#diff-07b6d8c6102940f884435a3670eb5007494d5c51b4deb718ba79c3b267825127R627) in the module [text](https://github.com/mikeqfu/pyhelpers/blob/d882fb31b1ffc41433f32b4b18f62e7840348aa7/pyhelpers/text.py);
- [merge_dicts()](https://github.com/mikeqfu/pyhelpers/commit/a32355e8041d904b604b4e2dc1534a0322121e12#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aR796) in the module [ops](https://github.com/mikeqfu/pyhelpers/blob/d882fb31b1ffc41433f32b4b18f62e7840348aa7/pyhelpers/ops.py).
- Added [a few constants](https://github.com/mikeqfu/pyhelpers/commit/f35145ffea30837cf0851c84011dc9af0e59da91) cached as the package/module is imported.
- Added the following new functions/methods:
- [load_csv()](https://github.com/mikeqfu/pyhelpers/commit/5793d4279cc52acb4489281e119ba8829ba88529#diff-5be4770b2702d34ea60ff69d076c06b6311d2de302323f4313f5829f857e7607R1070-R1160) and [load_data()](https://github.com/mikeqfu/pyhelpers/commit/7002573fb3530b55ac84b1a35c568200aa58a0ec#diff-5be4770b2702d34ea60ff69d076c06b6311d2de302323f4313f5829f857e7607R1176-R1236) to the module [store](https://github.com/mikeqfu/pyhelpers/blob/d882fb31b1ffc41433f32b4b18f62e7840348aa7/pyhelpers/store.py);
- [numeral_english_to_arabic()](https://github.com/mikeqfu/pyhelpers/commit/3d0ef9f892ff329e091714aacddbf6445ce384c5) to the module [text](https://github.com/mikeqfu/pyhelpers/blob/d882fb31b1ffc41433f32b4b18f62e7840348aa7/pyhelpers/text.py);
- [PostgreSQL.list_schema_names()](https://github.com/mikeqfu/pyhelpers/commit/cb547e0ce2da90760c02fd461335a11e4db31185#diff-402d385f94d69cd9596a357c63ccdf2d12f55165339af5d3c1bd554fb5a5e146R785-R855) to the module [dbms](https://github.com/mikeqfu/pyhelpers/blob/d882fb31b1ffc41433f32b4b18f62e7840348aa7/pyhelpers/dbms.py);
- [find_executable()](https://github.com/mikeqfu/pyhelpers/commit/a32355e8041d904b604b4e2dc1534a0322121e12#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aR314-R356) and [compare_dicts()](https://github.com/mikeqfu/pyhelpers/commit/a32355e8041d904b604b4e2dc1534a0322121e12#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aR749-R793) to the module [ops](https://github.com/mikeqfu/pyhelpers/blob/d882fb31b1ffc41433f32b4b18f62e7840348aa7/pyhelpers/ops.py).

**For more information and detailed specifications, check out [PyHelpers 1.3.1 documentation](https://pyhelpers.readthedocs.io/en/1.3.1/).**

(*6 January 2022*)

Notable [changes](https://github.com/mikeqfu/pyhelpers/compare/1.2.18...1.3.0) since [1.2.18](https://pypi.org/project/pyhelpers/1.2.18/):

- Renamed the module [~~sql~~](https://github.com/mikeqfu/pyhelpers/commit/edeb899b53ec9ba3b08e0e328f30bddcf064f0e5) to [dbms](https://github.com/mikeqfu/pyhelpers/blob/01e90ddc9824c7e15ce92ef2ae833a9be760cb3e/pyhelpers/dbms.py).
- Renamed the following functions:
- in the module [dir](https://github.com/mikeqfu/pyhelpers/blob/01e90ddc9824c7e15ce92ef2ae833a9be760cb3e/pyhelpers/dir.py):
- [~~validate_input_data_dir()~~](https://github.com/mikeqfu/pyhelpers/commit/ff821197e1e5bedda1893e63a0985c15c6eea6eb#diff-9658546df62eded721ef6049c33f4b2d7e985d9cce8c08ba9538a32da5229a09L245) to [validate_dir()](https://github.com/mikeqfu/pyhelpers/commit/ff821197e1e5bedda1893e63a0985c15c6eea6eb#diff-9658546df62eded721ef6049c33f4b2d7e985d9cce8c08ba9538a32da5229a09R245);
- in the module [ops](https://github.com/mikeqfu/pyhelpers/blob/01e90ddc9824c7e15ce92ef2ae833a9be760cb3e/pyhelpers/ops.py):
- [~~update_nested_dict()~~](https://github.com/mikeqfu/pyhelpers/commit/a4f3f617091587ce8aa83efca2fecfe1adaff8d6#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aL442) to [update_dict()](https://github.com/mikeqfu/pyhelpers/commit/a4f3f617091587ce8aa83efca2fecfe1adaff8d6#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aR442);
- [~~get_all_values_from_nested_dict()~~](https://github.com/mikeqfu/pyhelpers/commit/a4f3f617091587ce8aa83efca2fecfe1adaff8d6#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aL516) to [get_dict_values()](https://github.com/mikeqfu/pyhelpers/commit/a4f3f617091587ce8aa83efca2fecfe1adaff8d6#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aR516);
- [~~remove_multiple_keys_from_dict()~~](https://github.com/mikeqfu/pyhelpers/commit/a4f3f617091587ce8aa83efca2fecfe1adaff8d6#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aL575) to [remove_dict_keys()](https://github.com/mikeqfu/pyhelpers/commit/a4f3f617091587ce8aa83efca2fecfe1adaff8d6#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aR638);
- [~~instantiate_requests_session()~~](https://github.com/mikeqfu/pyhelpers/commit/dc3817d0ff2e816276ecd8241f43c9c3a59b3927#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aL1468) to [init_requests_session()](https://github.com/mikeqfu/pyhelpers/commit/dc3817d0ff2e816276ecd8241f43c9c3a59b3927#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aR1468).
- Improved the following functions/class:
- [PostgreSQL](https://github.com/mikeqfu/pyhelpers/commit/f23e534a9d0f65dcf695ca30ebaa766cae80fae3) in the module [dbms](https://github.com/mikeqfu/pyhelpers/blob/01e90ddc9824c7e15ce92ef2ae833a9be760cb3e/pyhelpers/dbms.py) (previously [~~sql~~](https://github.com/mikeqfu/pyhelpers/blob/fc6191fa37655fc664e6c74e15bcb4280e7bf5c1/pyhelpers/sql.py));
- [wgs84_to_osgb36()](https://github.com/mikeqfu/pyhelpers/commit/18f1299356c53072536e9f983e5d36b00f73a184#diff-dc4a0e4af0eb0e5a833d868a38bde78a7c5736be4021d9ddf03b97c6f0cc8af8R89) and [osgb36_to_wgs84()](https://github.com/mikeqfu/pyhelpers/commit/18f1299356c53072536e9f983e5d36b00f73a184#diff-dc4a0e4af0eb0e5a833d868a38bde78a7c5736be4021d9ddf03b97c6f0cc8af8R153) in the module [geom](https://github.com/mikeqfu/pyhelpers/blob/01e90ddc9824c7e15ce92ef2ae833a9be760cb3e/pyhelpers/geom.py).
- [parse_size()](https://github.com/mikeqfu/pyhelpers/commit/77abafb23312b57a034f0731ca8085dfeb2573b9) (newly added), [init_requests_session()](https://github.com/mikeqfu/pyhelpers/commit/6bde35cd84542403cc9a4d86976d5f33447ba0aa) and [download_file_from_url()](https://github.com/mikeqfu/pyhelpers/commit/898cba204f520daf459f770ba75cbc5af805440d) in the module [ops](https://github.com/mikeqfu/pyhelpers/blob/01e90ddc9824c7e15ce92ef2ae833a9be760cb3e/pyhelpers/ops.py);
- [load_json()](https://github.com/mikeqfu/pyhelpers/commit/adcb314be54daf4f19ed97c0df0e7fe61332fa2f) in the module [store](https://github.com/mikeqfu/pyhelpers/blob/01e90ddc9824c7e15ce92ef2ae833a9be760cb3e/pyhelpers/store.py);
- [find_similar_str()](https://github.com/mikeqfu/pyhelpers/commit/d1c4cd872a00e3c94343241a14610ea3dc9ccb15#diff-07b6d8c6102940f884435a3670eb5007494d5c51b4deb718ba79c3b267825127R185) in the module [text](https://github.com/mikeqfu/pyhelpers/blob/01e90ddc9824c7e15ce92ef2ae833a9be760cb3e/pyhelpers/text.py);
- Added the following functions to the module [ops](https://github.com/mikeqfu/pyhelpers/blob/01e90ddc9824c7e15ce92ef2ae833a9be760cb3e/pyhelpers/ops.py): [parse_size()](https://github.com/mikeqfu/pyhelpers/commit/295e60e9b38fab23896f5552986ba29c83f30e4d), [get_number_of_chunks()](https://github.com/mikeqfu/pyhelpers/commit/ec6d7a19a8a25e463ede05bbd3d5043217eb116f), [loop_in_pairs()](https://github.com/mikeqfu/pyhelpers/commit/cc26add9f3c269bb44b638f72602b7fa71e16e93), [is_url()](https://github.com/mikeqfu/pyhelpers/commit/a61e88abff2aa0028470fd7d538cac8688b1cd1c) and [update_dict_keys()](https://github.com/mikeqfu/pyhelpers/commit/a4f3f617091587ce8aa83efca2fecfe1adaff8d6#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aR516-R576).
- Reduced the number of essential dependencies.

**For more information and detailed specifications, check out [PyHelpers 1.3.0 documentation](https://pyhelpers.readthedocs.io/en/1.3.0/).**

(*20 October 2021*)

Notable [changes](https://github.com/mikeqfu/pyhelpers/compare/1.2.17...1.2.18) since [1.2.17](https://pypi.org/project/pyhelpers/1.2.17/):

- Improved the module [ops](https://github.com/mikeqfu/pyhelpers/blob/b4b822f71e03ea79ba4e663f2a20b772ce5824bd/pyhelpers/ops.py) by:
- fixing the issue in [fake_requests_headers()](https://github.com/mikeqfu/pyhelpers/commit/69adc0e7fdea6175c7ab6a9013470d541d96e3e2#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aL1248-R1376) that may occasionally raise [IndexError](https://docs.python.org/3/library/exceptions.html#IndexError);
- adding a new function [get_fake_user_agent()](https://github.com/mikeqfu/pyhelpers/commit/b4b822f71e03ea79ba4e663f2a20b772ce5824bd#diff-9266f224c0227114f50836ba656288a96bd7cca831301fe025c5a7cf9f4ab45aL1227-R1276).

**For more information and detailed specifications, check out [PyHelpers 1.2.18 documentation](https://pyhelpers.readthedocs.io/en/1.2.18/).**