"""
The latest version of this package is available at:
<http://github.com/jantman/jiveapi>
##################################################################################
Copyright 2017 Jason Antman <jason@jasonantman.com> <http://www.jasonantman.com>
This file is part of jiveapi, also known as jiveapi.
jiveapi is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
jiveapi is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with jiveapi. If not, see <http://www.gnu.org/licenses/>.
The Copyright and Authors attributions contained herein may not be removed or
otherwise altered, except to add the Author attribution of a contributor to
this work. (Additional Terms pursuant to Section 7b of the AGPL v3)
##################################################################################
While not legally required, I sincerely request that anyone who finds
bugs please submit them at <https://github.com/jantman/jiveapi> or
to me via email, and that you send any contributions or improvements
either as a pull request on GitHub, or to me via email.
##################################################################################
AUTHORS:
Jason Antman <jason@jasonantman.com> <http://www.jasonantman.com>
##################################################################################
"""
import logging
import json
logger = logging.getLogger(__name__)
[docs]def prettyjson(j):
"""
Return pretty-printed JSON.
:param j: object to JSON serialize
:return: pretty-printed JSON serialized version of j
:rtype: str
"""
return json.dumps(j, sort_keys=True, indent=4, separators=(',', ': '))
[docs]def set_log_info(logger):
"""
set logger level to INFO via :py:func:`~.set_log_level_format`.
"""
set_log_level_format(logger, logging.INFO,
'%(asctime)s %(levelname)s:%(name)s:%(message)s')
[docs]def set_log_debug(logger):
"""
set logger level to DEBUG, and debug-level output format,
via :py:func:`~.set_log_level_format`.
"""
set_log_level_format(
logger,
logging.DEBUG,
"%(asctime)s [%(levelname)s %(filename)s:%(lineno)s - "
"%(name)s.%(funcName)s() ] %(message)s"
)