DEPR: Positional arguments in Series.to_string

[rmhowe425]

• closes DEPR: Positional arguments in Series.to_markdown/string #57280
• Tests added and passed if fixing a bug or adding a new feature
• All code checks passed.
• Added type annotations to new arguments/methods/functions.
• Added an entry in the latest doc/source/whatsnew/vX.X.X.rst file if fixing a bug or adding a new feature.

[rmhowe425]

@mroeschke Pinging on green

[twoertwein]

Looking good! You can already make the two overloads keyword-only, if you want to:

    @overload
    def to_string(
        self,
        buf: None = ...,
        *,
        na_rep: str = ...,

[rmhowe425]

@twoertwein It looks like the two overloaded methods are already keyword only. Is there something specific I need to do?

[twoertwein]

Is there something specific I need to do?

Just need to add two *,

    @overload
    def to_string(
        self,
        buf: None = ...,
       *,  # add this
        na_rep: str = ...,

    @overload
    def to_string(
        self,
        buf: FilePath | WriteBuffer[str],
       *, # add this
        na_rep: str = ...,

    @deprecate_nonkeyword_arguments(
    def to_string(

[rmhowe425]

@twoertwein Pinging on green.

BTW I didn't know that you can use * to mandate the use of keyword args after the *. I learned something new today!

[twoertwein]

Thank you @rmhowe425 !