Advanced¶
Keep your security token secret¶
Be careful not to include your security token when sharing code. A simple way to ensure this doesn’t happen by accident is to store your security token as an environment variable that can be specified in your .bash_profile or .zshrc file:
export CHEMSPIDER_SECURITY_TOKEN=<YOUR-SECURITY-TOKEN>
This can then be retrieved in your scripts using os.environ
:
>>> CST = os.environ['CHEMSPIDER_SECURITY_TOKEN']
>>> cs = ChemSpider(security_token=CST)
Specify a User Agent¶
As well as using your security token, it is possible to identify your program to the ChemSpider servers using a User Agent string.
You can specify a custom User Agent through ChemSpiPy through the optional user_agent
parameter to the ChemSpider
class:
>>> from chemspipy import ChemSpider
>>> cs = ChemSpider('<YOUR-SECURITY-TOKEN>', user_agent='My program 1.3, ChemSpiPy 1.0.4, Python 2.7')
Logging¶
ChemSpiPy can generate logging statements if required. Just set the desired logging level:
import logging
logging.basicConfig(level=logging.DEBUG)
The logger is named ‘chemspipy’. There is more information on logging in the Python logging documentation.