Merge pull request #657 from achaikou/rev2_python

Update python interface with rev2 features

Author: achaikou

.github/workflows/wheels.yaml

@@ -53,7 +53,7 @@ jobs:
           CIBW_ENVIRONMENT_WINDOWS: >
             CMAKE_GENERATOR="${{ matrix.cmake_generator }}"
             CMAKE_GENERATOR_PLATFORM="${{ matrix.cmake_generator_platform }}"
-          CIBW_SKIP: cp38-* *-musllinux_*
+          CIBW_SKIP: cp38-* cp39-* *-musllinux_*
           CIBW_ARCHS: ${{ matrix.arch }}
         run: |
             python -m cibuildwheel --output-dir wheelhouse python/

README.md

@@ -96,7 +96,7 @@ To build segyio you need:
  * A C99 compatible C compiler (tested mostly on gcc and clang)
  * A C++11 compiler for the Python extension and tests
  * [CMake](https://cmake.org/) version 3.18 or greater
- * [Python](https://www.python.org/) 3.9 or greater
+ * [Python](https://www.python.org/) 3.10 or greater
  * [numpy](http://www.numpy.org/) version 1.10 or greater
  * [pytest](https://pypi.org/project/pytest)
 

python/docs/conf.py

@@ -62,10 +62,10 @@
 #
 # ref http://luc.lino-framework.org/blog/2018/0821.html
 
-from distutils.version import LooseVersion
+from packaging.version import Version
 import sphinx
 
-if LooseVersion(sphinx.__version__) < LooseVersion("1.8"):
+if Version(sphinx.__version__) < Version("1.8"):
     autodoc_default_flags = ['members', 'inherited-members']
 else:
     autodoc_default_options = {
@@ -109,7 +109,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = 'en'
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:
@@ -166,7 +166,7 @@
     'examples_dirs': ['../tutorials',],
     # path where to save gallery generated examples
     'gallery_dirs': ['tutorials'],
-    'filename_pattern': '\.py',
+    'filename_pattern': r'\.py',
     # Remove the "Download all examples" button from the top level gallery
     'download_all_examples': False,
     # Sort gallery example by file name instead of number of lines (default)

python/docs/segyio.rst

@@ -35,6 +35,12 @@ Trace header and attributes
 .. autoclass:: segyio.trace.Attributes()
     :special-members: __getitem__, __setitem__, __len__, __contains__, __iter__
 
+.. autoclass:: segyio.trace.FileFieldAccessor()
+    :special-members: __getitem__, __setitem__, __len__, __iter__
+
+.. autoclass:: segyio.trace.RowFieldAccessor()
+    :special-members: __getitem__, __setitem__, __getattr__, __setattr__, __len__, __iter__
+
 Data line
 ---------
 .. autoclass:: segyio.line.Line()
@@ -67,11 +73,31 @@ Text
 .. autoclass:: segyio.trace.Text()
     :special-members: __getitem__, __setitem__, __len__, __contains__, __iter__
 
+Stanza
+------
+.. autoclass:: segyio.trace.Stanza()
+    :special-members: __getitem__, __len__, __iter__
+    :exclude-members: count, index
+
 Trace and binary header
 =======================
 .. autoclass:: segyio.field.Field()
     :special-members: __getitem__, __setitem__, __delitem__, __len__, __contains__, __iter__
 
+.. autoclass:: segyio.field.HeaderFieldAccessor()
+    :special-members: __getattr__, __setattr__, __getitem__, __setitem__, __delitem__, __len__, __iter__
+
+.. autoclass:: segyio.trace.RowLayoutEntries()
+    :special-members: __getitem__, __getattr__, __len__, __iter__
+    :exclude-members: count, index
+
+.. autoclass:: segyio.trace.HeaderLayoutEntries()
+    :special-members: __getitem__, __getattr__, __len__, __iter__
+    :exclude-members: count
+
+.. autoclass:: segyio.trace.FieldLayoutEntry()
+    :special-members: __getitem__
+
 Tools
 =====
 

python/examples/flip-endianness.py

@@ -32,20 +32,12 @@ def main():
             dst.bin = src.bin
             dst.trace = src.trace
 
-            # intention:
-            # dst.traceheader = src.traceheader
-
         # traceheader mapping was copied after open. At the moment of creation
         # of this example file code can't deal with that, so we must reopen the
         # file after bin and ext_headers are copied so that mapping is
         # recognized.
         with segyio.open(dstfile, "r+", endian="little", ignore_geometry=True) as dst:
-            for trace_index in range(src.tracecount):
-                for traceheader_index in range(src.traceheader_count):
-                    traceheader = src.segyfd.getth(
-                        trace_index, traceheader_index, bytearray(240))
-                    dst.segyfd.putth(
-                        trace_index, traceheader_index, traceheader)
+            dst.traceheader = src.traceheader
 
 
 if __name__ == '__main__':

python/pyproject.toml

@@ -13,7 +13,7 @@ authors = [
 ]
 urls.homepage = "https://github.com/equinor/segyio"
 license = "LGPL-3.0-or-later"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 dependencies = ["numpy >= 1.10"]
 readme = { text = """
 =======
@@ -66,7 +66,6 @@ classifiers = [
     "Intended Audience :: Science/Research",
     "Natural Language :: English",
     "Programming Language :: Python",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",