Skip to content

Commit cad4093

Browse files
author
Sergio García Prado
authored
Merge pull request #112 from minos-framework/restyled/issue-1-remove-duplicate-config-packages
Restyle #1 - Remove duplicate config from packages
2 parents eb41271 + 5703d41 commit cad4093

File tree

5 files changed

+135
-148
lines changed
  • packages/core
    • minos-microservice-aggregate/docs
    • minos-microservice-common/docs
    • minos-microservice-cqrs/docs
    • minos-microservice-networks/docs
    • minos-microservice-saga/docs

5 files changed

+135
-148
lines changed

packages/core/minos-microservice-aggregate/docs/conf.py

Lines changed: 27 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,14 @@
1919
#
2020
import os
2121
import sys
22-
sys.path.insert(0, os.path.abspath('..'))
2322

24-
from minos import aggregate
23+
sys.path.insert(0, os.path.abspath(".."))
24+
25+
import sphinx_rtd_theme
26+
27+
from minos import (
28+
aggregate,
29+
)
2530

2631
# -- General configuration ---------------------------------------------
2732

@@ -32,29 +37,28 @@
3237
# Add any Sphinx extension module names here, as strings. They can be
3338
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
3439

35-
import sphinx_rtd_theme
3640

3741
extensions = [
3842
"sphinxcontrib.apidoc",
39-
'sphinx.ext.autodoc',
43+
"sphinx.ext.autodoc",
4044
"sphinx_autodoc_typehints",
4145
"sphinx.ext.viewcode",
4246
"sphinx_rtd_theme",
4347
"m2r2",
4448
]
4549
# Add any paths that contain templates here, relative to this directory.
46-
templates_path = ['_templates']
50+
templates_path = ["_templates"]
4751

4852
# The suffix(es) of source filenames.
4953
# You can specify multiple suffix as a list of string:
5054
#
51-
source_suffix = ['.rst', '.md']
55+
source_suffix = [".rst", ".md"]
5256

5357
# The master toctree document.
54-
master_doc = 'index'
58+
master_doc = "index"
5559

5660
# General information about the project.
57-
project = 'Minos Microservice Aggregate'
61+
project = "Minos Microservice Aggregate"
5862
copyright = "2021, Clariteia"
5963
author = "Clariteia Devs"
6064

@@ -77,10 +81,10 @@
7781
# List of patterns, relative to source directory, that match files and
7882
# directories to ignore when looking for source files.
7983
# This patterns also effect to html_static_path and html_extra_path
80-
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
84+
exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
8185

8286
# The name of the Pygments (syntax highlighting) style to use.
83-
pygments_style = 'sphinx'
87+
pygments_style = "sphinx"
8488

8589
# If true, `todo` and `todoList` produce output, else they produce nothing.
8690
todo_include_todos = False
@@ -92,7 +96,7 @@
9296
# a list of builtin themes.
9397
#
9498

95-
html_theme = 'sphinx_rtd_theme'
99+
html_theme = "sphinx_rtd_theme"
96100

97101
# Theme options are theme-specific and customize the look and feel of a
98102
# theme further. For a list of options available for each theme, see the
@@ -119,7 +123,7 @@
119123
# -- Options for HTMLHelp output ---------------------------------------
120124

121125
# Output file base name for HTML help builder.
122-
htmlhelp_basename = 'minosdoc'
126+
htmlhelp_basename = "minosdoc"
123127

124128

125129
# -- Options for LaTeX output ------------------------------------------
@@ -128,15 +132,12 @@
128132
# The paper size ('letterpaper' or 'a4paper').
129133
#
130134
# 'papersize': 'letterpaper',
131-
132135
# The font size ('10pt', '11pt' or '12pt').
133136
#
134137
# 'pointsize': '10pt',
135-
136138
# Additional stuff for the LaTeX preamble.
137139
#
138140
# 'preamble': '',
139-
140141
# Latex figure (float) alignment
141142
#
142143
# 'figure_align': 'htbp',
@@ -146,21 +147,15 @@
146147
# (source start file, target name, title, author, documentclass
147148
# [howto, manual, or own class]).
148149
latex_documents = [
149-
(master_doc, 'minos.tex',
150-
'Minos Microservice Aggregate Documentation',
151-
'Clariteia Devs', 'manual'),
150+
(master_doc, "minos.tex", "Minos Microservice Aggregate Documentation", "Clariteia Devs", "manual"),
152151
]
153152

154153

155154
# -- Options for manual page output ------------------------------------
156155

157156
# One entry per manual page. List of tuples
158157
# (source start file, name, description, authors, manual section).
159-
man_pages = [
160-
(master_doc, 'minos',
161-
'Minos Microservice Aggregate Documentation',
162-
[author], 1)
163-
]
158+
man_pages = [(master_doc, "minos", "Minos Microservice Aggregate Documentation", [author], 1)]
164159

165160

166161
# -- Options for Texinfo output ----------------------------------------
@@ -169,12 +164,15 @@
169164
# (source start file, target name, title, author,
170165
# dir menu entry, description, category)
171166
texinfo_documents = [
172-
(master_doc, 'minos',
173-
'Minos Microservice Aggregate Documentation',
174-
author,
175-
'minos',
176-
'One line description of project.',
177-
'Miscellaneous'),
167+
(
168+
master_doc,
169+
"minos",
170+
"Minos Microservice Aggregate Documentation",
171+
author,
172+
"minos",
173+
"One line description of project.",
174+
"Miscellaneous",
175+
),
178176
]
179177

180178
# "apidoc" extension

packages/core/minos-microservice-common/docs/conf.py

Lines changed: 28 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,14 @@
1919
#
2020
import os
2121
import sys
22-
sys.path.insert(0, os.path.abspath('..'))
2322

24-
from minos import common
23+
sys.path.insert(0, os.path.abspath(".."))
24+
25+
import sphinx_rtd_theme
26+
27+
from minos import (
28+
common,
29+
)
2530

2631
# -- General configuration ---------------------------------------------
2732

@@ -32,29 +37,28 @@
3237
# Add any Sphinx extension module names here, as strings. They can be
3338
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
3439

35-
import sphinx_rtd_theme
3640

3741
extensions = [
3842
"sphinxcontrib.apidoc",
39-
'sphinx.ext.autodoc',
43+
"sphinx.ext.autodoc",
4044
"sphinx_autodoc_typehints",
4145
"sphinx.ext.viewcode",
4246
"sphinx_rtd_theme",
4347
"m2r2",
4448
]
4549
# Add any paths that contain templates here, relative to this directory.
46-
templates_path = ['_templates']
50+
templates_path = ["_templates"]
4751

4852
# The suffix(es) of source filenames.
4953
# You can specify multiple suffix as a list of string:
5054
#
51-
source_suffix = ['.rst', '.md']
55+
source_suffix = [".rst", ".md"]
5256

5357
# The master toctree document.
54-
master_doc = 'index'
58+
master_doc = "index"
5559

5660
# General information about the project.
57-
project = 'Minos Microservice Common'
61+
project = "Minos Microservice Common"
5862
copyright = "2021, Clariteia"
5963
author = "Clariteia Devs"
6064

@@ -77,10 +81,10 @@
7781
# List of patterns, relative to source directory, that match files and
7882
# directories to ignore when looking for source files.
7983
# This patterns also effect to html_static_path and html_extra_path
80-
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
84+
exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
8185

8286
# The name of the Pygments (syntax highlighting) style to use.
83-
pygments_style = 'sphinx'
87+
pygments_style = "sphinx"
8488

8589
# If true, `todo` and `todoList` produce output, else they produce nothing.
8690
todo_include_todos = False
@@ -92,7 +96,7 @@
9296
# a list of builtin themes.
9397
#
9498

95-
html_theme = 'sphinx_rtd_theme'
99+
html_theme = "sphinx_rtd_theme"
96100

97101
# Theme options are theme-specific and customize the look and feel of a
98102
# theme further. For a list of options available for each theme, see the
@@ -119,7 +123,7 @@
119123
# -- Options for HTMLHelp output ---------------------------------------
120124

121125
# Output file base name for HTML help builder.
122-
htmlhelp_basename = 'minosdoc'
126+
htmlhelp_basename = "minosdoc"
123127

124128

125129
# -- Options for LaTeX output ------------------------------------------
@@ -128,15 +132,12 @@
128132
# The paper size ('letterpaper' or 'a4paper').
129133
#
130134
# 'papersize': 'letterpaper',
131-
132135
# The font size ('10pt', '11pt' or '12pt').
133136
#
134137
# 'pointsize': '10pt',
135-
136138
# Additional stuff for the LaTeX preamble.
137139
#
138140
# 'preamble': '',
139-
140141
# Latex figure (float) alignment
141142
#
142143
# 'figure_align': 'htbp',
@@ -146,21 +147,15 @@
146147
# (source start file, target name, title, author, documentclass
147148
# [howto, manual, or own class]).
148149
latex_documents = [
149-
(master_doc, 'minos.tex',
150-
'Minos Microservice Common Documentation',
151-
'Clariteia Devs', 'manual'),
150+
(master_doc, "minos.tex", "Minos Microservice Common Documentation", "Clariteia Devs", "manual"),
152151
]
153152

154153

155154
# -- Options for manual page output ------------------------------------
156155

157156
# One entry per manual page. List of tuples
158157
# (source start file, name, description, authors, manual section).
159-
man_pages = [
160-
(master_doc, 'minos',
161-
'Minos Microservice Common Documentation',
162-
[author], 1)
163-
]
158+
man_pages = [(master_doc, "minos", "Minos Microservice Common Documentation", [author], 1)]
164159

165160

166161
# -- Options for Texinfo output ----------------------------------------
@@ -169,12 +164,15 @@
169164
# (source start file, target name, title, author,
170165
# dir menu entry, description, category)
171166
texinfo_documents = [
172-
(master_doc, 'minos',
173-
'Minos Microservice Common Documentation',
174-
author,
175-
'minos',
176-
'One line description of project.',
177-
'Miscellaneous'),
167+
(
168+
master_doc,
169+
"minos",
170+
"Minos Microservice Common Documentation",
171+
author,
172+
"minos",
173+
"One line description of project.",
174+
"Miscellaneous",
175+
),
178176
]
179177

180178
# "apidoc" extension
@@ -193,9 +191,7 @@
193191
"--force",
194192
"--implicit-namespaces",
195193
]
196-
apidoc_excluded_paths = [
197-
'../minos/common/testing.py'
198-
]
194+
apidoc_excluded_paths = ["../minos/common/testing.py"]
199195
# "autodoc typehints" extension
200196

201197
set_type_checking_flag = True

0 commit comments

Comments
 (0)