python · vstinner · Mar 14, 2025 · Mar 11, 2025 · Mar 11, 2025 · Mar 12, 2025
diff --git a/Doc/library/cmdline.rst b/Doc/library/cmdline.rst
@@ -26,7 +26,7 @@ The following modules have a command-line interface.
 * :ref:`json <json-commandline>`
 * :mod:`mimetypes`
 * :mod:`pdb`
-* :mod:`pickle`
+* :ref:`pickle <pickle-cli>`
 * :ref:`pickletools <pickletools-cli>`
 * :mod:`platform`
 * :mod:`poplib`

diff --git a/Doc/library/pickle.rst b/Doc/library/pickle.rst
@@ -511,6 +511,30 @@ The :mod:`pickle` module exports three classes, :class:`Pickler`,
       Release the underlying buffer exposed by the PickleBuffer object.
 
 
+.. _pickle-cli:
+
+Command-line interface
+----------------------
+
+The :mod:`pickle` module can be invoked as a script from the command line,
+it will display contents of the pickle files. However, when the pickle file
+that you want to examine comes from an untrusted source, ``-m pickletools``
+is a safer option because it does not execute pickle bytecode, see
+:ref:`pickletools CLI usage <pickletools-cli>`.
+
+.. code-block:: bash
+
+   python -m pickle pickle_file [pickle_file ...]
+
+The following option is accepted:
+
+.. program:: pickle
+
+.. option:: pickle_file
+
+   A pickle file.
+
+
 .. _pickle-picklable:
 
 What can be pickled and unpickled?

diff --git a/Lib/pickle.py b/Lib/pickle.py
@@ -1913,7 +1913,7 @@ def _loads(s, /, *, fix_imports=True, encoding="ASCII", errors="strict",
         description='display contents of the pickle files')
     parser.add_argument(
         'pickle_file',
-        nargs='*', help='the pickle file')
+        nargs='+', help='the pickle file')
     args = parser.parse_args()
     if not args.pickle_file:
         parser.print_help()