How can I denote unused function arguments?

PythonPython 2.x

Python Problem Overview


When "deconstructing" a tuple, I can use _ to denote tuple elements I'm not interested in, e.g.

>>> a,_,_ = (1,2,3)
>>> a
1

Using Python 2.x, how can I express the same with function arguments? I tried to use underscores:

>>> def f(a,_,_): return a
...
  File "<stdin>", line 1
SyntaxError: duplicate argument '_' in function definition

I also tried to just omit the argument altogether:

>>> def f(a,,): return a
  File "<stdin>", line 1
    def f(a,,): return a
        ^
SyntaxError: invalid syntax

Is there another way to achieve the same?

Python Solutions


Solution 1 - Python

A funny way I just thought of is to delete the variable:

def f(foo, unused1, unused2, unused3):
	del unused1, unused2, unused3
	return foo

This has numerous advantages:

  • The unused variable can still be used when calling the function both as a positional argument and as a keyword argument.

  • If you start to use it later, you can't since it's deleted, so there is less risk of mistakes.

  • It's standard python syntax.

  • PyCharm does the right thing! (As of 2020, PyCharm no longer does the right thing :( tracking this at https://youtrack.jetbrains.com/issue/PY-39889 )

  • PyLint won't complain and using del is the solution recommended in the PyLint manual.

Solution 2 - Python

The underscore is used for things we don't care about and the * in *args denotes a list of arguments. Therefore, we can use *_ to denote a list of things we don't care about:

def foo(bar, *_):
    return bar

It even passes PyCharm's checks.

Solution 3 - Python

You can use '_' as prefix, so that pylint will ignore these parameters:

def f(a, _b, _c):

Solution 4 - Python

Here's what I do with unused arguments:

def f(a, *unused):
    return a

Solution 5 - Python

In order to avoid "unused variable" inspection messages for unused *args and/or **kwargs, I replace args and kwargs by _ and __ :

def f(a, b, *_, **__):
    ...

In addition to remove messages, it clearly shows that you don't care about these arguments.

I can't say if it is a really universal solution, but it worked everywhere I've used it until now.

Solution 6 - Python

If you have both args and keyword arg you should use

def f(a, *args, **kwargs):
    return a

Solution 7 - Python

I think the accepted answer is bad, but it can still work, if you use what I should call "Perl way" of dealing with arguments (I don't know Perl really, but I quit trying to learn it after seeing the sub syntax, with manual argument unpacking):

Your function has 3 arguments - this is what it gets called with (Duck typing, remember?). So you get:

def funfun(a, b, c):
    return b * 2

2 unused parameters. But now, enter improved larsmans' approach:

def funfun(*args):
    return args[1] * 2

And there go the warnings...

However, I still enjoy more the boxed's way:

def funfun(a, b, c):
    del a, c
    return b * 2

It keeps the self-documenting quality of parameter names. They're a feature, not a bug.

But, the language itself doesn't force you there - you could also go the other way around, and just let all your function have the signature (*args, **kwargs), and do the argument parsing manually every time. Imagine the level of control that gives you. And no more exceptions when being called in a deprecated way after changing your "signature" (argument count and meaning). This is something worth considering ;)

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionFrerich RaabeView Question on Stackoverflow
Solution 1 - PythonboxedView Answer on Stackoverflow
Solution 2 - PythonPaul BrownView Answer on Stackoverflow
Solution 3 - PythonRonyisView Answer on Stackoverflow
Solution 4 - PythonFred FooView Answer on Stackoverflow
Solution 5 - PythonEric PASCUALView Answer on Stackoverflow
Solution 6 - PythonMaksym PolshchaView Answer on Stackoverflow
Solution 7 - PythonTomasz GandorView Answer on Stackoverflow