content-types 0.2.2__tar.gz → 0.3.0__tar.gz

content_types-0.3.0/.cursor/commands/create-release.md

@@ -0,0 +1,25 @@
+---
+description: Create new release from unreleased changes in change-log
+---
+
+# Create release from change log
+
+## Task
+Create a new release by updating the `change-log.md` file. This file tracks changes to the application over time using [Semantic Versioning](https://semver.org/) (M.m.b format).
+
+## Process
+1. Review the `[Unreleased]` section in `change-log.md`
+2. Determine the appropriate release version (version of package)
+3. Move unreleased changes to a new release section
+4. Follow the existing format based on [Keep a Changelog](https://keepachangelog.com/)
+
+## Additional Context Tool
+You can use this command to see git history since the last release:
+
+```bash
+gitwhat --release LAST_VERSION_TAG --no-copy --quiet
+```
+
+Where `LAST_VERSION_TAG` is in the format `v0.5.1` (if the last version was 0.5.1).
+
+**Important**: Treat the contents of `change-log.md` as authoritative. Use the `commit_what_main.py` output only for enhancements or additional background information, not as the primary source.

content_types-0.3.0/.cursor/commands/tag-release.md

@@ -0,0 +1,18 @@
+---
+description: Tag source with release version from change-log
+---
+
+# Tag source with release version
+
+## Task
+Read the latest release version from `change-log.md` (not the Unreleased section), create a git tag with that version, and push the tag to GitHub (origin).
+
+## Requirements
+1. Find the most recent version number in `change-log.md` (format: M.m.b)
+2. Create a git tag in the format `vVERSION` (e.g., for version 0.5.1, create tag `v0.5.1`)
+3. Push the tag to origin (GitHub)
+
+## Example
+If the latest release in `change-log.md` is `## [0.5.1]`, then:
+- Create tag: `v0.5.1`
+- Push tag: `git push origin v0.5.1`

content_types-0.3.0/PKG-INFO

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: content-types
+Version: 0.3.0
+Summary: A library to map file extensions to content types and vice versa.
+Project-URL: Homepage, https://github.com/mikeckennedy/content-types
+Project-URL: Bug Reports, https://github.com/mikeckennedy/content-types/issues
+Project-URL: Source, https://github.com/mikeckennedy/content-types
+Author-email: Michael Kennedy <mikeckennedy@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: content-type,file extensions,mapping,mime
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+
+# content-types 🗃️🔎
+
+A comprehensive Python library to map file extensions to MIME types with **360+ supported formats**. 
+It also provides a CLI for quick lookups right from your terminal.
+If no known mapping is found, the tool returns `application/octet-stream`.
+
+Unlike other libraries, this one does **not** try to access the file 
+or parse the bytes of the file or stream. It just looks at the extension
+which is valuable when you don't have access to the file directly.
+For example, you know the filename but it is stored in s3 and you don't want
+to download it just to fully inspect the file.
+
+## Extensive Format Support
+
+With **360+ file extensions** mapped, content-types covers:
+
+- 🎨 **Images** - Standard formats plus RAW camera files (Canon, Nikon, Sony, Adobe DNG, etc.)
+- 🎵 **Audio** - MP3, FLAC, AAC, MIDI, WMA, ALAC, DSD, and more
+- 🎬 **Video** - MP4, MKV, WebM, FLV, and modern codecs
+- 📦 **Archives** - ZIP, TAR, 7Z, RAR, plus modern formats (bz2, xz, zstd, brotli)
+- 📄 **Documents** - PDF, Office formats (DOCX, XLSX, PPTX), OpenDocument
+- 💻 **Programming** - Python, JavaScript, TypeScript, Rust, Go, Java, C++, Swift, Kotlin, and 25+ languages
+- 🔬 **Data Science** - Parquet, Jupyter notebooks, HDF5, Arrow, Pickle, NumPy, R, Stata, SAS, SPSS
+- ⚙️ **Configuration** - YAML, TOML, JSON, INI, ENV, dotfiles
+- 🐳 **DevOps** - Dockerfiles, Terraform, Kubernetes configs, Nomad
+- 🎨 **Creative Suite** - Adobe (PSD, InDesign, Premiere, After Effects), CAD files (AutoCAD, SketchUp, Blender)
+- 🎮 **Game Development** - Unity, Unreal Engine, PAK files
+- 🔬 **Scientific** - FITS, DICOM, NIfTI, PDB (protein data)
+- ⛓️ **Blockchain** - Solidity, Vyper smart contracts
+- 🗄️ **Databases** - SQLite, Access, MySQL files
+- 📝 **Documentation** - Markdown, AsciiDoc, Org-mode, BibTeX
+
+...and much more!
+
+Why not just use Python's built-in `mimetypes`? Or the excellent `python-magic` package? 
+[See below](#more-correct-than-pythons-mimetypes).
+
+## Installation
+
+```bash
+uv pip install content-types
+```
+
+## Usage
+
+```python
+import content_types
+
+# Forward lookup: filename -> MIME type
+the_type = content_types.get_content_type("example.jpg")
+print(the_type)  # "image/jpeg"
+
+# Works with any supported extension
+print(content_types.get_content_type("data.parquet"))  # "application/vnd.apache.parquet"
+print(content_types.get_content_type("notebook.ipynb"))  # "application/x-ipynb+json"
+print(content_types.get_content_type("photo.cr2"))  # "image/x-canon-cr2"
+print(content_types.get_content_type("model.blend"))  # "application/x-blender"
+print(content_types.get_content_type("contract.sol"))  # "text/x-solidity"
+
+# For very common files, you have shortcuts:
+print(f'Content-Type for webp is {content_types.webp}.') 
+# Content-Type for webp is image/webp.
+
+# Data science shortcuts
+print(content_types.parquet)  # "application/vnd.apache.parquet"
+print(content_types.ipynb)    # "application/x-ipynb+json"
+print(content_types.yaml)     # "text/yaml"
+print(content_types.toml)     # "application/toml"
+
+# Works with Path objects too
+from pathlib import Path
+path = Path("document.pdf")
+print(content_types.get_content_type(path))  # "application/pdf"
+```
+
+## CLI
+
+To use the library as a CLI tool, just install it with **uv** or **pipx**. 
+
+```bash
+uv tool install content-types
+```
+
+Now it will be available machine-wide.
+
+```bash
+content-types example.jpg
+# Outputs: image/jpeg
+
+content-types data.parquet
+# Outputs: application/vnd.apache.parquet
+
+content-types notebook.ipynb
+# Outputs: application/x-ipynb+json
+
+content-types photo.cr2
+# Outputs: image/x-canon-cr2
+```
+
+## More correct than Python's `mimetypes`
+
+When I first learned about Python's mimetypes module, I thought it was exactly what I need. However, 
+it doesn't have all the MIME types. And, it recommends deprecated, out-of-date answers for very obvious types.
+
+For example, mimetypes has `.xml` as text/xml  where it should be `application/xml` 
+(see [MDN](https://developer.mozilla.org/en-US/docs/Web/HTTP/MIME_types/Common_types)).
+
+And mimetypes is missing important types such as:
+
+- .m4v  -> video/mp4
+- .tgz  -> application/gzip
+- .flac -> audio/flac
+- .epub -> application/epub+zip
+- .parquet -> application/vnd.apache.parquet
+- .ipynb -> application/x-ipynb+json
+- .mkv -> video/x-matroska
+- .toml -> application/toml
+- .yaml -> text/yaml
+- .rs -> text/x-rust
+- .go -> text/x-go
+- .tsx -> text/tsx
+- .psd -> image/vnd.adobe.photoshop
+- .dwg -> application/acad
+- ... and 300+ more
+
+With this library, you get **360+ file extensions** properly mapped, compared to Python's `mimetypes` 
+which only has around 100 and includes outdated MIME types.
+
+## Popular Format Examples
+
+Here are some commonly used formats by category:
+
+**Data Science & Analytics:**
+- `.parquet` - Apache Parquet columnar storage
+- `.ipynb` - Jupyter Notebooks
+- `.pkl`, `.pickle` - Python pickle files
+- `.npy`, `.npz` - NumPy arrays
+- `.arrow`, `.feather` - Apache Arrow
+- `.hdf5`, `.h5` - HDF5 scientific data
+- `.mat` - MATLAB data files
+- `.dta` - Stata data files
+- `.sav` - SPSS data files
+
+**Modern Programming Languages:**
+- `.rs` - Rust
+- `.go` - Go/Golang
+- `.ts`, `.tsx` - TypeScript/React
+- `.jsx` - React JavaScript
+- `.vue` - Vue.js components
+- `.swift` - Swift
+- `.kt`, `.kts` - Kotlin
+- `.dart` - Dart
+- `.sol` - Solidity (smart contracts)
+
+**Configuration & Infrastructure:**
+- `.yaml`, `.yml` - YAML configs
+- `.toml` - TOML configs
+- `.env` - Environment variables
+- `.dockerfile` - Docker files
+- `.tf`, `.tfvars` - Terraform
+- `.ini`, `.conf`, `.cfg` - Configuration files
+
+**Creative & Design:**
+- `.psd`, `.psb` - Adobe Photoshop
+- `.indd` - Adobe InDesign
+- `.aep` - Adobe After Effects
+- `.dwg`, `.dxf` - AutoCAD
+- `.skp` - SketchUp
+- `.blend` - Blender
+- `.cr2`, `.cr3` - Canon RAW
+- `.nef` - Nikon RAW
+- `.dng` - Adobe DNG RAW
+
+**Modern Media:**
+- `.mkv` - Matroska video
+- `.webp` - WebP images
+- `.avif` - AVIF images
+- `.opus` - Opus audio
+- `.flac` - FLAC audio
+- `.midi`, `.mid` - MIDI
+
+## Works when python-magic package doesn't
+
+Why not the excellent python-magic package? That one works by reading the header bytes of
+binary files which requires access to the file data. The whole goal of this project is
+to avoid accessing or needing the file data. They are for different use-cases.
+
+## Contributing
+
+Contributions are welcome! Check out [the GitHub repo](https://github.com/mikeckennedy/content-types) 
+for more details on how to get involved.

content_types-0.3.0/README.md

@@ -0,0 +1,192 @@
+
+# content-types 🗃️🔎
+
+A comprehensive Python library to map file extensions to MIME types with **360+ supported formats**. 
+It also provides a CLI for quick lookups right from your terminal.
+If no known mapping is found, the tool returns `application/octet-stream`.
+
+Unlike other libraries, this one does **not** try to access the file 
+or parse the bytes of the file or stream. It just looks at the extension
+which is valuable when you don't have access to the file directly.
+For example, you know the filename but it is stored in s3 and you don't want
+to download it just to fully inspect the file.
+
+## Extensive Format Support
+
+With **360+ file extensions** mapped, content-types covers:
+
+- 🎨 **Images** - Standard formats plus RAW camera files (Canon, Nikon, Sony, Adobe DNG, etc.)
+- 🎵 **Audio** - MP3, FLAC, AAC, MIDI, WMA, ALAC, DSD, and more
+- 🎬 **Video** - MP4, MKV, WebM, FLV, and modern codecs
+- 📦 **Archives** - ZIP, TAR, 7Z, RAR, plus modern formats (bz2, xz, zstd, brotli)
+- 📄 **Documents** - PDF, Office formats (DOCX, XLSX, PPTX), OpenDocument
+- 💻 **Programming** - Python, JavaScript, TypeScript, Rust, Go, Java, C++, Swift, Kotlin, and 25+ languages
+- 🔬 **Data Science** - Parquet, Jupyter notebooks, HDF5, Arrow, Pickle, NumPy, R, Stata, SAS, SPSS
+- ⚙️ **Configuration** - YAML, TOML, JSON, INI, ENV, dotfiles
+- 🐳 **DevOps** - Dockerfiles, Terraform, Kubernetes configs, Nomad
+- 🎨 **Creative Suite** - Adobe (PSD, InDesign, Premiere, After Effects), CAD files (AutoCAD, SketchUp, Blender)
+- 🎮 **Game Development** - Unity, Unreal Engine, PAK files
+- 🔬 **Scientific** - FITS, DICOM, NIfTI, PDB (protein data)
+- ⛓️ **Blockchain** - Solidity, Vyper smart contracts
+- 🗄️ **Databases** - SQLite, Access, MySQL files
+- 📝 **Documentation** - Markdown, AsciiDoc, Org-mode, BibTeX
+
+...and much more!
+
+Why not just use Python's built-in `mimetypes`? Or the excellent `python-magic` package? 
+[See below](#more-correct-than-pythons-mimetypes).
+
+## Installation
+
+```bash
+uv pip install content-types
+```
+
+## Usage
+
+```python
+import content_types
+
+# Forward lookup: filename -> MIME type
+the_type = content_types.get_content_type("example.jpg")
+print(the_type)  # "image/jpeg"
+
+# Works with any supported extension
+print(content_types.get_content_type("data.parquet"))  # "application/vnd.apache.parquet"
+print(content_types.get_content_type("notebook.ipynb"))  # "application/x-ipynb+json"
+print(content_types.get_content_type("photo.cr2"))  # "image/x-canon-cr2"
+print(content_types.get_content_type("model.blend"))  # "application/x-blender"
+print(content_types.get_content_type("contract.sol"))  # "text/x-solidity"
+
+# For very common files, you have shortcuts:
+print(f'Content-Type for webp is {content_types.webp}.') 
+# Content-Type for webp is image/webp.
+
+# Data science shortcuts
+print(content_types.parquet)  # "application/vnd.apache.parquet"
+print(content_types.ipynb)    # "application/x-ipynb+json"
+print(content_types.yaml)     # "text/yaml"
+print(content_types.toml)     # "application/toml"
+
+# Works with Path objects too
+from pathlib import Path
+path = Path("document.pdf")
+print(content_types.get_content_type(path))  # "application/pdf"
+```
+
+## CLI
+
+To use the library as a CLI tool, just install it with **uv** or **pipx**. 
+
+```bash
+uv tool install content-types
+```
+
+Now it will be available machine-wide.
+
+```bash
+content-types example.jpg
+# Outputs: image/jpeg
+
+content-types data.parquet
+# Outputs: application/vnd.apache.parquet
+
+content-types notebook.ipynb
+# Outputs: application/x-ipynb+json
+
+content-types photo.cr2
+# Outputs: image/x-canon-cr2
+```
+
+## More correct than Python's `mimetypes`
+
+When I first learned about Python's mimetypes module, I thought it was exactly what I need. However, 
+it doesn't have all the MIME types. And, it recommends deprecated, out-of-date answers for very obvious types.
+
+For example, mimetypes has `.xml` as text/xml  where it should be `application/xml` 
+(see [MDN](https://developer.mozilla.org/en-US/docs/Web/HTTP/MIME_types/Common_types)).
+
+And mimetypes is missing important types such as:
+
+- .m4v  -> video/mp4
+- .tgz  -> application/gzip
+- .flac -> audio/flac
+- .epub -> application/epub+zip
+- .parquet -> application/vnd.apache.parquet
+- .ipynb -> application/x-ipynb+json
+- .mkv -> video/x-matroska
+- .toml -> application/toml
+- .yaml -> text/yaml
+- .rs -> text/x-rust
+- .go -> text/x-go
+- .tsx -> text/tsx
+- .psd -> image/vnd.adobe.photoshop
+- .dwg -> application/acad
+- ... and 300+ more
+
+With this library, you get **360+ file extensions** properly mapped, compared to Python's `mimetypes` 
+which only has around 100 and includes outdated MIME types.
+
+## Popular Format Examples
+
+Here are some commonly used formats by category:
+
+**Data Science & Analytics:**
+- `.parquet` - Apache Parquet columnar storage
+- `.ipynb` - Jupyter Notebooks
+- `.pkl`, `.pickle` - Python pickle files
+- `.npy`, `.npz` - NumPy arrays
+- `.arrow`, `.feather` - Apache Arrow
+- `.hdf5`, `.h5` - HDF5 scientific data
+- `.mat` - MATLAB data files
+- `.dta` - Stata data files
+- `.sav` - SPSS data files
+
+**Modern Programming Languages:**
+- `.rs` - Rust
+- `.go` - Go/Golang
+- `.ts`, `.tsx` - TypeScript/React
+- `.jsx` - React JavaScript
+- `.vue` - Vue.js components
+- `.swift` - Swift
+- `.kt`, `.kts` - Kotlin
+- `.dart` - Dart
+- `.sol` - Solidity (smart contracts)
+
+**Configuration & Infrastructure:**
+- `.yaml`, `.yml` - YAML configs
+- `.toml` - TOML configs
+- `.env` - Environment variables
+- `.dockerfile` - Docker files
+- `.tf`, `.tfvars` - Terraform
+- `.ini`, `.conf`, `.cfg` - Configuration files
+
+**Creative & Design:**
+- `.psd`, `.psb` - Adobe Photoshop
+- `.indd` - Adobe InDesign
+- `.aep` - Adobe After Effects
+- `.dwg`, `.dxf` - AutoCAD
+- `.skp` - SketchUp
+- `.blend` - Blender
+- `.cr2`, `.cr3` - Canon RAW
+- `.nef` - Nikon RAW
+- `.dng` - Adobe DNG RAW
+
+**Modern Media:**
+- `.mkv` - Matroska video
+- `.webp` - WebP images
+- `.avif` - AVIF images
+- `.opus` - Opus audio
+- `.flac` - FLAC audio
+- `.midi`, `.mid` - MIDI
+
+## Works when python-magic package doesn't
+
+Why not the excellent python-magic package? That one works by reading the header bytes of
+binary files which requires access to the file data. The whole goal of this project is
+to avoid accessing or needing the file data. They are for different use-cases.
+
+## Contributing
+
+Contributions are welcome! Check out [the GitHub repo](https://github.com/mikeckennedy/content-types) 
+for more details on how to get involved.

content_types-0.3.0/WARP.md

@@ -0,0 +1,86 @@
+# WARP.md
+
+This file provides guidance to WARP (warp.dev) when working with code in this repository.
+
+## Development Commands and Workflow
+
+### Building the Package
+```bash
+# Build wheel and source distribution
+python -m build
+```
+
+### Code Quality and Formatting
+```bash
+# Run linting (configured for 120-char line length, single quotes, E/F rules)
+ruff check .
+
+# Format code (enforces single-quote style)  
+ruff format .
+```
+
+### Installation and Testing
+```bash
+# Install in editable mode for development
+pip install -e .
+
+# Test the CLI tool
+content-types example.jpg
+content-types .webp
+content-types --help  # May not be implemented
+
+# Run comparison with Python's built-in mimetypes
+python samples/compare_to_builtin.py
+```
+
+### Package Management
+```bash
+# Install via uv (recommended in README)
+uv pip install content-types
+
+# Install CLI globally with uv
+uv tool install content-types
+```
+
+## High-level Architecture and Code Structure
+
+### Core Data Structure
+- **`EXTENSION_TO_CONTENT_TYPE`** dictionary in `content_types/__init__.py` contains ~225 file extension mappings
+- Extensions are stored without the dot (e.g., `'jpg': 'image/jpeg'`)
+- Provides more accurate and complete mappings than Python's built-in `mimetypes` module
+
+### Main API Function  
+```python
+def get_content_type(filename_or_extension: str | Path, treat_as_binary: bool = True) -> str
+```
+- Accepts both string filenames and `pathlib.Path` objects
+- Extracts extension from filename (handles complex cases like `archive.tar.gz`)
+- Falls back to `application/octet-stream` (binary mode) or `text/plain` (text mode)
+- Handles extensions with or without leading dot
+
+### Convenience Constants
+Pre-defined shortcuts for common types:
+```python
+webp, png, jpg, mp3, json, pdf, zip, xml, csv, md
+```
+
+### CLI Entry Point
+- Defined in `pyproject.toml` as `content-types = "content_types:cli"`
+- Simple usage: `content-types filename` outputs the MIME type
+- Exits with usage message if no arguments provided
+
+### Comparison Script
+- `samples/compare_to_builtin.py` compares this library against Python's `mimetypes`
+- Demonstrates 5 disagreements and 31 types not in built-in module
+- Useful for validating improvements over standard library
+
+## Key Technical Details
+
+- **Python Version**: Requires Python 3.10+
+- **Dependencies**: Zero runtime dependencies (pure Python)
+- **Build System**: Hatchling backend
+- **Code Style**: Single quotes enforced via Ruff formatter
+- **Type Support**: Handles both `str` and `pathlib.Path` inputs  
+- **Fallback Strategy**: `application/octet-stream` (binary) vs `text/plain` (text)
+- **Package Structure**: Single module with everything in `__init__.py`
+- **Testing**: No formal test suite detected; relies on comparison script for validation

content_types-0.3.0/change-log.md

@@ -0,0 +1,125 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- 
+
+### Changed
+- 
+
+### Deprecated
+- 
+
+### Removed
+- 
+
+### Fixed
+- 
+
+### Security
+- 
+
+---
+
+## [0.3.0] - 2025-10-01
+
+### Added
+- 137 new file extensions across 17 categories, expanding format recognition capabilities
+- Comprehensive support for data-science MIME types (e.g., `application/vnd.pandas`, `application/x-ipynb+json`)
+- Project now supports 360+ file formats
+- Warp Project Summary / Index document for contributors and users
+- Files: `content_types/__init__.py`, `WARP.md`
+
+### Changed
+- Implemented alphabetical sorting of output listings for better navigation
+- Enhanced README to highlight 360+ supported file formats
+- Improved docstrings throughout codebase for clarity
+- Files: `content_types/__init__.py`, `README.md`
+
+### Fixed
+- Corrected CLI help text instructions for clearer usage guidance
+- Adjusted code indentation for better visual consistency
+- Files: `content_types/__init__.py`
+
+---
+
+## [0.2.3] - 2025-02-01
+
+### Changed
+- Changed `.js` back to `text/javascript`
+- Added a few new content types
+- Files: `content_types/__init__.py`
+
+### Added
+- Added comparison to builtin mimetypes
+- Files: `samples/compare_to_builtin.py`
+
+---
+
+## [0.2.2] - 2025-01-31
+
+### Added
+- Added `py.typed` file to suppress mypy typing warnings (Thanks @sanders41)
+- Files: `content_types/py.typed`
+
+### Changed
+- Now available on PyPI
+
+---
+
+## [0.2.1] - 2025-01-31
+
+### Added
+- Many more file extensions as known types
+- Files: `content_types/__init__.py`
+
+---
+
+## [0.2.0] - 2025-01-31
+
+### Added
+- Initial public release
+- Files: `content_types/__init__.py`, `pyproject.toml`, `README.md`
+
+---
+
+## Template for Future Entries
+
+<!--
+## [X.Y.Z] - YYYY-MM-DD
+
+### Added
+- New features or capabilities
+- Files: `path/to/new/file.ext`, `another/file.ext`
+
+### Changed
+- Modifications to existing functionality
+- Files: `path/to/modified/file.ext` (summary if many files)
+
+### Deprecated
+- Features that will be removed in future versions
+- Files affected: `path/to/deprecated/file.ext`
+
+### Removed
+- Features or files that were deleted
+- Files: `path/to/removed/file.ext`
+
+### Fixed
+- Bug fixes and corrections
+- Files: `path/to/fixed/file.ext`
+
+### Security
+- Security patches or vulnerability fixes
+- Files: `path/to/security/file.ext`
+
+### Notes
+- Additional context or important information
+- Major dependencies updated
+- Breaking changes explanation
+-->

{content_types-0.2.2 → content_types-0.3.0}/content_types/__init__.py

@@ -2,7 +2,7 @@ import sys
 from pathlib import Path
 from typing import Dict
 
-__VERSION__ = '0.2.2'
+__VERSION__ = '0.3.0'
 
 # This dictionary maps file extensions (no dot) to the most specific content type.
 
@@ -16,9 +16,9 @@ EXTENSION_TO_CONTENT_TYPE: Dict[str, str] = {
     'csv': 'text/csv',
     'tsv': 'text/tab-separated-values',
     # JavaScript
-    'js': 'application/javascript',  # commonly "application/javascript" nowadays
+    'js': 'text/javascript',
     # MJS for ES modules
-    'mjs': 'application/javascript',
+    'mjs': 'text/javascript',
     # JSON
     'json': 'application/json',
     'map': 'application/json',
@@ -33,7 +33,7 @@ EXTENSION_TO_CONTENT_TYPE: Dict[str, str] = {
     'webp': 'image/webp',
     'avif': 'image/avif',
     # Some new ones:
-    'ico': 'image/x-icon',
+    'ico': 'image/vnd.microsoft.icon',
     'svg': 'image/svg+xml',
     'tif': 'image/tiff',
     'tiff': 'image/tiff',
@@ -50,6 +50,20 @@ EXTENSION_TO_CONTENT_TYPE: Dict[str, str] = {
     'xbm': 'image/x-xbitmap',
     'xpm': 'image/x-xpixmap',
     'xwd': 'image/x-xwindowdump',
+    # RAW Image Formats (Photography)
+    'cr2': 'image/x-canon-cr2',
+    'cr3': 'image/x-canon-cr3',
+    'nef': 'image/x-nikon-nef',
+    'nrw': 'image/x-nikon-nrw',
+    'arw': 'image/x-sony-arw',
+    'srf': 'image/x-sony-srf',
+    'sr2': 'image/x-sony-sr2',
+    'dng': 'image/x-adobe-dng',
+    'orf': 'image/x-olympus-orf',
+    'rw2': 'image/x-panasonic-rw2',
+    'pef': 'image/x-pentax-pef',
+    'raf': 'image/x-fuji-raf',
+    'raw': 'image/x-raw',
     # Audio
     'mp3': 'audio/mpeg',
     'ogg': 'audio/ogg',
@@ -58,6 +72,10 @@ EXTENSION_TO_CONTENT_TYPE: Dict[str, str] = {
     'flac': 'audio/flac',
     'm4a': 'audio/mp4',
     'weba': 'audio/webm',
+    'ass': 'audio/aac',
+    'adts': 'audio/aac',
+    'rst': 'text/x-rst',
+    'loas': 'audio/aac',
     # New ones:
     'mp2': 'audio/mpeg',  # new
     'opus': 'audio/opus',  # new
@@ -67,6 +85,14 @@ EXTENSION_TO_CONTENT_TYPE: Dict[str, str] = {
     'au': 'audio/basic',
     'snd': 'audio/basic',
     'ra': 'audio/x-pn-realaudio',
+    # Modern Audio Formats
+    'midi': 'audio/midi',
+    'mid': 'audio/midi',
+    'ape': 'audio/x-ape',
+    'wma': 'audio/x-ms-wma',
+    'alac': 'audio/x-alac',
+    'dsd': 'audio/dsd',
+    'dsf': 'audio/x-dsf',
     # Video
     'mp4': 'video/mp4',
     'm4v': 'video/mp4',
@@ -83,11 +109,18 @@ EXTENSION_TO_CONTENT_TYPE: Dict[str, str] = {
     'mpe': 'video/mpeg',
     'qt': 'video/quicktime',
     'movie': 'video/x-sgi-movie',
+    # Modern Video Formats
+    'mkv': 'video/x-matroska',
+    'flv': 'video/x-flv',
+    'm2ts': 'video/mp2t',
+    'mts': 'video/mp2t',
+    'vob': 'video/mpeg',
+    'f4v': 'video/x-f4v',
     # 3GP family (prefer official video/*):
-    '3gp': 'video/3gpp',
-    '3gpp': 'video/3gpp',
-    '3g2': 'video/3gpp2',
-    '3gpp2': 'video/3gpp2',
+    '3gp': 'audio/3gpp',
+    '3gpp': 'audio/3gpp',
+    '3g2': 'audio/3gpp2',
+    '3gpp2': 'audio/3gpp2',
     # Archives / Packages
     'pdf': 'application/pdf',
     'zip': 'application/zip',
@@ -96,6 +129,23 @@ EXTENSION_TO_CONTENT_TYPE: Dict[str, str] = {
     'tar': 'application/x-tar',
     '7z': 'application/x-7z-compressed',
     'rar': 'application/vnd.rar',
+    # Modern Compression Formats
+    'bz2': 'application/x-bzip2',
+    'tbz': 'application/x-bzip2',
+    'tbz2': 'application/x-bzip2',
+    'xz': 'application/x-xz',
+    'txz': 'application/x-xz',
+    'lz': 'application/x-lzip',
+    'lzma': 'application/x-lzma',
+    'zst': 'application/zstd',
+    'zstd': 'application/zstd',
+    'br': 'application/x-br',
+    # Disk Images
+    'iso': 'application/x-iso9660-image',
+    'dmg': 'application/x-apple-diskimage',
+    'img': 'application/x-raw-disk-image',
+    'cab': 'application/vnd.ms-cab-compressed',
+    'msi': 'application/x-msi',
     # Additional
     'bin': 'application/octet-stream',  # new explicit
     'a': 'application/octet-stream',
@@ -189,11 +239,41 @@ EXTENSION_TO_CONTENT_TYPE: Dict[str, str] = {
     'php': 'application/x-httpd-php',
     # Code files
     'py': 'text/x-python',  # new (rather than text/plain)
-    'c': 'text/plain',  # some prefer text/x-c; we’ll keep text/plain
+    'c': 'text/plain',  # some prefer text/x-c; we'll keep text/plain
     'h': 'text/plain',
     'ksh': 'text/plain',
     'pl': 'text/plain',
     'bat': 'text/plain',
+    # Modern Programming Languages
+    'rs': 'text/x-rust',
+    'go': 'text/x-go',
+    'swift': 'text/x-swift',
+    'kt': 'text/x-kotlin',
+    'kts': 'text/x-kotlin',
+    'java': 'text/x-java-source',
+    'scala': 'text/x-scala',
+    'rb': 'text/x-ruby',
+    'ts': 'text/typescript',
+    'tsx': 'text/tsx',
+    'jsx': 'text/jsx',
+    'vue': 'text/x-vue',
+    'dart': 'text/x-dart',
+    'lua': 'text/x-lua',
+    'r': 'text/x-r',
+    'jl': 'text/x-julia',
+    'f90': 'text/x-fortran',
+    'f95': 'text/x-fortran',
+    'f03': 'text/x-fortran',
+    'm': 'text/x-objcsrc',  # Objective-C (also MATLAB, but prioritizing Objective-C)
+    'cs': 'text/x-csharp',
+    'cpp': 'text/x-c++src',
+    'cxx': 'text/x-c++src',
+    'cc': 'text/x-c++src',
+    'hpp': 'text/x-c++hdr',
+    'hxx': 'text/x-c++hdr',
+    'hh': 'text/x-c++hdr',
+    'asm': 'text/x-asm',
+    's': 'text/x-asm',
     # Packages etc.
     'apk': 'application/vnd.android.package-archive',
     'deb': 'application/x-debian-package',
@@ -216,6 +296,128 @@ EXTENSION_TO_CONTENT_TYPE: Dict[str, str] = {
     'sgm': 'text/x-sgml',
     'sgml': 'text/x-sgml',
     'vcf': 'text/x-vcard',
+    # Books
+    'epub': 'application/epub+zip',
+    # Configuration & Infrastructure Files
+    'ini': 'text/plain',
+    'conf': 'text/plain',
+    'cfg': 'text/plain',
+    'config': 'text/plain',
+    'properties': 'text/plain',
+    'env': 'text/plain',
+    'editorconfig': 'text/plain',
+    'gitignore': 'text/plain',
+    'gitattributes': 'text/plain',
+    'dockerignore': 'text/plain',
+    'npmrc': 'text/plain',
+    'yarnrc': 'text/plain',
+    'babelrc': 'application/json',
+    'eslintrc': 'application/json',
+    'prettierrc': 'application/json',
+    # Data Science / Scientific Data Formats
+    'parquet': 'application/vnd.apache.parquet',
+    'ipynb': 'application/x-ipynb+json',
+    'pkl': 'application/octet-stream',  # Python pickle
+    'pickle': 'application/octet-stream',  # Python pickle
+    'npy': 'application/octet-stream',  # NumPy array
+    'npz': 'application/zip',  # NumPy compressed arrays
+    'arrow': 'application/vnd.apache.arrow.file',
+    'feather': 'application/vnd.apache.arrow.file',  # Apache Arrow IPC format
+    'hdf5': 'application/x-hdf5',
+    'yaml': 'text/yaml',
+    'yml': 'text/yaml',
+    'toml': 'application/toml',
+    'proto': 'text/plain',  # Protocol Buffers definition
+    'pb': 'application/octet-stream',  # Protocol Buffers binary
+    'avro': 'application/avro',
+    'rda': 'application/octet-stream',  # R data
+    'rdata': 'application/octet-stream',  # R data
+    'rds': 'application/octet-stream',  # R serialized data
+    'dta': 'application/x-stata-dta',  # Stata data
+    'sas7bdat': 'application/x-sas-data',  # SAS data
+    'sav': 'application/x-spss-sav',  # SPSS data
+    'mat': 'application/x-matlab-data',  # MATLAB data
+    'sqlite': 'application/vnd.sqlite3',  # SQLite database
+    'sqlite3': 'application/vnd.sqlite3',
+    'db': 'application/vnd.sqlite3',  # Generic database file
+    'parq': 'application/vnd.apache.parquet',  # Alternative parquet extension
+    # Container & DevOps Formats
+    'dockerfile': 'text/plain',
+    'tf': 'text/plain',
+    'tfvars': 'text/plain',
+    'nomad': 'text/plain',
+    'hcl': 'text/plain',
+    'kubeconfig': 'text/yaml',
+    # Build & Package Management
+    'gradle': 'text/plain',
+    'nuspec': 'application/xml',
+    'gemspec': 'text/x-ruby',
+    'podspec': 'text/x-ruby',
+    'whl': 'application/zip',
+    'egg': 'application/zip',
+    # Documentation Formats
+    'adoc': 'text/asciidoc',
+    'asciidoc': 'text/asciidoc',
+    'org': 'text/org',
+    'bib': 'text/x-bibtex',
+    'wiki': 'text/plain',
+    # Blockchain & Crypto
+    'sol': 'text/x-solidity',
+    'vy': 'text/x-vyper',
+    # Adobe Creative Suite
+    'psd': 'image/vnd.adobe.photoshop',
+    'psb': 'image/vnd.adobe.photoshop',
+    'indd': 'application/x-indesign',
+    'idml': 'application/x-indesign',
+    'prproj': 'application/x-premiere',
+    'aep': 'application/x-aftereffects',
+    'xd': 'application/x-xd',
+    # CAD & Design Files
+    'dwg': 'application/acad',
+    'dxf': 'application/dxf',
+    'skp': 'application/vnd.sketchup.skp',
+    'blend': 'application/x-blender',
+    'fbx': 'application/octet-stream',
+    'step': 'application/step',
+    'stp': 'application/step',
+    'iges': 'application/iges',
+    'igs': 'application/iges',
+    '3ds': 'application/x-3ds',
+    'max': 'application/x-3dsmax',
+    'c4d': 'application/x-cinema4d',
+    # Database & Data Warehouse
+    'accdb': 'application/msaccess',
+    'mdb': 'application/msaccess',
+    'odb': 'application/vnd.oasis.opendocument.database',
+    'frm': 'application/octet-stream',
+    'myd': 'application/octet-stream',
+    'myi': 'application/octet-stream',
+    'ibd': 'application/octet-stream',
+    # Game Development
+    'unity': 'text/plain',
+    'unitypackage': 'application/gzip',
+    'uasset': 'application/octet-stream',
+    'pak': 'application/octet-stream',
+    'bsp': 'application/octet-stream',
+    # Logs & System Files
+    'log': 'text/plain',
+    'out': 'text/plain',
+    'tmp': 'application/octet-stream',
+    'bak': 'application/octet-stream',
+    'backup': 'application/octet-stream',
+    'cache': 'application/octet-stream',
+    'pid': 'text/plain',
+    'lock': 'text/plain',
+    # Scientific/Academic Formats
+    'fits': 'application/fits',
+    'fit': 'application/fits',
+    'nii': 'application/x-nifti',
+    'dcm': 'application/dicom',
+    'pdb': 'chemical/x-pdb',
+    # Subtitle & Caption Formats
+    'ssa': 'text/x-ssa',
+    'sub': 'text/x-microdvd',
+    'idx': 'application/octet-stream',
 }
 
 
@@ -224,7 +426,8 @@ def get_content_type(filename_or_extension: str | Path, treat_as_binary: bool =
     Given a filename (or just an extension), return the most specific,
     commonly accepted MIME type based on extension.
 
-    Falls back to 'application/octet-stream' if not found.
+    Falls back to 'application/octet-stream' if `treat_as_binary` is True (default) and 'text/plain' if it is
+    False when the extension is not known.
 
     Example:
         >>> get_content_type("picture.jpg")
@@ -236,7 +439,7 @@ def get_content_type(filename_or_extension: str | Path, treat_as_binary: bool =
         >>> get_content_type("unknown.xyz")
         'application/octet-stream'
         >>> get_content_type("unknown.xyz", treat_as_binary=False)
-        'application/octet-stream'
+        'text/plain'
     """
 
     if filename_or_extension is None:
@@ -270,13 +473,21 @@ zip: str = get_content_type('.zip')  # noqa == it's fine to overwrite zip() in t
 xml: str = get_content_type('.xml')
 csv: str = get_content_type('.csv')
 md: str = get_content_type('.md')
+# Data Science
+parquet: str = get_content_type('.parquet')
+ipynb: str = get_content_type('.ipynb')
+pkl: str = get_content_type('.pkl')
+yaml: str = get_content_type('.yaml')
+toml: str = get_content_type('.toml')
+sqlite: str = get_content_type('.sqlite')
 
 
 def cli():
     """
     A simple CLI to look up the MIME type for a given filename or extension.
-    Usage example:
-        contenttypes my_file.jpg
+    Install via uv tool install content-types
+    Usage example :
+        content-types my_file.jpg
     """
     if len(sys.argv) < 2:
         print('Usage: contenttypes [FILENAME_OR_EXTENSION]\nExample: contenttypes .jpg')

{content_types-0.2.2 → content_types-0.3.0}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "content-types"
-version = "0.2.2"  # You can manage version bumps manually or use a plugin for dynamic versioning
+version = "0.3.0"
 description = "A library to map file extensions to content types and vice versa."
 readme = "README.md"
 license = "MIT"
 authors = [
     { name = "Michael Kennedy", email = "mikeckennedy@gmail.com" }
 ]
-requires-python = ">=3.10, <=3.14"
+requires-python = ">=3.10"
 keywords = ["mime", "content-type", "mapping", "file extensions"]
 homepage = "https://github.com/mikeckennedy/content-types"
 

content_types-0.3.0/samples/compare_to_builtin.py

@@ -0,0 +1,44 @@
+import mimetypes
+
+import content_types
+
+
+def main():
+    print('Compare types in mimetypes vs content-types.')
+    in_mime_only = set()
+    differ = set()
+    for k, v in mimetypes.types_map.items():
+        cv_v = content_types.EXTENSION_TO_CONTENT_TYPE.get(k.lower().strip('.'))
+        if not cv_v:
+            in_mime_only.add((k, v))
+            continue
+
+        if cv_v != v:
+            differ.add(((k, v), (k, cv_v)))
+            continue
+
+    only_ct = set()
+    for k, v in content_types.EXTENSION_TO_CONTENT_TYPE.items():
+        mv = mimetypes.types_map.get('.' + k)
+        if not mv:
+            only_ct.add((k, v))
+            continue
+
+    print(f'There are {len(differ):,} types where mimetypes and content-types disagree')
+    for (mk, mv), (ct_k, ct_v) in sorted(differ):
+        print(f'mimetypes: {mk} {mv}, content-types: {ct_k} {ct_v}')
+    print()
+
+    print(f'There are {len(in_mime_only):,} types in mimetypes that are not in content-types')
+    for k, v in sorted(in_mime_only):
+        print(f'{k.ljust(5)}: {v}')
+    print()
+
+    print(f'There are {len(only_ct):,} types in content-types that are not in mimetypes')
+    for k, v in sorted(only_ct):
+        print(f'.{k.ljust(5)} -> {v}')
+    print()
+
+
+if __name__ == '__main__':
+    main()

content_types-0.2.2/PKG-INFO

@@ -1,77 +0,0 @@
-Metadata-Version: 2.4
-Name: content-types
-Version: 0.2.2
-Summary: A library to map file extensions to content types and vice versa.
-Project-URL: Homepage, https://github.com/mikeckennedy/content-types
-Project-URL: Bug Reports, https://github.com/mikeckennedy/content-types/issues
-Project-URL: Source, https://github.com/mikeckennedy/content-types
-Author-email: Michael Kennedy <mikeckennedy@gmail.com>
-License-Expression: MIT
-License-File: LICENSE
-Keywords: content-type,file extensions,mapping,mime
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-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: Topic :: Internet :: WWW/HTTP
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: <=3.14,>=3.10
-Description-Content-Type: text/markdown
-
-
-# content-types 🗃️🔎
-
-A Python library to map file extensions to MIME types. 
-It also provides a CLI for quick lookups right from your terminal.
-If no known mapping is found, the tool returns `application/octet-stream`.
-
-Unlike other libraries, this one does **not** try to access the file 
-or parse the bytes of the file or stream. It just looks at the extension
-which is valuable when you don't have access to the file directly.
-For example, you know the filename but it is stored in s3 and you don't want
-to download it just to fully inspect the file.
-
-## Installation
-
-```bash
-uv pip install content-types
-```
-
-## Usage
-
-```python
-import content_types
-
-# Forward lookup: filename -> MIME type
-the_type = content_types.get_content_type("example.jpg")
-print(the_type)  # "image/jpeg"
-
-# For very common files, you have shortcuts:
-print(f'Content-Type for webp is {content_types.webp}.') 
-# Content-Type for webp is image/webp.
-```
-
-## CLI
-
-To use the library as a CLI tool, just install it with **uv** or **pipx**. 
-
-```bash
-uv tool install content-types
-```
-
-Now it will be available machine-wide.
-
-```bash
-content-types example.jpg
-
-# Outputs image/jpeg
-```
-
-## Contributing
-
-Contributions are welcome! Check out [the GitHub repo](https://github.com/mikeckennedy/content-types) 
-for more details on how to get involved.

content_types-0.2.2/README.md

@@ -1,53 +0,0 @@
-
-# content-types 🗃️🔎
-
-A Python library to map file extensions to MIME types. 
-It also provides a CLI for quick lookups right from your terminal.
-If no known mapping is found, the tool returns `application/octet-stream`.
-
-Unlike other libraries, this one does **not** try to access the file 
-or parse the bytes of the file or stream. It just looks at the extension
-which is valuable when you don't have access to the file directly.
-For example, you know the filename but it is stored in s3 and you don't want
-to download it just to fully inspect the file.
-
-## Installation
-
-```bash
-uv pip install content-types
-```
-
-## Usage
-
-```python
-import content_types
-
-# Forward lookup: filename -> MIME type
-the_type = content_types.get_content_type("example.jpg")
-print(the_type)  # "image/jpeg"
-
-# For very common files, you have shortcuts:
-print(f'Content-Type for webp is {content_types.webp}.') 
-# Content-Type for webp is image/webp.
-```
-
-## CLI
-
-To use the library as a CLI tool, just install it with **uv** or **pipx**. 
-
-```bash
-uv tool install content-types
-```
-
-Now it will be available machine-wide.
-
-```bash
-content-types example.jpg
-
-# Outputs image/jpeg
-```
-
-## Contributing
-
-Contributions are welcome! Check out [the GitHub repo](https://github.com/mikeckennedy/content-types) 
-for more details on how to get involved.