docs: add docs to data storage & enums (#312)

bonjourmauko · web-flow · commit 9f59e662b829 · 2024-10-16T13:34:41.000Z
diff --git a/Makefile b/Makefile
@@ -14,7 +14,9 @@ install:
 	@pip install --upgrade pip
 	@pip install -r requirements.txt --use-deprecated=legacy-resolver
 
-test: lint test-build
+test:
+	@${MAKE} lint
+	@${MAKE} test-build
 
 test-build:
 	@${MAKE} dummy SPHINXOPTS="--quiet --fail-on-warning"
diff --git a/source/conf.py b/source/conf.py
@@ -69,7 +69,10 @@
     'ignore-module-all': True
 }
 
-napoleon_custom_sections = [('Returns', 'params_style')]
+napoleon_custom_sections = [
+    ('Raises', 'params_style'),
+    ('Returns', 'params_style'),
+]
 
 
 def missing_reference(app, env, node, contnode):
diff --git a/source/openfisca-python-api/data_storage.rst b/source/openfisca-python-api/data_storage.rst
@@ -0,0 +1,8 @@
+============
+Data Storage
+============
+
+.. automodule:: openfisca_core.data_storage
+    :members:
+    :imported-members:
+    :private-members: _decode_file
diff --git a/source/openfisca-python-api/enum_array.rst b/source/openfisca-python-api/enum_array.rst
@@ -2,13 +2,7 @@
 Enum & EnumArray
 ================
 
-.. module:: openfisca_core.indexed_enums
-
-.. autoclass:: Enum
-  :members:
-
-.. autoclass:: EnumArray
-  :members:
-
-.. automodule:: openfisca_core.indexed_enums.config
+.. automodule:: openfisca_core.indexed_enums
     :members:
+    :imported-members:
+    :special-members: __eq__, __ne__, __new__, __array_finalize__
diff --git a/source/openfisca-python-api/index.md b/source/openfisca-python-api/index.md
@@ -4,6 +4,7 @@ Modules:
 
 ```{toctree}
 commons
+data_storage
 tax-benefit-system
 variables
 parameters

Original file line number	Diff line number	Diff line change
`@@ -69,7 +69,10 @@`
`69`	`69`	`'ignore-module-all': True`
`70`	`70`	`}`
`71`	`71`
`72`		`-napoleon_custom_sections = [('Returns', 'params_style')]`
	`72`	`+napoleon_custom_sections = [`
	`73`	`+ ('Raises', 'params_style'),`
	`74`	`+ ('Returns', 'params_style'),`
	`75`	`+]`
`73`	`76`
`74`	`77`
`75`	`78`	`def missing_reference(app, env, node, contnode):`