Python dir() Function – List Attributes of Objects

Python dir() Function

The dir() function is a built-in Python tool that returns a list of valid attributes (including methods) for any object. It's often used for exploring objects during development or debugging.

Syntax

dir([object])

Parameters:

  • object (optional) – the object whose attributes you want to list

Returns:

  • A list of strings – each representing a valid attribute name of the object

Example 1: Using dir() without Arguments

When used without arguments, dir() returns the names in the current local scope.

x = 10
y = "hello"
print(dir())
['__annotations__', '__builtins__', '__doc__', '__loader__', '__name__', '__package__', '__spec__', 'x', 'y']

Example 2: Using dir() with a Built-in Object

print(dir("hello"))

Output (partial):

['__add__', '__class__', '__contains__', 'capitalize', 'casefold', 'center', 'count', ...]

This shows all the string methods and internal attributes.

Example 3: Using dir() with a Module

import math
print(dir(math))

Output (partial):

['__doc__', '__loader__', 'acos', 'asin', 'atan', 'ceil', 'cos', 'pi', 'sqrt', ...]

Use Cases of dir()

  • Exploring unknown objects or modules during development
  • Quick introspection without reading documentation
  • Understanding what operations can be done on an object

Common Mistakes

  • Not all returned items are methods – some are special/internal attributes
  • dir() doesn't always list everything – some attributes added via __getattr__ may not appear

Interview Tip

Use dir() along with type() and help() for debugging and exploring unfamiliar objects during coding interviews or while using third-party libraries.

Summary

  • dir() helps inspect available attributes and methods of objects
  • With no arguments, it shows names in the current local scope
  • It's useful for exploring built-in types, custom classes, and modules

Practice Task

Try running dir() on a few different objects like [], {}, set(), and len. Observe how their available methods and properties differ.

print("List Methods:", dir([]))
print("Dict Methods:", dir({}))
print("Set Methods:", dir(set()))
print("Function Methods:", dir(len))

Comments

💬 Please keep your comment relevant and respectful. Avoid spamming, offensive language, or posting promotional/backlink content.
All comments are subject to moderation before being published.

Loading comments...

Python Built-in Functions❯

  1. 1Python aiter() Function – Get Async Iterator in Python
  2. 2Python all() Function – Check If All Elements Are True
  3. 3Python anext() Function – Get Next Item from Async Iterator
  4. 4Python any() Function – Check if Any Element is True
  5. 5Python ascii() Function – Get ASCII Representation of Objects
  6. 6Python bin() Function – Convert Integer to Binary String
  7. 7Python bool() Function – Convert to Boolean
  8. 8Python breakpoint() Function – Add Debug Points in Your Code
  9. 9Python bytearray() Function – Create and Modify Binary Data
  10. 10Python bytes() Function – Create Immutable Byte Objects
  11. 11Python callable() Function – Check If Object Is Callable
  12. 12Python chr() Function – Get Character from Unicode Code Point
  13. 13Python classmethod() Function – Convert Method to Class Method
  14. 14Python compile() Function – Compile Source Code at Runtime
  15. 15Python complex() Function – Create Complex Numbers Easily
  16. 16Python delattr() Function – Delete Attribute from Object
  17. 17Python dict() Function – Create and Use Dictionaries Easily
  18. 18Python dir() Function – List Attributes of Objects
  19. 19Python divmod() Function – Quotient and Remainder in One Go
  20. 20Python enumerate() Function – Loop with Index Easily
  21. 21Python eval() Function – Evaluate Expressions from Strings
  22. 22Python exec() Function – Execute Dynamic Python Code
  23. 23Python filter() Function – Filter Items in a List
  24. 24Python float() Function – Convert to Floating Point Number
  25. 25Python format() Function – Format Strings Easily
  26. 26Python frozenset() Function – Create Immutable Sets
  27. 27Python getattr() Function – Access Object Attributes Dynamically
  28. 28Python globals() Function – Access Global Symbol Table
  29. 29Python hasattr() Function – Check If an Object Has an Attribute
  30. 30Python hash() Function – Generate Hash Values of Objects
  31. 31Python help() Function – Get Help on Python Functions, Classes, and Modules
  32. 32Python hex() Function – Convert Integer to Hexadecimal
  33. 33Python id() Function – Get Memory Address of an Object
  34. 34Python input() Function – Get User Input Easily
  35. 35Python int() Function – Convert to Integer
  36. 36Python isinstance() Function – Check Type of a Variable
  37. 37Python issubclass() Function – Check Class Inheritance
  38. 38Python iter() Function – Create an Iterator from Iterable
  39. 39Python len() Function – Get the Length of Strings, Lists, and More
  40. 40Python list() Function – Convert Data to a List
  41. 41Python locals() Function – Get Local Symbol Table as a Dictionary
  42. 42Python map() Function – Apply a Function to Each Element
  43. 43Python max() Function – Find the Largest Value
  44. 44Python memoryview() Function – Work With Binary Data Efficiently
  45. 45Python min() Function – Find the Smallest Value
  46. 46Python next() Function – Retrieve Next Item from an Iterator
  47. 47Python object() Function – Base Object Constructor Explained
  48. 48Python oct() Function – Convert Number to Octal
  49. 49Python open() Function – Read, Write, and Create Files Easily
  50. 50Python ord() Function – Get Unicode Code of a Character
  51. 51Python pow() Function – Raise a Number to a Power
  52. 52Python print() Function – Print Output to the Console
  53. 53Python property() Function – Create Managed Attributes
  54. 54Python range() Function – Generate Number Sequences Easily
  55. 55Python repr() Function – Get String Representation of an Object
  56. 56Python reversed() Function – Reverse Iterables Easily
  57. 57Python round() Function – Round Numbers to Nearest Integer or Decimal Places
  58. 58Python set() Function – Create a Set from Iterable
  59. 59Python setattr() Function – Dynamically Set Object Attributes
  60. 60Python slice() Function – Create Slice Objects for Lists and Strings
  61. 61Python sorted() Function – Sort Any Iterable Easily
  62. 62Python staticmethod() Function – Create Static Methods in Classes
  63. 63Python str() Function – Convert to String Easily
  64. 64Python sum() Function – Add Items of an Iterable
  65. 65Python super() Function – Call Parent Class Methods
  66. 66Python tuple() Function – Create a Tuple from Iterable
  67. 67Python type() Function – Get the Type of an Object
  68. 68Python vars() Function – View Object’s Attributes
  69. 69Python zip() Function – Combine Iterables Element-Wise
  70. 70Python __import__() Function – Dynamic Module Import
  71. 71Python str.format() – Format Strings Easily with Placeholders
  72. 72Python String format_map() – Format Strings with a Mapping