pyhelpers 2.5.3__tar.gz → 2.5.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. pyhelpers-2.5.4/.gitignore +34 -0
  2. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/CHANGELOG.md +22 -1
  3. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/PKG-INFO +3 -2
  4. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/__init__.py +16 -9
  5. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/data/user-agent-strings.json +117 -111
  6. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/geom/transforms.py +76 -46
  7. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/ops/downloads.py +68 -42
  8. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/store/loaders.py +71 -41
  9. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/store/savers.py +9 -4
  10. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyproject.toml +40 -22
  11. pyhelpers-2.5.3/.gitignore +0 -30
  12. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/CITATION.cff +0 -0
  13. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/LICENSE +0 -0
  14. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/README.md +0 -0
  15. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/_cache.py +0 -0
  16. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/data/ansi-escape-codes.json +0 -0
  17. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/data/english-numerals.json +0 -0
  18. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/data/xlsx2csv.vbs +0 -0
  19. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/dbms/__init__.py +0 -0
  20. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/dbms/_base.py +0 -0
  21. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/dbms/mssql.py +0 -0
  22. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/dbms/postgresql.py +0 -0
  23. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/dbms/utils.py +0 -0
  24. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/dirs/__init__.py +0 -0
  25. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/dirs/formatting.py +0 -0
  26. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/dirs/management.py +0 -0
  27. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/dirs/navigation.py +0 -0
  28. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/dirs/validation.py +0 -0
  29. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/geom/__init__.py +0 -0
  30. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/geom/distances.py +0 -0
  31. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/geom/shapes.py +0 -0
  32. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/ops/__init__.py +0 -0
  33. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/ops/apis.py +0 -0
  34. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/ops/computation.py +0 -0
  35. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/ops/general.py +0 -0
  36. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/ops/manipulation.py +0 -0
  37. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/ops/web.py +0 -0
  38. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/settings/__init__.py +0 -0
  39. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/settings/configurations.py +0 -0
  40. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/settings/preferences.py +0 -0
  41. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/store/__init__.py +0 -0
  42. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/store/converters.py +0 -0
  43. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/store/utils.py +0 -0
  44. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/text/__init__.py +0 -0
  45. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/text/preprocessing.py +0 -0
  46. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/text/similarity.py +0 -0
  47. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/viz/__init__.py +0 -0
  48. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/viz/color_utils.py +0 -0
  49. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/viz/colormap.py +0 -0
  50. {pyhelpers-2.5.3 → pyhelpers-2.5.4}/pyhelpers/viz/maps.py +0 -0
@@ -0,0 +1,34 @@
1
+ # Environment
2
+ .env
3
+ .idea/
4
+ .venv/
5
+ */vscode/
6
+ **/__pycache__/
7
+ venv/
8
+
9
+ # Python runtime and bytecode
10
+ __pycache__/
11
+ *.py[cod]
12
+
13
+ # Sphinx documentation
14
+ docs/build/
15
+ docs/source/api/
16
+
17
+ # Jupyter Notebooks
18
+ .ipynb_checkpoints/
19
+
20
+ # Testing and code coverage
21
+ .coverage
22
+ .coverage.*
23
+ reports/
24
+ .pytest_cache/
25
+
26
+ # Distribution and packaging
27
+ dist/
28
+ *.egg-info/
29
+
30
+ # Project-specific directories / files
31
+ tutorials/*
32
+ !tutorials/.gitkeep
33
+ .pypirc
34
+ cmd.md
@@ -1,6 +1,27 @@
1
1
  # Changelog / Release notes
2
2
 
3
3
 
4
+ ## [2.5.4](https://github.com/mikeqfu/pyhelpers/releases/tag/2.5.4)
5
+
6
+ (*20 November 2026*)
7
+
8
+ ### Notable [changes](https://github.com/mikeqfu/pyhelpers/compare/2.5.3...2.5.4) since [2.5.3](https://pypi.org/project/pyhelpers/2.5.3/):
9
+
10
+ - **Subpackage refinements & bug fixes:**
11
+ * Configured `GitHubFileDownloader` with a `certifi`-backed SSL context and private opener to fix certificate verification failures (#165, #170).
12
+ * Modernised Shapely geometry transform logic and fixed variable scoping in `geom` subpackage (#168).
13
+ * Replaced deprecated `ExcelFile.parse` with `pandas.read_excel` (#163, #169).
14
+ * Fixed `load_parquet` returning `None` and stopped forwarding `engine='auto'` to Pandas when saving Parquet files (#166, #167).
15
+ - **Documentation & project metadata:**
16
+ * Renamed Sphinx autosummary output directory from `_generated` to `api`, removed redundant `requirements.txt` from documentation source and added clean build targets (#171).
17
+ * Standardised metadata keys, updated build configuration in `pyproject.toml` (#171).
18
+ - **CI/CD & maintenance:**
19
+ * Configured CI test coverage workflow, refined unit test suite and upgraded `astral-sh/setup-uv` Action dependencies (#155, #159, #161).
20
+ * Refined `.gitignore` patterns, added `.gitkeep` placeholder for tutorials directory and locked latest package dependencies in `uv.lock` (#160, #171).
21
+
22
+ **For more information and detailed specifications, check out the [PyHelpers 2.5.4 documentation](https://pyhelpers.readthedocs.io/en/2.5.4/).**
23
+
24
+
4
25
  ## [2.5.3](https://github.com/mikeqfu/pyhelpers/releases/tag/2.5.3)
5
26
 
6
27
  (*20 September 2026*)
@@ -28,7 +49,7 @@
28
49
 
29
50
  - **Packaging & metadata resolution:**
30
51
  * Standardised `license`, `authors` and `[project.urls]` tables in `pyproject.toml` to fix PyPI metadata rendering.
31
- * Standardised `__title__` string formatting in package initialisation module (`__init__.py`).
52
+ * Standardised `__title__` string formatting in package initialization module (`__init__.py`).
32
53
  - **Documentation & maintenance:**
33
54
  * Standardised copyright format in Sphinx configuration (`docs/conf.py`).
34
55
  * Updated `uv.lock` dependency lockfile.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: pyhelpers
3
- Version: 2.5.3
3
+ Version: 2.5.4
4
4
  Summary: An open-source toolkit for facilitating Python users' data manipulation tasks.
5
5
  Project-URL: Homepage, https://github.com/mikeqfu/pyhelpers
6
6
  Project-URL: Documentation, https://pyhelpers.readthedocs.io/en/latest/
@@ -8,7 +8,7 @@ Project-URL: Repository, https://github.com/mikeqfu/pyhelpers
8
8
  Project-URL: Bug Tracker, https://github.com/mikeqfu/pyhelpers/issues
9
9
  Project-URL: Changelog, https://github.com/mikeqfu/pyhelpers/blob/master/CHANGELOG.md
10
10
  Author: Qian Fu
11
- License: MIT
11
+ License-Expression: MIT
12
12
  License-File: LICENSE
13
13
  Keywords: Data manipulation,Data preprocessing,Python,Python utilities,Python utility,Python utils,Utilities
14
14
  Classifier: Intended Audience :: Developers
@@ -17,6 +17,7 @@ Classifier: Intended Audience :: Science/Research
17
17
  Classifier: Operating System :: Microsoft :: Windows
18
18
  Classifier: Operating System :: POSIX :: Linux
19
19
  Classifier: Programming Language :: Python :: 3
20
+ Classifier: Programming Language :: Python :: 3 :: Only
20
21
  Classifier: Programming Language :: Python :: 3.12
21
22
  Classifier: Programming Language :: Python :: 3.13
22
23
  Classifier: Programming Language :: Python :: 3.14
@@ -75,22 +75,25 @@ def _load_metadata():
75
75
  cfg = tomllib.load(f)
76
76
 
77
77
  project_info = cfg.get('project', {})
78
- custom_info = cfg.get('tool', {}).get('custom', {}).get('metadata', {})
78
+ custom_info = cfg.get('tool', {}).get('pyhelpers', {}).get('metadata', {})
79
79
 
80
80
  name = project_info.get('name', package_name)
81
81
  version = version or project_info.get('version')
82
82
  description = description or project_info.get('description')
83
83
 
84
- authors_str = ', '.join(a.get('name', '') for a in project_info['authors'])
84
+ authors_str = ', '.join(a.get('name', '') for a in project_info.get('authors', []))
85
85
 
86
86
  # Format copyright string
87
87
  start_year = 2019
88
88
  current_year = datetime.date.today().year
89
89
  years = f'{start_year}-{current_year}' if current_year > start_year else f'{start_year}'
90
- copyright_str = f'Copyright (c) {years} {authors_str}'.strip()
90
+ copyright_str = (
91
+ f'Copyright (c) {years} {authors_str}'.strip() if authors_str
92
+ else f'Copyright (c) {years}'
93
+ )
91
94
 
92
95
  # Parse corresponding author details
93
- corr_auth_list = custom_info.get('corresponding_author', [])
96
+ corr_auth_list = custom_info.get('corresponding-author', [])
94
97
  corr_author_str = ''
95
98
  affiliation_str = ''
96
99
 
@@ -111,8 +114,9 @@ def _load_metadata():
111
114
  'copyright': copyright_str,
112
115
 
113
116
  # Custom medata
114
- 'project_start': custom_info.get('project_start', ''),
115
- 'corresponding_author': corr_author_str,
117
+ 'project-name': custom_info.get('project-name', ''),
118
+ 'project-start': custom_info.get('project-start', ''),
119
+ 'corresponding-author': corr_author_str,
116
120
  'affiliation': affiliation_str,
117
121
  'funder': custom_info.get('funder', ''),
118
122
  }
@@ -120,19 +124,22 @@ def _load_metadata():
120
124
 
121
125
  METADATA = _load_metadata()
122
126
 
123
- __project__ = 'PyHelpers'
127
+ __project__ = METADATA.get('project-name')
124
128
  __pkgname__ = METADATA.get('name')
125
129
  __description__ = METADATA.get('description')
130
+
126
131
  __title__ = f"{__project__}: {__description__.strip('.')}" if __description__ else __project__
132
+
127
133
  __version__ = METADATA.get('version')
128
134
  __license__ = METADATA.get('license')
129
135
  __copyright__ = METADATA.get('copyright')
130
- __first_release__ = METADATA.get('project_start')
136
+
137
+ __first_release__ = METADATA.get('project-start')
131
138
 
132
139
  __funder__ = METADATA.get("funder")
133
140
 
134
141
  __author__ = METADATA.get('authors')
135
- __corresponding_author__ = METADATA.get('corresponding_author')
142
+ __corresponding_author__ = METADATA.get('corresponding-author')
136
143
  __affiliation__ = METADATA.get('affiliation')
137
144
 
138
145
  __all__ = [