<filename>easy_as_pypi_apppth/app_dirs.py
# This file exists within 'easy-as-pypi-apppth':
#
#   https://github.com/tallybark/easy-as-pypi-apppth#🛣
#
# Copyright © 2018-2020 <NAME>. All rights reserved.
#
# Permission is hereby granted,  free of charge,  to any person obtaining a
# copy of this software and associated documentation files (the "Software"),
# to deal in the Software without restriction, including without limitation
# the rights to use, copy, modify, merge,  publish,  distribute, sublicense,
# and/or  sell copies  of the Software,  and to permit persons  to whom the
# Software  is  furnished  to do so,  subject  to  the following conditions:
#
# The  above  copyright  notice  and  this  permission  notice  shall  be
# included  in  all  copies  or  substantial  portions  of  the  Software.
#
# THE  SOFTWARE  IS  PROVIDED  "AS IS",  WITHOUT  WARRANTY  OF ANY KIND,
# EXPRESS OR IMPLIED,  INCLUDING  BUT NOT LIMITED  TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE  FOR ANY
# CLAIM,  DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,
# TORT OR OTHERWISE,  ARISING FROM,  OUT OF  OR IN  CONNECTION WITH THE
# SOFTWARE   OR   THE   USE   OR   OTHER   DEALINGS  IN   THE  SOFTWARE.

from .app_dirs_with_mkdir import AppDirsWithMkdir

__all__ = (
    'register_application',
)


def register_application(package_name):
    """Registers appname for future uses of AppDirsWithMkdir."""
    # This should be the first time this class is instantiated,
    # because it's a singleton. Otherwise, the constructor will
    # raise on it having already been called.
    new_singleton = AppDirsWithMkdir(appname=package_name)
    return new_singleton


<filename>easy_as_pypi_apppth/app_dirs.py
# This file exists within 'easy-as-pypi-apppth':
#
#   https://github.com/tallybark/easy-as-pypi-apppth#🛣
#
# Copyright © 2018-2020 <NAME>. All rights reserved.
#
# Permission is hereby granted,  free of charge,  to any person obtaining a
# copy of this software and associated documentation files (the "Software"),
# to deal in the Software without restriction, including without limitation
# the rights to use, copy, modify, merge,  publish,  distribute, sublicense,
# and/or  sell copies  of the Software,  and to permit persons  to whom the
# Software  is  furnished  to do so,  subject  to  the following conditions:
#
# The  above  copyright  notice  and  this  permission  notice  shall  be
# included  in  all  copies  or  substantial  portions  of  the  Software.
#
# THE  SOFTWARE  IS  PROVIDED  "AS IS",  WITHOUT  WARRANTY  OF ANY KIND,
# EXPRESS OR IMPLIED,  INCLUDING  BUT NOT LIMITED  TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE  FOR ANY
# CLAIM,  DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,
# TORT OR OTHERWISE,  ARISING FROM,  OUT OF  OR IN  CONNECTION WITH THE
# SOFTWARE   OR   THE   USE   OR   OTHER   DEALINGS  IN   THE  SOFTWARE.

from .app_dirs_with_mkdir import AppDirsWithMkdir

__all__ = (
    'register_application',
)


def register_application(package_name):
    """Registers appname for future uses of AppDirsWithMkdir."""
    # This should be the first time this class is instantiated,
    # because it's a singleton. Otherwise, the constructor will
    # raise on it having already been called.
    new_singleton = AppDirsWithMkdir(appname=package_name)
    return new_singleton


# This file exists within 'easy-as-pypi-apppth': # #   https://github.com/tallybark/easy-as-pypi-apppth#🛣 # # Copyright © 2018-2020 <NAME>. All rights reserved. # # Permission is hereby granted,  free of charge,  to any person obtaining a # copy of this software and associated documentation files (the "Software"), # to deal in the Software without restriction, including without limitation # the rights to use, copy, modify, merge,  publish,  distribute, sublicense, # and/or  sell copies  of the Software,  and to permit persons  to whom the # Software  is  furnished  to do so,  subject  to  the following conditions: # # The  above  copyright  notice  and  this  permission  notice  shall  be # included  in  all  copies  or  substantial  portions  of  the  Software. # # THE  SOFTWARE  IS  PROVIDED  "AS IS",  WITHOUT  WARRANTY  OF ANY KIND, # EXPRESS OR IMPLIED,  INCLUDING  BUT NOT LIMITED  TO THE WARRANTIES OF # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. # IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE  FOR ANY # CLAIM,  DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT, # TORT OR OTHERWISE,  ARISING FROM,  OUT OF  OR IN  CONNECTION WITH THE # SOFTWARE   OR   THE   USE   OR   OTHER   DEALINGS  IN   THE  SOFTWARE. Registers appname for future uses of AppDirsWithMkdir. # This should be the first time this class is instantiated, # because it's a singleton. Otherwise, the constructor will # raise on it having already been called.