Created markup-languages pkg

Author: adamlui

.github/dependabot.yml

@@ -13,6 +13,7 @@ updates:
       - /get-min-py
       - /is-unicode-supported
       - /latin-locales
+      - /markup-languages
       - /non-latin-locales
       - /programming-languages
       - /project-markers

docs/README.md

@@ -2,7 +2,7 @@
 
 # 🐍 adamlui / python-utils
 
-<a href="https://pypacktrends.com/?packages=find-project-root&packages=get-min-py&packages=is-unicode-supported&packages=latin-locales&packages=non-latin-locales&packages=programming-languages&packages=project-markers&packages=remove-json-keys&packages=translate-messages&time_range=allTimeCumulative&scheme=dark">
+<a href="https://pypacktrends.com/?packages=find-project-root&packages=get-min-py&packages=is-unicode-supported&packages=latin-locales&packages=markup-languages&packages=non-latin-locales&packages=programming-languages&packages=project-markers&packages=remove-json-keys&packages=translate-messages&time_range=allTimeCumulative&scheme=dark">
     <img height=31 src="https://img.shields.io/badge/Downloads-9.8k-af68ff.svg?logo=weightsandbiases&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 <a href="./LICENSE.md">
     <img height=31 src="https://img.shields.io/badge/License-MIT-f99b27.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
@@ -49,6 +49,14 @@
 [API usage](https://github.com/adamlui/python-utils/tree/main/latin-locales/#usage) /
 [Discuss](https://github.com/adamlui/python-utils/discussions)
 
+### <a href="https://github.com/adamlui/python-utils/tree/main/markup-languages/#readme"><> markup-languages</a>
+
+> File extensions for markup languages.
+<br>[Install](https://github.com/adamlui/python-utils/tree/main/markup-languages/#installation) /
+[Readme](https://github.com/adamlui/python-utils/tree/main/markup-languages/#readme) /
+[API usage](https://github.com/adamlui/python-utils/tree/main/markup-languages/#usage) /
+[Discuss](https://github.com/adamlui/python-utils/discussions)
+
 ### <a href="https://github.com/adamlui/python-utils/tree/main/non-latin-locales/#readme">🇨🇳 non-latin-locales</a>
 
 > ISO 639-1 (2-letter) codes for non-Latin locales.

markup-languages/docs/LICENSE.md

@@ -0,0 +1,21 @@
+# 🏛️ MIT License
+
+**Copyright © 2026 [Adam Lui](https://github.com/adamlui)**
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

markup-languages/docs/README.md

@@ -0,0 +1,84 @@
+<a id="top"></a>
+
+# > markup-languages
+
+<a href="https://github.com/adamlui/python-utils/releases/tag/markup-languages-1.0.0">
+    <img height=31 src="https://img.shields.io/badge/Latest_Build-1.0.0-32fcee.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://github.com/adamlui/python-utils/blob/main/markup-languages/docs/LICENSE.md">
+    <img height=31 src="https://img.shields.io/badge/License-MIT-f99b27.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
+<a href="https://www.codefactor.io/repository/github/adamlui/python-utils">
+    <img height=31 src="https://img.shields.io/codefactor/grade/github/adamlui/python-utils?label=Code+Quality&logo=codefactor&logoColor=white&labelColor=464646&color=a0fc55&style=for-the-badge"></a>
+<a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_python-utils">
+    <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=sonarcloud&logoColor=white&labelColor=464646&label=Vulnerabilities&color=fafc74"></a>
+
+> ### _File extensions for markup languages._
+
+It's just a [JSON file](https://github.com/adamlui/python-utils/blob/markup-languages-1.0.0/markup-languages/src/markup_languages/markup_languages.json), so you can use it in any environment. Sourced from GitHub's [Linguist](https://github.com/github-linguist/linguist) project (defines all markdown languages known to GitHub). Data is updated via script and released via new package version.
+
+## Installation
+
+```bash
+pip install markup-languages
+```
+
+## Usage
+
+```py
+import markup_languages
+
+html_data = markup_languages['HTML']
+
+print(html_data['extensions']) # => ['.html', '.hta', '.htm', ...]
+```
+
+_Note: Most type checkers will falsely warn_ `markup_languages` _is not subscriptable because they are incapable of analyzing runtime behavior (where the module is replaced w/ a dictionary for cleaner, direct access). You can safely suppress such warnings using_ `# type: ignore`.
+
+## Examples
+
+List all extensions for a language:
+
+```py
+html_exts = markup_languages['HTML']['extensions']
+
+print(html_exts) # => ['.html', '.hta', '.htm', '.html.hl', ...]
+```
+
+Get language from an extension:
+
+```py
+def get_lang(file_ext):
+    for lang, data in markup_languages.items():
+        if file_ext in data['extensions']:
+            return lang
+
+print(get_lang('.sss')) # => 'SugarSS'
+```
+
+Get language from a file path:
+
+```py
+def get_lang_from_path(filepath):
+    from pathlib import Path
+    file_ext = Path(filepath).suffix
+    for lang, data in markup_languages.items():
+        if file_ext in data['extensions']:
+            return lang
+
+print(get_lang_from_path('index.html')) # => 'HTML'
+print(get_lang_from_path('style.css'))  # => 'CSS'
+print(get_lang_from_path('script.js'))  # => None (use programming-languages pkg)
+```
+
+## MIT License
+
+Copyright © 2026 [Adam Lui](https://github.com/adamlui).
+
+## Related
+
+🇨🇳 [non-latin-locales](https://github.com/adamlui/python-utils/tree/main/non-latin-locales/#readme) - ISO 639-1 (2-letter) codes for non-Latin locales.
+<br></> [programming-languages](https://github.com/adamlui/python-utils/tree/main/programming-languages/#readme) - File extensions for programming languages.
+<br>🏷️ [project-markers](https://github.com/adamlui/python-utils/tree/main/project-markers/#readme) - Common project root markers.
+
+#
+
+<a href="#top">Back to top ↑</a>

markup-languages/docs/SECURITY.md

@@ -0,0 +1,3 @@
+# 🛡️ Security Policy
+
+If you find a vulnerability, please e-mail security@tidelift.com and a fix will be coordinated within 2 business days.

markup-languages/noxfile.py

@@ -0,0 +1,60 @@
+from pathlib import Path
+from types import SimpleNamespace as sn
+
+import nox
+
+pkg = sn(dir=Path(__file__).parent.name)
+pkg.name = pkg.dir.replace('-', '_')
+paths = sn(
+    utils=sn(bump='utils/bump.py', clean='utils/clean.py', publish='utils/publish.sh', update='utils/update_langs.py'))
+
+def session(func) : return nox.session(venv_backend='none', name=func.__name__.replace('_', '-'))(func)
+
+# SESSIONS
+
+@session
+def dev(session) : session.run('pip', 'install', '-e', '.')
+
+@session
+def lint(session) : session.run('ruff', 'check', '.', *session.posargs)
+@session
+def lint_fix(session) : session.run('ruff', 'check', '.', '--fix', *session.posargs)
+
+@session
+def update(session, *args) : session.run('py', paths.utils.update, *args)
+
+@session
+def bump_patch(session, no_push=True):
+    cmd = ['py', paths.utils.bump, '--patch']
+    if no_push : cmd.append('--no-push')
+    session.run(*cmd, *session.posargs)
+@session
+def bump_minor(session, no_push=True):
+    cmd = ['py', paths.utils.bump, '--minor']
+    if no_push : cmd.append('--no-push')
+    session.run(*cmd, *session.posargs)
+@session
+def bump_feat(session, no_push=True):
+    bump_minor(session, no_push)
+@session
+def bump_major(session, no_push=True):
+    cmd = ['py', paths.utils.bump, '--major']
+    if no_push : cmd.append('--no-push')
+    session.run(*cmd, *session.posargs)
+
+@session
+def build(session) : clean(session) ; session.run('py', '-m', 'build') ; print('Build complete!')
+@session
+def publish(session) : session.run('bash', paths.utils.publish, *session.posargs)
+
+@session
+def deploy_patch(session) : bump_patch(session, no_push=False) ; build(session) ; publish(session)
+@session
+def deploy_minor(session) : bump_minor(session, no_push=False) ; build(session) ; publish(session)
+@session
+def deploy_feat(session) : deploy_minor(session)
+@session
+def deploy_major(session) : bump_major(session, no_push=False) ; build(session) ; publish(session)
+
+@session
+def clean(session, *args) : session.run('py', paths.utils.clean, *args)

markup-languages/pyproject.toml

@@ -0,0 +1,93 @@
+[build-system]
+requires = [
+    "setuptools~=82.0.0",
+    "wheel",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "markup-languages"
+version = "1.0.0"
+description = "File extensions for markup languages."
+authors = [
+    { name = "Adam Lui", email = "adam@kudoai.com" },
+]
+readme = "docs/README.md"
+license = "MIT"
+license-files = [
+    "docs/LICENSE.md",
+]
+requires-python = ">=2.6,<4"
+keywords = [
+    "computer-languages",
+    "css",
+    "extensions",
+    "file-extensions",
+    "file‑type-detection",
+    "filenames",
+    "github",
+    "html",
+    "language-detection",
+    "languages",
+    "linguist",
+    "markup-languages",
+    "syntax-highlighting",
+    "xml",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Intended Audience :: Information Technology",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: System Administrators",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 2",
+    "Programming Language :: Python :: 2.6",
+    "Programming Language :: Python :: 2.7",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Topic :: Education",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing",
+    "Topic :: Text Processing :: Markup",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Changelog = "https://github.com/adamlui/python-utils/releases/tag/markup-languages-1.0.0"
+Documentation = "https://github.com/adamlui/python-utils/tree/main/markup-languages/docs"
+Funding = "https://github.com/sponsors/adamlui"
+Homepage = "https://github.com/adamlui/python-utils/tree/main/markup-languages/#readme"
+Issues = "https://github.com/adamlui/python-utils/issues"
+"PyPI Stats" = "https://pepy.tech/projects/markup-languages"
+Releases = "https://github.com/adamlui/python-utils/releases"
+Repository = "https://github.com/adamlui/python-utils"
+
+[project.optional-dependencies]
+dev = [
+    "nox>=2026.2.9",
+    "tomli~=2.4.0",
+    "tomli-w~=1.2.0",
+]
+
+[tool.setuptools.packages.find]
+where = [
+    "src",
+]
+
+[tool.setuptools.package-data]
+markup_languages = [
+    "markup_languages.json",
+]

markup-languages/setup.cfg

@@ -0,0 +1,2 @@
+[bdist_wheel]
+universal = 1

markup-languages/src/markup_languages/__init__.py

@@ -0,0 +1,6 @@
+import json, os, sys
+
+with open(os.path.join(os.path.dirname(__file__), 'markup_languages.json')) as file:
+    markup_languages = json.load(file)
+
+sys.modules[__name__] = markup_languages

markup-languages/src/markup_languages/markup_languages.json

@@ -0,0 +1,83 @@
+{
+  "API Blueprint": { "extensions": [".apib"] },
+  "Antlers": { "extensions": [".antlers.html",".antlers.php",".antlers.xml"] },
+  "Astro": { "extensions": [".astro"] },
+  "BibTeX": { "extensions": [".bib",".bibtex"] },
+  "Bikeshed": { "extensions": [".bs"] },
+  "Blade": { "extensions": [".blade",".blade.php"] },
+  "Bru": { "extensions": [".bru"] },
+  "CSS": { "extensions": [".css"] },
+  "Closure Templates": { "extensions": [".soy"] },
+  "Cooklang": { "extensions": [".cook"] },
+  "D2": { "extensions": [".d2"] },
+  "EJS": { "extensions": [".ejs",".ect",".ejs.t",".jst"] },
+  "Ecmarkup": { "extensions": [".html"] },
+  "Edge": { "extensions": [".edge"] },
+  "Genero per": { "extensions": [".per"] },
+  "Go Template": { "extensions": [".gohtml",".gotmpl",".html.tmpl",".tmpl",".tpl"] },
+  "HTML": { "extensions": [".html",".hta",".htm",".html.hl",".inc",".xht",".xhtml"] },
+  "HTML+ECR": { "extensions": [".ecr"] },
+  "HTML+EEX": { "extensions": [".html.eex",".heex",".leex"] },
+  "HTML+ERB": { "extensions": [".erb",".erb.deface",".rhtml"] },
+  "HTML+PHP": { "extensions": [".phtml"] },
+  "HTML+Razor": { "extensions": [".cshtml",".razor"] },
+  "Haml": { "extensions": [".haml",".haml.deface"] },
+  "Handlebars": { "extensions": [".handlebars",".hbs"] },
+  "Jinja": { "extensions": [".jinja",".j2",".jinja2"] },
+  "Jupyter Notebook": { "extensions": [".ipynb"] },
+  "Kit": { "extensions": [".kit"] },
+  "Latte": { "extensions": [".latte"] },
+  "Less": { "extensions": [".less"] },
+  "Liquid": { "extensions": [".liquid"] },
+  "MDX": { "extensions": [".mdx"] },
+  "MTML": { "extensions": [".mtml"] },
+  "Marko": { "extensions": [".marko"] },
+  "Mask": { "extensions": [".mask"] },
+  "Mermaid": { "extensions": [".mmd",".mermaid"] },
+  "Mustache": { "extensions": [".mustache"] },
+  "Nunjucks": { "extensions": [".njk"] },
+  "Pic": { "extensions": [".pic",".chem"] },
+  "PostCSS": { "extensions": [".pcss",".postcss"] },
+  "PostScript": { "extensions": [".ps",".eps",".epsi",".pfa"] },
+  "Pug": { "extensions": [".jade",".pug"] },
+  "RAML": { "extensions": [".raml"] },
+  "RUNOFF": { "extensions": [".rnh",".rno"] },
+  "Rich Text Format": { "extensions": [".rtf"] },
+  "Riot": { "extensions": [".riot"] },
+  "Roff": {
+    "extensions": [
+      ".roff", ".1", ".1in", ".1m", ".1x", ".2", ".3", ".3in", ".3m", ".3p", ".3pm", ".3qt", ".3x", ".4", ".5", ".6",
+      ".7", ".8", ".9", ".l", ".man", ".mdoc", ".me", ".ms", ".n", ".nr", ".rno", ".tmac"
+    ]
+  },
+  "Roff Manpage": {
+    "extensions": [
+      ".1", ".1in", ".1m", ".1x", ".2", ".3", ".3in", ".3m", ".3p", ".3pm", ".3qt", ".3x", ".4", ".5", ".6", ".7", ".8",
+      ".9", ".man", ".mdoc"
+    ]
+  },
+  "SCSS": { "extensions": [".scss"] },
+  "SRecode Template": { "extensions": [".srt"] },
+  "Sass": { "extensions": [".sass"] },
+  "Scaml": { "extensions": [".scaml"] },
+  "Slim": { "extensions": [".slim"] },
+  "Slint": { "extensions": [".slint"] },
+  "StringTemplate": { "extensions": [".st"] },
+  "Stylus": { "extensions": [".styl"] },
+  "SugarSS": { "extensions": [".sss"] },
+  "Svelte": { "extensions": [".svelte"] },
+  "TeX": {
+    "extensions": [".tex",".aux",".bbx",".cbx",".cls",".dtx",".ins",".lbx",".ltx",".mkii",".mkiv",".mkvi",".sty",".toc"]
+  },
+  "Tea": { "extensions": [".tea"] },
+  "Terraform Template": { "extensions": [".tftpl"] },
+  "Twig": { "extensions": [".twig"] },
+  "Velocity Template Language": { "extensions": [".vtl"] },
+  "Vento": { "extensions": [".vto"] },
+  "Vim Snippet": { "extensions": [".snip",".snippet",".snippets"] },
+  "Vue": { "extensions": [".vue"] },
+  "YASnippet": { "extensions": [".yasnippet"] },
+  "kvlang": { "extensions": [".kv"] },
+  "mdsvex": { "extensions": [".svx"] },
+  "templ": { "extensions": [".templ"] }
+}