pythonanywhere-core 0.2.7__py3-none-any.whl → 0.2.9__py3-none-any.whl

pythonanywhere_core/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.7"
+__version__ = "0.2.9"

pythonanywhere_core/base.py

@@ -1,8 +1,10 @@
 import os
+import platform
 from typing import Dict
 
 import requests
 
+from pythonanywhere_core import __version__
 from pythonanywhere_core.exceptions import AuthenticationError, NoTokenError
 
 PYTHON_VERSIONS: Dict[str, str] = {
@@ -14,6 +16,7 @@ PYTHON_VERSIONS: Dict[str, str] = {
     "3.11": "python311",
     "3.12": "python312",
     "3.13": "python313",
+    "3.14": "python314",
 }
 
 
@@ -53,17 +56,35 @@ def call_api(url: str, method: str, **kwargs) -> requests.Response:
     :returns: requests.Response object
 
     :raises AuthenticationError: if API returns 401
-    :raises NoTokenError: if API_TOKEN environment variable is not set"""
+    :raises NoTokenError: if API_TOKEN environment variable is not set
+
+    Client identification can be provided via PYTHONANYWHERE_CLIENT environment
+    variable (e.g., "pa/1.0.0" or "mcp-server/0.5.0") to help with usage analytics.
+    """
 
     token = os.environ.get("API_TOKEN")
     if token is None:
         raise NoTokenError(helpful_token_error_message())
-    insecure = os.environ.get("PYTHONANYWHERE_INSECURE_API") == "true"
+
+    base_user_agent = f"pythonanywhere-core/{__version__}"
+    client_info = os.environ.get("PYTHONANYWHERE_CLIENT")
+
+    if client_info:
+        user_agent = f"{base_user_agent} ({client_info}; Python/{platform.python_version()})"
+    else:
+        user_agent = f"{base_user_agent} (Python/{platform.python_version()})"
+
+    headers = {
+        "Authorization": f"Token {token}",
+        "User-Agent": user_agent
+    }
+    if "headers" in kwargs:
+        headers.update(kwargs.pop("headers"))
+
     response = requests.request(
         method=method,
         url=url,
-        headers={"Authorization": f"Token {token}"},
-        verify=not insecure,
+        headers=headers,
         **kwargs,
     )
     if response.status_code == 401:

pythonanywhere_core/exceptions.py

@@ -15,4 +15,14 @@ class NoTokenError(PythonAnywhereApiException):
 
 
 class DomainAlreadyExistsException(PythonAnywhereApiException):
-    pass
+    pass
+
+
+class MissingCNAMEException(PythonAnywhereApiException):
+    def __init__(self):
+        super().__init__(
+            "Could not find a CNAME for your website. If you're using an A record, "
+            "CloudFlare, or some other way of pointing your domain at PythonAnywhere "
+            "then that should not be a problem. If you're not, you should double-check "
+            "your DNS setup."
+        )

pythonanywhere_core/webapp.py

@@ -7,10 +7,9 @@ from textwrap import dedent
 from typing import Any
 
 from dateutil.parser import parse
-from snakesay import snakesay
 
 from pythonanywhere_core.base import call_api, get_api_endpoint, PYTHON_VERSIONS
-from pythonanywhere_core.exceptions import SanityException, PythonAnywhereApiException
+from pythonanywhere_core.exceptions import SanityException, PythonAnywhereApiException, MissingCNAMEException
 
 
 class Webapp:
@@ -54,7 +53,6 @@ class Webapp:
 
         :raises SanityException: if API token is missing or webapp already exists
         """
-        print(snakesay("Running API sanity checks"))
         token = os.environ.get("API_TOKEN")
         if not token:
             raise SanityException(
@@ -127,24 +125,13 @@ class Webapp:
     def reload(self) -> None:
         """Reload webapp
 
+        :raises MissingCNAMEException: if CNAME not found (reload succeeded)
         :raises PythonAnywhereApiException: if API call fails"""
         url = f"{self.domain_url}reload/"
         response = call_api(url, "post")
         if not response.ok:
             if response.status_code == 409 and response.json()["error"] == "cname_error":
-                print(
-                    snakesay(
-                        dedent(
-                            """
-                            Could not find a CNAME for your website.  If you're using an A record,
-                            CloudFlare, or some other way of pointing your domain at PythonAnywhere
-                            then that should not be a problem.  If you're not, you should double-check
-                            your DNS setup.
-                        """
-                        )
-                    )
-                )
-                return
+                raise MissingCNAMEException()
             raise PythonAnywhereApiException(f"POST to reload webapp via API failed, got {response}:{response.text}")
 
     def set_ssl(self, certificate: str, private_key: str) -> None:
@@ -155,7 +142,6 @@ class Webapp:
 
         :raises PythonAnywhereApiException: if API call fails
         """
-        print(snakesay(f"Setting up SSL for {self.domain} via API"))
         url = f"{self.domain_url}ssl/"
         response = call_api(url, "post", json={"cert": certificate, "private_key": private_key})
         if not response.ok:
@@ -193,12 +179,6 @@ class Webapp:
 
         :raises PythonAnywhereApiException: if API call fails
         """
-        if index:
-            message = f"Deleting old (archive number {index}) {log_type} log file for {self.domain} via API"
-        else:
-            message = f"Deleting current {log_type} log file for {self.domain} via API"
-        print(snakesay(message))
-
         if index == 1:
             suffix = ".1"
         elif index > 1:

{pythonanywhere_core-0.2.7.dist-info → pythonanywhere_core-0.2.9.dist-info}/METADATA

@@ -1,8 +1,9 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: pythonanywhere-core
-Version: 0.2.7
+Version: 0.2.9
 Summary: API wrapper for programmatic management of PythonAnywhere services.
 License: MIT
+License-File: LICENSE
 Keywords: pythonanywhere,api,cloud,web hosting
 Author: PythonAnywhere
 Author-email: developers@pythonanywhere.com
@@ -15,19 +16,30 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries
 Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
 Requires-Dist: requests (>=2.30.0,<3.0.0)
-Requires-Dist: snakesay (>=0.10.3,<0.11.0)
 Requires-Dist: typing_extensions (>=4.5.0,<5.0.0)
+Project-URL: Documentation, https://core.pythonanywhere.com/
+Project-URL: Homepage, https://core.pythonanywhere.com/
+Project-URL: Repository, https://github.com/pythonanywhere/pythonanywhere-core
 Description-Content-Type: text/x-rst
 
-API wrapper for programmatic management of PythonAnywhere services.
+pythonanywhere-core
+===================
 
-It's a core code behind `PythonAnywhere cli tool`_.
+Python SDK for PythonAnywhere API - programmatic management of PythonAnywhere
+services including webapps, files, scheduled tasks, students, and websites.
+
+Core library behind the `PythonAnywhere cli tool`_.
 
 .. _PythonAnywhere cli tool: https://pypi.org/project/pythonanywhere/
 
+Documentation
+=============
+
+Full documentation is available at https://core.pythonanywhere.com/
 
 Development
 ===========

pythonanywhere_core-0.2.9.dist-info/RECORD

@@ -0,0 +1,13 @@
+pythonanywhere_core/__init__.py,sha256=F8OVhAhMXSkvvXYgZtbPn2SG1AQC3joK4yu-FrHt81Y,22
+pythonanywhere_core/base.py,sha256=fMdyaccJdpeB8ZN2QqqEmUPYSaAp3ZdvFxgDexR0Bfg,3195
+pythonanywhere_core/exceptions.py,sha256=37aZy6txVFuiXfUdRJA5d7NQ1N5vbkdOveqv8rwnDbk,691
+pythonanywhere_core/files.py,sha256=qIfbcg472TPeOejpif_i64PtWP_qROlxoz5JbePzX8Q,6491
+pythonanywhere_core/resources.py,sha256=NzzL-eNyo26Lr5FVJSAaxTq0Ia0vP3tIew_N7yFiFlk,1172
+pythonanywhere_core/schedule.py,sha256=giSO-Gssshkto9de2hSA3VeNKotXYu-lBG-iyqDolIw,3904
+pythonanywhere_core/students.py,sha256=PeBLUP7AOCRwCDiaH71wURwFx3H3PLQW91f5AjOPQmU,1778
+pythonanywhere_core/webapp.py,sha256=Fg-c_qnoXYK_VN3bMQjBPoVkRj49KZt_7OkWdqwW_Us,11277
+pythonanywhere_core/website.py,sha256=6Q_37QDKkuKE3771V056aiPmrQ0v8ot6U59CIaZwQzk,4348
+pythonanywhere_core-0.2.9.dist-info/METADATA,sha256=eYEs0j3fTbw5u1ayGidBnCzzFFKzECKpMWWQYPSnWl0,1880
+pythonanywhere_core-0.2.9.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+pythonanywhere_core-0.2.9.dist-info/licenses/LICENSE,sha256=zOJT_E5Fv8crFEKS5ulv0btbjnUiIkdsEBPEBmLHRlQ,1080
+pythonanywhere_core-0.2.9.dist-info/RECORD,,

{pythonanywhere_core-0.2.7.dist-info → pythonanywhere_core-0.2.9.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.3
+Generator: poetry-core 2.2.1
 Root-Is-Purelib: true
 Tag: py3-none-any

pythonanywhere_core-0.2.7.dist-info/RECORD

@@ -1,13 +0,0 @@
-pythonanywhere_core/__init__.py,sha256=XHypfHSPdgXFKmOdoewn7czU670gt8InhHhzlP5j_aA,22
-pythonanywhere_core/base.py,sha256=ro1ByvW1Wlf8Qv2d3NFnHdmM7viujmDJmxUBATqvvHI,2572
-pythonanywhere_core/exceptions.py,sha256=NT6JBtd0VK3PbFc69qx4bnAygA94-pOTghp70xxz1Xw,281
-pythonanywhere_core/files.py,sha256=qIfbcg472TPeOejpif_i64PtWP_qROlxoz5JbePzX8Q,6491
-pythonanywhere_core/resources.py,sha256=NzzL-eNyo26Lr5FVJSAaxTq0Ia0vP3tIew_N7yFiFlk,1172
-pythonanywhere_core/schedule.py,sha256=giSO-Gssshkto9de2hSA3VeNKotXYu-lBG-iyqDolIw,3904
-pythonanywhere_core/students.py,sha256=PeBLUP7AOCRwCDiaH71wURwFx3H3PLQW91f5AjOPQmU,1778
-pythonanywhere_core/webapp.py,sha256=x_66jfGldtQrRhPPQgGFydJnvPreFyCBEYZGqeP0Ql4,12126
-pythonanywhere_core/website.py,sha256=6Q_37QDKkuKE3771V056aiPmrQ0v8ot6U59CIaZwQzk,4348
-pythonanywhere_core-0.2.7.dist-info/LICENSE,sha256=zOJT_E5Fv8crFEKS5ulv0btbjnUiIkdsEBPEBmLHRlQ,1080
-pythonanywhere_core-0.2.7.dist-info/METADATA,sha256=sf8yUXYmAt_0AZAv4jg1Ytr4AUe1r-A2rPlENC4bbP8,1430
-pythonanywhere_core-0.2.7.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-pythonanywhere_core-0.2.7.dist-info/RECORD,,