Metadata-Version: 2.1
Name: mimetypeplus
Version: 1.0.0.0
Summary: A powerful Python module for intuitive MIME type management, providing utilities for identifying, creating, and manipulating MIME types in various contexts.
Author-email: Markus Hammer <107761433+MarkusHammer@users.noreply.github.com>
Project-URL: Homepage, https://github.com/MarkusHammer/mimetypeplus-python
Project-URL: Documentation, https://MarkusHammer.github.io/mimetypeplus-python
Project-URL: Github, https://github.com/MarkusHammer/mimetypeplus-python
Project-URL: Issues, https://github.com/MarkusHammer/mimetypeplus-python/issues
Project-URL: Pull Requests, https://github.com/MarkusHammer/mimetypeplus-python/pulls
Project-URL: Git, https://github.com/MarkusHammer/mimetypeplus-python.git
Keywords: MIME,MIME type,content,content type,file,extension,media,type,HTTP,HTML,web,development,content negotiation,file management,internet,utilities
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: typing-extensions <=3.10
Provides-Extra: detection
Requires-Dist: python-magic ; extra == 'detection'
Requires-Dist: puremagic ; extra == 'detection'
Provides-Extra: dev
Requires-Dist: setuptools >=64.0.0 ; extra == 'dev'
Requires-Dist: pip-tools ; extra == 'dev'
Requires-Dist: validate-pyproject[all] ; extra == 'dev'
Requires-Dist: build ; extra == 'dev'
Requires-Dist: twine ; extra == 'dev'
Requires-Dist: coverage ; extra == 'dev'
Requires-Dist: pdoc3 ; extra == 'dev'
Requires-Dist: pyright ; extra == 'dev'
Requires-Dist: pylint ; extra == 'dev'


# `mimetypeplus`

> A simple python module focused on easy MIME type manipulation and detection.

[Documentation](https://MarkusHammer.github.io/mimetypeplus-python)

## Setup

This module can be installed using:

```bash
pip install mimetypeplus
```

## Usage

This module is intended to be used only as a module, and can be imported after installing using the traditional process:

```python
from mimetypeplus import MimeType
```

### Create a MIME Type Object

```python
mime = MimeType("application/json")
```

### Identify MIME Types

Quickly determine the MIME type of content from various sources:

```python
# Identify MIME type from a file path
mime = MimeType.from_path("data.json")
mime = MimeType.from_path(__file__)

# Identify MIME type from a URI
mime = MimeType.from_uri("https://example.com/api/data")
```

### Facet Manipulation

```python
# Check if the MIME type is experimental
if mime.experimental_facet:
    print("This is an experimental MIME type.")

# Set a vendor-specific facet
mime.facet = "vnd"
```

### Quickly Find File Extensions

```python
extension = mime.to_extention()
print(f"The file extension for this MIME type is '{extension}'")
```

### And More

There are a handfull of other ease of use features that this module provides, feel free to reference the [documentation](https://MarkusHammer.github.io/mimetypeplus-python) for more information.

## Licence

This is licensed under the Mozilla Public License 2.0 (MPL 2.0) Licence. See the Licence file in this repository for more information.

## Contribute

Contributions are always welcome!
Use the [github repository](https://github.com/MarkusHammer/mimetypeplus-python) to report issues and contribute to this project.

## Credits

While not required, feel free to credit "Markus Hammer" (or just "Markus") if you find this code or script useful for whatever you may be doing with it.

# Security Policy

While the python source code will be actively maintained, any binary files (if at all provided) are in no way supported.
These are provided as a courtesy and are not intended to be the main usage of this software.
Please keep this in mind when choosing how you wish to use this software.

## Supported Versions

| Version     | Supported |
| ----------- | --------- |
| 1.0.0.0 >= | ✅        |
| 1.0.0.0 <  | ❌        |

## Reporting a Vulnerability

Please report any issues to the email 107761433+MarkusHammer(THEN THE @ SYMBOL HERE)users.noreply.github.com
