Feature (issue #75): better ease of use / code cleanliness for supporting the EU service region

CHANGELOG.rst

@@ -1,3 +1,9 @@
+**2026-02-23: 6.2.0: New way of setting base URL + deprecate method in OAuthTokenClient**
+
+* Adds ``base_url`` as a universally-accepted keyword argument to constructors of all clients, and provides a more explicit method of specifying the default base URL for any given client class.
+* Deprecate classmethod in ``get_authorize_url`` in ``OAuthTokenClient``, which cannot be used outside of the commercial AWS partition, in favor of the more flexible instance methods.
+* Add support for two new endpoints in the Jira Cloud Integration API
+
 **2025-11-19: 6.1.0: Add uv and ruff and fix errors and formatting**
 
 This release adopts `uv <https://docs.astral.sh/uv/>`_ as the project's chosen package manager and build tool, and `ruff <https://docs.astral.sh/ruff/>`_ as its chosen linter and formatter.

README.rst

@@ -67,7 +67,7 @@ control over how API calls were made.
 
 License
 -------
-All the code in this distribution is Copyright (c) 2025 PagerDuty.
+All the code in this distribution is Copyright (c) 2026 PagerDuty.
 
 ``python-pagerduty`` is made available under the MIT License:
 

docs/changelog.html

@@ -76,6 +76,12 @@
 
   <section id="changelog">
 <h1>Changelog<a class="headerlink" href="#changelog" title="Link to this heading"></a></h1>
+<p><strong>2026-02-23: 6.2.0: New way of setting base URL + deprecate method in OAuthTokenClient</strong></p>
+<ul class="simple">
+<li><p>Adds <code class="docutils literal notranslate"><span class="pre">base_url</span></code> as a universally-accepted keyword argument to constructors of all clients, and provides a more explicit method of specifying the default base URL for any given client class.</p></li>
+<li><p>Deprecate classmethod in <code class="docutils literal notranslate"><span class="pre">get_authorize_url</span></code> in <code class="docutils literal notranslate"><span class="pre">OAuthTokenClient</span></code>, which cannot be used outside of the commercial AWS partition, in favor of the more flexible instance methods.</p></li>
+<li><p>Add support for two new endpoints in the Jira Cloud Integration API</p></li>
+</ul>
 <p><strong>2025-11-19: 6.1.0: Add uv and ruff and fix errors and formatting</strong></p>
 <p>This release adopts <a class="reference external" href="https://docs.astral.sh/uv/">uv</a> as the project’s chosen package manager and build tool, and <a class="reference external" href="https://docs.astral.sh/ruff/">ruff</a> as its chosen linter and formatter.</p>
 <ul class="simple">
@@ -314,7 +320,7 @@ <h1>Changelog<a class="headerlink" href="#changelog" title="Link to this heading
   <hr/>
 
   <div role="contentinfo">
-    <p>&#169; Copyright 2025 PagerDuty, Inc.</p>
+    <p>&#169; Copyright 2026 PagerDuty, Inc.</p>
   </div>
 
   Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a

docs/contributing.html

@@ -330,7 +330,7 @@ <h3>Publishing<a class="headerlink" href="#publishing" title="Link to this headi
   <hr/>
 
   <div role="contentinfo">
-    <p>&#169; Copyright 2025 PagerDuty, Inc.</p>
+    <p>&#169; Copyright 2026 PagerDuty, Inc.</p>
   </div>
 
   Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a

docs/genindex.html

@@ -176,6 +176,8 @@ <h2 id="D">D</h2>
       <li><a href="module_reference.html#pagerduty.common.datetime_intervals">datetime_intervals() (in module pagerduty.common)</a>
 </li>
       <li><a href="module_reference.html#pagerduty.common.datetime_to_relative_seconds">datetime_to_relative_seconds() (in module pagerduty.common)</a>
+</li>
+      <li><a href="module_reference.html#pagerduty.ApiClient.default_base_url">default_base_url (pagerduty.ApiClient property)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
@@ -406,7 +408,7 @@ <h2 id="P">P</h2>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="module_reference.html#pagerduty.ApiClient.permitted_methods">permitted_methods (pagerduty.ApiClient attribute)</a>
+      <li><a href="module_reference.html#pagerduty.ApiClient.permitted_methods">permitted_methods (pagerduty.ApiClient property)</a>
 </li>
       <li><a href="module_reference.html#pagerduty.RestApiV2Client.persist">persist() (pagerduty.RestApiV2Client method)</a>
 </li>
@@ -566,7 +568,7 @@ <h2 id="W">W</h2>
   <hr/>
 
   <div role="contentinfo">
-    <p>&#169; Copyright 2025 PagerDuty, Inc.</p>
+    <p>&#169; Copyright 2026 PagerDuty, Inc.</p>
   </div>
 
   Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a

docs/index.html

@@ -93,12 +93,12 @@ <h2>Table of Contents<a class="headerlink" href="#table-of-contents" title="Link
 <li class="toctree-l2"><a class="reference internal" href="user_guide.html#installation">Installation</a></li>
 <li class="toctree-l2"><a class="reference internal" href="user_guide.html#command-line-interface">Command Line Interface</a></li>
 <li class="toctree-l2"><a class="reference internal" href="user_guide.html#authentication">Authentication</a><ul>
-<li class="toctree-l3"><a class="reference internal" href="user_guide.html#using-non-us-service-regions">Using Non-US Service Regions</a></li>
 <li class="toctree-l3"><a class="reference internal" href="user_guide.html#the-from-header">The From header</a></li>
 <li class="toctree-l3"><a class="reference internal" href="user_guide.html#performing-an-oauth-exchange-to-obtain-an-access-token">Performing an OAuth Exchange to Obtain an Access Token</a></li>
 <li class="toctree-l3"><a class="reference internal" href="user_guide.html#performing-oauth-token-refresh-automatically">Performing OAuth Token Refresh Automatically</a></li>
 </ul>
 </li>
+<li class="toctree-l2"><a class="reference internal" href="user_guide.html#using-non-us-service-regions">Using Non-US Service Regions</a></li>
 <li class="toctree-l2"><a class="reference internal" href="user_guide.html#basic-usage-examples">Basic Usage Examples</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="user_guide.html#rest-api-v2">REST API v2</a></li>
 <li class="toctree-l3"><a class="reference internal" href="user_guide.html#events-api-v2">Events API v2</a></li>
@@ -253,7 +253,7 @@ <h2>Table of Contents<a class="headerlink" href="#table-of-contents" title="Link
   <hr/>
 
   <div role="contentinfo">
-    <p>&#169; Copyright 2025 PagerDuty, Inc.</p>
+    <p>&#169; Copyright 2026 PagerDuty, Inc.</p>
   </div>
 
   Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a