11# python-build-utils
22
3- [ ![ GitHub Release] ( https://img.shields.io/github/v/release/dave-Lab-and-Engineering /python-build-utils )] ( https://github.com/dave-Lab-and-Engineering /python-build-utils/releases/tag/0.1.1 )
3+ [ ![ GitHub Release] ( https://img.shields.io/github/v/release/eelcovv /python-build-utils )] ( https://github.com/eelcovv /python-build-utils/releases )
44[ ![ PyPI Version] ( https://img.shields.io/pypi/v/python-build-utils )] ( https://pypi.org/project/python-build-utils/ )
5- [ ![ Build Status] ( https://img.shields.io/github/actions/workflow/status/dave-Lab-and-Engineering /python-build-utils/main.yml?branch=main )] ( https://github.com/dave-Lab-and-Engineering /python-build-utils/actions/workflows/main.yml )
6- [ ![ Coverage Status ] ( https://coveralls .io/repos/github/dave-Lab-and-Engineering/ python-build-utils/badge.svg )] ( https://coveralls .io/github/dave-Lab-and-Engineering /python-build-utils )
7- [ ![ Commit Activity] ( https://img.shields.io/github/commit-activity/m/dave-Lab-and-Engineering /python-build-utils )] ( https://github.com/dave-Lab-and-Engineering/python-build-utils/commits /main )
8- [ ![ License] ( https://img.shields.io/github/license/dave-Lab-and-Engineering /python-build-utils )] ( https://github.com/dave-Lab-and-Engineering/python-build-utils/blob/main/LICENSE )
5+ [ ![ Build Status] ( https://img.shields.io/github/actions/workflow/status/eelcovv /python-build-utils/main.yml?branch=main )] ( https://github.com/eelcovv /python-build-utils/actions/workflows/main.yml )
6+ [ ![ Codecov ] ( https://codecov .io/gh/eelcovv/ python-build-utils/branch/main/graph/ badge.svg )] ( https://codecov .io/gh/eelcovv /python-build-utils )
7+ [ ![ Commit Activity] ( https://img.shields.io/github/commit-activity/m/eelcovv /python-build-utils )] ( https://github.com/dave-Lab-and-Engineering/python-build-utils/commit /main )
8+ [ ![ License] ( https://img.shields.io/github/license/eelcovv /python-build-utils )] ( https://github.com/dave-Lab-and-Engineering/python-build-utils/blob/main/LICENSE )
99
1010Small collection of command line utilities to assist with building your python wheels
1111
12+ - ** Github repository** : < https://github.com/dave-Lab-and-Engineering/python-build-utils >
13+ - ** Documentation** < https://dave-lab-and-engineering.github.io/python-build-utils/ >
14+
1215## Description
1316
14- ### Cli-tool ` python-build-utils --help `
17+ ### Cli-tool ` python-build-utils `
18+
19+ ``` shell
20+ (python-build-utils) PS> python-build-utils.exe --help
21+ Usage: python-build-utils [OPTIONS] COMMAND [ARGS]...
22+
23+ A collection of CLI tools for Python build utilities.
24+
25+ Options:
26+ --help Show this message and exit.
27+
28+ Commands:
29+ remove-tarballs Remove tarball files from dist
30+ rename-wheel-files Rename wheel files in the dist folder.
31+ py2wheel Rename wheel files in the dist folder.
1532
16- ``` text
33+ (python-build-utils) PS > python-build-utils.exe --help
1734Usage: python-build-utils [OPTIONS] COMMAND [ARGS]...
1835
1936 A collection of CLI tools for Python build utilities.
2037
2138Options:
22- -v, --version Show the version and exit.
23- --help Show this message and exit.
39+ --help Show this message and exit.
2440
2541Commands:
26- pyd2wheel Create a wheel from a compiled python *.pyd file.
2742 remove-tarballs Remove tarball files from dist.
2843 rename-wheel-files Rename wheel files in the dist folder.
2944```
3045
31- ### Cli-tool ` rename-wheel-files --help `
46+ ### rename-wheel-files
3247
33- ``` text
48+ ``` shell
49+ (python-build-utils) PS> rename-wheel-files.exe --help
3450Usage: rename-wheel-files [OPTIONS]
3551
3652 Rename wheel files in the dist folder.
@@ -59,20 +75,15 @@ Usage: rename-wheel-files [OPTIONS]
5975 tag is constructed using the ` python_version_tag` and ` platform_tag` as
6076 described above.
6177
62- Returns: None
63-
64- Example: rename_wheel_files("dist", "cp39", "win_amd64", "")
65-
6678Options:
67- -v, --version Show the version and exit.
6879 --dist_dir TEXT Directory containing wheel files. Default is
6980 ' dist'
7081 --python_version_tag TEXT Explicitly specify the python version tag.
71- Default is cp{major}{minor}
82+ Default is cp{major}{minor}.
7283 --platform_tag TEXT Explicitly specify the platform tag. Default is
73- sysconfig.get_platform()
84+ sysconfig.get_platform ().
7485 --wheel_tag TEXT Explicitly specify the total wheel tag. Default is
75- {python_version_tag}-{python_version_tag}-{platform_tag}
86+ {python_version_tag}-{python_version_tag}-{platform_tag}.
7687 --help Show this message and exit.
7788```
7889
@@ -84,9 +95,10 @@ From your project root folder, just run
8495rename-wheel-files
8596```
8697
87- ### Cli-tool ` remove-tarballs --help `
98+ ### remove-tarballs
8899
89- ``` text
100+ ``` shell
101+ (python-build-utils) PS> remove-tarballs.exe --help
90102Usage: remove-tarballs [OPTIONS]
91103
92104 Remove tarball files from dist.
@@ -96,12 +108,7 @@ Usage: remove-tarballs [OPTIONS]
96108 Args: dist_dir (str): The directory containing the tarball files to be
97109 removed.
98110
99- Returns: None
100-
101- Example: remove_tarballs("dist")
102-
103111Options:
104- -v, --version Show the version and exit.
105112 --dist_dir TEXT Directory containing wheel the files. Default is ' dist'
106113 --help Show this message and exit.
107114```
@@ -114,19 +121,7 @@ From your project root folder, just run
114121remove-tarballs
115122```
116123
117- ### Cli-tool ` pyd2wheel --help `
118-
119- ``` text
120- Usage: pyd2wheel [OPTIONS] PYD_FILE
121-
122- Create a wheel from a compiled python *.pyd file.
123-
124- Options:
125- -v, --version Show the version and exit.
126- --package_version TEXT The version of the package.
127- --abi_tag TEXT The ABI tag of the package. Default is 'none'.
128- --help Show this message and exit.
129- ```
124+ ### pyd2wheel tool
130125
131126This is a tool to convert bare .pyd files to a wheel file such that they can be installed.
132127
@@ -142,5 +137,4 @@ pyd2wheel("mybinary.cp310-win_amd64.pyd", version="1.0.0")
142137```
143138
144139This will create a wheel file named in the same directory as the input file.
145-
146140Note: The version argument is used only if the version is not already present in the filename (like in the example above).
0 commit comments