mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2026-03-31 06:24:07 -04:00
60 lines
3.0 KiB
Python
60 lines
3.0 KiB
Python
# Copyright (c) 2016-2025 Martin Donath <martin.donath@squidfunk.com>
|
||
|
||
# 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 NON-INFRINGEMENT. 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.
|
||
|
||
import os
|
||
import sys
|
||
|
||
from colorama import Fore, Style
|
||
from pathlib import Path
|
||
from sys import stderr
|
||
|
||
# Check if we're running MkDocs. Disable the warning automatically for other
|
||
# contexts, e.g., to allow for forks of MkDocs to adjust behavior to fit
|
||
def is_mkdocs():
|
||
path = Path(sys.argv[0])
|
||
return path.name in ("mkdocs", "mkdocs.exe") or (
|
||
path.name == "__main__.py" and path.parent.name == "mkdocs"
|
||
)
|
||
|
||
# Check if we're running MkDocs and the warning hasn't been disabled
|
||
if is_mkdocs() and not os.getenv("NO_MKDOCS_2_WARNING"):
|
||
print(
|
||
"\n"
|
||
f"{Fore.RED} │ ⚠ Warning from the Material for MkDocs team{Style.RESET_ALL}\n"
|
||
f"{Fore.RED} │{Style.RESET_ALL}\n"
|
||
f"{Fore.RED} │{Style.RESET_ALL} MkDocs 2.0, the underlying framework of Material for MkDocs,\n"
|
||
f"{Fore.RED} │{Style.RESET_ALL} will introduce backward-incompatible changes, including:\n"
|
||
f"{Fore.RED} │{Style.RESET_ALL}\n"
|
||
f"{Fore.RED} │ × {Style.RESET_ALL}All plugins will stop working – the plugin system has been removed\n"
|
||
f"{Fore.RED} │ × {Style.RESET_ALL}All theme overrides will break – the theming system has been rewritten\n"
|
||
f"{Fore.RED} │ × {Style.RESET_ALL}No migration path exists – existing projects cannot be upgraded\n"
|
||
f"{Fore.RED} │ × {Style.RESET_ALL}Closed contribution model – community members can't report bugs\n"
|
||
f"{Fore.RED} │ × {Style.RESET_ALL}Currently unlicensed – unsuitable for production use\n"
|
||
f"{Fore.RED} │{Style.RESET_ALL}\n"
|
||
f"{Fore.RED} │{Style.RESET_ALL} Our full analysis:\n"
|
||
f"{Fore.RED} │{Style.RESET_ALL}\n"
|
||
f"{Fore.RED} │{Style.RESET_ALL} \033[4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/{Style.RESET_ALL}\n"
|
||
f"{Style.RESET_ALL}",
|
||
file=stderr
|
||
)
|
||
|
||
# Disable for subsequent imports
|
||
os.environ["NO_MKDOCS_2_WARNING"] = "true"
|