A Huge Guide to Dictionaries in Python

What is a Python Dictionary? Second to a Python list, the dictionary or is a place in memory to store a series of values – also called a collection. The dictionary is special because values are not referenced in order using a numerical index. Rather, in a dictionary, , just as words in a physical dictionary are “keys” associated with the “value” of their meaning. This key is usually a string, but could be any number of data types. “dict” values are referenced with a user-defined key <code class="Python hljs livecodeserver" style="box-sizing: border-box; font-size: 1.75 rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51 , 51 ); background: rgb(248, 248 , 248 ); border-radius: 0 px; line-height: 25 px; padding: 0.5 em 16 rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0 px; display: block; overflow-x: auto; border-top: 1 px solid rgb(224, 224 , 225 ); border-bottom: 1 px solid rgb(224, 224 , 225 );">my_dict = { 'my_key' : 'my_value' } For example, instead of referring to the first value in a list with , one refers to any dictionary element by its key: my_list[0] <code class="Python hljs livecodeserver" style="box-sizing: border-box; font-size: 1.75 rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51 , 51 ); background: rgb(248, 248 , 248 ); border-radius: 0 px; line-height: 25 px; padding: 0.5 em 16 rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0 px; display: block; overflow-x: auto; border-top: 1 px solid rgb(224, 224 , 225 ); border-bottom: 1 px solid rgb(224, 224 , 225 );"> &gt;&gt;&gt; my_dict[ 'my_key' ] ‘my_value’ These explicit references are more legible than list index notation and improve the maintainability and performance of code in most situations. Additionally, key-value combinations allow As words in a dictionary are keys to the values of their definitions, so letters of the alphabet are keys to the values of words themselves. Such complexity in data in structure is often necessary, when dealing with complex data. With this special feature, a dictionary lives somewhere between lists and user-defined classes. Python dictionaries are more feature-rich than lists, but don’t require as much effort as a user-defined class with unique attributes and methods. complex hierarchies of nested data. How to Create and Reference Python Dictionaries There are several ways to declare a dictionary, depending on the situation. The simplest is to enclose the keys and values in curly braces, like so: my_dict = { : , : } class "Python hljs livecodeserver" "box-sizing: border-box; font-size: 1.75rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51, 51); background: rgb(248, 248, 248); border-radius: 0px; line-height: 25px; padding: 0.5em 16rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0px; display: block; overflow-x: auto; border-top: 1px solid rgb(224, 224, 225); border-bottom: 1px solid rgb(224, 224, 225);" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'key1' class "hljs-number" "box-sizing: border-box; color: teal;" 1 class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'key2' class "hljs-number" "box-sizing: border-box; color: teal;" 2 You can also pass key-value pairs to the dict keyword constructor, though this is less common: <code class="Python hljs livecodeserver" style="box-sizing: border-box; font-size: 1.75 rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51 , 51 ); background: rgb(248, 248 , 248 ); border-radius: 0 px; line-height: 25 px; padding: 0.5 em 16 rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0 px; display: block; overflow-x: auto; border-top: 1 px solid rgb(224, 224 , 225 ); border-bottom: 1 px solid rgb(224, 224 , 225 );">my_dict = dict(key1 = 1 , key2 = 2 ) Assigning values on declaration is useful when returning a dictionary with dynamic values, or as part of a lambda or comprehension. Both the keys and the values may be references to variables defined elsewhere, allowing dynamic assignment. Sometimes it’s necessary to declare an empty dictionary, as values might be added later, but other parts of the code need something to reference in the meantime. To declare an empty dictionary: <code class="Python hljs livecodeserver" style="box-sizing: border-box; font-size: 1.75 rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51 , 51 ); background: rgb(248, 248 , 248 ); border-radius: 0 px; line-height: 25 px; padding: 0.5 em 16 rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0 px; display: block; overflow-x: auto; border-top: 1 px solid rgb(224, 224 , 225 ); border-bottom: 1 px solid rgb(224, 224 , 225 );">my_dict = {} my_dict = dict() Values may then be appended to this dictionary when they become available with the assignment operator: my_dict[ ] = &gt;&gt;&gt; my_dict { : } class "Python hljs livecodeserver" "box-sizing: border-box; font-size: 1.75rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51, 51); background: rgb(248, 248, 248); border-radius: 0px; line-height: 25px; padding: 0.5em 16rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0px; display: block; overflow-x: auto; border-top: 1px solid rgb(224, 224, 225); border-bottom: 1px solid rgb(224, 224, 225);" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'key' class "hljs-number" "box-sizing: border-box; color: teal;" 123 class "hljs-meta" "box-sizing: border-box; color: rgb(153, 153, 153); font-weight: 700;" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'key' class "hljs-number" "box-sizing: border-box; color: teal;" 123 Python dictionaries are stored and referenced like any other variable. In fact, dictionaries can be stored within dictionaries, and often are. In this case, just refer to the stored dictionary as you would any other value – by its key. my_dict = { : { : , : , } } class "Python hljs livecodeserver" "box-sizing: border-box; font-size: 1.75rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51, 51); background: rgb(248, 248, 248); border-radius: 0px; line-height: 25px; padding: 0.5em 16rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0px; display: block; overflow-x: auto; border-top: 1px solid rgb(224, 224, 225); border-bottom: 1px solid rgb(224, 224, 225);" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'my_nested_dict' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'a_key' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'a_value' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'another_key' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'another_value' It’s polite to use whitespace in a way that clearly indicates nested layers while maintaining consistency with Python best practices. The specific format may be determined by an IDE auto-formatter, or a pre-deployment linter. Now, we can refer to the nested dictionary by its key: <code class="Python hljs livecodeserver" style="box-sizing: border-box; font-size: 1.75 rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51 , 51 ); background: rgb(248, 248 , 248 ); border-radius: 0 px; line-height: 25 px; padding: 0.5 em 16 rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0 px; display: block; overflow-x: auto; border-top: 1 px solid rgb(224, 224 , 225 ); border-bottom: 1 px solid rgb(224, 224 , 225 );">my_variable = my_dict[ 'my_nested_dict' ] The Dictionary Comprehension – Less is More A more advanced technique for defining a dictionary is using the Python dictionary comprehension. Like a list comprehension, a dictionary comprehension generates a dynamically-sized dictionary in a format more concise than the notation above: <code class="Python hljs livecodeserver" style="box-sizing: border-box; font-size: 1.75 rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51 , 51 ); background: rgb(248, 248 , 248 ); border-radius: 0 px; line-height: 25 px; padding: 0.5 em 16 rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0 px; display: block; overflow-x: auto; border-top: 1 px solid rgb(224, 224 , 225 ); border-bottom: 1 px solid rgb(224, 224 , 225 );">automatic_dictionary = {key: value for (key, value) in &lt; some_iterable &gt;} Any iterable object that could be associated in terms of keys and values, a list of tuples for example, easily becomes a dictionary with a single line of code. Depending on the size of the iterable, the dictionary comprehension notation can be a space-saver (and a lifesaver!) making code that much more “Pythonic.” Want to Code ?Kite is a plugin for PyCharm, Atom, Vim, VSCode, Sublime Text, and IntelliJ that uses machine learning to provide you with code completions in real time sorted by relevance. .Download Kite Free Faster Start coding faster today Practical Use Cases Let’s say we need to quickly model and store some data without the boiler-plate of a class or hairy SQL statements. For example, we need to store some data about users of a website. A User class might look like… User ( ) : def init (self, name, email, address, password, url) : self.name = name self.email = email ... def send email (self) : pass def repr () : bill = User( , , , , ) bill.send email() class "Python hljs livecodeserver" "box-sizing: border-box; font-size: 1.75rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51, 51); background: rgb(248, 248, 248); border-radius: 0px; line-height: 25px; padding: 0.5em 16rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0px; display: block; overflow-x: auto; border-top: 1px solid rgb(224, 224, 225); border-bottom: 1px solid rgb(224, 224, 225);" class "hljs-class" "box-sizing: border-box;" class "hljs-keyword" "box-sizing: border-box; color: rgb(51, 51, 51); font-weight: 700;" class class "hljs-title" "box-sizing: border-box; color: rgb(68, 85, 136); font-weight: 700;" class "hljs-params" "box-sizing: border-box;" object class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" """ Stores info about Users """ class "hljs-function" "box-sizing: border-box;" class "hljs-keyword" "box-sizing: border-box; color: rgb(51, 51, 51); font-weight: 700;" class "hljs-title" "box-sizing: border-box; color: rgb(153, 0, 0); font-weight: 700;" __ __ class "hljs-params" "box-sizing: border-box;" class "hljs-function" "box-sizing: border-box;" class "hljs-keyword" "box-sizing: border-box; color: rgb(51, 51, 51); font-weight: 700;" class "hljs-title" "box-sizing: border-box; color: rgb(153, 0, 0); font-weight: 700;" _ class "hljs-params" "box-sizing: border-box;" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" """ Send an email to our user""" class "hljs-keyword" "box-sizing: border-box; color: rgb(51, 51, 51); font-weight: 700;" class "hljs-function" "box-sizing: border-box;" class "hljs-keyword" "box-sizing: border-box; color: rgb(51, 51, 51); font-weight: 700;" class "hljs-title" "box-sizing: border-box; color: rgb(153, 0, 0); font-weight: 700;" __ __ class "hljs-params" "box-sizing: border-box;" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" """Logic to properly format data""" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'Bill' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'bill @ gmail.com' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" '123 Acme Dr.' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'secret-password' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'http: // www.bill.com' _ Such a class could have all kinds of features, and developers could argue over the whether to use the new @dataclass feature, or whether we want class or instance methods, etc., but with a dictionary, there is less overhead: bill = { : , : , : , : } def send_email (user_dict) : pass send_email(bill[ ]) send_email(bill. ( )) class "Python hljs livecodeserver" "box-sizing: border-box; font-size: 1.75rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51, 51); background: rgb(248, 248, 248); border-radius: 0px; line-height: 25px; padding: 0.5em 16rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0px; display: block; overflow-x: auto; border-top: 1px solid rgb(224, 224, 225); border-bottom: 1px solid rgb(224, 224, 225);" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'email' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'bill@gmail.com' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'address' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" '123 Acme Dr.' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'password' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'secret-password' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'url' class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'http://www.bill.com' class "hljs-function" "box-sizing: border-box;" class "hljs-keyword" "box-sizing: border-box; color: rgb(51, 51, 51); font-weight: 700;" class "hljs-title" "box-sizing: border-box; color: rgb(153, 0, 0); font-weight: 700;" class "hljs-params" "box-sizing: border-box;" class "hljs-keyword" "box-sizing: border-box; color: rgb(51, 51, 51); font-weight: 700;" class "hljs-comment" "box-sizing: border-box; color: rgb(153, 153, 136); font-style: italic;" # smtp email logic … class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'email' class "hljs-comment" "box-sizing: border-box; color: rgb(153, 153, 136); font-style: italic;" # bracket notation or … get class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" 'email' class "hljs-comment" "box-sizing: border-box; color: rgb(153, 153, 136); font-style: italic;" # .get() method is handy, too Now we can have bill’s data as intuitively as we would we a Bill object, along with half the code. Iterating through Data Stored in Dictionaries Because JSON responses are often lists of dictionaries (perhaps parsed form an API response to generate a list of User instances,) we can iterate through this to create some User instances. json_response = [{ : , : , : , : , : }, { : , : , : , : , : }, { : , : , : , : , : }] class "Python hljs livecodeserver" "box-sizing: border-box; font-size: 1.75rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51, 51); background: rgb(248, 248, 248); border-radius: 0px; line-height: 25px; padding: 0.5em 16rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0px; display: block; overflow-x: auto; border-top: 1px solid rgb(224, 224, 225); border-bottom: 1px solid rgb(224, 224, 225);" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "id" class "hljs-number" "box-sizing: border-box; color: teal;" 1 class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "first_name" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "Florentia" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "last_name" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "Schelle" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "email" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "fschelle0@nyu.edu" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "url" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "https://wired.com" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "id" class "hljs-number" "box-sizing: border-box; color: teal;" 2 class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "first_name" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "Montague" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "last_name" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "McAteer" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "email" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "mmcateer1@zdnet.com" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "url" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "https://domainmarket.com" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "id" class "hljs-number" "box-sizing: border-box; color: teal;" 3 class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "first_name" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "Dav" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "last_name" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "Yurin" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "email" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "dyurin2@e-recht24.de" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "url" class "hljs-string" "box-sizing: border-box; color: rgb(221, 17, 68);" "http://wufoo.com" Notice the natural structure of dictionaries as rows of data. We can easily iterate through these rows to create our User objects. users = [] i json_response: users.append(User( name=i + i , email = i , url=i , # ... )) class "Python hljs livecodeserver" "box-sizing: border-box; font-size: 1.75rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51, 51); background: rgb(248, 248, 248); border-radius: 0px; line-height: 25px; padding: 0.5em 16rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0px; display: block; overflow-x: auto; border-top: 1px solid rgb(224, 224, 225); border-bottom: 1px solid rgb(224, 224, 225);" class "hljs-keyword" "box-sizing: border-box; color: rgb(51, 51, 51); font-weight: 700;" for class "hljs-keyword" "box-sizing: border-box; color: rgb(51, 51, 51); font-weight: 700;" in [ 'first_name' ] [ 'last_name' ] [ 'email' ] [ 'url' ] class "hljs-comment" "box-sizing: border-box; color: rgb(153, 153, 136); font-style: italic;" Dictionaries as Nested Data Structures Compared to lists, Python dictionaries may seem at first to be rigid and unforgiving: a veritable soup of colons and brackets. However, compared to data stored in a relational database (where values must comply to specific constraints in order to make relationships possible), dictionaries are extremely flexible. For one thing, a value in a dictionary can be any python object, and collections of objects are often instantiated with values from a dictionary. Values are related to other values by simply “attaching” them. That is, placing one value in a list or dictionary, with the first value as the key. Although a dictionary created this way may seem complex, it’s actually far simpler to pull specific values out of a dictionary than to write a SQL query. Because of their structure, Python dictionaries are a good way of understanding other nested data structures (like JSON or XML) – which are often referred to as non-relational, encompassing everything but relational databases like MySQL, PostgreSQL, as well as others. The advantage of less rigid structures is that specific values are easily accessible. The disadvantage is that sets of values on a corresponding “level” of nesting under other keys are more difficult to relate to each other, and the resulting code is more verbose. If data naturally falls into columns and rows, then something like a DataFrame or a ndarray would be more appropriate, allowing values to be referenced by their relative location in vector space. Pandas Numpy The Python Home for JSON While there are some subtle differences between Python dictionaries and JSON (JavaScript Object Notation), the similarities between the two data structures are a major bonus for developers consuming data from other sources. In fact, calling the .json() method on a response from the requests library will return a dictionary. Recently, JSON has become the de facto medium for data exchange via an API, with markup languages like XML and YAML trailing by a significant margin. This lead is most likely due to the prevalence of JavaScript, and the need for web services to be able to “speak” JavaScript to other web services. According to some, JSON is simply less work to unpack. Luckily, or perhaps by design, Python lends itself well to consuming JSON via its native data structure: the Python dictionary. That being said, here are some of the differences: While Python developers are used to manipulating Python objects in memory, JSON is a different story. Instead, JSON is a standard for serializing all sorts of data to send like a telegram over HTTP. Once JSON makes it across the wire, it can be deserialized, or loaded into a Python object. Before JSON objects make it into Python logic, they are strings usually sent as a response to an HTTP request, and then parsed in various ways. JSON responses usually look like lists of dictionaries surrounded by quotes. Conveniently, lists of dictionaries can be easily parsed into even more useful objects like Pandas DataFrames (Pandas is a powerful data analysis tool for Python). Whenever loading and dumping (serializing) JSON objects, at some point they will become strings in Python. Python dictionary keys must be unique. In other words, some_dictionary.keys() will be a set of unique values. This is not the case for JSON – which is a bit unusual as it seems to defeat the purpose of keys in the first place – but no one ever said JSON was pythoic. Duplicate keys must be explicitly handled when converting JSON to a Python object, or only one key-value pair will make it through.Want to Code ?Kite is a plugin for PyCharm, Atom, Vim, VSCode, Sublime Text, and IntelliJ that uses machine learning to provide you with code completions in real time sorted by relevance. .Download Kite Free JSON is for Serialization JSON can be a String Duplicate Keys Faster Start coding faster today Pitfalls and Dictionary-like Alternatives Dictionaries are incredibly useful, but some aspects of the language specification cause dictionaries to seem to misbehave. For example, when iterating through a dictionary, a developer may reference a key-value pair that hasn’t been defined. Instead of returning “None,” the Python dictionary will throw an error and print out a traceback, halting execution entirely if the error is not handled. This behavior can slow the development cycle. &gt;&gt;&gt; (my_dict['my_key']) Traceback (most recent call ): File hljs-tag -sizing: - ; : navy; -weight: ; hljs-name -sizing: - ; : navy; -weight: ; , line , &lt; module &gt; KeyError: 'my_key' "html hljs xml" style "box-sizing: border-box; font-size: 1.75rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51, 51); background: rgb(248, 248, 248); border-radius: 0px; line-height: 25px; padding: 0.5em 16rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0px; display: block; overflow-x: auto; border-top: 1px solid rgb(224, 224, 225); border-bottom: 1px solid rgb(224, 224, 225);" print last " &lt; input &gt; " 1 in "hljs-tag" style "box-sizing: border-box; color: navy; font-weight: 400;" "hljs-name" style "box-sizing: border-box; color: navy; font-weight: 400;" Since a program may often just need to “check” for the existence of a key-value pair without throwing an error, a developer has other options. The first is to import the object from the collections module, a handy override automatically populated with default values. Rather than showing an error, the default value is returned. defaultdict Secondly, the .get() method on a standard dictionary may return any value passed as the second argument. So, instead of bracket notation, referencing a value looks like … just_checking = my_dict.get( class "Python hljs livecodeserver" "box-sizing: border-box; font-size: 1.75rem; font-family: &quot;Input Sans Narrow&quot;; color: rgb(51, 51, 51); background: rgb(248, 248, 248); border-radius: 0px; line-height: 25px; padding: 0.5em 16rem; white-space: pre; font-feature-settings: &quot;zero&quot;; letter-spacing: 0px; display: block; overflow-x: auto; border-top: 1px solid rgb(224, 224, 225); border-bottom: 1px solid rgb(224, 224, 225);" 'my_key’, None) span class "hljs-string" style "box-sizing: border-box; color: rgb(221, 17, 68);" span &gt;&gt;&gt; print(just_checking) span class "hljs-string" style "box-sizing: border-box; color: rgb(221, 17, 68);" span None span class "hljs-string" style "box-sizing: border-box; color: rgb(221, 17, 68);" span code Much better! OrderedDict Dictionaries are defined as “unordered” collections of key-value pairs, which can be inconvenient. To add ordered behavior, we have the , also from the collections module. As the name implies, an OrderedDict maintains returns pairs in the order they are defined. OrderedDict While not as lightweight as the standard dictionary, many developers prefer to use OrderedDict, as it behaves in a more predictable way. When iterating through a standard dictionary, the key-value pairs will be returned in a random order. An OrderedDict always returns pairs in the same order, which can be helpful when looking for specific pairs in a large dataset. Proponents of defaultdict and OrderedDict don’t ask “Why?” – they ask “Why not?” Performance Considerations Are you seeing poor performance in your Python application? Stop iterating through lists, and start referencing values in a dictionary. Technically, the function of a dictionary could be emulated with the use of lists. Creating key-value pairs with lists is often an introductory programming exercise. However, it’s critical to a high-level language like Python to have a high-performing implementation. One reason is that dictionaries are used internally by the Python language implementation itself. Another reason is that dictionaries perform exponentially faster than a list. In a Python list, to locate a specific item, each item must be checked until a match is found. With a dictionary, the only item that’s checked is the item (or object, or collection), that is associated with the specific key. This has the effect of dramatically improving performance, often by orders of magnitude. Where to Go From Here… The best way to get to know dictionaries is to get some practice! Try iterating through dictionaries, storing the keys and values in separate lists, and then re-assigning them to each other in the proper order. Try creating interesting series of objects from dictionaries, and dictionaries from objects. If you had to store 1,000 rows of data in a dictionary, what my be a good Python pattern to approach the problem? Before running to stack exchange, think about the nature of a dictionary. Are the keys unique values, or can they be repeated? If they are unique, what type of Python collection could best store the values? Now, try searching for the canonical solutions. Of course, don’t forget to check out the official Python documentation on dictionaries: https://docs.python.org/3/tutorial/datastructures.html The Python dictionary is a fundamental data structure in Python, and is a core component of the Python language specification. When treated with care, dictionaries become high-performance tools for storing and accessing complex data in an explicit, readable, and – most importantly –a pythonic way. This post is a part of Kite’s new series on Python. You can check out the code from this and other posts on our . GitHub repository This article was originally published at . Kite