pretext 2.56.1__tar.gz → 2.56.2__tar.gz

{pretext-2.56.1 → pretext-2.56.2}/CHANGELOG.md

@@ -11,6 +11,25 @@ Instructions: Add a subsection under `[Unreleased]` for additions, fixes, change
 
 ### Fixed
 
+- Runestone HTML builds no longer fail while reading the Runestone Services file, which now begins with a declaration of its encoding.
+- LaTeX: a boxed `fillin` has closed sides, a `fillin` in a table cell keeps its full height, and partial table rules keep their width when the `calc` package is loaded.
+- EPUB: code blocks and table borders take the color of the text, so they stay readable in dark mode, and images get a white background as in HTML.
+- HTML: an image `datafile` has alt text, taken from its `description` when there is one.
+- HTML: a GeoGebra interactive calls a `listeners` function only when an attached script defines one.
+- HTML: standalone pages without a table of contents no longer raise a JavaScript error.
+- WeBWorK: a server that refuses its credentials is reported with a message instead of a traceback, and a warning notes that a non-default `@password` becomes public once the book is published.
+- YouTube thumbnails are downloaded over HTTPS.
+
+### Changed
+
+- A `console` may give its `input` and `output` in any order, so a session can start with output.
+
+## [2.56.1] - 2026-10-24
+
+Includes updates to core through commit: [da19341](https://github.com/PreTeXtBook/pretext/commit/da193419f0746242287b2358094a496029ca9671)
+
+### Fixed
+
 - An interrupted build no longer leaves a partially copied file in the generated-asset cache, which later builds would have reused. Cached assets and the asset table are now written to a temporary file and renamed into place.
 - A target's `output-filename` is now honored for `latex` targets, and for `pdf` and `beamer` targets built with `--latex` or `latex-source="yes"`. These builds had named the file after the source instead.
 - A `beamer` target now honors `latex-source="yes"`, as a `pdf` target does.

{pretext-2.56.1 → pretext-2.56.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pretext
-Version: 2.56.1
+Version: 2.56.2
 Summary: A package to author, build, and deploy PreTeXt projects.
 Project-URL: Homepage, https://pretextbook.org
 Project-URL: Repository, https://github.com/PreTeXtBook/pretext-cli

{pretext-2.56.1 → pretext-2.56.2}/pretext/__init__.py

@@ -18,7 +18,7 @@ from single_version import get_version
 
 VERSION = get_version("pretext", Path(__file__).parent.parent)
 
-CORE_COMMIT = "da193419f0746242287b2358094a496029ca9671"
+CORE_COMMIT = "d6a846cc46399b6e2484eda40c2930bb3c80c5ce"
 
 
 def activate() -> None:

{pretext-2.56.1 → pretext-2.56.2}/pretext/core/common.py

@@ -649,21 +649,6 @@ def sanitize_url(url):
     return url
 
 
-def sanitize_alpha_num_underscore(param):
-    """Verify parameter is a string containing only alphanumeric and undescores"""
-    import string
-
-    allowed = set(string.ascii_letters + string.digits + "_")
-    log.info("verifying parameter: {}".format(param))
-    if not (set(param) <= allowed):
-        raise ValueError(
-            "PTX:ERROR: param {} contains characters other than a-zA-Z0-9_ ".format(
-                param
-            )
-        )
-    return param
-
-
 def get_temporary_directory():
     """Create, record, and return a scratch directory"""
     import tempfile  #  mkdtemp()

{pretext-2.56.1 → pretext-2.56.2}/pretext/core/pretext.py

@@ -1881,7 +1881,7 @@ def youtube_thumbnail(xml_source, pub_file, stringparams, xmlid_root, dest_dir):
     failed_thumbnails = []
     for thumb in thumbs:
         thumb_pair = thumb.split(",")
-        url = "http://i.ytimg.com/vi/{}/default.jpg".format(thumb_pair[0])
+        url = "https://i.ytimg.com/vi/{}/default.jpg".format(thumb_pair[0])
         path = os.path.join(dest_dir, thumb_pair[1] + ".jpg")
         log.info("downloading {} as {}...".format(url, path))
         # http://stackoverflow.com/questions/13137817/how-to-download-image-using-requests/13137873
@@ -3802,7 +3802,9 @@ def _runestone_services(stringparams, ext_rs_methods):
 
     # Now services_xml should be meaningful since we haven't raised an exception.
 
-    services = ET.fromstring(services_xml)
+    # The services file begins with a declaration of its encoding, which
+    # lxml accepts only from bytes, so parse the UTF-8 the text came from
+    services = ET.fromstring(services_xml.encode("utf-8"))
     # Interrogate the services XML
     rs_js, rs_css, rs_cdn_url, rs_version = _parse_runestone_services(services)
 
@@ -3863,7 +3865,9 @@ def _cdn_runestone_services(stringparams, ext_rs_methods):
         raise Exception(e)
 
     # Now services_xml should be meaningful since we haven't raised an exception.
-    services = ET.fromstring(services_xml)
+    # The services file begins with a declaration of its encoding, which
+    # lxml accepts only from bytes, so parse the UTF-8 the text came from
+    services = ET.fromstring(services_xml.encode("utf-8"))
     # Interrogate the services XML
     rs_js, rs_css, rs_cdn_url, rs_version = _parse_runestone_services(services)
 
@@ -3918,7 +3922,10 @@ def query_runestone_services(services_url):
         log.debug(msg)
         # fatal error here, a URL is not doing the job
         raise Exception(msg)
-    # Return the XML from the services response
+    # Return the XML from the services response.  The file declares
+    # UTF-8, but the server names no charset, so "requests" would
+    # decode the text as ISO-8859-1 without this.
+    services_response.encoding = "utf-8"
     return services_response.text
 
 

{pretext-2.56.1 → pretext-2.56.2}/pretext/core/webwork.py

@@ -109,64 +109,24 @@ def webwork_to_xml(
     webwork_sets(xml_source, pub_file, stringparams, ww_pg_dir, False, False)
     pg_macros(xml_source, pub_file, stringparams, ww_macros_dir)
 
-    no_publication_file = False
-    if webwork2_server is not None:
-        server_params_pub = {
-            "webwork2_domain": webwork2_server,
-            "courseID": extracted_pg_xml.find("server-params-pub").get("course-id"),
-            "user": extracted_pg_xml.find("server-params-pub").get("user-id"),
-            "passwd": extracted_pg_xml.find("server-params-pub").get("password"),
-            "disableCookies": '1',
-        }
-        static_processing = extracted_pg_xml.find("processing").attrib["static"]
-        pg_location = extracted_pg_xml.find("processing").attrib["pg-location"]
-    else:
-        no_publication_file = True
-        server_params_pub = {
-            "webwork2_domain": "https://webwork-ptx.aimath.org",
-            "courseID": "anonymous",
-            "user": "anonymous",
-            "passwd": "anonymous",
-            "disableCookies": '1',
-        }
-        static_processing = 'webwork2'
-        pg_location = '/opt/webwork/pg'
-
-    # ideally, pub_file is in use, in which case server_params_pub is nonempty.
-    # if no pub_file in use, rely on server_params argument.
-    # if both present, use server_params_pub and give warning
-    # if neither in use give warning and fail
-    if no_publication_file and server_params is None:
-        raise ValueError("Either use a publication file or pass a --server argument")
-    elif no_publication_file:
-        # We rely on the argument server_params
-        # This is deprecated in favor of using a publication file
-        log.warning("WeBWorK server declared using -s argument.\n" +
-              "              Please consider using a publication file with publication/webwork instead.")
-        server_params = server_params.strip()
-        if (server_params.startswith("(") and server_params.endswith(")")):
-            server_params = server_params.strip("()")
-            split_server_params = server_params.split(",")
-            webwork2_domain = common.sanitize_url(split_server_params[0])
-            courseID = common.sanitize_alpha_num_underscore(split_server_params[1])
-            user = common.sanitize_alpha_num_underscore(split_server_params[2])
-            passwd = common.sanitize_alpha_num_underscore(split_server_params[3])
-        else:
-            webwork2_domain = common.sanitize_url(server_params)
-            courseID        = "anonymous"
-            user            = "anonymous"
-            passwd          = "anonymous"
-    else:
-        # Now we know we had a publication file
-        # Use it, and warn if server_params argument is also present
-        if server_params is not None:
-            log.warning("Publication file in use and -s argument passed for WeBWorK server.\n"
-                  + "              -s argument will be ignored.\n"
-                  + "              Using publication/webwork values (or defaults) instead.")
-        webwork2_domain = common.sanitize_url(server_params_pub["webwork2_domain"])
-        courseID        = server_params_pub["courseID"]
-        user            = server_params_pub["user"]
-        passwd          = server_params_pub["passwd"]
+    # The extracted problems always carry the server and its credentials,
+    # from the "webwork" element of a publication file or from the defaults
+    # for that element.  The "server_params" argument is not read; it stays
+    # in the signature because the PreTeXt command-line interface passes it.
+    webwork2_domain = common.sanitize_url(webwork2_server)
+    courseID        = extracted_pg_xml.find("server-params-pub").get("course-id")
+    user            = extracted_pg_xml.find("server-params-pub").get("user-id")
+    passwd          = extracted_pg_xml.find("server-params-pub").get("password")
+    static_processing = extracted_pg_xml.find("processing").attrib["static"]
+    pg_location = extracted_pg_xml.find("processing").attrib["pg-location"]
+
+    # The password goes into the representations file and from there into
+    # the HTML of every exercise, so readers can see it once published
+    if passwd != "anonymous":
+        log.warning("WeBWorK password is not \"anonymous\".\n" +
+              "              It is written into the generated representations file and into the HTML\n" +
+              "              of every WeBWorK exercise, where any reader can see it.\n" +
+              "              Use only credentials you are willing to make public.")
 
     webwork2_domain_webwork2 = webwork2_domain + "/webwork2/"
     webwork2_render_rpc = webwork2_domain_webwork2 + "render_rpc"
@@ -207,18 +167,29 @@ def webwork_to_xml(
             outputformat='raw'
         )
         render_rpc_response = requests.get(url=webwork2_render_rpc, params=params_for_version_determination)
-        if render_rpc_response.status_code == 200:
-            version_determination_json = render_rpc_response.json()
-            if "ww_version" in version_determination_json:
-                webwork2_version = version_determination_json["ww_version"]
-                webwork2_version_match = re.search(
-                    r"((\d+)\.(\d+)(\+develop)?)", webwork2_version, re.I
-                )
     except Exception as e:
         root_cause = str(e)
         msg = ("PTX:ERROR:   There was a problem contacting the WeBWorK server.\n")
         raise ValueError(msg.format(webwork2_domain_webwork2) + root_cause)
 
+    if render_rpc_response.status_code == 200:
+        # A server that refuses the credentials still answers 200, with a
+        # line of text in place of the JSON of a rendered problem.  Every
+        # JSON decoding error that "requests" raises is a ValueError.
+        try:
+            version_determination_json = render_rpc_response.json()
+        except ValueError:
+            server_reply = " ".join(render_rpc_response.text.split())[:200]
+            msg = ("The WeBWorK server at {} answered, but did not accept the course \"{}\",\n" +
+                  "              the user \"{}\", and the password given in the \"webwork\" element\n" +
+                  "              of the publication file.  The server replied: {}")
+            log.fatal(msg.format(webwork2_domain, courseID, user, server_reply))
+        if "ww_version" in version_determination_json:
+            webwork2_version = version_determination_json["ww_version"]
+            webwork2_version_match = re.search(
+                r"((\d+)\.(\d+)(\+develop)?)", webwork2_version, re.I
+            )
+
     # Now if that failed, try to infer the version from what is printed on the landing page.
     if webwork2_version == None:
         try:

{pretext-2.56.1 → pretext-2.56.2}/pretext/resources/resource_hash_table.json

@@ -853,5 +853,13 @@
     "pretext-cli.yml": "8220140f3fc814b1b8d30421299cc4902c8af911569c727f9fbe94e9a8c11da7",
     "pretext-deploy.yml": "e8a889f61838d3f5fa130ec77f44d89260847488f01425d32d7c5dcb44dfcff0",
     "installPandoc.sh": "45492942e3dc7ffbfafb21e282d3a0004611572b7041b8c538d229656fdc9013"
+  },
+  "2.56.2": {
+    "project.ptx": "228f0f83a45bb0e2fc4950547a0e6d21ae22e3dc53b6390a320c5f8dd2705b10",
+    ".gitignore": "8c12c09afe8359d34ae6779eb2a4106b663bb24a287b8f9c42273fc6cf415cb0",
+    "devcontainer.json": "aec01163c5f28d662999d936ef5a93ca82d35dc3698b24dbddd6c00b94b75c2e",
+    "pretext-cli.yml": "feff84f9de4b7ee10a478c51ba23ecd9e1649b59a79c075f371e0138ccae30ab",
+    "pretext-deploy.yml": "5a8f323ca69b555bbc425e6005cf8ae0cbfe71f20a351852997cbe94a8bd0b91",
+    "installPandoc.sh": "4f6af94ce05a4d26c1a1b6d6166d2edcdc312030ee77455be25153f11c75130b"
   }
 }

{pretext-2.56.1 → pretext-2.56.2}/pyproject.toml

@@ -11,7 +11,7 @@
 # ----------------
 [project]
 name = "pretext"
-version = "2.56.1"
+version = "2.56.2"
 description = "A package to author, build, and deploy PreTeXt projects."
 readme = "README.md"
 license = "GPL-3.0-or-later"

{pretext-2.56.1 → pretext-2.56.2}/templates/.gitignore

@@ -1,4 +1,4 @@
-# This file was automatically generated with PreTeXt 2.56.1.
+# This file was automatically generated with PreTeXt 2.56.2.
 # If you modify this file, PreTeXt will no longer automatically update it.
 #
 # Boilerplate list of files in a PreTeXt project for git to ignore

{pretext-2.56.1 → pretext-2.56.2}/templates/devcontainer.json

@@ -1,4 +1,4 @@
-// This file was automatically generated with PreTeXt 2.56.1.
+// This file was automatically generated with PreTeXt 2.56.2.
 // If you modify this file, PreTeXt will no longer automatically update it.
 //
 //////////////////////////////////////////////////////////////

{pretext-2.56.1 → pretext-2.56.2}/templates/installPandoc.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-# This file was automatically generated with PreTeXt 2.56.1.
+# This file was automatically generated with PreTeXt 2.56.2.
 # If you modify this file, PreTeXt will no longer automatically update it.
 
 # Detect architecture and download appropriate Pandoc version

{pretext-2.56.1 → pretext-2.56.2}/templates/pretext-cli.yml

@@ -1,4 +1,4 @@
-# This file was automatically generated with PreTeXt 2.56.1.
+# This file was automatically generated with PreTeXt 2.56.2.
 # If you modify this file, PreTeXt will no longer automatically update it.
 #
 # This workflow file can be used to automatically build a project and create

{pretext-2.56.1 → pretext-2.56.2}/templates/pretext-deploy.yml

@@ -1,4 +1,4 @@
-# This file was automatically generated with PreTeXt 2.56.1.
+# This file was automatically generated with PreTeXt 2.56.2.
 # If you modify this file, PreTeXt will no longer automatically update it.
 #
 

{pretext-2.56.1 → pretext-2.56.2}/templates/project.ptx

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- This file was automatically generated by PreTeXt 2.56.1. -->
+<!-- This file was automatically generated by PreTeXt 2.56.2. -->
 <!-- If you modify this file, PreTeXt will no longer automatically update it.-->
 
 <!-- This file, the project manifest, provides the overall configuration for your PreTeXt project. To edit the content of your document, open `source/main.ptx`. See https://pretextbook.org/doc/guide/html/processing-CLI.html#cli-project-manifest. -->

{pretext-2.56.1 → pretext-2.56.2}/uv.lock

@@ -1661,7 +1661,7 @@ text = [
 
 [[package]]
 name = "pretext"
-version = "2.56.1"
+version = "2.56.2"
 source = { editable = "." }
 dependencies = [
     { name = "citeproc-py" },