ModuleNotFoundError: No module named 'cgi'

[CharlesWiltgen]

Description

The application fails to start when using Python 3.11 or later due to the removal of the cgi module. The error occurs when running Headphones.py.

Steps to Reproduce

1. Clone the repository
2. Navigate to the project directory
3. Run the script with Python 3.11 or later
4. Observe the error

Observed Error

Traceback (most recent call last):
  File "/Applications/Headphones/Headphones.py", line 27, in <module>
    from headphones import webstart, logger
  File "/Applications/Headphones/headphones/__init__.py", line 27, in <module>
    import cherrypy
  File "/Applications/Headphones/lib/cherrypy/__init__.py", line 68, in <module>
    from ._cperror import (
    ...<2 lines>...
    )
  File "/Applications/Headphones/lib/cherrypy/_cperror.py", line 135, in <module>
    from cherrypy.lib import httputil as _httputil
  File "/Applications/Headphones/lib/cherrypy/lib/httputil.py", line 15, in <module>
    from cgi import parse_header
ModuleNotFoundError: No module named 'cgi'

Environment

• OS: macOS Sequoia 15.1
• Python version: 3.11 or later
• Headphones version: Latest from master branch

Possible Cause

The cgi module was removed in Python 3.11, causing the script to fail when importing parse_header.

Proposed Solutions

1. Update the codebase to replace from cgi import parse_header with the equivalent implementation using the email module:

   from email.message import Message
   from email.parser import BytesParser
   
   def parse_header(value):
       parser = BytesParser()
       msg = parser.parsebytes(b"Content-Type: " + value.encode("ascii"))
       return msg.get_content_type(), msg.get_params()

2. Document Python version requirements in the README.md and explicitly state support for Python versions prior to 3.11.
3. Explore compatibility fixes for the broader application to support newer Python versions.

Additional Context

Switching to Python 3.10 resolves the issue temporarily, but long-term compatibility with Python 3.11+ would enhance the user experience.

Thank you! ✌️

[AdeHub]

Can you try the develop branch