poetry check command validates readme (files must exist)

docs/pyproject.md

@@ -114,6 +114,12 @@ The file(s) can be of any format, but if you intend to publish to PyPI keep the
 https://packaging.python.org/en/latest/guides/making-a-pypi-friendly-readme/) in
 mind. README paths are implicitly relative to `pyproject.toml`.
 
+{{% note %}}
+Whether paths are case-sensitive follows platform defaults, but it is recommended to keep cases.
+
+To be specific, you can set `readme = "rEaDmE.mD"` for `README.md` on macOS and Windows, but Linux users can't `poetry install` after cloning your repo. This is because macOS and Windows are case-insensitive and case-preserving.
+{{% /note %}}
+
 The contents of the README file(s) are used to populate the [Description
 field](https://packaging.python.org/en/latest/specifications/core-metadata/#description-optional)
 of your distribution's metadata (similar to `long_description` in setuptools).

src/poetry/console/commands/check.py

@@ -1,8 +1,14 @@
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
+
 from poetry.console.commands.command import Command
 
 
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
 class CheckCommand(Command):
     name = "check"
     description = "Checks the validity of the <comment>pyproject.toml</comment> file."
@@ -57,6 +63,22 @@ def validate_classifiers(
 
         return errors, warnings
 
+    def validate_readme(
+        self, readme: str | list[str], poetry_file: Path
+    ) -> tuple[list[str], list[str]]:
+        """Check existence of referenced readme files"""
+
+        errors = []
+        warnings: list[str] = []
+
+        readmes = [readme] if isinstance(readme, str) else readme
+
+        for name in readmes:
+            if not (poetry_file.parent / name).exists():
+                errors.append(f"Declared README file must exist: found {name}")
+
+        return errors, warnings
+
     def handle(self) -> int:
         from poetry.factory import Factory
         from poetry.pyproject.toml import PyProjectTOML
@@ -72,6 +94,12 @@ def handle(self) -> int:
         check_result["errors"].extend(errors)
         check_result["warnings"].extend(warnings)
 
+        # Validate readme (files must exist)
+        if "readme" in config:
+            errors, warnings = self.validate_readme(config["readme"], poetry_file)
+            check_result["errors"].extend(errors)
+            check_result["warnings"].extend(warnings)
+
         if not check_result["errors"] and not check_result["warnings"]:
             self.info("All set!")
 

tests/console/commands/test_check.py

@@ -45,6 +45,7 @@ def test_check_invalid(
 Error: 'description' is a required property
 Error: Project name (invalid) is same as one of its dependencies
 Error: Unrecognized classifiers: ['Intended Audience :: Clowns'].
+Error: Declared README file must exist: found never/exists.md
 Warning: A wildcard Python dependency is ambiguous.\
  Consider specifying a more explicit one.
 Warning: The "pendulum" dependency specifies the "allows-prereleases" property,\

tests/fixtures/invalid_pyproject/pyproject.toml

@@ -4,6 +4,7 @@ version = "1.0.0"
 authors = [
     "Foo <foo@bar.com>"
 ]
+readme = "never/exists.md"
 license = "INVALID"
 classifiers = [
     "Environment :: Console",