seppy 0.1.17__tar.gz → 0.1.19__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of seppy might be problematic. Click here for more details.

Files changed (62) hide show
  1. seppy-0.1.19/.github/release.yml +10 -0
  2. seppy-0.1.19/.github/workflows/pytest.yml +45 -0
  3. seppy-0.1.19/.gitignore +141 -0
  4. seppy-0.1.19/.zenodo.json +53 -0
  5. seppy-0.1.19/MANIFEST.in +11 -0
  6. {seppy-0.1.17/seppy.egg-info → seppy-0.1.19}/PKG-INFO +41 -12
  7. {seppy-0.1.17 → seppy-0.1.19}/README.rst +5 -2
  8. {seppy-0.1.17 → seppy-0.1.19}/docs/conf.py +39 -25
  9. seppy-0.1.19/docs/index.rst +15 -0
  10. {seppy-0.1.17 → seppy-0.1.19}/docs/make.bat +35 -35
  11. seppy-0.1.19/pyproject.toml +130 -0
  12. seppy-0.1.19/seppy/__init__.py +4 -0
  13. seppy-0.1.19/seppy/_version.py +21 -0
  14. {seppy-0.1.17 → seppy-0.1.19}/seppy/loader/psp.py +5 -5
  15. {seppy-0.1.17 → seppy-0.1.19}/seppy/loader/soho.py +4 -4
  16. {seppy-0.1.17 → seppy-0.1.19}/seppy/loader/stereo.py +2 -0
  17. {seppy-0.1.17 → seppy-0.1.19}/seppy/loader/wind.py +1 -1
  18. seppy-0.1.19/seppy/tests/__init__.py +3 -0
  19. {seppy-0.1.17 → seppy-0.1.19}/seppy/tests/test_loader.py +17 -8
  20. seppy-0.1.19/seppy/tests/test_time_shift_analysis.ipynb +286 -0
  21. seppy-0.1.19/seppy/tests/tsa_org.png +0 -0
  22. {seppy-0.1.17 → seppy-0.1.19}/seppy/tools/__init__.py +15 -16
  23. seppy-0.1.19/seppy/version.py +17 -0
  24. {seppy-0.1.17 → seppy-0.1.19/seppy.egg-info}/PKG-INFO +41 -12
  25. {seppy-0.1.17 → seppy-0.1.19}/seppy.egg-info/SOURCES.txt +7 -2
  26. {seppy-0.1.17 → seppy-0.1.19}/seppy.egg-info/requires.txt +1 -2
  27. seppy-0.1.19/setup.cfg +4 -0
  28. seppy-0.1.19/setup.py +4 -0
  29. seppy-0.1.19/tox.ini +67 -0
  30. seppy-0.1.17/MANIFEST.in +0 -18
  31. seppy-0.1.17/docs/index.rst +0 -21
  32. seppy-0.1.17/pyproject.toml +0 -7
  33. seppy-0.1.17/requirements.txt +0 -15
  34. seppy-0.1.17/seppy/__init__.py +0 -7
  35. seppy-0.1.17/seppy/tests/__init__.py +0 -4
  36. seppy-0.1.17/seppy/version.py +0 -8
  37. seppy-0.1.17/setup.cfg +0 -92
  38. seppy-0.1.17/setup.py +0 -24
  39. seppy-0.1.17/tox.ini +0 -45
  40. {seppy-0.1.17 → seppy-0.1.19}/LICENSE.rst +0 -0
  41. {seppy-0.1.17 → seppy-0.1.19}/docs/Makefile +0 -0
  42. {seppy-0.1.17 → seppy-0.1.19}/licenses/LICENSE.rst +0 -0
  43. {seppy-0.1.17 → seppy-0.1.19}/licenses/SUNPY_LICENSE.rst +0 -0
  44. {seppy-0.1.17 → seppy-0.1.19}/licenses/TEMPLATE_LICENSE.rst +0 -0
  45. {seppy-0.1.17 → seppy-0.1.19}/seppy/data/test/20230719_side0.csv +0 -0
  46. {seppy-0.1.17 → seppy-0.1.19}/seppy/data/test/20230719_side1.csv +0 -0
  47. {seppy-0.1.17 → seppy-0.1.19}/seppy/data/test/20230719_side2.csv +0 -0
  48. {seppy-0.1.17 → seppy-0.1.19}/seppy/data/test/epi21106.rl2 +0 -0
  49. {seppy-0.1.17 → seppy-0.1.19}/seppy/data/test/sept_ahead_ele_sun_2006_318_1min_l2_v03.dat +0 -0
  50. {seppy-0.1.17 → seppy-0.1.19}/seppy/data/test/soho_erne-hed_l2-1min_20211028_v01.cdf +0 -0
  51. {seppy-0.1.17 → seppy-0.1.19}/seppy/data/test/solo_l2_mag-rtn-normal-1-minute_20210712_v01.cdf +0 -0
  52. {seppy-0.1.17 → seppy-0.1.19}/seppy/data/test/sta_l1_het_20211028_v01.cdf +0 -0
  53. {seppy-0.1.17 → seppy-0.1.19}/seppy/data/test/wi_sfsp_3dp_00000000_v01.cdf +0 -0
  54. {seppy-0.1.17 → seppy-0.1.19}/seppy/data/test/wi_sfsp_3dp_20200213_v01.cdf +0 -0
  55. {seppy-0.1.17 → seppy-0.1.19}/seppy/loader/solo.py +0 -0
  56. {seppy-0.1.17 → seppy-0.1.19}/seppy/tests/test_tools.py +0 -0
  57. {seppy-0.1.17 → seppy-0.1.19}/seppy/tools/swaves.py +0 -0
  58. {seppy-0.1.17 → seppy-0.1.19}/seppy/tools/widgets.py +0 -0
  59. {seppy-0.1.17 → seppy-0.1.19}/seppy/util/__init__.py +0 -0
  60. {seppy-0.1.17 → seppy-0.1.19}/seppy.egg-info/dependency_links.txt +0 -0
  61. {seppy-0.1.17 → seppy-0.1.19}/seppy.egg-info/not-zip-safe +0 -0
  62. {seppy-0.1.17 → seppy-0.1.19}/seppy.egg-info/top_level.txt +0 -0
@@ -0,0 +1,10 @@
1
+ # .github/release.yml
2
+
3
+ changelog:
4
+ categories:
5
+ - title: Bugfixes 🛠
6
+ labels:
7
+ - bug
8
+ - title: New Features 🎉
9
+ labels:
10
+ - enhancement
@@ -0,0 +1,45 @@
1
+ # This workflow will install Python dependencies, run tests and lint with a variety of Python versions
2
+ # For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
3
+
4
+ name: pytest
5
+
6
+ on:
7
+ push:
8
+ # branches: [ "main" ]
9
+ pull_request:
10
+ # branches: [ "main" ]
11
+
12
+ jobs:
13
+ build:
14
+
15
+ runs-on: ubuntu-latest
16
+ strategy:
17
+ fail-fast: false
18
+ matrix:
19
+ python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
20
+
21
+ steps:
22
+ - uses: actions/checkout@v4
23
+ - name: Set up Python ${{ matrix.python-version }}
24
+ uses: actions/setup-python@v5
25
+ with:
26
+ python-version: ${{ matrix.python-version }}
27
+ - name: Install dependencies
28
+ run: |
29
+ python -m pip install --upgrade pip
30
+ python -m pip install flake8 nbmake pytest pytest-doctestplus pytest-cov
31
+ # if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
32
+ pip install .
33
+ - name: Lint with flake8
34
+ run: |
35
+ # stop the build if there are Python syntax errors or undefined names
36
+ flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
37
+ # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
38
+ flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
39
+ - name: Test with pytest
40
+ run: |
41
+ pytest --cov --nbmake .
42
+ - name: Upload coverage reports to Codecov
43
+ uses: codecov/codecov-action@v4
44
+ env:
45
+ CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
@@ -0,0 +1,141 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[cod]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+
9
+ # Distribution / packaging
10
+ .Python
11
+ build/
12
+ develop-eggs/
13
+ dist/
14
+ downloads/
15
+ eggs/
16
+ .eggs/
17
+ lib/
18
+ lib64/
19
+ parts/
20
+ sdist/
21
+ var/
22
+ wheels/
23
+ pip-wheel-metadata/
24
+ share/python-wheels/
25
+ *.egg-info/
26
+ .installed.cfg
27
+ *.egg
28
+ MANIFEST
29
+
30
+ # file generated by setuptools_scm
31
+ _version.py
32
+
33
+ # PyInstaller
34
+ # Usually these files are written by a python script from a template
35
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
36
+ *.manifest
37
+ *.spec
38
+
39
+ # Installer logs
40
+ pip-log.txt
41
+ pip-delete-this-directory.txt
42
+
43
+ # Unit test / coverage reports
44
+ htmlcov/
45
+ .tmp/
46
+ .tox/
47
+ .nox/
48
+ .coverage
49
+ .coverage.*
50
+ .cache
51
+ nosetests.xml
52
+ coverage.xml
53
+ *.cover
54
+ *.py,cover
55
+ .hypothesis/
56
+ .pytest_cache/
57
+
58
+ # Translations
59
+ *.mo
60
+ *.pot
61
+
62
+ # Django stuff:
63
+ *.log
64
+ local_settings.py
65
+ db.sqlite3
66
+ db.sqlite3-journal
67
+
68
+ # Flask stuff:
69
+ instance/
70
+ .webassets-cache
71
+
72
+ # Scrapy stuff:
73
+ .scrapy
74
+
75
+ # Sphinx documentation
76
+ docs/_build/
77
+
78
+ # PyBuilder
79
+ target/
80
+
81
+ # Jupyter Notebook
82
+ .ipynb_checkpoints
83
+
84
+ # IPython
85
+ profile_default/
86
+ ipython_config.py
87
+
88
+ # pyenv
89
+ .python-version
90
+
91
+ # pipenv
92
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
93
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
94
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
95
+ # install all needed dependencies.
96
+ #Pipfile.lock
97
+
98
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow
99
+ __pypackages__/
100
+
101
+ # Celery stuff
102
+ celerybeat-schedule
103
+ celerybeat.pid
104
+
105
+ # SageMath parsed files
106
+ *.sage.py
107
+
108
+ # Environments
109
+ .env
110
+ .venv
111
+ env/
112
+ venv/
113
+ ENV/
114
+ env.bak/
115
+ venv.bak/
116
+
117
+ # Spyder project settings
118
+ .spyderproject
119
+ .spyproject
120
+
121
+ # Rope project settings
122
+ .ropeproject
123
+
124
+ # mkdocs documentation
125
+ /site
126
+
127
+ # mypy
128
+ .mypy_cache/
129
+ .dmypy.json
130
+ dmypy.json
131
+
132
+ # Pyre type checker
133
+ .pyre/
134
+ .vscode/settings.json
135
+
136
+ ### MacOS: https://raw.githubusercontent.com/github/gitignore/master/Global/macOS.gitignore
137
+
138
+ # General
139
+ .DS_Store
140
+ .AppleDouble
141
+ .LSOverride
@@ -0,0 +1,53 @@
1
+ {
2
+ "description": "A compendium of Python data loaders and analysis tools for in-situ measurements of Solar Energetic Particles (SEP).",
3
+ "license": "BSD-3-Clause",
4
+ "title": "SEPpy",
5
+ "grants": [
6
+ {
7
+ "id": "10.13039/501100000780::101004159"
8
+ }
9
+ ],
10
+ "upload_type": "software",
11
+ "creators": [
12
+ {
13
+ "name": "Gieseler, Jan",
14
+ "orcid": "0000-0003-1848-7067",
15
+ "affiliation": "University of Turku"
16
+ },
17
+ {
18
+ "name": "Palmroos, Christian",
19
+ "orcid": "0000-0002-7778-5454",
20
+ "affiliation": "University of Turku"
21
+ },
22
+ {
23
+ "name": "Dresing, Nina",
24
+ "orcid": "0000-0003-3903-4649",
25
+ "affiliation": "University of Turku"
26
+ },
27
+ {
28
+ "name": "Morosan, Diana",
29
+ "orcid": "0000-0002-8416-1375",
30
+ "affiliation": "University of Helsinki"
31
+ },
32
+ {
33
+ "name": "Asvestari, Eleanna",
34
+ "orcid": "0000-0002-6998-7224",
35
+ "affiliation": "University of Helsinki"
36
+ },
37
+ {
38
+ "name": "Yli-Laurila, Aleksi",
39
+ "affiliation": "University of Turku"
40
+ },
41
+ {
42
+ "name": "Price, Daniel J.",
43
+ "orcid": "0000-0002-8065-2847",
44
+ "affiliation": "University of Helsinki"
45
+ },
46
+ {
47
+ "name": "Vainio, Rami",
48
+ "orcid": "0000-0002-3298-2067",
49
+ "affiliation": "University of Turku"
50
+ }
51
+ ],
52
+ "access_right": "open"
53
+ }
@@ -0,0 +1,11 @@
1
+ # Exclude specific files
2
+ # All files which are tracked by git and not explicitly excluded here are included by setuptools_scm
3
+ # Prune folders
4
+ prune build
5
+ prune docs/_build
6
+ prune docs/api
7
+ global-exclude *.pyc *.o
8
+
9
+ # This subpackage is only used in development checkouts
10
+ # and should not be included in built tarballs
11
+ prune seppy/_dev
@@ -1,28 +1,54 @@
1
- Metadata-Version: 2.2
1
+ Metadata-Version: 2.4
2
2
  Name: seppy
3
- Version: 0.1.17
3
+ Version: 0.1.19
4
4
  Summary: SEPpy
5
- Home-page: https://github.com/serpentine-h2020/SEPpy
6
- Author: Jan Gieseler
7
- Author-email: jan.gieseler@utu.fi
8
- License: BSD 3-clause
5
+ Author-email: Jan Gieseler <jan.gieseler@utu.fi>
6
+ License: Copyright (c) 2022, Jan Gieseler
7
+ All rights reserved.
8
+
9
+ Redistribution and use in source and binary forms, with or without modification,
10
+ are permitted provided that the following conditions are met:
11
+
12
+ * Redistributions of source code must retain the above copyright notice, this
13
+ list of conditions and the following disclaimer.
14
+ * Redistributions in binary form must reproduce the above copyright notice, this
15
+ list of conditions and the following disclaimer in the documentation and/or
16
+ other materials provided with the distribution.
17
+ * Neither the name of SEPpy nor the names of its contributors may be
18
+ used to endorse or promote products derived from this software without
19
+ specific prior written permission.
20
+
21
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
22
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
23
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
24
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
25
+ ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
26
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
27
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
28
+ ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
30
+ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31
+
32
+ Project-URL: repository, https://github.com/serpentine-h2020/SEPpy
9
33
  Classifier: Intended Audience :: Science/Research
10
34
  Classifier: License :: OSI Approved :: BSD License
11
35
  Classifier: Natural Language :: English
12
36
  Classifier: Operating System :: OS Independent
13
37
  Classifier: Programming Language :: Python
14
- Classifier: Programming Language :: Python :: 3.8
15
38
  Classifier: Programming Language :: Python :: 3.9
16
39
  Classifier: Programming Language :: Python :: 3.10
17
40
  Classifier: Programming Language :: Python :: 3.11
18
41
  Classifier: Programming Language :: Python :: 3.12
42
+ Classifier: Programming Language :: Python :: 3.13
19
43
  Classifier: Topic :: Scientific/Engineering :: Physics
20
- Requires-Python: >=3.8
21
- License-File: licenses/LICENSE.rst
44
+ Requires-Python: >=3.9
45
+ Description-Content-Type: text/x-rst
46
+ License-File: LICENSE.rst
22
47
  Requires-Dist: astropy
23
48
  Requires-Dist: astroquery
24
49
  Requires-Dist: bs4
25
50
  Requires-Dist: cdflib
51
+ Requires-Dist: ipympl
26
52
  Requires-Dist: ipywidgets
27
53
  Requires-Dist: matplotlib
28
54
  Requires-Dist: mpl-animators>=1.0.0
@@ -32,7 +58,6 @@ Requires-Dist: pooch
32
58
  Requires-Dist: requests
33
59
  Requires-Dist: solo-epd-loader
34
60
  Requires-Dist: sunpy>=4.1.0
35
- Provides-Extra: all
36
61
  Provides-Extra: test
37
62
  Requires-Dist: pytest; extra == "test"
38
63
  Requires-Dist: pytest-doctestplus; extra == "test"
@@ -40,11 +65,12 @@ Requires-Dist: pytest-cov; extra == "test"
40
65
  Provides-Extra: docs
41
66
  Requires-Dist: sphinx; extra == "docs"
42
67
  Requires-Dist: sphinx-automodapi; extra == "docs"
68
+ Dynamic: license-file
43
69
 
44
70
  seppy
45
71
  =====
46
72
 
47
- |pypi Version| |python version| |pytest| |codecov| |zenodo doi|
73
+ |pypi Version| |python version| |pytest| |codecov| |repostatus| |zenodo doi|
48
74
 
49
75
  .. |pypi Version| image:: https://img.shields.io/pypi/v/seppy?style=flat&logo=pypi
50
76
  :target: https://pypi.org/project/seppy/
@@ -54,6 +80,9 @@ seppy
54
80
  .. |pytest| image:: https://github.com/serpentine-h2020/SEPpy/actions/workflows/pytest.yml/badge.svg?branch=main
55
81
  .. |codecov| image:: https://codecov.io/gh/serpentine-h2020/SEPpy/branch/main/graph/badge.svg?token=FYELM4Y7DF
56
82
  :target: https://codecov.io/gh/serpentine-h2020/SEPpy
83
+ .. |repostatus| image:: https://www.repostatus.org/badges/latest/active.svg
84
+ :alt: Project Status: Active – The project has reached a stable, usable state and is being actively developed.
85
+ :target: https://www.repostatus.org/#active
57
86
 
58
87
  *This package is in development status! Intended for internal use only, as the syntax is in a floating state and the documentation is incomplete.*
59
88
 
@@ -77,7 +106,7 @@ This software is provided "as is", with no guarantee. It is no official data sou
77
106
  Installation
78
107
  ------------
79
108
 
80
- seppy requires python >= 3.8.
109
+ seppy requires python >= 3.9.
81
110
 
82
111
  It can be installed from `PyPI <https://pypi.org/project/seppy/>`_ using:
83
112
 
@@ -1,7 +1,7 @@
1
1
  seppy
2
2
  =====
3
3
 
4
- |pypi Version| |python version| |pytest| |codecov| |zenodo doi|
4
+ |pypi Version| |python version| |pytest| |codecov| |repostatus| |zenodo doi|
5
5
 
6
6
  .. |pypi Version| image:: https://img.shields.io/pypi/v/seppy?style=flat&logo=pypi
7
7
  :target: https://pypi.org/project/seppy/
@@ -11,6 +11,9 @@ seppy
11
11
  .. |pytest| image:: https://github.com/serpentine-h2020/SEPpy/actions/workflows/pytest.yml/badge.svg?branch=main
12
12
  .. |codecov| image:: https://codecov.io/gh/serpentine-h2020/SEPpy/branch/main/graph/badge.svg?token=FYELM4Y7DF
13
13
  :target: https://codecov.io/gh/serpentine-h2020/SEPpy
14
+ .. |repostatus| image:: https://www.repostatus.org/badges/latest/active.svg
15
+ :alt: Project Status: Active – The project has reached a stable, usable state and is being actively developed.
16
+ :target: https://www.repostatus.org/#active
14
17
 
15
18
  *This package is in development status! Intended for internal use only, as the syntax is in a floating state and the documentation is incomplete.*
16
19
 
@@ -34,7 +37,7 @@ This software is provided "as is", with no guarantee. It is no official data sou
34
37
  Installation
35
38
  ------------
36
39
 
37
- seppy requires python >= 3.8.
40
+ seppy requires python >= 3.9.
38
41
 
39
42
  It can be installed from `PyPI <https://pypi.org/project/seppy/>`_ using:
40
43
 
@@ -1,68 +1,82 @@
1
- # -*- coding: utf-8 -*-
2
- #
3
1
  # Configuration file for the Sphinx documentation builder.
4
2
  #
5
3
  # This file does only contain a selection of the most common options. For a
6
4
  # full list see the documentation:
7
5
  # http://www.sphinx-doc.org/en/master/config
8
6
 
7
+ import datetime
9
8
 
10
9
  # -- Project information -----------------------------------------------------
11
10
 
12
- project = 'SEPpy'
13
- copyright = '2022, Jan Gieseler'
14
- author = 'Jan Gieseler'
15
-
16
11
  # The full version, including alpha/beta/rc tags
17
12
  from seppy import __version__
13
+
18
14
  release = __version__
19
15
 
16
+ project = "SEPpy"
17
+ author = "Jan Gieseler"
18
+ copyright = f"{datetime.datetime.now().year}, {author}" # noqa: A001
19
+
20
20
  # -- General configuration ---------------------------------------------------
21
21
 
22
22
  # Add any Sphinx extension module names here, as strings. They can be
23
- # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
23
+ # extensions coming with Sphinx (named "sphinx.ext.*") or your custom
24
24
  # ones.
25
25
  extensions = [
26
- 'sphinx.ext.autodoc',
27
- 'sphinx.ext.intersphinx',
28
- 'sphinx.ext.todo',
29
- 'sphinx.ext.coverage',
30
- 'sphinx.ext.inheritance_diagram',
31
- 'sphinx.ext.viewcode',
32
- 'sphinx.ext.napoleon',
33
- 'sphinx.ext.doctest',
34
- 'sphinx.ext.mathjax',
35
- 'sphinx_automodapi.automodapi',
36
- 'sphinx_automodapi.smart_resolver',
26
+ "sphinx.ext.autodoc",
27
+ "sphinx.ext.intersphinx",
28
+ "sphinx.ext.todo",
29
+ "sphinx.ext.coverage",
30
+ "sphinx.ext.inheritance_diagram",
31
+ "sphinx.ext.viewcode",
32
+ "sphinx.ext.napoleon",
33
+ "sphinx.ext.doctest",
34
+ "sphinx.ext.mathjax",
35
+ "sphinx_automodapi.automodapi",
36
+ "sphinx_automodapi.smart_resolver",
37
37
  ]
38
38
 
39
39
  # Add any paths that contain templates here, relative to this directory.
40
- # templates_path = ['_templates']
40
+ # templates_path = ["_templates"]
41
41
 
42
42
  # List of patterns, relative to source directory, that match files and
43
43
  # directories to ignore when looking for source files.
44
44
  # This pattern also affects html_static_path and html_extra_path.
45
- exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
45
+ exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
46
46
 
47
47
  # The suffix(es) of source filenames.
48
48
  # You can specify multiple suffix as a list of string:
49
- source_suffix = '.rst'
49
+ source_suffix = ".rst"
50
50
 
51
51
  # The master toctree document.
52
- master_doc = 'index'
52
+ master_doc = "index"
53
+
54
+ # Treat everything in single ` as a Python reference.
55
+ default_role = 'py:obj'
53
56
 
54
57
  # -- Options for intersphinx extension ---------------------------------------
55
58
 
56
59
  # Example configuration for intersphinx: refer to the Python standard library.
57
- intersphinx_mapping = {'https://docs.python.org/': None}
60
+ intersphinx_mapping = {"python": ("https://docs.python.org/", None)}
58
61
 
59
62
  # -- Options for HTML output -------------------------------------------------
60
63
 
61
64
  # The theme to use for HTML and HTML Help pages. See the documentation for
62
65
  # a list of builtin themes.
63
- html_theme = 'alabaster'
66
+ html_theme = "alabaster"
64
67
 
65
68
  # Add any paths that contain custom static files (such as style sheets) here,
66
69
  # relative to this directory. They are copied after the builtin static files,
67
70
  # so a file named "default.css" will overwrite the builtin "default.css".
68
- # html_static_path = ['_static']
71
+ # html_static_path = ["_static"]
72
+
73
+ # By default, when rendering docstrings for classes, sphinx.ext.autodoc will
74
+ # make docs with the class-level docstring and the class-method docstrings,
75
+ # but not the __init__ docstring, which often contains the parameters to
76
+ # class constructors across the scientific Python ecosystem. The option below
77
+ # will append the __init__ docstring to the class-level docstring when rendering
78
+ # the docs. For more options, see:
79
+ # https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#confval-autoclass_content
80
+ autoclass_content = "both"
81
+
82
+ # -- Other options ----------------------------------------------------------
@@ -0,0 +1,15 @@
1
+ SEPpy Documentation
2
+ -------------------
3
+
4
+ This is the documentation for seppy.
5
+
6
+ .. toctree::
7
+ :maxdepth: 2
8
+ :caption: Contents:
9
+
10
+ Indices and tables
11
+ ==================
12
+
13
+ * :ref:`genindex`
14
+ * :ref:`modindex`
15
+ * :ref:`search`
@@ -1,35 +1,35 @@
1
- @ECHO OFF
2
-
3
- pushd %~dp0
4
-
5
- REM Command file for Sphinx documentation
6
-
7
- if "%SPHINXBUILD%" == "" (
8
- set SPHINXBUILD=sphinx-build
9
- )
10
- set SOURCEDIR=.
11
- set BUILDDIR=_build
12
-
13
- if "%1" == "" goto help
14
-
15
- %SPHINXBUILD% >NUL 2>NUL
16
- if errorlevel 9009 (
17
- echo.
18
- echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
19
- echo.installed, then set the SPHINXBUILD environment variable to point
20
- echo.to the full path of the 'sphinx-build' executable. Alternatively you
21
- echo.may add the Sphinx directory to PATH.
22
- echo.
23
- echo.If you don't have Sphinx installed, grab it from
24
- echo.http://sphinx-doc.org/
25
- exit /b 1
26
- )
27
-
28
- %SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
29
- goto end
30
-
31
- :help
32
- %SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
33
-
34
- :end
35
- popd
1
+ @ECHO OFF
2
+
3
+ pushd %~dp0
4
+
5
+ REM Command file for Sphinx documentation
6
+
7
+ if "%SPHINXBUILD%" == "" (
8
+ set SPHINXBUILD=sphinx-build
9
+ )
10
+ set SOURCEDIR=.
11
+ set BUILDDIR=_build
12
+
13
+ if "%1" == "" goto help
14
+
15
+ %SPHINXBUILD% >NUL 2>NUL
16
+ if errorlevel 9009 (
17
+ echo.
18
+ echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
19
+ echo.installed, then set the SPHINXBUILD environment variable to point
20
+ echo.to the full path of the 'sphinx-build' executable. Alternatively you
21
+ echo.may add the Sphinx directory to PATH.
22
+ echo.
23
+ echo.If you don't have Sphinx installed, grab it from
24
+ echo.http://sphinx-doc.org/
25
+ exit /b 1
26
+ )
27
+
28
+ %SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
29
+ goto end
30
+
31
+ :help
32
+ %SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
33
+
34
+ :end
35
+ popd