Clarify Python MIME type

[jdek]

BPO	39115
Nosy	@asvetlov, @jdek

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2019-12-24.10:02:31.791>
created_at = <Date 2019-12-21.14:14:39.608>
labels = ['type-feature', 'invalid', '3.9', 'docs']
title = 'Clarify Python MIME type'
updated_at = <Date 2019-12-24.10:02:31.790>
user = 'https://github.com/jdek'

bugs.python.org fields:

activity = <Date 2019-12-24.10:02:31.790>
actor = 'asvetlov'
assignee = 'docs@python'
closed = True
closed_date = <Date 2019-12-24.10:02:31.791>
closer = 'asvetlov'
components = ['Documentation']
creation = <Date 2019-12-21.14:14:39.608>
creator = 'jdek'
dependencies = []
files = []
hgrepos = []
issue_num = 39115
keywords = []
message_count = 6.0
messages = ['358772', '358810', '358811', '358812', '358832', '358846']
nosy_count = 3.0
nosy_names = ['asvetlov', 'docs@python', 'jdek']
pr_nums = []
priority = 'normal'
resolution = 'not a bug'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue39115'
versions = ['Python 3.9']

[jdek]

I'd like to add Python's MIME types to a database so that they can be properly used by other services. However, apart from the source code1, I can't find any documentation from Python which highlights this. Is the source code correct here, and can it be taken as the 'official' MIME types from the project?

text/x-python py
application/x-python-code pyc pyo

[asvetlov]

Do you mean adding a record to https://www.iana.org/assignments/media-types/media-types.xhtml?

[jdek]

An IANA media type assignment would be even better than a '*/x-*' MIME, of course, but my original intention was just to clarify that the MIMEs in the cpython source can be used as documentation for 'which MIME should you use when sending .py,.pyc,.pyo'.

I'm unsure if Python is eligible for a 'real' assignment, as far as I can tell, the main factor is if they are willing to take a reference implementation as 'a permanent and readily available public specification of the format for the media type' 1.

[asvetlov]

If you are not talking about IANA registration (I doubt if Python needs it) what do you propose?
I've missed what do you want to update in Python or its docs to satisfy your needs.

[jdek]

I just wanted the intended MIME type for sending python over various mediums to be written down somewhere other than the source code, but I'm not sure where it should go.

Though if you don't think it is necessary then that is fine too, I mostly just wanted someone else's opinion. After looking into it further I couldn't find much on other languages specifically stating which MIME you should use, it's mostly somewhat of an infrequent unofficial convention.

If you don't think there is an appropriate place to put this information, other than the source code itself, then feel free to close this bug. Thank you for your replies, and sorry for wasting your time.

[asvetlov]

As you mentioned, IANA did not registry any programming language except JavaScript; I think that's fine.

You can consider text/x-python and application/x-python-code as unofficial but permanent MIME types that are used in Python written programs at least; feel free to use them.