computer-languages 1.0.0__tar.gz

computer_languages-1.0.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: computer-languages
+Version: 1.0.0
+Summary: File extensions for computer languages.
+Author-email: Adam Lui <adam@kudoai.com>
+License-Expression: MIT
+Project-URL: Changelog, https://github.com/adamlui/python-utils/releases/tag/computer-languages-1.0.0
+Project-URL: Documentation, https://github.com/adamlui/python-utils/tree/main/computer-languages/docs
+Project-URL: Funding, https://github.com/sponsors/adamlui
+Project-URL: Homepage, https://github.com/adamlui/python-utils/tree/main/computer-languages/#readme
+Project-URL: Issues, https://github.com/adamlui/python-utils/issues
+Project-URL: PyPI Stats, https://pepy.tech/projects/computer-languages
+Project-URL: Releases, https://github.com/adamlui/python-utils/releases
+Project-URL: Repository, https://github.com/adamlui/python-utils
+Keywords: asciidoc,bash,c,c#,c++,code-languages,computer-languages,csv,dart,data-languages,extensions,file‑type-detection,file-extensions,filenames,github,go,html,java,javascript,json,kotlin,language-detection,languages,linguist,markdown,markup-languages,php,powershell,programming-languages,prose-languages,python,ruby,rust,shell,sql,swift,syntax-highlighting,toml,typescript,xml,yaml
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: System Administrators
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Database
+Classifier: Topic :: Documentation
+Classifier: Topic :: Education
+Classifier: Topic :: Internet
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Text Processing :: General
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Topic :: Text Processing :: Markup
+Classifier: Topic :: Utilities
+Requires-Python: <4,>=2.6
+Description-Content-Type: text/markdown
+License-File: docs/LICENSE.md
+Provides-Extra: dev
+Requires-Dist: nox>=2026.2.9; extra == "dev"
+Requires-Dist: tomli~=2.4.0; extra == "dev"
+Requires-Dist: tomli-w~=1.2.0; extra == "dev"
+Dynamic: license-file
+
+<a id="top"></a>
+
+# ⊕ computer-languages
+
+<a href="https://github.com/adamlui/python-utils/releases/tag/computer-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/computer-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 computer languages._
+
+It's just a [JSON file](https://github.com/adamlui/python-utils/blob/computer-languages-1.0.0/computer-languages/src/computer_languages/computer_languages.json), so you can use it in any environment. Sourced from GitHub's [Linguist](https://github.com/github-linguist/linguist) project (defines all 700+ languages known to GitHub). Data is updated via script and released via new package version.
+
+## Installation
+
+```bash
+pip install computer-languages
+```
+
+## Usage
+
+```py
+import computer_languages
+
+py_lang_data = computer_languages['Python']
+
+print(py_lang_data['type']) # => 'programming'
+print(py_lang_data['extensions']) # => ['.cgi', '.fcgi', '.gyp', ...]
+```
+
+_Note: Most type checkers will falsely warn_ `computer_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
+js_exts = computer_languages['JavaScript']['extensions']
+
+print(js_exts) # => ['._js', '.bones', '.cjs', '.es', ...]
+```
+
+Get language from an extension:
+
+```py
+def get_lang(file_ext):
+    for lang, data in computer_languages.items():
+        if file_ext in data['extensions']:
+            return lang
+
+print(get_lang('.rs')) # => 'Rust'
+```
+
+Filter by language type:
+
+```py
+markup_langs = [
+    lang for lang, data in computer_languages.items()
+        if data['type'] == 'markup'
+]
+
+print(markup_langs) # => ['Antlers', 'API Blueprint', 'Astro', 'BibTeX', ...]
+print(f'{len(markup_langs)} markup languages') # -> '69 markup languages'
+```
+
+## MIT License
+
+Copyright © 2026 [Adam Lui](https://github.com/adamlui).
+
+## Related
+
+</> [markup-languages](https://github.com/adamlui/python-utils/tree/main/markup-languages/#readme) - File extensions for markup languages.
+<br>## [prose-languages](https://github.com/adamlui/python-utils/tree/main/prose-languages/#readme) - File extensions for prose languages.
+<br>{ } [data-languages](https://github.com/adamlui/python-utils/tree/main/data-languages/#readme) - File extensions for data languages.
+<br>#! [programming-languages](https://github.com/adamlui/python-utils/tree/main/programming-languages/#readme) - File extensions for programming languages.
+
+#
+
+<a href="#top">Back to top ↑</a>

computer_languages-1.0.0/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.

computer_languages-1.0.0/docs/README.md

@@ -0,0 +1,83 @@
+<a id="top"></a>
+
+# ⊕ computer-languages
+
+<a href="https://github.com/adamlui/python-utils/releases/tag/computer-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/computer-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 computer languages._
+
+It's just a [JSON file](https://github.com/adamlui/python-utils/blob/computer-languages-1.0.0/computer-languages/src/computer_languages/computer_languages.json), so you can use it in any environment. Sourced from GitHub's [Linguist](https://github.com/github-linguist/linguist) project (defines all 700+ languages known to GitHub). Data is updated via script and released via new package version.
+
+## Installation
+
+```bash
+pip install computer-languages
+```
+
+## Usage
+
+```py
+import computer_languages
+
+py_lang_data = computer_languages['Python']
+
+print(py_lang_data['type']) # => 'programming'
+print(py_lang_data['extensions']) # => ['.cgi', '.fcgi', '.gyp', ...]
+```
+
+_Note: Most type checkers will falsely warn_ `computer_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
+js_exts = computer_languages['JavaScript']['extensions']
+
+print(js_exts) # => ['._js', '.bones', '.cjs', '.es', ...]
+```
+
+Get language from an extension:
+
+```py
+def get_lang(file_ext):
+    for lang, data in computer_languages.items():
+        if file_ext in data['extensions']:
+            return lang
+
+print(get_lang('.rs')) # => 'Rust'
+```
+
+Filter by language type:
+
+```py
+markup_langs = [
+    lang for lang, data in computer_languages.items()
+        if data['type'] == 'markup'
+]
+
+print(markup_langs) # => ['Antlers', 'API Blueprint', 'Astro', 'BibTeX', ...]
+print(f'{len(markup_langs)} markup languages') # -> '69 markup languages'
+```
+
+## MIT License
+
+Copyright © 2026 [Adam Lui](https://github.com/adamlui).
+
+## Related
+
+</> [markup-languages](https://github.com/adamlui/python-utils/tree/main/markup-languages/#readme) - File extensions for markup languages.
+<br>## [prose-languages](https://github.com/adamlui/python-utils/tree/main/prose-languages/#readme) - File extensions for prose languages.
+<br>{ } [data-languages](https://github.com/adamlui/python-utils/tree/main/data-languages/#readme) - File extensions for data languages.
+<br>#! [programming-languages](https://github.com/adamlui/python-utils/tree/main/programming-languages/#readme) - File extensions for programming languages.
+
+#
+
+<a href="#top">Back to top ↑</a>

computer_languages-1.0.0/pyproject.toml

@@ -0,0 +1,128 @@
+[build-system]
+requires = [
+    "setuptools~=82.0.0",
+    "wheel",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "computer-languages"
+version = "1.0.0"
+description = "File extensions for computer 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 = [
+    "asciidoc",
+    "bash",
+    "c",
+    "c#",
+    "c++",
+    "code-languages",
+    "computer-languages",
+    "csv",
+    "dart",
+    "data-languages",
+    "extensions",
+    "file‑type-detection",
+    "file-extensions",
+    "filenames",
+    "github",
+    "go",
+    "html",
+    "java",
+    "javascript",
+    "json",
+    "kotlin",
+    "language-detection",
+    "languages",
+    "linguist",
+    "markdown",
+    "markup-languages",
+    "php",
+    "powershell",
+    "programming-languages",
+    "prose-languages",
+    "python",
+    "ruby",
+    "rust",
+    "shell",
+    "sql",
+    "swift",
+    "syntax-highlighting",
+    "toml",
+    "typescript",
+    "xml",
+    "yaml",
+]
+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 :: Database",
+    "Topic :: Documentation",
+    "Topic :: Education",
+    "Topic :: Internet",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing",
+    "Topic :: Text Processing :: General",
+    "Topic :: Text Processing :: Linguistic",
+    "Topic :: Text Processing :: Markup",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Changelog = "https://github.com/adamlui/python-utils/releases/tag/computer-languages-1.0.0"
+Documentation = "https://github.com/adamlui/python-utils/tree/main/computer-languages/docs"
+Funding = "https://github.com/sponsors/adamlui"
+Homepage = "https://github.com/adamlui/python-utils/tree/main/computer-languages/#readme"
+Issues = "https://github.com/adamlui/python-utils/issues"
+"PyPI Stats" = "https://pepy.tech/projects/computer-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]
+computer_languages = [
+    "computer_languages.json",
+]

computer_languages-1.0.0/setup.cfg

@@ -0,0 +1,7 @@
+[bdist_wheel]
+universal = 1
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

computer_languages-1.0.0/src/computer_languages/__init__.py

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