Improve punctuation/grammar with header. (#1547)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Albert Tugushev <albert@tugushev.ru>
Co-authored-by: Sorin Sbarnea <sorin.sbarnea@gmail.com>

piptools/writer.py

@@ -123,10 +123,10 @@ def write_header(self) -> Iterator[str]:
         if self.emit_header:
             yield comment("#")
             yield comment(
-                "# This file is autogenerated by pip-compile with python "
+                "# This file is autogenerated by pip-compile with Python "
                 f"{sys.version_info.major}.{sys.version_info.minor}"
             )
-            yield comment("# To update, run:")
+            yield comment("# by the following command:")
             yield comment("#")
             compile_command = os.environ.get(
                 "CUSTOM_COMPILE_COMMAND"

tests/test_cli_compile.py

@@ -1758,17 +1758,10 @@ def test_upgrade_package_doesnt_remove_annotation(pip_conf, runner):
             "small-fake-a==0.1         # via small-fake-with-deps\n"
         )
 
-    runner.invoke(cli, ["-P", "small-fake-a", "--no-emit-find-links"])
+    runner.invoke(cli, ["-P", "small-fake-a", "--no-emit-options", "--no-header"])
     with open("requirements.txt") as req_txt:
         assert req_txt.read() == dedent(
-            f"""\
-            #
-            # This file is autogenerated by pip-compile with python \
-{sys.version_info.major}.{sys.version_info.minor}
-            # To update, run:
-            #
-            #    pip-compile --no-emit-find-links
-            #
+            """\
             small-fake-a==0.1
                 # via small-fake-with-deps
             small-fake-with-deps==0.1

tests/test_writer.py

@@ -192,9 +192,9 @@ def test_write_header(writer):
         comment,
         [
             "#",
-            "# This file is autogenerated by pip-compile with python "
+            "# This file is autogenerated by pip-compile with Python "
             f"{sys.version_info.major}.{sys.version_info.minor}",
-            "# To update, run:",
+            "# by the following command:",
             "#",
             "#    pip-compile --output-file={} src_file src_file2".format(
                 writer.click_ctx.params["output_file"].name
@@ -211,9 +211,9 @@ def test_write_header_custom_compile_command(writer, monkeypatch):
         comment,
         [
             "#",
-            "# This file is autogenerated by pip-compile with python "
+            "# This file is autogenerated by pip-compile with Python "
             f"{sys.version_info.major}.{sys.version_info.minor}",
-            "# To update, run:",
+            "# by the following command:",
             "#",
             "#    ./pipcompilewrapper",
             "#",