Sphinx: autodoc loses the first staticmethod parameter

[ovekaaven]

As an example, if I have

class BaseStorage:
    @staticmethod
    def get_username(user, flags):
        """
        Get the username of the user.

        :param user: user object
        :param flags: flags
        :return: username
        """
        return None

and

.. autoclass:: storage.BaseStorage
    :members:

then the signature of the method in the HTML output is

static get_username(flags)

That is, the first parameter is missing.

This is using Python 3.6.3, and Sphinx 1.7.1, on Ubuntu 17.10.

[tk0miya]

Confirmed. Surely this is a bug.

[tk0miya]

Fixed by #4774.
Thank you for reporting!

[thijsfranck]

This bug seems to still be occurring using Sphinx 1.7.4 and Python 2.7. My example:

Source

class GraphUtils():

    @staticmethod
    def toTransitionMatrix(graph):

        """
        Generates a transition matrix for the given graph along three dimensions: source x target x type

        :returns: A pandas DataFrame containing the transition matrix
        :rtype: DataFrame

        :param Graph graph: The graph for which you wish to calculate the transition matrix
        """       

        pass

    # END toTransitionMatrix
# END GraphUtils

.rst

.. automodule:: analytics.graphs.GraphUtils
    :members:
    :undoc-members:
    :show-inheritance:

HTML output

The first parameter for the static method is missing (should be graph).

[StinGer-ShoGuN]

I have the same issue with Sphinx 1.7.4 and Python 2.7.

(Commit 9e0089b2 should be in the 1.7.4 release though, so it's weird...)