help, dir

The Python language provides two commands to obtain documentation about objects defined in the current scope, both built-in and user-defined.

We can ask for help about an object, for example “1”:

  1. >>> help(1)
  2. Help on int object:
  3. class int(object)
  4. | int(x=0) -> int or long
  5. | int(x, base=10) -> int or long
  6. |
  7. | Convert a number or string to an integer, or return 0 if no arguments
  8. | are given. If x is floating point, the conversion truncates towards zero.
  9. | If x is outside the integer range, the function returns a long instead.
  10. |
  11. | If x is not a number or if base is given, then x must be a string or
  12. | Unicode object representing an integer literal in the given base. The
  13. | literal can be preceded by '+' or '-' and be surrounded by whitespace.
  14. | The base defaults to 10. Valid bases are 0 and 2-36. Base 0 means to
  15. | interpret the base from the string as an integer literal.
  16. | >>> int('0b100', base=0)
  17. | 4
  18. |
  19. | Methods defined here:
  20. |
  21. | __abs__(...)
  22. | x.__abs__() <==> abs(x)
  23. ...

and, since “1” is an integer, we get a description about the int class and all its methods. Here the output has been truncated because it is very long and detailed.

Similarly, we can obtain a list of methods of the object “1” with the command dir:

  1. >>> dir(1)
  2. ['__abs__', '__add__', '__and__', ...