How to Create a Tuple in Python

See Python: Tips and Tricks for similar articles.

Let's start with a lie: Python tuples are created using parentheses, like this:

MAGENTA = (255, 0, 255)

Wait, what??! In Python, tuples are not created with parentheses?

The truth is that tuples are created with commas AND do not require parentheses. You can create a tuple like this:

MAGENTA = 255, 0, 255 #Avoid this

But just because you can doesn't mean you should. It's a better idea to get used to including the parentheses, because sometimes you do need them.

The best way to understand why you should get in the habit of using parentheses when creating tuples is to look at some Python code:

def show_type(obj):
    print(type(obj))

#tuple created w/o parentheses (works but bad practice)
MAGENTA = 255, 0, 255
show_type(MAGENTA)

#When passing a tuple to a function, you need parentheses:
show_type( (255, 0, 255) )

#Passing the tuple w/o parentheses to a function will error
show_type( 255, 0, 255 )

The above code will render the following:Tuple Demo Output

  1. On line 5, the MAGENTA tuple is created without using parentheses.
  2. By passing MAGENTA to the show_type() function, we see that MAGENTA is indeed a tuple.
  3. On line 9, the tuple (255, 0, 255) (constructed with parentheses) is passed to the show_type() function. This works fine.
  4. On line 12, the tuple (well, not really) 255, 0, 255 (constructed without parentheses) is passed to the show_type() function. In this case, Python passes the values to the show_type() function as three separate arguments. As the function only expects one argument, this results in an error: TypeError: show_type() takes 1 positional argument but 3 were given.

Creating a Single-element Tuple

To create an empty tuple, use an empty set of parentheses:

veggies_my_son_likes = ()

To create a single-element tuple, follow the element with a comma, like this:

pitchers_with_500_wins = ('Cy Young',)

If you do not include the comma, you just get a string as illustrated below:

Tuple

So, in a nutshell, tuples are created with commas, but you should wrap them in parentheses.

Written by Nat Dunn. Follow Nat on Twitter.


Related Articles

  1. Fixing WebVTT Times with Python
  2. Using Python to Convert Images to WEBP
  3. Scientific Notation in Python
  4. Understanding Python’s __main__ variable
  5. Converting Leading Tabs to Spaces with Python
  6. Python Clocks Explained
  7. Python: isdigit() vs. isdecimal()
  8. Maximum recursion depth exceeded while calling a Python object
  9. When to use Static Methods in Python? Never
  10. Finally, a use case for finally – Python Exception Handling
  11. Python Coding Challenge: Two People with the Same Birthday
  12. How to Create a Simple Simulation in Python – Numeric Data
  13. Collatz Conjecture in Python
  14. Associate Python Files with IDLE
  15. How to find all your Python installations on Windows (and Mac)
  16. Python Color Constants Module
  17. A Python Model for Ping Pong Matches
  18. Bulk Convert Python files to IPython Notebook Files (py to ipynb conversion)
  19. pow(x, y, z) more efficient than x**y % z and other options
  20. Python’s date.strftime() slower than str(), split, unpack, and concatenate?
  21. Bi-directional Dictionary in Python
  22. Creating an Email Decorator with Python and AWS
  23. Change Default autosave Interval in JupyterLab
  24. Basic Python Programming Exercise: A Penny Doubled Every Day
  25. Simple Python Script for Extracting Text from an SRT File
  26. Python Virtual Environments with venv
  27. Mapping python to Python 3 on Your Mac
  28. How to Make IDLE the Default Editor for Python Files on Windows
  29. How to Do Ternary Operator Assignment in Python
  30. How to Convert Seconds to Years with Python
  31. How to Create a Python Package
  32. How to Read a File with Python
  33. How to Check the Operating System with Python
  34. How to Use enumerate() to Print a Numbered List in Python
  35. How to Repeatedly Append to a String in Python
  36. Checking your Sitemap for Broken Links with Python
  37. How to do Simultaneous Assignment in Python
  38. Visual Studio Code - Opening Files with Python open()
  39. How to Slice Strings in Python
  40. How Python Finds Imported Modules
  41. How to Merge Dictionaries in Python
  42. How to Index Strings in Python
  43. How to Create a Tuple in Python (this article)