Contexts and Packages

A typical package written in the Wolfram Language introduces several new symbols intended for use outside the package. These symbols may correspond for example to new functions or new objects defined in the package.

There is a general convention that all new symbols introduced in a particular package are put into a context whose name is related to the name of the package. When you read in the package, it adds this context at the beginning of your context search path $ContextPath.

This reads in a package for proving primality.
In[1]:=
Click for copyable input
The package prepends its context to $ContextPath.
In[2]:=
Click for copyable input
Out[2]=
The symbol is in the context set up by the package.
In[3]:=
Click for copyable input
Out[3]=
You can refer to the symbol using its short name.
In[4]:=
Click for copyable input
Out[4]=

The full names of symbols defined in packages are often quite long. In most cases, however, you will only need to use their short names. The reason for this is that after you have read in a package, its context is added to $ContextPath, so the context is automatically searched whenever you type in a short name.

There is a complication, however, when two symbols with the same short name appear in two different packages. In such a case, the Wolfram Language will warn you when you read in the second package. It will tell you which symbols will be "shadowed" by the new symbols that are being introduced.

The symbol in the context is shadowed by the symbol with the same short name in the new package.
You can access the shadowed symbol by giving its full name.
In[6]:=
Click for copyable input
Out[6]=

Conflicts can occur not only between symbols in different packages, but also between symbols in packages and symbols that you introduce directly in your Wolfram Language session. If you define a symbol in your current context, then this symbol may become shadowed by another symbol with the same short name in packages that you read in. The reason for this is that the Wolfram Language searches for symbols in contexts on the context search path before looking in the current context.

This defines a function in the current context.
In[7]:=
Click for copyable input
Out[7]=
This function considers complex numbers scalars.
In[8]:=
Click for copyable input
Out[8]=
The function in your current context will be shadowed by the one in the package.
The ScalarQ from the package is used.
In[10]:=
Click for copyable input
Out[10]=

If you get into the situation where unwanted symbols are shadowing the symbols you want, the best thing to do is usually to get rid of the unwanted symbols using Remove[s]. An alternative that is sometimes appropriate is to rearrange the entries in $ContextPath and to reset the value of $Context so as to make the contexts that contain the symbols you want be the ones that are searched first.

$Packagesa list of the contexts corresponding to all packages loaded into your Wolfram Language session

Getting a list of packages.