docs: def token(self):
          """ returns the token for the site """
          if self._token is None or \
             datetime.datetime.now() >= self._token_expires_on:
              if self._referer_url is None:
                  self._generateForTokenSecurity(username=self._username,
                                             password=self._password,
                                             tokenUrl=self._token_url)
              else:
                  self._generateForTokenSecurity(username=self._username,
                                                 password=self._password,
                                                 tokenUrl=self._token_url,
                                                 client="referer")
          return self._token