Merge pull request #18 from GeoStat-Framework/update_package_structure

Update package structure

Author: MuellerSeb

.git_archival.txt

@@ -0,0 +1,4 @@
+node: $Format:%H$
+node-date: $Format:%cI$
+describe-name: $Format:%(describe:tags=true,match=*[0-9]*)$
+ref-names: $Format:%D$

.gitattributes

@@ -0,0 +1 @@
+.git_archival.txt  export-subst

.github/workflows/main.yml

@@ -26,16 +26,15 @@ jobs:
     steps:
       - uses: actions/checkout@v2
 
-      - name: Set up Python 3.8
+      - name: Set up Python 3.9
         uses: actions/setup-python@v2
         with:
-          python-version: 3.8
+          python-version: 3.9
 
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install black 'isort[colors]<6' # 'pylint<3'
-          pip install --editable .
+          pip install --editable .[check]
 
       - name: black check
         run: |
@@ -52,7 +51,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ['3.6', '3.7', '3.8', '3.9']  # '3.10'
+        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11']
 
     steps:
       - uses: actions/checkout@v2

.gitignore

@@ -112,11 +112,11 @@ info/
 *.cpp
 
 # generated version file
-ogs5py/_version.py
+src/ogs5py/_version.py
 
 # generated docs
 docs/source/examples/
-docs/source/generated/
+docs/source/api/
 
 # other settings
 .vscode/
@@ -126,4 +126,4 @@ docs/source/generated/
 
 *.vtu
 *.vtr
-*.vtk
+*.vtk

CHANGELOG.md

@@ -3,6 +3,21 @@
 All notable changes to **ogs5py** will be documented in this file.
 
 
+## [1.3.0] - 2023-04
+
+See [#18](https://github.com/GeoStat-Framework/ogs5py/pull/18)
+
+### Enhancements
+- move to `src/` base package structure
+- use [hatchling](https://pypi.org/project/hatchling/) as build backend
+- drop py36 support
+- added archive support
+- simplify documentation
+
+### Bugfixes
+- remove usage of deprecated `np.int`
+
+
 ## [1.2.2] - 2022-05-25
 
 ### Bugfixes
@@ -185,7 +200,8 @@ All notable changes to **ogs5py** will be documented in this file.
 First release of ogs5py.
 
 
-[Unreleased]: https://github.com/GeoStat-Framework/ogs5py/compare/v1.2.2...HEAD
+[Unreleased]: https://github.com/GeoStat-Framework/ogs5py/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/GeoStat-Framework/ogs5py/compare/v1.2.2...v1.3.0
 [1.2.2]: https://github.com/GeoStat-Framework/ogs5py/compare/v1.2.1...v1.2.2
 [1.2.1]: https://github.com/GeoStat-Framework/ogs5py/compare/v1.2.0...v1.2.1
 [1.2.0]: https://github.com/GeoStat-Framework/ogs5py/compare/v1.1.1...v1.2.0

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 Sebastian Mueller
+Copyright (c) 2023 Sebastian Mueller
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

MANIFEST.in

@@ -178,7 +178,7 @@ You can contact us via <[email protected]>.
 
 ## License
 
-[MIT][gpl_link] © 2018-2022 (inspired by Falk Hesse and Miao Jing)
+[MIT][gpl_link] © 2018-2023 (inspired by Falk Hesse and Miao Jing)
 
 This project is based on [OGSPY][ogspy_link].
 

README.md

@@ -0,0 +1,3 @@
+dl.py.property {
+    display: block !important;
+}

docs/source/_static/custom.css

@@ -0,0 +1,9 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ fullname }}
+
+.. automodule:: {{ fullname }}
+
+.. raw:: latex
+
+    \clearpage

docs/source/_templates/autosummary/module.rst

@@ -21,7 +21,7 @@
     <br />
     <br />
     <ul>
-      <Li><a href="genindex.html">Index</a></Li>
-      <Li><a href="contents.html">Sitemap</a></Li>
+      <Li><a href="{{ pathto('genindex') }}">Index</a></Li>
+      <Li><a href="{{ pathto(master_doc) }}">Sitemap</a></Li>
     </ul>
   {% endblock %}

docs/source/_templates/layout.html

@@ -7,10 +7,3 @@ ogs5py API
 .. raw:: latex
 
     \clearpage
-
-.. toctree::
-   :hidden:
-
-   fileclasses.rst
-   reader.rst
-   tools.rst

docs/source/package.rst renamed to docs/source/api.rst

@@ -49,7 +49,7 @@ def setup(app):
     "sphinx.ext.doctest",
     "sphinx.ext.intersphinx",
     "sphinx.ext.coverage",
-    "sphinx.ext.imgmath",
+    "sphinx.ext.mathjax",
     "sphinx.ext.ifconfig",
     "sphinx.ext.viewcode",
     "sphinx.ext.autosummary",
@@ -69,7 +69,10 @@ def setup(app):
 # Notes in boxes
 napoleon_use_admonition_for_notes = True
 # Attributes like parameters
-# napoleon_use_ivar = True
+napoleon_use_ivar = True
+# keep "Other Parameters" section
+# https://github.com/sphinx-doc/sphinx/issues/10330
+napoleon_use_param = False
 # this is a nice class-doc layout
 numpydoc_show_class_members = True
 # class members have no separate file, so they are not in a toctree
@@ -111,7 +114,7 @@ def setup(app):
 #
 # 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"
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -143,14 +146,18 @@ def setup(app):
     # Toc options
     "collapse_navigation": False,
     "sticky_navigation": True,
-    "navigation_depth": 4,
+    "navigation_depth": 6,
     "includehidden": True,
     "titles_only": False,
 }
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-# html_static_path = ['_static']
+html_static_path = ["_static"]
+
+# These paths are either relative to html_static_path
+# or fully qualified paths (eg. https://...)
+html_css_files = ["custom.css"]
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.
@@ -236,11 +243,8 @@ def setup(app):
 
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
-    "Python 3.6": ("https://docs.python.org/3.6", None),
     "Python": ("https://docs.python.org/", None),
     "NumPy": ("http://docs.scipy.org/doc/numpy/", None),
     "matplotlib": ("http://matplotlib.org", None),
     "Sphinx": ("http://www.sphinx-doc.org/en/stable/", None),
-    #    "hankel": ("https://hankel.readthedocs.io/en/latest/", None),
-    #    "emcee": ("http://dfm.io/emcee/current/", None),
 }

docs/source/conf.py

@@ -4,9 +4,9 @@ Contents
 
 .. toctree::
    :includehidden:
-   :maxdepth: 3
+   :maxdepth: 5
 
    index
    tutorials
-   package
+   api
    changelog