From nobody Fri Dec 30 09:11:17 2022 X-Original-To: dev-commits-ports-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4NjzyY6Pkfz2kdHW; Fri, 30 Dec 2022 09:11:17 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4NjzyY5bPlz44Dv; Fri, 30 Dec 2022 09:11:17 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1672391477; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=p3PiRlbelFB4qYJiUCN30GItnrD8KPcr5dSdHj+ikDA=; b=Llb+MW4yWb27uIf0L4AkDylgzIRHvirZUi4rvQyCqtMoCkaWg16POEzp/zuz3QNeanZ4Jt OGlfhqEwxGLU57+llfpxjbVYESEuN+XSy2OCwzH3tk04Y8UqTkfSBydCGdZYzRvQrk3vgZ jwzvARSwHBAq14HyQwQ7clrSZFxTGDzO46m8QCjaTmQokAO+Wo04F55Y4dSsjn4POaGFUp A3dMK6UcwCGh6c/suESBtbeSt4mR6MvpeJe111fIRugQdDvqlS35IQBKuEK9rBslJQl8r2 eLrhBmAqU4lkvo/spCjGFspU01sGYbyA1Hkb/j7pgAFIrzwjTirAbXBy+IuL3g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1672391477; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=p3PiRlbelFB4qYJiUCN30GItnrD8KPcr5dSdHj+ikDA=; b=E/xfrJm1qwt6RPcmrP5E8gLCCuRBGMSypmyW+lXpXTSleITCtzXNivugr6hEnphvIHkcLY +WNyGI/PrVYg/0BnkwAmYhLGjiukDjRL+0GaySLD7SnC92xllM3wBWZYXKMHfaNZu2jVjh LiG8+3HW3Xvi58YNHqabt8oWmzhfG65rNBYcCWgmD1rwJ4l+fc+c11I08kwLS0KbAlJKZH DI6X/6+TkBtLMy0hXM/t6UWRA8BxVoFbAd02oUvw79aXhX6lc+HBCpIge4rHnpIUJ/t7Ky PvGdkF57y5M8wvrL6ndQRE7mSD7TI+6LgBVg9ztqwGmgL8GiMrRJBw8+NANKOg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1672391477; a=rsa-sha256; cv=none; b=W6waIhhFAyHYiuyc+lsiHfbScKDIFLdYEOWuA/S0sFHx9iun2cIX95ijJyPCJG3ev7qyS0 FNo2rz2AsoAqhyc9KhahSc+s1bmx5spnMogl2L+PnSthvXTRuD/Y59pr9G8CIUOXaai24C CMUzLU3bQI/sWpVbjBuxLbbCnrPcMUJBzWvIe/uHjqkXTqs/ATciC73hxqJZGnUblHKSpn IvD/f3IWRSntFa/97hLDgMgPP+4Kb4BjmL9wXc9GtuRY7l/iPLVWrJbj7TWF0nqXKIVfl5 jEWwUwvli1GkPb0vFKbjnSRXvUvhHaDhh1bu4TBi7nRUiK0P5w5Cnol7KpOl6w== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4NjzyY4XS5z12m3; Fri, 30 Dec 2022 09:11:17 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 2BU9BHdt013377; Fri, 30 Dec 2022 09:11:17 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2BU9BHI8013376; Fri, 30 Dec 2022 09:11:17 GMT (envelope-from git) Date: Fri, 30 Dec 2022 09:11:17 GMT Message-Id: <202212300911.2BU9BHI8013376@gitrepo.freebsd.org> To: ports-committers@FreeBSD.org, dev-commits-ports-all@FreeBSD.org, dev-commits-ports-main@FreeBSD.org From: Po-Chuan Hsieh Subject: git: 2c0b50bd110e - main - devel/py-platformdirs: Update to 2.5.1 List-Id: Commits to the main branch of the FreeBSD ports repository List-Archive: https://lists.freebsd.org/archives/dev-commits-ports-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-ports-main@freebsd.org X-BeenThere: dev-commits-ports-main@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: sunpoet X-Git-Repository: ports X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2c0b50bd110e1d2bbec44b9579a76fd748866c9a Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by sunpoet: URL: https://cgit.FreeBSD.org/ports/commit/?id=2c0b50bd110e1d2bbec44b9579a76fd748866c9a commit 2c0b50bd110e1d2bbec44b9579a76fd748866c9a Author: Po-Chuan Hsieh AuthorDate: 2022-12-30 08:43:02 +0000 Commit: Po-Chuan Hsieh CommitDate: 2022-12-30 09:04:48 +0000 devel/py-platformdirs: Update to 2.5.1 - Update LICENSE_FILE Changes: https://github.com/platformdirs/platformdirs/releases https://github.com/platformdirs/platformdirs/blob/main/CHANGES.rst --- devel/py-platformdirs/Makefile | 5 ++--- devel/py-platformdirs/distinfo | 6 +++--- devel/py-platformdirs/files/setup.py | 23 ++++++++++++----------- 3 files changed, 17 insertions(+), 17 deletions(-) diff --git a/devel/py-platformdirs/Makefile b/devel/py-platformdirs/Makefile index b3be0470c1a6..c9fc572b9a08 100644 --- a/devel/py-platformdirs/Makefile +++ b/devel/py-platformdirs/Makefile @@ -1,6 +1,5 @@ PORTNAME= platformdirs -PORTVERSION= 2.5.2 -PORTREVISION= 1 +PORTVERSION= 2.5.4 CATEGORIES= devel python MASTER_SITES= CHEESESHOP PKGNAMEPREFIX= ${PYTHON_PKGNAMEPREFIX} @@ -10,7 +9,7 @@ COMMENT= Python module for determining appropriate platform-specific dirs WWW= https://github.com/platformdirs/platformdirs LICENSE= MIT -LICENSE_FILE= ${WRKSRC}/LICENSE.txt +LICENSE_FILE= ${WRKSRC}/LICENSE USES= python:3.7+ USE_PYTHON= autoplist concurrent distutils diff --git a/devel/py-platformdirs/distinfo b/devel/py-platformdirs/distinfo index f3059c928284..6f98a5b836fe 100644 --- a/devel/py-platformdirs/distinfo +++ b/devel/py-platformdirs/distinfo @@ -1,3 +1,3 @@ -TIMESTAMP = 1650970123 -SHA256 (platformdirs-2.5.2.tar.gz) = 58c8abb07dcb441e6ee4b11d8df0ac856038f944ab98b7be6b27b2a3c7feef19 -SIZE (platformdirs-2.5.2.tar.gz) = 22529 +TIMESTAMP = 1669057815 +SHA256 (platformdirs-2.5.4.tar.gz) = 1006647646d80f16130f052404c6b901e80ee4ed6bef6792e1f238a8969106f7 +SIZE (platformdirs-2.5.4.tar.gz) = 20843 diff --git a/devel/py-platformdirs/files/setup.py b/devel/py-platformdirs/files/setup.py index ca7224ada1e2..8b4acb24c1e3 100644 --- a/devel/py-platformdirs/files/setup.py +++ b/devel/py-platformdirs/files/setup.py @@ -4,8 +4,8 @@ from setuptools import setup setup( name='platformdirs', version='%%PORTVERSION%%', - description='A small Python module for determining appropriate platform-specific dirs, e.g. a "user data dir".', - long_description='The problem\n===========\n\n.. image:: https://github.com/platformdirs/platformdirs/workflows/Test/badge.svg\n :target: https://github.com/platformdirs/platformdirs/actions?query=workflow%3ATest\n\nWhen writing desktop application, finding the right location to store user data\nand configuration varies per platform. Even for single-platform apps, there\nmay by plenty of nuances in figuring out the right location.\n\nFor example, if running on macOS, you should use::\n\n ~/Library/Application Support/\n\nIf on Windows (at least English Win XP) that should be::\n\n C:\\Documents and Settings\\\\Application Data\\Local Settings\\\\\n\nor possibly::\n\n C:\\Documents and Settings\\\\Application Data\\\\\n\nfor `roaming profiles `_ but that is another story.\n\nOn Linux (and other Unices), accordin g to the `XDG Basedir Spec`_, it should be::\n\n ~/.local/share/\n\n.. _XDG Basedir Spec: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html\n\n``platformdirs`` to the rescue\n==============================\n\nThis kind of thing is what the ``platformdirs`` module is for.\n``platformdirs`` will help you choose an appropriate:\n\n- user data dir (``user_data_dir``)\n- user config dir (``user_config_dir``)\n- user cache dir (``user_cache_dir``)\n- site data dir (``site_data_dir``)\n- site config dir (``site_config_dir``)\n- user log dir (``user_log_dir``)\n- user documents dir (``user_documents_dir``)\n- user runtime dir (``user_runtime_dir``)\n\nAnd also:\n\n- Is a single module so other Python packages can vendor their own private copy.\n- Is slightly opinionated on the directory names used. Look for "OPINION" in\n documentation and code for when an opinion is being applied.\n\nExample output\n==============\n\nOn macOS:\n\n.. code-block:: pyco n\n\n >>> from platformdirs import *\n ! >>> appname = "SuperApp"\n >>> appauthor = "Acme"\n >>> user_data_dir(appname, appauthor)\n \'/Users/trentm/Library/Application Support/SuperApp\'\n >>> site_data_dir(appname, appauthor)\n \'/Library/Application Support/SuperApp\'\n >>> user_cache_dir(appname, appauthor)\n \'/Users/trentm/Library/Caches/SuperApp\'\n >>> user_log_dir(appname, appauthor)\n \'/Users/trentm/Library/Logs/SuperApp\'\n >>> user_documents_dir()\n \'/Users/trentm/Documents\'\n >>> user_runtime_dir(appname, appauthor)\n \'/Users/trentm/Library/Caches/TemporaryItems/SuperApp\'\n\nOn Windows 7:\n\n.. code-block:: pycon\n\n >>> from platformdirs import *\n >>> appname = "SuperApp"\n >>> appauthor = "Acme"\n >>> user_data_dir(appname, appauthor)\n \'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Acme\\\\SuperApp\'\n >>> user_data_dir(appname, appauthor, roaming=True)\n \'C:\\\\Users\\\\trentm\\\\AppData\\\\Roaming\\\\Acme\\\\SuperApp\'\n >>> user_cache _dir(appname, appauthor)\n \'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Acme\\\\SuperApp\\\\Cache\'\n >>> user_log_dir(appname, appauthor)\n \'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Acme\\\\SuperApp\\\\Logs\'\n >>> user_documents_dir()\n \'C:\\\\Users\\\\trentm\\\\Documents\'\n >>> user_runtime_dir(appname, appauthor)\n \'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Temp\\\\Acme\\\\SuperApp\'\n\nOn Linux:\n\n.. code-block:: pycon\n\n >>> from platformdirs import *\n >>> appname = "SuperApp"\n >>> appauthor = "Acme"\n >>> user_data_dir(appname, appauthor)\n \'/home/trentm/.local/share/SuperApp\'\n >>> site_data_dir(appname, appauthor)\n \'/usr/local/share/SuperApp\'\n >>> site_data_dir(appname, appauthor, multipath=True)\n \'/usr/local/share/SuperApp:/usr/share/SuperApp\'\n >>> user_cache_dir(appname, appauthor)\n \'/home/trentm/.cache/SuperApp\'\n >>> user_log_dir(appname, appauthor)\n \'/home/trentm/.cache/SuperApp /log\'\n >>> user_config_dir(appname)\n ! \'/home! /trentm/..config/SuperApp\'\n >>> user_documents_dir()\n \'/home/trentm/Documents\'\n >>> user_runtime_dir(appname, appauthor)\n \'/run/user/{os.getuid()}/SuperApp\'\n >>> site_config_dir(appname)\n \'/etc/xdg/SuperApp\'\n >>> os.environ["XDG_CONFIG_DIRS"] = "/etc:/usr/local/etc"\n >>> site_config_dir(appname, multipath=True)\n \'/etc/SuperApp:/usr/local/etc/SuperApp\'\n\nOn Android::\n\n >>> from platformdirs import *\n >>> appname = "SuperApp"\n >>> appauthor = "Acme"\n >>> user_data_dir(appname, appauthor)\n \'/data/data/com.myApp/files/SuperApp\'\n >>> user_cache_dir(appname, appauthor)\n \'/data/data/com.myApp/cache/SuperApp\'\n >>> user_log_dir(appname, appauthor)\n \'/data/data/com.myApp/cache/SuperApp/log\'\n >>> user_config_dir(appname)\n \'/data/data/com.myApp/shared_prefs/SuperApp\'\n >>> user_documents_dir()\n \'/storage/emulated/0/Documents\'\n >>> user_runtime_dir(appname, appauthor)\n \'/data/data /com.myApp/cache/SuperApp/tmp\'\n\nNote: Some android apps like Termux and Pydroid are used as shells. These\napps are used by the end user to emulate Linux environment. Presence of\n``SHELL`` environment variable is used by Platformdirs to differentiate\nbetween general android apps and android apps used as shells. Shell android\napps also support ``XDG_*`` environment variables.\n\n\n``PlatformDirs`` for convenience\n================================\n\n.. code-block:: pycon\n\n >>> from platformdirs import PlatformDirs\n >>> dirs = PlatformDirs("SuperApp", "Acme")\n >>> dirs.user_data_dir\n \'/Users/trentm/Library/Application Support/SuperApp\'\n >>> dirs.site_data_dir\n \'/Library/Application Support/SuperApp\'\n >>> dirs.user_cache_dir\n \'/Users/trentm/Library/Caches/SuperApp\'\n >>> dirs.user_log_dir\n \'/Users/trentm/Library/Logs/SuperApp\'\n >>> dirs.user_documents_dir\n \'/Users/trentm/Documents\'\n >>> dirs.user_runtime_dir\n \'/Us ers/trentm/Library/Caches/TemporaryItems/Sup! erApp\'\n\! nPer-version isolation\n=====================\n\nIf you have multiple versions of your app in use that you want to be\nable to run side-by-side, then you may want version-isolation for these\ndirs::\n\n >>> from platformdirs import PlatformDirs\n >>> dirs = PlatformDirs("SuperApp", "Acme", version="1.0")\n >>> dirs.user_data_dir\n \'/Users/trentm/Library/Application Support/SuperApp/1.0\'\n >>> dirs.site_data_dir\n \'/Library/Application Support/SuperApp/1.0\'\n >>> dirs.user_cache_dir\n \'/Users/trentm/Library/Caches/SuperApp/1.0\'\n >>> dirs.user_log_dir\n \'/Users/trentm/Library/Logs/SuperApp/1.0\'\n >>> dirs.user_documents_dir\n \'/Users/trentm/Documents\'\n >>> dirs.user_runtime_dir\n \'/Users/trentm/Library/Caches/TemporaryItems/SuperApp/1.0\'\n\nBe wary of using this for configuration files though; you\'ll need to handle\nmigrating configuration files manually.\n\nWhy this Fork?\n==============\n\nThis repository is a friendly fork of the wonderful work started by\n`ActiveState `_ who created\n``appdirs``, this package\'s ancestor.\n\nMaintaining an open source project is no easy task, particularly\nfrom within an organization, and the Python community is indebted\nto ``appdirs`` (and to Trent Mick and Jeff Rouse in particular) for\ncreating an incredibly useful simple module, as evidenced by the wide\nnumber of users it has attracted over the years.\n\nNonetheless, given the number of long-standing open issues\nand pull requests, and no clear path towards `ensuring\nthat maintenance of the package would continue or grow\n`_, this fork was\ncreated.\n\nContributions are most welcome.\n', + description='A small Python package for determining appropriate platform-specific dirs, e.g. a "user data dir".', + long_description='The problem\n===========\n\n.. image:: https://github.com/platformdirs/platformdirs/workflows/Test/badge.svg\n :target: https://github.com/platformdirs/platformdirs/actions?query=workflow%3ATest\n\nWhen writing desktop application, finding the right location to store user data\nand configuration varies per platform. Even for single-platform apps, there\nmay by plenty of nuances in figuring out the right location.\n\nFor example, if running on macOS, you should use::\n\n ~/Library/Application Support/\n\nIf on Windows (at least English Win XP) that should be::\n\n C:\\Documents and Settings\\\\Application Data\\Local Settings\\\\\n\nor possibly::\n\n C:\\Documents and Settings\\\\Application Data\\\\\n\nfor `roaming profiles `_ but that is another story.\n\nOn Linux (and other Unices), accordin g to the `XDG Basedir Spec`_, it should be::\n\n ~/.local/share/\n\n.. _XDG Basedir Spec: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html\n\n``platformdirs`` to the rescue\n==============================\n\nThis kind of thing is what the ``platformdirs`` package is for.\n``platformdirs`` will help you choose an appropriate:\n\n- user data dir (``user_data_dir``)\n- user config dir (``user_config_dir``)\n- user cache dir (``user_cache_dir``)\n- site data dir (``site_data_dir``)\n- site config dir (``site_config_dir``)\n- user log dir (``user_log_dir``)\n- user documents dir (``user_documents_dir``)\n- user runtime dir (``user_runtime_dir``)\n\nAnd also:\n\n- Is slightly opinionated on the directory names used. Look for "OPINION" in\n documentation and code for when an opinion is being applied.\n\nExample output\n==============\n\nOn macOS:\n\n.. code-block:: pycon\n\n >>> from platformdirs import *\n >>> appname = "SuperApp"\n >>> ap pauthor = "Acme"\n >>> user_data_dir(appn! ame, appauthor)\n \'/Users/trentm/Library/Application Support/SuperApp\'\n >>> site_data_dir(appname, appauthor)\n \'/Library/Application Support/SuperApp\'\n >>> user_cache_dir(appname, appauthor)\n \'/Users/trentm/Library/Caches/SuperApp\'\n >>> user_log_dir(appname, appauthor)\n \'/Users/trentm/Library/Logs/SuperApp\'\n >>> user_documents_dir()\n \'/Users/trentm/Documents\'\n >>> user_runtime_dir(appname, appauthor)\n \'/Users/trentm/Library/Caches/TemporaryItems/SuperApp\'\n\nOn Windows 7:\n\n.. code-block:: pycon\n\n >>> from platformdirs import *\n >>> appname = "SuperApp"\n >>> appauthor = "Acme"\n >>> user_data_dir(appname, appauthor)\n \'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Acme\\\\SuperApp\'\n >>> user_data_dir(appname, appauthor, roaming=True)\n \'C:\\\\Users\\\\trentm\\\\AppData\\\\Roaming\\\\Acme\\\\SuperApp\'\n >>> user_cache_dir(appname, appauthor)\n \'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Acme \\\\SuperApp\\\\Cache\'\n >>> user_log_dir(appname, appauthor)\n \'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Acme\\\\SuperApp\\\\Logs\'\n >>> user_documents_dir()\n \'C:\\\\Users\\\\trentm\\\\Documents\'\n >>> user_runtime_dir(appname, appauthor)\n \'C:\\\\Users\\\\trentm\\\\AppData\\\\Local\\\\Temp\\\\Acme\\\\SuperApp\'\n\nOn Linux:\n\n.. code-block:: pycon\n\n >>> from platformdirs import *\n >>> appname = "SuperApp"\n >>> appauthor = "Acme"\n >>> user_data_dir(appname, appauthor)\n \'/home/trentm/.local/share/SuperApp\'\n >>> site_data_dir(appname, appauthor)\n \'/usr/local/share/SuperApp\'\n >>> site_data_dir(appname, appauthor, multipath=True)\n \'/usr/local/share/SuperApp:/usr/share/SuperApp\'\n >>> user_cache_dir(appname, appauthor)\n \'/home/trentm/.cache/SuperApp\'\n >>> user_log_dir(appname, appauthor)\n \'/home/trentm/.cache/SuperApp/log\'\n >>> user_config_dir(appname)\n \'/home/trentm/.config/SuperApp\'\n >>> user_documents_dir()\n \'/home/tr! entm/Docu! ments\'\n >>> user_runtime_dir(appname, appauthor)\n \'/run/user/{os.getuid()}/SuperApp\'\n >>> site_config_dir(appname)\n \'/etc/xdg/SuperApp\'\n >>> os.environ["XDG_CONFIG_DIRS"] = "/etc:/usr/local/etc"\n >>> site_config_dir(appname, multipath=True)\n \'/etc/SuperApp:/usr/local/etc/SuperApp\'\n\nOn Android::\n\n >>> from platformdirs import *\n >>> appname = "SuperApp"\n >>> appauthor = "Acme"\n >>> user_data_dir(appname, appauthor)\n \'/data/data/com.myApp/files/SuperApp\'\n >>> user_cache_dir(appname, appauthor)\n \'/data/data/com.myApp/cache/SuperApp\'\n >>> user_log_dir(appname, appauthor)\n \'/data/data/com.myApp/cache/SuperApp/log\'\n >>> user_config_dir(appname)\n \'/data/data/com.myApp/shared_prefs/SuperApp\'\n >>> user_documents_dir()\n \'/storage/emulated/0/Documents\'\n >>> user_runtime_dir(appname, appauthor)\n \'/data/data/com.myApp/cache/SuperApp/tmp\'\n\nNote: Some android apps like Termux and Pydroid are used as shells. These\napps are used by the end user to emulate Linux environment. Presence of\n``SHELL`` environment variable is used by Platformdirs to differentiate\nbetween general android apps and android apps used as shells. Shell android\napps also support ``XDG_*`` environment variables.\n\n\n``PlatformDirs`` for convenience\n================================\n\n.. code-block:: pycon\n\n >>> from platformdirs import PlatformDirs\n >>> dirs = PlatformDirs("SuperApp", "Acme")\n >>> dirs.user_data_dir\n \'/Users/trentm/Library/Application Support/SuperApp\'\n >>> dirs.site_data_dir\n \'/Library/Application Support/SuperApp\'\n >>> dirs.user_cache_dir\n \'/Users/trentm/Library/Caches/SuperApp\'\n >>> dirs.user_log_dir\n \'/Users/trentm/Library/Logs/SuperApp\'\n >>> dirs.user_documents_dir\n \'/Users/trentm/Documents\'\n >>> dirs.user_runtime_dir\n \'/Users/trentm/Library/Caches/TemporaryItems/SuperApp\'\n\nPer-version isolation\n==== =================\n\nIf you have multiple ve! rsions of! your app in use that you want to be\nable to run side-by-side, then you may want version-isolation for these\ndirs::\n\n >>> from platformdirs import PlatformDirs\n >>> dirs = PlatformDirs("SuperApp", "Acme", version="1.0")\n >>> dirs.user_data_dir\n \'/Users/trentm/Library/Application Support/SuperApp/1.0\'\n >>> dirs.site_data_dir\n \'/Library/Application Support/SuperApp/1.0\'\n >>> dirs.user_cache_dir\n \'/Users/trentm/Library/Caches/SuperApp/1.0\'\n >>> dirs.user_log_dir\n \'/Users/trentm/Library/Logs/SuperApp/1.0\'\n >>> dirs.user_documents_dir\n \'/Users/trentm/Documents\'\n >>> dirs.user_runtime_dir\n \'/Users/trentm/Library/Caches/TemporaryItems/SuperApp/1.0\'\n\nBe wary of using this for configuration files though; you\'ll need to handle\nmigrating configuration files manually.\n\nWhy this Fork?\n==============\n\nThis repository is a friendly fork of the wonderful work started by\n`ActiveState `_ who created\n``appdirs``, this package\'s ancestor.\n\nMaintaining an open source project is no easy task, particularly\nfrom within an organization, and the Python community is indebted\nto ``appdirs`` (and to Trent Mick and Jeff Rouse in particular) for\ncreating an incredibly useful simple module, as evidenced by the wide\nnumber of users it has attracted over the years.\n\nNonetheless, given the number of long-standing open issues\nand pull requests, and no clear path towards `ensuring\nthat maintenance of the package would continue or grow\n`_, this fork was\ncreated.\n\nContributions are most welcome.\n', maintainer_email='Bernát Gábor , Julian Berman , Ofek Lev , Ronny Pfannschmidt ', classifiers=[ 'Development Status :: 5 - Production/Stable', @@ -15,32 +15,33 @@ setup( 'Programming Language :: Python', 'Programming Language :: Python :: 3', 'Programming Language :: Python :: 3 :: Only', - 'Programming Language :: Python :: 3.10', 'Programming Language :: Python :: 3.7', 'Programming Language :: Python :: 3.8', 'Programming Language :: Python :: 3.9', + 'Programming Language :: Python :: 3.10', + 'Programming Language :: Python :: 3.11', 'Programming Language :: Python :: Implementation :: CPython', 'Programming Language :: Python :: Implementation :: PyPy', 'Topic :: Software Development :: Libraries :: Python Modules', ], extras_require={ 'docs': [ - 'furo>=2021.7.5b38', - 'proselint>=0.10.2', - 'sphinx-autodoc-typehints>=1.12', - 'sphinx>=4', + 'furo>=2022.9.29', + 'proselint>=0.13', + 'sphinx-autodoc-typehints>=1.19.4', + 'sphinx>=5.3', ], 'test': [ 'appdirs==1.4.4', - 'pytest-cov>=2.7', - 'pytest-mock>=3.6', - 'pytest>=6', + 'pytest-cov>=4', + 'pytest-mock>=3.10', + 'pytest>=7.2', ], }, packages=[ 'platformdirs', ], package_dir={ - 'platformdirs': 'src/platformdirs' + '': 'src' }, )