From b43f5e64f7e31ce1d15f1cd9707c455803f3b3dc Mon Sep 17 00:00:00 2001 From: esoteric-ephemera Date: Mon, 20 Apr 2026 11:50:06 -0700 Subject: [PATCH 1/4] deprec warning --- mpcontribs-client/mpcontribs/client/__init__.py | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/mpcontribs-client/mpcontribs/client/__init__.py b/mpcontribs-client/mpcontribs/client/__init__.py index ea6875915..3d8afe8fd 100644 --- a/mpcontribs-client/mpcontribs/client/__init__.py +++ b/mpcontribs-client/mpcontribs/client/__init__.py @@ -889,6 +889,18 @@ def __init__( project (str): use this project for all operations (query, update, create, delete) session (requests.Session): override session for client to use """ + + logger.warning( + """The `mpcontribs-client` package has been deprecated in favor of the main Materials Project (MP) API client `mp-api`. +To use the MP Contribs client swith up-to-date features, please `pip install 'mp-api[contribs]'`: +```py +from mp_api.client import MPRester + +with MPRester() as mpr: + mpr.contribs.query_contributions(...) +```""" + ) + # NOTE bravado future doesn't work with concurrent.futures # - Kong forwards consumer headers when api-key used for auth # - forward consumer headers when connecting through localhost From d8fd311abf443828f4bd4bb455b0f0ddc5a69d53 Mon Sep 17 00:00:00 2001 From: esoteric-ephemera Date: Mon, 20 Apr 2026 11:56:54 -0700 Subject: [PATCH 2/4] noqanoqa --- mpcontribs-client/mpcontribs/client/__init__.py | 2 ++ 1 file changed, 2 insertions(+) diff --git a/mpcontribs-client/mpcontribs/client/__init__.py b/mpcontribs-client/mpcontribs/client/__init__.py index 3d8afe8fd..d6ccbbea6 100644 --- a/mpcontribs-client/mpcontribs/client/__init__.py +++ b/mpcontribs-client/mpcontribs/client/__init__.py @@ -890,6 +890,7 @@ def __init__( session (requests.Session): override session for client to use """ + # ruff: disable[E501] logger.warning( """The `mpcontribs-client` package has been deprecated in favor of the main Materials Project (MP) API client `mp-api`. To use the MP Contribs client swith up-to-date features, please `pip install 'mp-api[contribs]'`: @@ -900,6 +901,7 @@ def __init__( mpr.contribs.query_contributions(...) ```""" ) + # ruff: enable[E501] # NOTE bravado future doesn't work with concurrent.futures # - Kong forwards consumer headers when api-key used for auth From 8d4f2379053c8faaa10570ac94d8c684a60758e7 Mon Sep 17 00:00:00 2001 From: esoteric-ephemera Date: Mon, 20 Apr 2026 13:05:42 -0700 Subject: [PATCH 3/4] reformat warn --- .../mpcontribs/client/__init__.py | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/mpcontribs-client/mpcontribs/client/__init__.py b/mpcontribs-client/mpcontribs/client/__init__.py index d6ccbbea6..436a5e629 100644 --- a/mpcontribs-client/mpcontribs/client/__init__.py +++ b/mpcontribs-client/mpcontribs/client/__init__.py @@ -890,18 +890,17 @@ def __init__( session (requests.Session): override session for client to use """ - # ruff: disable[E501] logger.warning( - """The `mpcontribs-client` package has been deprecated in favor of the main Materials Project (MP) API client `mp-api`. -To use the MP Contribs client swith up-to-date features, please `pip install 'mp-api[contribs]'`: -```py -from mp_api.client import MPRester - -with MPRester() as mpr: - mpr.contribs.query_contributions(...) -```""" + "The `mpcontribs-client` package has been deprecated " + "in favor of the main Materials Project (MP) API client `mp-api`. " + "To use the MP Contribs client swith up-to-date features, " + "please `pip install 'mp-api[contribs]'`:\n" + "```py\n" + "from mp_api.client import MPRester\n" + "with MPRester() as mpr:\n" + " mpr.contribs.query_contributions(...)\n" + "```" ) - # ruff: enable[E501] # NOTE bravado future doesn't work with concurrent.futures # - Kong forwards consumer headers when api-key used for auth From 2cbe9ffe5c95ce9dec33ae87117bbb6d93783a14 Mon Sep 17 00:00:00 2001 From: esoteric-ephemera Date: Fri, 8 May 2026 13:02:26 -0700 Subject: [PATCH 4/4] correct init warning --- mpcontribs-client/mpcontribs/client/__init__.py | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/mpcontribs-client/mpcontribs/client/__init__.py b/mpcontribs-client/mpcontribs/client/__init__.py index 436a5e629..81383d1b3 100644 --- a/mpcontribs-client/mpcontribs/client/__init__.py +++ b/mpcontribs-client/mpcontribs/client/__init__.py @@ -891,10 +891,10 @@ def __init__( """ logger.warning( - "The `mpcontribs-client` package has been deprecated " - "in favor of the main Materials Project (MP) API client `mp-api`. " - "To use the MP Contribs client swith up-to-date features, " - "please `pip install 'mp-api[contribs]'`:\n" + "The `mpcontribs-client` package is entering long-term maintenance. " + "All new features will be added to the main Materials Project " + "(MP) API client `mp-api`. To use the MP Contribs client with " + "up-to-date features, please `pip install 'mp-api[contribs]'`:\n" "```py\n" "from mp_api.client import MPRester\n" "with MPRester() as mpr:\n"