dir() function in Python
In Python, the dir() function is a built-in function used to list the attributes (methods, properties, and other members) of an object. In this article we will see about dir() function in Python.
Python dir() Function Syntax
Syntax: dir({object})
Parameters :
object [optional] : Takes object name
Returns :
dir() tries to return a valid list of attributes of the object it is called upon. Also, dir() function behaves rather differently with different type of objects, as it aims to produce the most relevant one, rather than the complete information.
- For Class Objects, it returns a list of names of all the valid attributes and base attributes as well.
- For Modules/Library objects, it tries to return a list of names of all the attributes, contained in that module.
- If no parameters are passed it returns a list of names in the current local scope.
What is dir() in Python?
dir() is a powerful inbuilt function in Python3, which returns a list of the attributes and methods of any object (say functions, modules, strings, lists, dictionaries, etc.)
Python dir() function Examples
When No Parameters are Passed
In this example, we are using the dir() function to list object attributes and methods in Python. It provides a demonstration for exploring the available functions and objects in our Python environment and modules when we are working with them.
Python3
# Python3 code to demonstrate dir()# when no parameters are passed# Note that we have not imported any modulesprint(dir())# Now let's import two modulesimport randomimport mathprint(dir()) |
['__annotations__', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__spec__'] ['__annotations__', '__builtins__', '__cached__', '__doc__', '__file__', '...
When a Module Object is Passed
In this example, we are using the dir() function when a module object is passed as a parameter to list object attributes and methods in Python. This provides a demonstration for exploring the available functions and objects within a Python module when we are working with it.
Python3
# Python3 code to demonstrate dir() function# when a module Object is passed as parameter.# import the random module import random# Prints list which contains names of# attributes in random functionprint("The contents of the random library are::")# module Object is passed as parameterprint(dir(random)) |
Output
The contents of the random library are::
[‘BPF’, ‘LOG4’, ‘NV_MAGICCONST’, ‘RECIP_BPF’, ‘Random’, ‘SG_MAGICCONST’, ‘SystemRandom’, ‘TWOPI’, ‘_BuiltinMethodType’, ‘_MethodType’, ‘_Sequence’, ‘_Set’, ‘__…
When a List Object is Passed as Parameter
In this example, we are using the dir() function when a list object and an empty dictionary are passed as parameters to list object attributes and methods in Python. This demonstrates how to explore the available functions and objects within both a list and an empty dictionary in Python.
Python3
# When a list object is passed as # parameters for the dir() function# A list, which contains# a few random valuesgeeks = ["geeksforgeeks", "gfg", "Computer Science", "Data Structures", "Algorithms" ]# dir() will also list out common# attributes of the dictionaryd = {} # empty dictionary# dir() will return all the available # list methods in current local scopeprint(dir(geeks))print(dir(d)) |
Output
[‘__add__’, ‘__class__’, ‘__contains__’, ‘__delattr__’, ‘__delitem__’, ‘__dir__’, ‘__doc__’, ‘__eq__’, ‘__format__’, ‘__ge__’, ‘__getattribute__’, ‘__getitem__’, ‘__gt__’, ‘__hash__’, ‘__iadd__’, ‘__i…
When User Defined Objects are Passed as Parameters
In this example, we are using the dir() function when user-defined objects are passed as parameters to list object attributes and methods in Python. This demonstrates how to explore the available functions and objects within custom objects created by the user in Python.
Python3
# Creation of a simple class with __dir()__# method to demonstrate it's workingclass Supermarket: # Function __dir()___ which list all # the base attributes to be used. def __dir__(self): return['customer_name', 'product', 'quantity', 'price', 'date']# user-defined object of class supermarketmy_cart = Supermarket()# listing out the dir() methodprint(dir(my_cart)) |
['customer_name', 'date', 'price', 'product', 'quantity']
Applications of Python dir()
- The dir() has it’s own set of uses. It is usually used for debugging purposes in simple day to day programs, and even in large projects taken up by a team of developers. The capability of dir() to list out all the attributes of the parameter passed, is really useful when handling a lot of classes and functions, separately.
- The dir() function can also list out all the available attributes for a module/list/dictionary. So, it also gives us information on the operations we can perform with the available list or module, which can be very useful when having little to no information about the module. It also helps to know new modules faster.
Dive into the future of technology - explore the Complete Machine Learning and Data Science Program by GeeksforGeeks and stay ahead of the curve.
Commit to GfG's Three-90 Challenge! Purchase a course, complete 90% in 90 days, and save 90% cost click here to explore.
