Skip to content

Commit cf6ddf9

Browse files
adamluiadamlui
committed
Centered header, organized into categories, replaced <h3>s w/ ### 
1 parent f3ebeb9 commit cf6ddf9

1 file changed

Lines changed: 197 additions & 98 deletions

File tree

‎docs/README.md‎

Lines changed: 197 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
<a id="top"></a>
22

3+
<div align="center">
4+
35
# 🐍 adamlui / python-utils
46

57
<a href="https://pypacktrends.com/?packages=ai-personas&packages=computer-languages&packages=data-languages&packages=find-project-root&packages=get-min-py&packages=is-legacy-terminal&packages=is-unicode-supported&packages=latin-locales&packages=markup-languages&packages=non-latin-locales&packages=programming-languages&packages=project-markers&packages=prose-languages&packages=remove-json-keys&packages=sys-lang&packages=translate-messages&time_range=allTimeCumulative&scheme=dark">
@@ -11,16 +13,33 @@
1113
<a href="https://sonarcloud.io/component_measures?metric=vulnerabilities&id=adamlui_python-utils">
1214
<img height=31 src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fsonarcloud.io%2Fapi%2Fmeasures%2Fcomponent%3Fcomponent%3Dadamlui_python-utils%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonar&logoColor=white&labelColor=464646&label=Vulnerabilities&color=gold"></a>
1315

14-
> ### A collection of useful Python utilities.
16+
### A collection of useful Python utilities.
1517

1618
<a href="#"><img height=10px width="100%" src="https://cdn.jsdelivr.net/gh/adamlui/python-utils@b8b2932/assets/images/separators/aqua-gradient.png"></a>
1719

20+
</div>
21+
22+
23+
## 📑 Data processing <!-- CATEGORY -->
24+
25+
26+
<!-- REMOVE-JSON-KEYS -->
27+
28+
### <a href="https://github.com/adamlui/python-utils/tree/main/remove-json-keys/#readme">remove-json-keys</a>
29+
30+
> Simply remove JSON keys via CLI command.
31+
<br>[Install](https://github.com/adamlui/python-utils/tree/main/remove-json-keys/#installation) /
32+
[Readme](https://github.com/adamlui/python-utils/tree/main/remove-json-keys/#readme) /
33+
[CLI usage](https://github.com/adamlui/python-utils/tree/main/remove-json-keys/#usage) /
34+
[Discuss](https://github.com/adamlui/python-utils/discussions)
35+
36+
37+
## 📊 Datasets <!-- CATEGORY -->
38+
39+
1840
<!-- AI-PERSONAS -->
1941

20-
<h3>
21-
<a href="https://github.com/adamlui/python-utils/tree/main/ai-personas/#readme">
22-
🤖 ai-personas</a>
23-
</h3>
42+
### <a href="https://github.com/adamlui/python-utils/tree/main/ai-personas/#readme">ai-personas</a>
2443

2544
<details>
2645
<summary>1,000+ AI personas for LLMs and agents.</summary>
@@ -43,10 +62,7 @@
4362

4463
<!-- COMPUTER-LANGUAGES -->
4564

46-
<h3>
47-
<a href="https://github.com/adamlui/python-utils/tree/main/computer-languages/#readme">
48-
💻 computer-languages</a>
49-
</h3>
65+
### <a href="https://github.com/adamlui/python-utils/tree/main/computer-languages/#readme">computer-languages</a>
5066

5167
<details>
5268
<summary>File extensions for computer languages.</summary>
@@ -69,10 +85,7 @@
6985

7086
<!-- DATA-LANGUAGES -->
7187

72-
<h3>
73-
<a href="https://github.com/adamlui/python-utils/tree/main/data-languages/#readme">
74-
{ } data-languages</a>
75-
</h3>
88+
### <a href="https://github.com/adamlui/python-utils/tree/main/data-languages/#readme">data-languages</a>
7689

7790
<details>
7891
<summary>File extensions for data languages.</summary>
@@ -93,66 +106,9 @@
93106
Discuss</a>
94107
</blockquote>
95108

96-
### <a href="https://github.com/adamlui/python-utils/tree/main/find-project-root/#readme">📂 find-project-root</a>
97-
98-
> Locate project root via custom markers.
99-
<br>[Install](https://github.com/adamlui/python-utils/tree/main/find-project-root/#installation) /
100-
[Readme](https://github.com/adamlui/python-utils/tree/main/find-project-root/#readme) /
101-
[API usage](https://github.com/adamlui/python-utils/tree/main/find-project-root/#api-usage) /
102-
[Discuss](https://github.com/adamlui/python-utils/discussions)
103-
104-
<!-- GET-MIN-PY -->
105-
106-
<h3>
107-
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#readme">
108-
📊 get-min-py</a>
109-
</h3>
110-
111-
<details>
112-
<summary>Get the minimum Python version required for a PyPI package.</summary>
113-
<br><blockquote>
114-
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#readme">
115-
<img width=550 src="https://cdn.jsdelivr.net/gh/adamlui/python-utils@f133ea3/get-min-py/assets/images/cli-output.png"></a>
116-
</blockquote>
117-
</details>
118-
119-
<blockquote>
120-
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#-installation">
121-
Install</a> /
122-
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#readme">
123-
Readme</a> /
124-
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#-api-usage">
125-
API usage</a> /
126-
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#-command-line-usage">
127-
CLI usage</a> /
128-
<a href="https://github.com/adamlui/python-utils/discussions">
129-
Discuss</a>
130-
</blockquote>
131-
132-
### <a href="https://github.com/adamlui/python-utils/tree/main/is-legacy-terminal/#readme">📟 is-legacy-terminal</a>
133-
134-
> Detect whether the terminal is legacy.
135-
<br>[Install](https://github.com/adamlui/python-utils/tree/main/is-legacy-terminal/#-installation) /
136-
[Readme](https://github.com/adamlui/python-utils/tree/main/is-legacy-terminal/#readme) /
137-
[API usage](https://github.com/adamlui/python-utils/tree/main/is-legacy-terminal/#-api-usage) /
138-
[CLI usage](https://github.com/adamlui/python-utils/tree/main/is-legacy-terminal/#-command-line-usage) /
139-
[Discuss](https://github.com/adamlui/python-utils/discussions)
140-
141-
### <a href="https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#readme">🈶 is-unicode-supported</a>
142-
143-
> Detect whether the terminal supports advanced Unicode.
144-
<br>[Install](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#-installation) /
145-
[Readme](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#readme) /
146-
[API usage](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#-api-usage) /
147-
[CLI usage](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#-command-line-usage) /
148-
[Discuss](https://github.com/adamlui/python-utils/discussions)
149-
150109
<!-- LATIN-LOCALES -->
151110

152-
<h3>
153-
<a href="https://github.com/adamlui/python-utils/tree/main/latin-locales/#readme">
154-
🇪🇸 latin-locales</a>
155-
</h3>
111+
### <a href="https://github.com/adamlui/python-utils/tree/main/latin-locales/#readme">latin-locales</a>
156112

157113
<details>
158114
<summary>ISO 639-1 (2-letter) codes for Latin locales.</summary>
@@ -175,10 +131,7 @@
175131

176132
<!-- MARKUP-LANGUAGES -->
177133

178-
<h3>
179-
<a href="https://github.com/adamlui/python-utils/tree/main/markup-languages/#readme">
180-
{ } markup-languages</a>
181-
</h3>
134+
### <a href="https://github.com/adamlui/python-utils/tree/main/markup-languages/#readme">markup-languages</a>
182135

183136
<details>
184137
<summary>File extensions for markup languages.</summary>
@@ -201,10 +154,7 @@
201154

202155
<!-- NON-LATIN-LOCALES -->
203156

204-
<h3>
205-
<a href="https://github.com/adamlui/python-utils/tree/main/computer-languages/#readme">
206-
🇨🇳 non-latin-locales</a>
207-
</h3>
157+
### <a href="https://github.com/adamlui/python-utils/tree/main/non-latin-locales/#readme">non-latin-locales</a>
208158

209159
<details>
210160
<summary>ISO 639-1 (2-letter) codes for non-Latin locales.</summary>
@@ -227,10 +177,7 @@
227177

228178
<!-- PROGRAMMING-LANGUAGES -->
229179

230-
<h3>
231-
<a href="https://github.com/adamlui/python-utils/tree/main/programming-languages/#readme">
232-
{ } programming-languages</a>
233-
</h3>
180+
### <a href="https://github.com/adamlui/python-utils/tree/main/programming-languages/#readme">programming-languages</a>
234181

235182
<details>
236183
<summary>File extensions for programming languages.</summary>
@@ -253,10 +200,7 @@
253200

254201
<!-- PROJECT-MARKERS -->
255202

256-
<h3>
257-
<a href="https://github.com/adamlui/python-utils/tree/main/project-markers/#readme">
258-
🏷️ project-markers</a>
259-
</h3>
203+
### <a href="https://github.com/adamlui/python-utils/tree/main/project-markers/#readme">project-markers</a>
260204

261205
<details>
262206
<summary>Common project root markers.</summary>
@@ -279,10 +223,7 @@
279223

280224
<!-- PROSE-LANGUAGES -->
281225

282-
<h3>
283-
<a href="https://github.com/adamlui/python-utils/tree/main/prose-languages/#readme">
284-
## prose-languages</a>
285-
</h3>
226+
### <a href="https://github.com/adamlui/python-utils/tree/main/prose-languages/#readme">prose-languages</a>
286227

287228
<details>
288229
<summary>File extensions for prose languages.</summary>
@@ -303,15 +244,140 @@
303244
Discuss</a>
304245
</blockquote>
305246

306-
### <a href="https://github.com/adamlui/python-utils/tree/main/remove-json-keys/#readme">{ } remove-json-keys</a>
307247

308-
> Simply remove JSON keys via CLI command.
309-
<br>[Install](https://github.com/adamlui/python-utils/tree/main/remove-json-keys/#installation) /
310-
[Readme](https://github.com/adamlui/python-utils/tree/main/remove-json-keys/#readme) /
311-
[CLI usage](https://github.com/adamlui/python-utils/tree/main/remove-json-keys/#usage) /
248+
## 🖥️ Environment <!-- CATEGORY -->
249+
250+
251+
<!-- FIND-PROJECT-ROOT -->
252+
253+
### <a href="https://github.com/adamlui/python-utils/tree/main/find-project-root/#readme">find-project-root</a>
254+
255+
> Locate project root via custom markers.
256+
<br>[Install](https://github.com/adamlui/python-utils/tree/main/find-project-root/#installation) /
257+
[Readme](https://github.com/adamlui/python-utils/tree/main/find-project-root/#readme) /
258+
[API usage](https://github.com/adamlui/python-utils/tree/main/find-project-root/#api-usage) /
259+
[Discuss](https://github.com/adamlui/python-utils/discussions)
260+
261+
<!-- IS-LEGACY-TERMINAL -->
262+
263+
### <a href="https://github.com/adamlui/python-utils/tree/main/is-legacy-terminal/#readme">is-legacy-terminal</a>
264+
265+
> Detect whether the terminal is legacy.
266+
<br>[Install](https://github.com/adamlui/python-utils/tree/main/is-legacy-terminal/#-installation) /
267+
[Readme](https://github.com/adamlui/python-utils/tree/main/is-legacy-terminal/#readme) /
268+
[API usage](https://github.com/adamlui/python-utils/tree/main/is-legacy-terminal/#-api-usage) /
269+
[CLI usage](https://github.com/adamlui/python-utils/tree/main/is-legacy-terminal/#-command-line-usage) /
270+
[Discuss](https://github.com/adamlui/python-utils/discussions)
271+
272+
<!-- IS-UNICODE-SUPPORTED -->
273+
274+
### <a href="https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#readme">is-unicode-supported</a>
275+
276+
> Detect whether the terminal supports advanced Unicode.
277+
<br>[Install](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#-installation) /
278+
[Readme](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#readme) /
279+
[API usage](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#-api-usage) /
280+
[CLI usage](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#-command-line-usage) /
281+
[Discuss](https://github.com/adamlui/python-utils/discussions)
282+
283+
<!-- PROJECT-MARKERS -->
284+
285+
### <a href="https://github.com/adamlui/python-utils/tree/main/project-markers/#readme">project-markers</a>
286+
287+
<details>
288+
<summary>Common project root markers.</summary>
289+
<br><blockquote>
290+
<a href="https://github.com/adamlui/python-utils/tree/main/project-markers/#readme">
291+
<img width=375 src="https://cdn.jsdelivr.net/gh/adamlui/python-utils@2066dc5/project-markers/assets/images/dataset-preview.png"></a>
292+
</blockquote>
293+
</details>
294+
295+
<blockquote>
296+
<a href="https://github.com/adamlui/python-utils/tree/main/project-markers/#installation">
297+
Install</a> /
298+
<a href="https://github.com/adamlui/python-utils/tree/main/project-markers/#readme">
299+
Readme</a> /
300+
<a href="https://github.com/adamlui/python-utils/tree/main/project-markers/#usage">
301+
API usage</a> /
302+
<a href="https://github.com/adamlui/python-utils/discussions">
303+
Discuss</a>
304+
</blockquote>
305+
306+
<!-- SYS-LANG -->
307+
308+
### <a href="https://github.com/adamlui/python-utils/tree/main/sys-lang/#readme">sys-lang</a>
309+
310+
> Detect the system language.
311+
<br>[Install](https://github.com/adamlui/python-utils/tree/main/sys-lang/#-installation) /
312+
[Readme](https://github.com/adamlui/python-utils/tree/main/sys-lang/#readme) /
313+
[API usage](https://github.com/adamlui/python-utils/tree/main/sys-lang/#-api-usage) /
314+
[CLI usage](https://github.com/adamlui/python-utils/tree/main/sys-lang/#-command-line-usage) /
312315
[Discuss](https://github.com/adamlui/python-utils/discussions)
313316

314-
### <a href="https://github.com/adamlui/python-utils/tree/main/sys-lang/#readme">🗺 sys-lang</a>
317+
318+
## Internationalization / Localization <!-- CATEGORY -->
319+
320+
321+
<!-- IS-UNICODE-SUPPORTED -->
322+
323+
### <a href="https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#readme">is-unicode-supported</a>
324+
325+
> Detect whether the terminal supports advanced Unicode.
326+
<br>[Install](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#-installation) /
327+
[Readme](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#readme) /
328+
[API usage](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#-api-usage) /
329+
[CLI usage](https://github.com/adamlui/python-utils/tree/main/is-unicode-supported/#-command-line-usage) /
330+
[Discuss](https://github.com/adamlui/python-utils/discussions)
331+
332+
<!-- LATIN-LOCALES -->
333+
334+
### <a href="https://github.com/adamlui/python-utils/tree/main/latin-locales/#readme">latin-locales</a>
335+
336+
<details>
337+
<summary>ISO 639-1 (2-letter) codes for Latin locales.</summary>
338+
<br><blockquote>
339+
<a href="https://github.com/adamlui/python-utils/tree/main/latin-locales/#readme">
340+
<img width=275 src="https://cdn.jsdelivr.net/gh/adamlui/python-utils@2066dc5/latin-locales/assets/images/dataset-preview.png"></a>
341+
</blockquote>
342+
</details>
343+
344+
<blockquote>
345+
<a href="https://github.com/adamlui/python-utils/tree/main/latin-locales/#installation">
346+
Install</a> /
347+
<a href="https://github.com/adamlui/python-utils/tree/main/latin-locales/#readme">
348+
Readme</a> /
349+
<a href="https://github.com/adamlui/python-utils/tree/main/latin-locales/#usage">
350+
API usage</a> /
351+
<a href="https://github.com/adamlui/python-utils/discussions">
352+
Discuss</a>
353+
</blockquote>
354+
355+
<!-- NON-LATIN-LOCALES -->
356+
357+
### <a href="https://github.com/adamlui/python-utils/tree/main/non-latin-locales/#readme">non-latin-locales</a>
358+
359+
<details>
360+
<summary>ISO 639-1 (2-letter) codes for non-Latin locales.</summary>
361+
<br><blockquote>
362+
<a href="https://github.com/adamlui/python-utils/tree/main/non-latin-locales/#readme">
363+
<img width=275 src="https://cdn.jsdelivr.net/gh/adamlui/python-utils@2066dc5/non-latin-locales/assets/images/dataset-preview.png"></a>
364+
</blockquote>
365+
</details>
366+
367+
<blockquote>
368+
<a href="https://github.com/adamlui/python-utils/tree/main/non-latin-locales/#installation">
369+
Install</a> /
370+
<a href="https://github.com/adamlui/python-utils/tree/main/non-latin-locales/#readme">
371+
Readme</a> /
372+
<a href="https://github.com/adamlui/python-utils/tree/main/non-latin-locales/#usage">
373+
API usage</a> /
374+
<a href="https://github.com/adamlui/python-utils/discussions">
375+
Discuss</a>
376+
</blockquote>
377+
378+
<!-- SYS-LANG -->
379+
380+
### <a href="https://github.com/adamlui/python-utils/tree/main/sys-lang/#readme">sys-lang</a>
315381

316382
> Detect the system language.
317383
<br>[Install](https://github.com/adamlui/python-utils/tree/main/sys-lang/#-installation) /
@@ -320,14 +386,47 @@
320386
[CLI usage](https://github.com/adamlui/python-utils/tree/main/sys-lang/#-command-line-usage) /
321387
[Discuss](https://github.com/adamlui/python-utils/discussions)
322388

323-
### <a href="https://github.com/adamlui/python-utils/tree/main/translate-messages/#readme">🌍 translate-messages</a>
389+
<!-- TRANSLATE-MESSAGES -->
390+
391+
### <a href="https://github.com/adamlui/python-utils/tree/main/translate-messages/#readme">translate-messages</a>
324392

325393
> Translate `en/messages.json` (chrome.i18n format) to 100+ locales automatically.
326394
<br>[Install](https://github.com/adamlui/python-utils/tree/main/translate-messages/#installation) /
327395
[Readme](https://github.com/adamlui/python-utils/tree/main/translate-messages/#readme) /
328396
[CLI usage](https://github.com/adamlui/python-utils/tree/main/translate-messages/#usage) /
329397
[Discuss](https://github.com/adamlui/python-utils/discussions)
330398

399+
400+
## 📦 Package <!-- CATEGORY -->
401+
402+
403+
<!-- GET-MIN-PY -->
404+
405+
### <a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#readme">get-min-py</a>
406+
407+
<details>
408+
<summary>Get the minimum Python version required for a PyPI package.</summary>
409+
<br><blockquote>
410+
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#readme">
411+
<img width=550 src="https://cdn.jsdelivr.net/gh/adamlui/python-utils@f133ea3/get-min-py/assets/images/cli-output.png"></a>
412+
</blockquote>
413+
</details>
414+
415+
<blockquote>
416+
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#-installation">
417+
Install</a> /
418+
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#readme">
419+
Readme</a> /
420+
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#-api-usage">
421+
API usage</a> /
422+
<a href="https://github.com/adamlui/python-utils/tree/main/get-min-py/#-command-line-usage">
423+
CLI usage</a> /
424+
<a href="https://github.com/adamlui/python-utils/discussions">
425+
Discuss</a>
426+
</blockquote>
427+
428+
<!-- FOOTER -->
429+
331430
<a href="#"><img height=6px width="100%" src="https://cdn.jsdelivr.net/gh/adamlui/python-utils@b8b2932/assets/images/separators/aqua-gradient.png"></a>
332431

333432
<picture><source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/gh/adamlui/python-utils@d6fae85/assets/images/icons/tag/white/icon16.svg"><img height=14 src="https://cdn.jsdelivr.net/gh/adamlui/python-utils@d6fae85/assets/images/icons/tag/dark-gray/icon16.svg"></picture>

0 commit comments

Comments
 (0)