pyjelly 0.6.0__py3-none-any.whl → 0.6.2__py3-none-any.whl

pyjelly/parse/ioutils.py

@@ -1,3 +1,4 @@
+import io
 import os
 from collections.abc import Generator, Iterator
 from itertools import chain
@@ -48,7 +49,7 @@ def delimited_jelly_hint(header: bytes) -> bool:
     False
     """
     magic = 0x0A
-    return len(header) == 3 and (  # noqa: PLR2004
+    return len(header) >= 3 and (  # noqa: PLR2004
         header[0] != magic or (header[1] == magic and header[2] != magic)
     )
 
@@ -77,8 +78,15 @@ def get_options_and_frames(
             stream types, lookup presets and other stream options
 
     """
-    is_delimited = delimited_jelly_hint(bytes_read := inp.read(3))
-    inp.seek(-len(bytes_read), os.SEEK_CUR)
+    if not inp.seekable():
+        # Input may not be seekable (e.g. a network stream) -- then we need to buffer
+        # it to determine if it's delimited.
+        # See also: https://github.com/Jelly-RDF/pyjelly/issues/298
+        inp = io.BufferedReader(inp)  # type: ignore[arg-type]
+        is_delimited = delimited_jelly_hint(inp.peek(3))
+    else:
+        is_delimited = delimited_jelly_hint(bytes_read := inp.read(3))
+        inp.seek(-len(bytes_read), os.SEEK_CUR)
 
     if is_delimited:
         first_frame = None

pyjelly/parse/lookup.py

@@ -26,7 +26,7 @@ class LookupDecoder:
 
     def __init__(self, *, lookup_size: int) -> None:
         if lookup_size > MAX_LOOKUP_SIZE:
-            msg = f"lookup size must be less than {MAX_LOOKUP_SIZE}"
+            msg = f"lookup size cannot be larger than {MAX_LOOKUP_SIZE}"
             raise JellyAssertionError(msg)
         self.lookup_size = lookup_size
         placeholders = (None,) * lookup_size

{pyjelly-0.6.0.dist-info → pyjelly-0.6.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyjelly
-Version: 0.6.0
+Version: 0.6.2
 Summary: Jelly-RDF implementation for Python
 Project-URL: Homepage, https://w3id.org/jelly/pyjelly
 Project-URL: Documentation, https://w3id.org/jelly/pyjelly
@@ -44,9 +44,22 @@ Description-Content-Type: text/markdown
 
 ## Features
 
-- **Fast reading and writing** of RDF knowledge graphs in the [Jelly format](http://w3id.org/jelly)
-- **Seamless integration with [rdflib](https://rdflib.readthedocs.io/)**
-- **Stream processing support** for large datasets or streams of many RDF graphs/datasets
+- **Fast reading and writing** of RDF knowledge graphs in the [Jelly format](http://w3id.org/jelly).
+- **Standalone [generic API](https://w3id.org/jelly/pyjelly/dev/generic-sink)** with no third-party dependencies, allowing for:
+    - Serialization and parsing of statements to and from Jelly files.
+    - Parsing and serializing streams of graphs and statements.
+- Precise control over **serialization options, framing and compression**.
+- **Seamless** integration with: 
+    - **[rdflib](https://w3id.org/jelly/pyjelly/dev/getting-started)**
+    - **[RDFLib-Neo4j](https://w3id.org/jelly/pyjelly/dev/rdflib-neo4j-integration)**
+    - **[NetworkX](https://w3id.org/jelly/pyjelly/dev/networkx-integration)**
+- **Stream processing support** for large datasets or streams of all [physical stream types](https://w3id.org/jelly/dev/specification/reference/#physicalstreamtype).
+
+**pyjelly** is useful when dealing with (see [full description](https://w3id.org/jelly/pyjelly/dev/overview/#use-cases)):
+
+- Dumping and loading **large RDF datasets**.
+- **Client-server communication**.
+- Workflows, where **streaming** is required.
 
 ## Getting started
 

{pyjelly-0.6.0.dist-info → pyjelly-0.6.2.dist-info}/RECORD

@@ -17,16 +17,16 @@ pyjelly/jelly/rdf_pb2.py,sha256=qjgS3kQnCJqoOmgzvgk1BeYxGbeDX2zygJPc2vDjRts,8952
 pyjelly/jelly/rdf_pb2.pyi,sha256=-gxZO-r2wyN68l83XomySz60c82SZmoPKh1HxamBjZs,11816
 pyjelly/parse/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyjelly/parse/decode.py,sha256=ze1u7xDz_ySxs4tTqaNN_mpd7GCRN6_Tuz9-xZOwCt8,14381
-pyjelly/parse/ioutils.py,sha256=O3wRtL5tf1WyIZ1LTfHjHwjKEGrhIWqFisOWjYmspNg,3434
-pyjelly/parse/lookup.py,sha256=1AbdZEycLC4tRfh3fgF5hv5PrhwhdWvCUC53iHt-E4c,2193
+pyjelly/parse/ioutils.py,sha256=0eqLmY1lpxRT5PZjx93g8FGfvpfDsXOkZBq2Ag8vptw,3808
+pyjelly/parse/lookup.py,sha256=_E9sg4p5X8INeeqAZqmLH_HENpONr3IF-GqWVV6TeJc,2197
 pyjelly/serialize/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyjelly/serialize/encode.py,sha256=_ACdaxYAoh7z5ND77ceJikKF_AGlZ-P69XPsnl7Fmsg,12664
 pyjelly/serialize/flows.py,sha256=0C2soigJKyHr3xoR-7v0kc1RL8COwnuCRd4iVZpukFU,5524
 pyjelly/serialize/ioutils.py,sha256=2_NaadLfHO3jKR1ZV7aK6jQ09sPKBar9iLFHYwourz8,400
 pyjelly/serialize/lookup.py,sha256=h0lYFjdB6CIuN2DzAW6EE4ILJFUuto3paAK6DG1DZYg,4091
 pyjelly/serialize/streams.py,sha256=p4RTQ750C4mT64vDxiK0KcUwD0qaAy-rZ7vwwvV_Cy8,8339
-pyjelly-0.6.0.dist-info/METADATA,sha256=c2BD1jdHBcFMne7uIaWO6uqIq9BE51b79_tbCZwIVM0,4753
-pyjelly-0.6.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-pyjelly-0.6.0.dist-info/entry_points.txt,sha256=kUG0p9zso7HpitdMaQaXEj_KSqgOGsL0Ky9ARbecN1g,339
-pyjelly-0.6.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-pyjelly-0.6.0.dist-info/RECORD,,
+pyjelly-0.6.2.dist-info/METADATA,sha256=5JVdbuV6KtIdSaXABcfSVwHDD8s6g2bykjWx3w-U2iU,5615
+pyjelly-0.6.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pyjelly-0.6.2.dist-info/entry_points.txt,sha256=kUG0p9zso7HpitdMaQaXEj_KSqgOGsL0Ky9ARbecN1g,339
+pyjelly-0.6.2.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+pyjelly-0.6.2.dist-info/RECORD,,