Skip to content

Commit

Permalink
add docstrings to __init__.py
Browse files Browse the repository at this point in the history
  • Loading branch information
JessyBarrette committed Oct 7, 2024
1 parent 33f3537 commit 2fdaf81
Show file tree
Hide file tree
Showing 10 changed files with 62 additions and 1 deletion.
12 changes: 12 additions & 0 deletions ocean_data_parser/batch/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
"""This module contains the batch processing functions for the ocean data parser.
Modules:
- __init__.py: Initializes the batch package.
- convert.py: Contains functions to convert multiple files at once.
- utils.py: Contains utility functions for batch processing.
- registry.py: Contains the registry for batch processing functions.
- config.py: Contains functions to load configuration files.
- default-batch-config.json: Default configuration file for batch processing.
The batch package is responsible for managing and processing multiple files at once.
"""
11 changes: 11 additions & 0 deletions ocean_data_parser/metadata/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
"""This package contains modules related to metadata used in the ocean data parser.
Modules:
- __init__.py: Initializes the metadata package.
- cf.py: Contains functions to load CF metadata standard names.
- nerc.py: Contains functions to load NERC metadata standard names.
- pdc.py: Contains functions to convert PDC metadata standard names
to the ACDD 1.3 standard format.
The metadata package is responsible for managing and parsing various metadata
"""
2 changes: 1 addition & 1 deletion ocean_data_parser/parsers/__init__.py
Original file line number Diff line number Diff line change
@@ -1 +1 @@

"""This package contains all the parsers used in the ocean data parser."""
11 changes: 11 additions & 0 deletions ocean_data_parser/parsers/dfo/__init__.py
Original file line number Diff line number Diff line change
@@ -1,2 +1,13 @@
"""This package contains all the parsers related to the Fisheries and Ocean Canada standard formats.
Modules:
- __init__.py: Initializes the parsers package.
- ios.py: Contains functions to parse the DFO-IOS office file formats.
- nafc.py: Contains functions to parse DFO-NAFC office file formats.
- odf.py: Contains functions to parse the ODF file format used at
the DFO-BIO and DFO-IML offices.
"""

__all__ = ["ios", "nafc", "odf"]
from . import ios, nafc, odf
1 change: 1 addition & 0 deletions ocean_data_parser/parsers/dfo/ios_source/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
"""This module contains the parsers for the Institute of Ocean Sciences (IOS) file formats."""
1 change: 1 addition & 0 deletions ocean_data_parser/parsers/dfo/odf_source/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
"""This package contains all the parsers related to the Fisheries and Ocean Canada ODF standard format."""
1 change: 1 addition & 0 deletions ocean_data_parser/process/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
"""This package contains modules related to processing oceanographic data."""

Check failure on line 1 in ocean_data_parser/process/__init__.py

View workflow job for this annotation

GitHub Actions / testing

Ruff (W292)

ocean_data_parser/process/__init__.py:1:78: W292 No newline at end of file
2 changes: 2 additions & 0 deletions ocean_data_parser/tools/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
"""This package a series of tools used by the ocean_data_parser package."""
"""

Check failure on line 2 in ocean_data_parser/tools/__init__.py

View workflow job for this annotation

GitHub Actions / testing

Ruff

ocean_data_parser/tools/__init__.py:2:1: SyntaxError: missing closing quote in string literal

Check failure on line 2 in ocean_data_parser/tools/__init__.py

View workflow job for this annotation

GitHub Actions / testing

Ruff

ocean_data_parser/tools/__init__.py:2:4: SyntaxError: Expected a statement

Check failure on line 2 in ocean_data_parser/tools/__init__.py

View workflow job for this annotation

GitHub Actions / testing

Ruff

ocean_data_parser/tools/__init__.py:2:1: SyntaxError: missing closing quote in string literal

Check failure on line 2 in ocean_data_parser/tools/__init__.py

View workflow job for this annotation

GitHub Actions / testing

Ruff

ocean_data_parser/tools/__init__.py:2:4: SyntaxError: Expected a statement

Check failure on line 2 in ocean_data_parser/tools/__init__.py

View workflow job for this annotation

GitHub Actions / testing

Ruff (W292)

ocean_data_parser/tools/__init__.py:2:4: W292 No newline at end of file
11 changes: 11 additions & 0 deletions ocean_data_parser/vocabularies/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
"""This package contains modules related to vocabularies used in the ocean data parser.
Modules:
- __init__.py: Initializes the vocabularies package.
- load.py: Contains functions to load vocabularies from various sources.
- *.json or *.csv: Vocabulary files containing terms and definitions
used by each specific parsers.
The vocabularies package is responsible for managing and
parsing various vocabulariesnused in oceanographic data processing.
"""
11 changes: 11 additions & 0 deletions tests/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
"""This package contains all the difrent tests to be run on the ocean_data_parser package.
Modules:
test_*.py: Contains the tests for each module in the ocean_data_parser package.
parsers_test_files/: Contains the test files used by the tests.
batch_test_config/: Contains the configuration files for the batch tests.
The tests package is responsible for testing the ocean_data_parser package during
the continuous integration process.
"""

0 comments on commit 2fdaf81

Please sign in to comment.