ds-caselaw-marklogic-api-client 27.1.0__tar.gz → 27.2.0__tar.gz

{ds_caselaw_marklogic_api_client-27.1.0 → ds_caselaw_marklogic_api_client-27.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ds-caselaw-marklogic-api-client
-Version: 27.1.0
+Version: 27.2.0
 Summary: An API client for interacting with the underlying data in Find Caselaw.
 Home-page: https://github.com/nationalarchives/ds-caselaw-custom-api-client
 Keywords: national archives,caselaw

{ds_caselaw_marklogic_api_client-27.1.0 → ds_caselaw_marklogic_api_client-27.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "ds-caselaw-marklogic-api-client"
-version = "27.1.0"
+version = "27.2.0"
 description = "An API client for interacting with the underlying data in Find Caselaw."
 authors = ["The National Archives"]
 homepage = "https://github.com/nationalarchives/ds-caselaw-custom-api-client"

{ds_caselaw_marklogic_api_client-27.1.0 → ds_caselaw_marklogic_api_client-27.2.0}/src/caselawclient/Client.py

@@ -403,6 +403,7 @@ class MarklogicApiClient:
         judgment_uri: DocumentURIString,
         version_uri: Optional[DocumentURIString] = None,
         show_unpublished: bool = False,
+        search_query: Optional[str] = None,
     ) -> bytes:
         marklogic_document_uri = self._format_uri_for_marklogic(judgment_uri)
         marklogic_document_version_uri = (
@@ -418,6 +419,7 @@ class MarklogicApiClient:
             "uri": marklogic_document_uri,
             "version_uri": marklogic_document_version_uri,
             "show_unpublished": show_unpublished,
+            "search_query": search_query,
         }
 
         response = self._eval_as_bytes(vars, "get_judgment.xqy")
@@ -433,11 +435,13 @@ class MarklogicApiClient:
         judgment_uri: DocumentURIString,
         version_uri: Optional[DocumentURIString] = None,
         show_unpublished: bool = False,
+        search_query: Optional[str] = None,
     ) -> str:
         return self.get_judgment_xml_bytestring(
             judgment_uri,
             version_uri,
             show_unpublished,
+            search_query=search_query,
         ).decode(encoding="utf-8")
 
     def set_document_name(

{ds_caselaw_marklogic_api_client-27.1.0 → ds_caselaw_marklogic_api_client-27.2.0}/src/caselawclient/models/documents/__init__.py

@@ -105,7 +105,7 @@ class Document:
     Individual document classes should extend this list where necessary to validate document type-specific attributes.
     """
 
-    def __init__(self, uri: str, api_client: "MarklogicApiClient"):
+    def __init__(self, uri: str, api_client: "MarklogicApiClient", search_query: Optional[str] = None):
         """
         :param uri: For historical reasons this accepts a pseudo-URI which may include leading or trailing slashes.
 
@@ -117,7 +117,11 @@ class Document:
             raise DocumentNotFoundError(f"Document {self.uri} does not exist")
 
         self.body: DocumentBody = DocumentBody(
-            xml_bytestring=self.api_client.get_judgment_xml_bytestring(self.uri, show_unpublished=True),
+            xml_bytestring=self.api_client.get_judgment_xml_bytestring(
+                self.uri,
+                show_unpublished=True,
+                search_query=search_query,
+            ),
         )
         """ `Document.body` represents the XML of the document itself, without any information such as version tracking or properties. """
 

{ds_caselaw_marklogic_api_client-27.1.0 → ds_caselaw_marklogic_api_client-27.2.0}/src/caselawclient/models/documents/transforms/html.xsl

@@ -973,6 +973,14 @@
 	</xsl:element>
 </xsl:template>
 
+<!-- search query numbering -->
+
+<xsl:template match="uk:mark">
+	<xsl:element name="{ local-name(.) }">
+		<xsl:copy-of select="@*"/>
+		<xsl:apply-templates />
+	</xsl:element>
+</xsl:template>
 
 <!-- text -->
 

ds_caselaw_marklogic_api_client-27.2.0/src/caselawclient/xquery/get_judgment.xqy

@@ -0,0 +1,66 @@
+xquery version "1.0-ml";
+
+declare namespace xdmp = "http://marklogic.com/xdmp";
+declare namespace cts = "http://marklogic.com/cts";
+declare namespace uk = "https://caselaw.nationalarchives.gov.uk/akn";
+import module namespace helper = "https://caselaw.nationalarchives.gov.uk/helper" at "/judgments/search/helper.xqy";
+
+declare variable $show_unpublished as xs:boolean? external;
+declare variable $uri as xs:string external;
+declare variable $version_uri as xs:string? external;
+declare variable $search_query as xs:string? external;
+
+(: Note that `xsl:output method` is changed from `html` to `xml` and we've namespaced the tag :)
+let $number_marks_xslt := (
+  <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                  xmlns:uk="https://caselaw.nationalarchives.gov.uk/akn"
+                  version="2.0">
+    <xsl:output method="xml" />
+    <xsl:template match="@*|node()">
+      <xsl:copy>
+        <xsl:apply-templates select="@*|node()"/>
+      </xsl:copy>
+    </xsl:template>
+    <xsl:template match="uk:mark">
+      <xsl:copy>
+          <xsl:copy-of select="@*" />
+          <xsl:attribute name="id">
+              <xsl:text>mark_</xsl:text>
+              <xsl:value-of select="count(preceding::uk:mark)"/>
+          </xsl:attribute>
+          <xsl:apply-templates />
+      </xsl:copy>
+    </xsl:template>
+  </xsl:stylesheet>
+)
+
+let $judgment := fn:document($uri)
+let $version := if ($version_uri) then fn:document($version_uri) else ()
+let $judgment_published_property := xdmp:document-get-properties($uri, xs:QName("published"))[1]
+let $is_published := $judgment_published_property/text()
+
+let $document_to_return := if ($version_uri) then $version else $judgment
+
+
+let $raw_xml := if ($show_unpublished) then
+        $document_to_return
+    else if (xs:boolean($is_published)) then
+        $document_to_return
+    else
+        ()
+
+(: If a search query string is present, highlight instances :)
+let $transformed := if($search_query) then
+      xdmp:xslt-eval(
+        $number_marks_xslt,
+        cts:highlight(
+          $raw_xml,
+          helper:make-q-query($search_query),
+          <uk:mark>{$cts:text}</uk:mark>
+        )
+      )
+    else
+      $raw_xml
+
+
+return $transformed

{ds_caselaw_marklogic_api_client-27.1.0 → ds_caselaw_marklogic_api_client-27.2.0}/src/caselawclient/xquery_type_dicts.py

@@ -64,6 +64,7 @@ class GetComponentsForDocumentDict(MarkLogicAPIDict):
 
 # get_judgment.xqy
 class GetJudgmentDict(MarkLogicAPIDict):
+    search_query: Optional[str]
     show_unpublished: Optional[bool]
     uri: MarkLogicDocumentURIString
     version_uri: Optional[MarkLogicDocumentVersionURIString]

ds_caselaw_marklogic_api_client-27.1.0/src/caselawclient/xquery/get_judgment.xqy

@@ -1,21 +0,0 @@
-xquery version "1.0-ml";
-
-declare variable $show_unpublished as xs:boolean? external;
-declare variable $uri as xs:string external;
-declare variable $version_uri as xs:string? external;
-
-let $judgment := fn:document($uri)
-let $version := if ($version_uri) then fn:document($version_uri) else ()
-let $judgment_published_property := xdmp:document-get-properties($uri, xs:QName("published"))[1]
-let $is_published := $judgment_published_property/text()
-
-let $document_to_return := if ($version_uri) then $version else $judgment
-
-let $return_value := if ($show_unpublished) then
-        $document_to_return
-    else if (xs:boolean($is_published)) then
-        $document_to_return
-    else
-        ()
-
-return $return_value