From d89c738c97890e13407b77b7bbbc002c31c6b705 Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 14:35:24 +0000 Subject: [PATCH 01/14] updating documentation --- docs/source/conf.py | 3 ++- docs/source/introduction.rst | 10 +++++++ docs/source/toc.rst | 10 ++++--- src/musicbrainzapi/api/lyrics/director.py | 32 +++++++++++------------ 4 files changed, 35 insertions(+), 20 deletions(-) diff --git a/docs/source/conf.py b/docs/source/conf.py index c5992ac..37a5689 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -39,6 +39,7 @@ extensions = [ 'sphinx.ext.napoleon', 'sphinx.ext.todo', 'sphinx_click.ext', + 'sphinx.ext.intersphinx' ] # -- Napoleon Settings ----------------------------------------------------- @@ -60,7 +61,7 @@ autodoc_member_order = 'bysource' templates_path = ['_templates'] # The master toctree document. -master_doc = 'introduction' +master_doc = 'index' # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. diff --git a/docs/source/introduction.rst b/docs/source/introduction.rst index 0e2138c..ac73fbe 100644 --- a/docs/source/introduction.rst +++ b/docs/source/introduction.rst @@ -1,3 +1,13 @@ +============= Introduction ============= +##### +Test +##### + +testing + +test code:: + + some test code diff --git a/docs/source/toc.rst b/docs/source/toc.rst index e4796b1..c5feb52 100644 --- a/docs/source/toc.rst +++ b/docs/source/toc.rst @@ -1,5 +1,9 @@ .. toctree:: - :maxdepth: 1 + + self + +.. toctree:: + :maxdepth: 2 :caption: Overview :titlesonly: @@ -7,14 +11,14 @@ changelog .. toctree:: - :maxdepth: 4 + :maxdepth: 2 :caption: Modules :titlesonly: modules/musicbrainzapi.rst .. toctree:: - :maxdepth: 4 + :maxdepth: 2 :caption: Submodules :titlesonly: diff --git a/src/musicbrainzapi/api/lyrics/director.py b/src/musicbrainzapi/api/lyrics/director.py index b44698b..58a5568 100644 --- a/src/musicbrainzapi/api/lyrics/director.py +++ b/src/musicbrainzapi/api/lyrics/director.py @@ -15,6 +15,22 @@ class LyricsClickDirector: def __init__(self) -> None: self._builder = None + @staticmethod + def _get_product(builder_inst: LyricsBuilder) -> Lyrics: + """Returns the constructed Lyrics object + + Parameters + ---------- + builder_inst : LyricsBuilder + Builder class for Lyrics object + + Returns + ------- + Lyrics + Lyrics object + """ + return builder_inst._product + @property def builder(self) -> LyricsBuilder: return self._builder @@ -156,19 +172,3 @@ class LyricsClickDirector: self.builder._product.show_summary() self.builder._product.show_summary_statistics(group_by='year') return self - - @staticmethod - def _get_product(builder_inst: LyricsBuilder) -> Lyrics: - """Returns the constructed Lyrics object - - Parameters - ---------- - builder_inst : LyricsBuilder - Builder class for Lyrics object - - Returns - ------- - Lyrics - Lyrics object - """ - return builder_inst._product From f2145d8cdc76d424a54091bd752a5bca41a5a0d6 Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 15:45:23 +0000 Subject: [PATCH 02/14] updating documentation --- docs/source/changelog.rst | 9 +++++---- .../modules/musicbrainzapi.api.lyrics.director.rst | 4 +--- docs/source/modules/musicbrainzapi.api.lyrics.rst | 4 +--- docs/source/modules/musicbrainzapi.api.rst | 4 +--- docs/source/toc.rst | 3 --- 5 files changed, 8 insertions(+), 16 deletions(-) diff --git a/docs/source/changelog.rst b/docs/source/changelog.rst index f1bb7a6..6a26b77 100644 --- a/docs/source/changelog.rst +++ b/docs/source/changelog.rst @@ -3,13 +3,14 @@ Changelog All notable changes to this project will be documented in this file. -The format is based on `Keep a Changelog`_ +This format is based on `Keep a Changelog`_ -.. _https://keepachangelog.com/en/1.0.0/ +.. _Keep a Changelog: https://keepachangelog.com/en/1.0.0/ -and this project adheres to `Semantic Versioning`_ +and this project adheres to `Semantic Versioning`_ + +.. _Semantic Versioning: https://semver.org/spec/v2.0.0.html -.. _https://semver.org/spec/v2.0.0.html [1.0.0] - 2020-03-07 ------------------------ diff --git a/docs/source/modules/musicbrainzapi.api.lyrics.director.rst b/docs/source/modules/musicbrainzapi.api.lyrics.director.rst index bdce62d..d284607 100644 --- a/docs/source/modules/musicbrainzapi.api.lyrics.director.rst +++ b/docs/source/modules/musicbrainzapi.api.lyrics.director.rst @@ -1,6 +1,4 @@ -.. include:: ../global.rst - -musicbrainzapi.api.lyrics.director :modname:`musicbrainzapi.api.lyrics.director` +musicbrainzapi.api.lyrics.director ---------------------------------------------------------------------------------- .. automodule:: musicbrainzapi.api.lyrics.director diff --git a/docs/source/modules/musicbrainzapi.api.lyrics.rst b/docs/source/modules/musicbrainzapi.api.lyrics.rst index 71a8c01..38ae92d 100644 --- a/docs/source/modules/musicbrainzapi.api.lyrics.rst +++ b/docs/source/modules/musicbrainzapi.api.lyrics.rst @@ -1,6 +1,4 @@ -.. include:: ../global.rst - -musicbrainzapi.api.lyrics :modname:`musicbrainzapi.api.lyrics` +musicbrainzapi.api.lyrics -------------------------------------------------------------------------- .. automodule:: musicbrainzapi.api.lyrics diff --git a/docs/source/modules/musicbrainzapi.api.rst b/docs/source/modules/musicbrainzapi.api.rst index c3d3ebe..b79c924 100644 --- a/docs/source/modules/musicbrainzapi.api.rst +++ b/docs/source/modules/musicbrainzapi.api.rst @@ -1,6 +1,4 @@ -.. include:: ../global.rst - -musicbrainzapi.api :modname:`musicbrainzapi.api` +musicbrainzapi.api -------------------------------------------------------------------------- .. automodule:: musicbrainzapi.api diff --git a/docs/source/toc.rst b/docs/source/toc.rst index c5feb52..35495cb 100644 --- a/docs/source/toc.rst +++ b/docs/source/toc.rst @@ -5,7 +5,6 @@ .. toctree:: :maxdepth: 2 :caption: Overview - :titlesonly: introduction changelog @@ -13,14 +12,12 @@ .. toctree:: :maxdepth: 2 :caption: Modules - :titlesonly: modules/musicbrainzapi.rst .. toctree:: :maxdepth: 2 :caption: Submodules - :titlesonly: modules/musicbrainzapi.api.rst modules/musicbrainzapi.cli.rst From 509cd868306e7061cd3e018e2a519e48817716e1 Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 21:32:44 +0000 Subject: [PATCH 03/14] updating README and CHANGELOG --- CHANGELOG.md | 10 -- CHANGELOG.rst | 21 +++ README.rst | 121 +++++++++++++++++- docs/source/changelog.rst | 22 +--- docs/source/conf.py | 3 +- docs/source/introduction.rst | 14 +- .../musicbrainzapi.api.lyrics.director.rst | 2 +- src/musicbrainzapi/api/lyrics/director.py | 3 +- 8 files changed, 146 insertions(+), 50 deletions(-) delete mode 100644 CHANGELOG.md create mode 100644 CHANGELOG.rst diff --git a/CHANGELOG.md b/CHANGELOG.md deleted file mode 100644 index b2c2f00..0000000 --- a/CHANGELOG.md +++ /dev/null @@ -1,10 +0,0 @@ -# Changelog -All notable changes to this project will be documented in this file. - -The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), -and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). - -## [1.0.0] - 2020-03-07 -### Added - -- Initial version diff --git a/CHANGELOG.rst b/CHANGELOG.rst new file mode 100644 index 0000000..6a26b77 --- /dev/null +++ b/CHANGELOG.rst @@ -0,0 +1,21 @@ +Changelog +========== + +All notable changes to this project will be documented in this file. + +This format is based on `Keep a Changelog`_ + +.. _Keep a Changelog: https://keepachangelog.com/en/1.0.0/ + +and this project adheres to `Semantic Versioning`_ + +.. _Semantic Versioning: https://semver.org/spec/v2.0.0.html + + +[1.0.0] - 2020-03-07 +------------------------ + +Added +###### + +- Initial version diff --git a/README.rst b/README.rst index 1c6e18b..859f72d 100644 --- a/README.rst +++ b/README.rst @@ -1,5 +1,6 @@ -musicbrainzapi -=============== +============= +Introduction +============= .. image:: https://img.shields.io/readthedocs/panaetius?style=for-the-badge :target: https://panaetius.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status @@ -17,3 +18,119 @@ musicbrainzapi .. image:: https://img.shields.io/github/languages/top/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge :alt: GitHub top language .. image:: https://img.shields.io/requires/github/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge :alt: Requires.io + +Summary +======== + +Musicbrainzapi is a Python module with a CLI that allows you to search for an artist and receive summary statistics on lyrics across all albums + tracks. + +In addition to basic statistics the module further allows you to save details of an artist. You can save album information, the lyrics themselves and track lists. + +The module (currently) provides a simple CLI with some underlying assumptions: + +- We are interested in albums only - no singles. +- We are interested in any album where the artist is listed as a primary artist on a release. This could include compilations or joint albums with other artists. +- Where an album has been released multiple times, in different regions, we take the album with the longest track list. + +These assumptions are not configurable in the current version - but this functionality could be added to the module if needed. + +Further information, and a brief summary of decisions taken and current caveats can be found in the documentation which is linked below. + +Documentation +============= + +The documentation for the module can be found at https://musicbrainzapi-cv-airelogic.readthedocs.io/en/latest/ + +Installation +============ + +You will need ``python>=3.7``. Installation to a python virtual environment is recommended. + +PIP +--- + +Download the latest release ``.whl`` file from the `releases`_ page + +.. _releases: https://github.com/dtomlinson91/musicbrainzapi-cv-airelogic/releases + +In a virtual environment run: + +.. code-block:: bash + + pip install -U musicbrainzapi.whl + +Replacing ``musicbrainzapi.whl`` with the filename you downloaded. + +setup.py +-------- + +Clone the repo: + +.. code-block:: bash + + git clone https://github.com/dtomlinson91/musicbrainzapi-cv-airelogic.git + +In the root of the repo in a virtual environment run: + +.. code-block:: bash + + python ./setup.py install + +Docker +------ + +.. note:: Using Docker will mean you cannot view a wordcloud, as the default behaviour is to show the plot interactively which the container cannot do. + +If you don't have ``python>=3.7`` installed, or would rather use Docker, you can build a Docker image and run the module using Docker. + +Clone the repo: + +.. code-block:: bash + + git clone https://github.com/dtomlinson91/musicbrainzapi-cv-airelogic.git + +In the root of the repo build the Docker image: + +.. code-block:: bash + + docker build . -t musicbrainzapi + +No entrypoint is provided in the ``Dockerfile`` - you will have to specify the command at runtime and run the container in interactive mode: + +Using Docker run +^^^^^^^^^^^^^^^^ + +.. code-block:: bash + + docker run --rm -it --volume=$(pwd):/outputs \ + musicbrainzapi:latest musicbrainzapi --path /outputs \ + lyrics -a "Savage Garden" -c gb --show-summary all --save-output + + +Usage +===== + +Once installed you can access the command running: + +.. code-block:: bash + + musicbrainzapi + +To see all options available you can run: + +.. code-block:: bash + + musicbrainzapi --help + +In the current release there is one command available ``lyrics``: + +.. code-block:: bash + + musicbrainzapi lyrics --help + +License information +=================== + +Released under the `MIT License`_ + +.. _MIT License: https://github.com/dtomlinson91/musicbrainzapi-cv-airelogic/blob/master/LICENSE diff --git a/docs/source/changelog.rst b/docs/source/changelog.rst index 6a26b77..09929fe 100644 --- a/docs/source/changelog.rst +++ b/docs/source/changelog.rst @@ -1,21 +1 @@ -Changelog -========== - -All notable changes to this project will be documented in this file. - -This format is based on `Keep a Changelog`_ - -.. _Keep a Changelog: https://keepachangelog.com/en/1.0.0/ - -and this project adheres to `Semantic Versioning`_ - -.. _Semantic Versioning: https://semver.org/spec/v2.0.0.html - - -[1.0.0] - 2020-03-07 ------------------------- - -Added -###### - -- Initial version +.. include:: ../../CHANGELOG.rst diff --git a/docs/source/conf.py b/docs/source/conf.py index 37a5689..5b13938 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -39,7 +39,8 @@ extensions = [ 'sphinx.ext.napoleon', 'sphinx.ext.todo', 'sphinx_click.ext', - 'sphinx.ext.intersphinx' + 'sphinx.ext.intersphinx', + 'sphinx.ext.autosectionlabel' ] # -- Napoleon Settings ----------------------------------------------------- diff --git a/docs/source/introduction.rst b/docs/source/introduction.rst index ac73fbe..a6210d3 100644 --- a/docs/source/introduction.rst +++ b/docs/source/introduction.rst @@ -1,13 +1 @@ -============= -Introduction -============= - -##### -Test -##### - -testing - -test code:: - - some test code +.. include:: ../../README.rst diff --git a/docs/source/modules/musicbrainzapi.api.lyrics.director.rst b/docs/source/modules/musicbrainzapi.api.lyrics.director.rst index d284607..f5dc1d2 100644 --- a/docs/source/modules/musicbrainzapi.api.lyrics.director.rst +++ b/docs/source/modules/musicbrainzapi.api.lyrics.director.rst @@ -1,5 +1,5 @@ musicbrainzapi.api.lyrics.director ----------------------------------------------------------------------------------- +------------------------------------- .. automodule:: musicbrainzapi.api.lyrics.director :members: diff --git a/src/musicbrainzapi/api/lyrics/director.py b/src/musicbrainzapi/api/lyrics/director.py index 58a5568..d80da30 100644 --- a/src/musicbrainzapi/api/lyrics/director.py +++ b/src/musicbrainzapi/api/lyrics/director.py @@ -9,8 +9,7 @@ from musicbrainzapi.api.lyrics import Lyrics class LyricsClickDirector: - """Director for Lyrics builder. - """ + """Director for Lyrics builder.""" def __init__(self) -> None: self._builder = None From 4d5b32bcd9816518ef8a23b4b6a5d0baefbcf724 Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 21:35:34 +0000 Subject: [PATCH 04/14] updating badges --- README.rst | 24 ++++++++---------------- 1 file changed, 8 insertions(+), 16 deletions(-) diff --git a/README.rst b/README.rst index 859f72d..9d45835 100644 --- a/README.rst +++ b/README.rst @@ -2,22 +2,14 @@ Introduction ============= -.. image:: https://img.shields.io/readthedocs/panaetius?style=for-the-badge :target: https://panaetius.readthedocs.io/en/latest/?badge=latest - :alt: Documentation Status - -.. image:: https://img.shields.io/github/v/tag/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge :alt: GitHub tag (latest by date) - -.. image:: https://img.shields.io/github/commit-activity/m/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge :alt: GitHub commit activity - -.. image:: https://img.shields.io/github/issues/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge :alt: GitHub issues - -.. image:: https://img.shields.io/github/license/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge :alt: GitHubtbc - -.. image:: https://img.shields.io/github/languages/code-size/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge :alt: GitHub code size in bytes - -.. image:: https://img.shields.io/github/languages/top/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge :alt: GitHub top language - -.. image:: https://img.shields.io/requires/github/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge :alt: Requires.io +.. image:: https://img.shields.io/readthedocs/panaetius?style=for-the-badge +.. image:: https://img.shields.io/github/v/tag/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge +.. image:: https://img.shields.io/github/commit-activity/m/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge +.. image:: https://img.shields.io/github/issues/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge +.. image:: https://img.shields.io/github/license/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge +.. image:: https://img.shields.io/github/languages/code-size/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge +.. image:: https://img.shields.io/github/languages/top/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge +.. image:: https://img.shields.io/requires/github/dtomlinson91/musicbrainzapi-cv-airelogic?style=for-the-badge Summary ======== From 06a42afb2f334a5b9ce3e3de9b9fff0b0096964b Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 21:49:16 +0000 Subject: [PATCH 05/14] adding custom css --- docs/source/_static/custom.css | 86 +--------------------------------- docs/source/conf.py | 2 +- 2 files changed, 3 insertions(+), 85 deletions(-) diff --git a/docs/source/_static/custom.css b/docs/source/_static/custom.css index d4be59d..d968758 100644 --- a/docs/source/_static/custom.css +++ b/docs/source/_static/custom.css @@ -1,87 +1,5 @@ @import url("css/theme.css"); -.modname { - font-size: 0.8em; - opacity: 0.4; -} -.modname::before { - content: '- '; -} -.title { - font-weight: bold; - font-size: 1.2em; - background-color: #eee; - display: block; - padding: 1px 5px; - border-left: 2px solid #ddd; -} - -/*colour of the text in the toc*/ -.wy-menu-vertical header, .wy-menu-vertical p.caption{ - color: #b26d46;; -} - -/*colour of the top left header*/ -.wy-side-nav-search{ - background-color: #31465a; -} - -/*colours of the class definitions*/ -.rst-content dl:not(.docutils) dt{ - background: #e2d7d1; - color: #0b2852; - border-top: solid 3px #31465a; -} - -/*colour of the link in the class defintions*/ -.rst-content .viewcode-link, .rst-content .viewcode-back{ - color: #4b674a; -} - -/*colour of the function definitions*/ -.rst-content dl:not(.docutils) dl dt{ - border-left: solid 3px #31465a; - background: #e2d7d1; - color: #0b2852; -} - -/*colour of the link in the function definitions*/ -.rst-content .viewcode-link, .rst-content .viewcode-back{ - color: #4b674a; -} - -/*edit the width of the body*/ -.wy-nav-content{ - max-width: 1200px; -} - -/*code example blocks*/ -.rst-content pre.literal-block, .rst-content div[class^="highlight"] pre, .rst-content .linenodiv pre{ - background: #b4bec8; - color: black; - /*border-style: solid;*/ - /*border-width: thin;*/ -} - -/*colour of inline code blocks using ``*/ -.rst-content tt.literal, .rst-content tt.literal, .rst-content code.literal{ - color: #b26d46; -} - -/* Change code blocks font and bump up font size slightly (normally 12px)*/ -.rst-content pre.literal-block, .rst-content div[class^="highlight"] pre, .rst-content .linenodiv pre { - font-family: 'Inconsolata', monospace !important; - font-size: 14px !important; - white-space: pre-wrap; -} - -/* Change code descriptions and literal blocks (inline code via ``) to match the normal font size being used in the sphinx_RTD_theme text (normally 14px)*/ -.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descclassname,.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) code.descname,.rst-content dl:not(.docutils) tt.descclassname,.rst-content dl:not(.docutils) code.descclassname, code.docutils { - font-family: 'Inconsolata', monospace !important; - font-size: 14px !important; -} - -/*variables text*/ -dl.class > dd > table.docutils.field-list tbody tr.field-odd.field th.field-name::before{ - content: '(Class Attributes) '; +.highlight { + background: white !important } diff --git a/docs/source/conf.py b/docs/source/conf.py index 5b13938..801b4a1 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -84,7 +84,7 @@ html_theme = "sphinx_rtd_theme" html_theme = "sphinx_rtd_theme" html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] html_static_path = ['_static'] -# html_context = {'css_files': ['_static/custom.css']} +html_context = {'css_files': ['_static/custom.css']} html_theme_options = { 'collapse_navigation': True, 'display_version': True, From 026bfc12b7ab3204be4d569929c8703e24e92ecd Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 22:19:55 +0000 Subject: [PATCH 06/14] adding CLI --- docs/source/CLI.rst | 48 +++++++++++++++++++++++++++++++++++++++++++ docs/source/index.rst | 29 ++++++++++++++++++++++++-- docs/source/toc.rst | 24 ---------------------- 3 files changed, 75 insertions(+), 26 deletions(-) create mode 100644 docs/source/CLI.rst delete mode 100644 docs/source/toc.rst diff --git a/docs/source/CLI.rst b/docs/source/CLI.rst new file mode 100644 index 0000000..dee9064 --- /dev/null +++ b/docs/source/CLI.rst @@ -0,0 +1,48 @@ +*** +CLI +*** + +As the CLI is provided by `Click`_ , you can pass the ``--help`` option to the base command, or any subcommands, to see information on usage and all available options. + +.. _Click: https://click.palletsprojects.com/en/7.x/ + +Full options of the CLI are provided on this page. + +.. important:: The ``--path`` option should be provided to the base command. This is so the path provided can be used in all subcommands. + + +Quickstart +========== + +If you want to see everything the module offers run the following: + +.. code-block:: bash + + musicbrainzapi --path . lyrics -a "savage garden" -c gb --show-summary all --wordcloud --save-output + +This will search for all tracks across all albums for the artist Savage Garden. + +``--show-summary all`` will show descriptive statistics for both albums and years for this artist. + +``--wordcloud`` will generate a wordcloud showing the most popular words across all lyrics. + +``--save-output`` will save the module's output to disk as ``.json`` files. + +Outputs +======= + +The following files will be saved to disk + +- all_albums_lyrics_sum.json - Total number of words in a track for each album. +- year_statistics.json - Descriptive statistics by year. +- album_statistics.json - Descriptive statistics by album +- all_albums_with_tracks.json - Track titles for each album. +- all_albums_with_lyrics.json - Lyrics for each track for each album. +- all_albums_lyrics_count.json - Shows a frequency count of each word in every track. + +CLI Documentation +================= + +.. click:: musicbrainzapi.cli.cli:cli + :prog: musicbrainzapi + :show-nested: diff --git a/docs/source/index.rst b/docs/source/index.rst index 86fd692..2f60e6c 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -1,4 +1,29 @@ +***************** Table of Contents -================= +***************** -.. include:: toc.rst +.. toctree:: + :maxdepth: 2 + :caption: Contents + + introduction + changelog + +.. toctree:: + :maxdepth: 2 + :caption: Modules + + modules/musicbrainzapi.rst + +.. toctree:: + :maxdepth: 2 + :caption: Submodules + + modules/musicbrainzapi.api.rst + modules/musicbrainzapi.cli.rst + modules/musicbrainzapi.wordcloud.rst + +.. toctree:: + :caption: Table of Contents + + self diff --git a/docs/source/toc.rst b/docs/source/toc.rst deleted file mode 100644 index 35495cb..0000000 --- a/docs/source/toc.rst +++ /dev/null @@ -1,24 +0,0 @@ -.. toctree:: - - self - -.. toctree:: - :maxdepth: 2 - :caption: Overview - - introduction - changelog - -.. toctree:: - :maxdepth: 2 - :caption: Modules - - modules/musicbrainzapi.rst - -.. toctree:: - :maxdepth: 2 - :caption: Submodules - - modules/musicbrainzapi.api.rst - modules/musicbrainzapi.cli.rst - modules/musicbrainzapi.wordcloud.rst From c711795cce6847c53f1a28350473841cd7184970 Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 22:20:18 +0000 Subject: [PATCH 07/14] adding CLI to toctree --- docs/source/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/source/index.rst b/docs/source/index.rst index 2f60e6c..4ea68c1 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -7,6 +7,7 @@ Table of Contents :caption: Contents introduction + CLI changelog .. toctree:: From d6e7e49f3f287bc3774c6124d2aaea197a1ce53d Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 23:19:07 +0000 Subject: [PATCH 08/14] latest documentation --- docs/source/index.rst | 12 ++------- docs/source/modules/musicbrainzapi.api.rst | 27 ++++++++++++------- docs/source/modules/musicbrainzapi.rst | 14 ++++++---- src/musicbrainzapi/cli/cli.py | 4 +-- src/musicbrainzapi/cli/commands/cmd_lyrics.py | 6 ++--- 5 files changed, 34 insertions(+), 29 deletions(-) diff --git a/docs/source/index.rst b/docs/source/index.rst index 4ea68c1..a351198 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -12,17 +12,9 @@ Table of Contents .. toctree:: :maxdepth: 2 - :caption: Modules + :caption: API - modules/musicbrainzapi.rst - -.. toctree:: - :maxdepth: 2 - :caption: Submodules - - modules/musicbrainzapi.api.rst - modules/musicbrainzapi.cli.rst - modules/musicbrainzapi.wordcloud.rst + modules/modules .. toctree:: :caption: Table of Contents diff --git a/docs/source/modules/musicbrainzapi.api.rst b/docs/source/modules/musicbrainzapi.api.rst index b79c924..fc152e4 100644 --- a/docs/source/modules/musicbrainzapi.api.rst +++ b/docs/source/modules/musicbrainzapi.api.rst @@ -1,17 +1,26 @@ -musicbrainzapi.api --------------------------------------------------------------------------- +musicbrainzapi.api package +=========================== .. automodule:: musicbrainzapi.api - :members: - :undoc-members: - :show-inheritance: - :private-members: + :members: + :undoc-members: + :show-inheritance: + :private-members: +Subpackages +=========== .. toctree:: + musicbrainzapi.lyrics - musicbrainzapi.api.lyrics +Submodules +========== -.. toctree:: +musicbrainzapi.api.authenticate +------------------------------- - musicbrainzapi.api.authenticate +.. automodule:: musicbrainzapi.api.authenticate + :members: + :undoc-members: + :show-inheritance: + :private-members: diff --git a/docs/source/modules/musicbrainzapi.rst b/docs/source/modules/musicbrainzapi.rst index 3148c84..d6e76ac 100644 --- a/docs/source/modules/musicbrainzapi.rst +++ b/docs/source/modules/musicbrainzapi.rst @@ -1,7 +1,5 @@ -.. include:: ../global.rst - -musicbrainzapi :modname:`musicbrainzapi` ------------------------------------------ +musicbrainzapi +=============== .. automodule:: musicbrainzapi :members: @@ -9,4 +7,10 @@ musicbrainzapi :modname:`musicbrainzapi` :show-inheritance: :private-members: -Main module text +Subpackages +=========== + +.. toctree:: + musicbrainzapi.api + musicbrainzapi.wordcloud + diff --git a/src/musicbrainzapi/cli/cli.py b/src/musicbrainzapi/cli/cli.py index 2ebe25f..43c2d9f 100644 --- a/src/musicbrainzapi/cli/cli.py +++ b/src/musicbrainzapi/cli/cli.py @@ -42,7 +42,7 @@ class ComplexCLI(click.MultiCommand): type=click.Path( exists=True, file_okay=False, resolve_path=True, writable=True ), - help='Path to save results.', + help='Local path to save any output files.', default=os.getcwd() ) # @click.option('-v', '--verbose', is_flag=True, help='Enables verbose mode.') @@ -53,7 +53,7 @@ class ComplexCLI(click.MultiCommand): ) @pass_environment def cli(ctx, path): - """A complex command line interface.""" + """Base command for the musicbrainzapi program.""" # ctx.verbose = verbose if path is not None: click.echo(f'Path set to {os.path.expanduser(path)}') diff --git a/src/musicbrainzapi/cli/commands/cmd_lyrics.py b/src/musicbrainzapi/cli/commands/cmd_lyrics.py index 850f80c..cffe828 100644 --- a/src/musicbrainzapi/cli/commands/cmd_lyrics.py +++ b/src/musicbrainzapi/cli/commands/cmd_lyrics.py @@ -24,7 +24,7 @@ from musicbrainzapi.api.lyrics.director import LyricsClickDirector @click.option( '--wordcloud', required=False, - help='Generate a wordcloud from lyrics.', + help='Generates a wordcloud from lyrics.', is_flag=True, default=False, ) @@ -41,7 +41,7 @@ from musicbrainzapi.api.lyrics.director import LyricsClickDirector required=False, multiple=False, type=str, - help='ISO A-2 Country code (https://en.wikipedia.org/wiki/ISO_3166-1_alpha' + help='Filter artist by country. This is optional but can narrow down a search if many artists share the same or similar names. Country must be a ISO A-2 Country code (https://en.wikipedia.org/wiki/ISO_3166-1_alpha' '-2) Example: GB', ) @click.option( @@ -63,7 +63,7 @@ def lyrics( wordcloud: bool, save_output: bool, ) -> None: - """Search for lyrics statistics of an Artist/Group. + """Search for lyrics statistics of an Artist/Group. Optionally save the results to disk, and show a wordcloud. Descriptive statistics can be shown in addition to the final average. """ director = LyricsClickDirector() builder = LyricsBuilder() From 199302afb37f43b275eb6c4915cccccc8058027e Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 23:19:14 +0000 Subject: [PATCH 09/14] modules update --- docs/source/modules/modules.rst | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 docs/source/modules/modules.rst diff --git a/docs/source/modules/modules.rst b/docs/source/modules/modules.rst new file mode 100644 index 0000000..7c27e42 --- /dev/null +++ b/docs/source/modules/modules.rst @@ -0,0 +1,7 @@ +musicbrainzapi +-------------- + +.. toctree:: + :maxdepth: 4 + + musicbrainzapi From f06c9f43d4160641913c20f5abd5927c94283154 Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 23:27:42 +0000 Subject: [PATCH 10/14] adding api documentation --- .../modules/musicbrainzapi.api.lyrics.rst | 37 +++++++++++++------ docs/source/modules/musicbrainzapi.api.rst | 2 +- 2 files changed, 27 insertions(+), 12 deletions(-) diff --git a/docs/source/modules/musicbrainzapi.api.lyrics.rst b/docs/source/modules/musicbrainzapi.api.lyrics.rst index 38ae92d..28bda3e 100644 --- a/docs/source/modules/musicbrainzapi.api.lyrics.rst +++ b/docs/source/modules/musicbrainzapi.api.lyrics.rst @@ -1,14 +1,29 @@ -musicbrainzapi.api.lyrics --------------------------------------------------------------------------- +musicbrainzapi.api.lyrics package +================================= -.. automodule:: musicbrainzapi.api.lyrics - :members: - :undoc-members: - :show-inheritance: - :private-members: +.. autmodule:: musicbrainzapi.api.lyrics + :members: + :undoc-members: + :show-inheritance: + :private-members: -.. toctree:: +Submodules +========== - musicbrainzapi.api.lyrics.builder - musicbrainzapi.api.lyrics.concrete_builder - musicbrainzapi.api.lyrics.director +.. automodule:: musicbrainzapi.api.lyrics.builder + :members: + :undoc-members: + :show-inheritance: + :private-members: + +.. automodule:: musicbrainzapi.api.lyrics.concrete_builder + :members: + :undoc-members: + :show-inheritance: + :private-members: + +.. automodule:: musicbrainzapi.api.lyrics.director + :members: + :undoc-members: + :show-inheritance: + :private-members: diff --git a/docs/source/modules/musicbrainzapi.api.rst b/docs/source/modules/musicbrainzapi.api.rst index fc152e4..d0080a9 100644 --- a/docs/source/modules/musicbrainzapi.api.rst +++ b/docs/source/modules/musicbrainzapi.api.rst @@ -11,7 +11,7 @@ Subpackages =========== .. toctree:: - musicbrainzapi.lyrics + musicbrainzapi.api.lyrics Submodules ========== From a322df759e49f808596ebc5fbfc3b0b311a131e7 Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Sun, 8 Mar 2020 23:38:36 +0000 Subject: [PATCH 11/14] updating documentation --- .../modules/musicbrainzapi.api.authenticate.rst | 10 ---------- .../modules/musicbrainzapi.api.lyrics.builder.rst | 10 ---------- .../musicbrainzapi.api.lyrics.concrete_builder.rst | 10 ---------- .../modules/musicbrainzapi.api.lyrics.director.rst | 8 -------- docs/source/modules/musicbrainzapi.api.lyrics.rst | 11 ++++++++++- docs/source/modules/musicbrainzapi.api.rst | 10 ++++++---- docs/source/modules/musicbrainzapi.rst | 5 ++++- 7 files changed, 20 insertions(+), 44 deletions(-) delete mode 100644 docs/source/modules/musicbrainzapi.api.authenticate.rst delete mode 100644 docs/source/modules/musicbrainzapi.api.lyrics.builder.rst delete mode 100644 docs/source/modules/musicbrainzapi.api.lyrics.concrete_builder.rst delete mode 100644 docs/source/modules/musicbrainzapi.api.lyrics.director.rst diff --git a/docs/source/modules/musicbrainzapi.api.authenticate.rst b/docs/source/modules/musicbrainzapi.api.authenticate.rst deleted file mode 100644 index 805ba56..0000000 --- a/docs/source/modules/musicbrainzapi.api.authenticate.rst +++ /dev/null @@ -1,10 +0,0 @@ - .. include:: ../global.rst - -musicbrainzapi.api.authenticate :modname:`musicbrainzapi.api.authenticate module` ------------------------------------------------------------------------------------------- - -.. automodule:: musicbrainzapi.api.authenticate - :members: - :undoc-members: - :show-inheritance: - :private-members: diff --git a/docs/source/modules/musicbrainzapi.api.lyrics.builder.rst b/docs/source/modules/musicbrainzapi.api.lyrics.builder.rst deleted file mode 100644 index 38d5e4b..0000000 --- a/docs/source/modules/musicbrainzapi.api.lyrics.builder.rst +++ /dev/null @@ -1,10 +0,0 @@ - .. include:: ../global.rst - -musicbrainzapi.api.lyrics.builder :modname:`musicbrainzapi.api.lyrics.builder` -------------------------------------------------------------------------------- - -.. automodule:: musicbrainzapi.api.lyrics.builder - :members: - :undoc-members: - :show-inheritance: - :private-members: diff --git a/docs/source/modules/musicbrainzapi.api.lyrics.concrete_builder.rst b/docs/source/modules/musicbrainzapi.api.lyrics.concrete_builder.rst deleted file mode 100644 index 4acc336..0000000 --- a/docs/source/modules/musicbrainzapi.api.lyrics.concrete_builder.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. include:: ../global.rst - -musicbrainzapi.api.lyrics.concrete_builder :modname:`musicbrainzapi.api.lyrics.concrete_builder` -------------------------------------------------------------------------------------------------- - -.. automodule:: musicbrainzapi.api.lyrics.concrete_builder - :members: - :undoc-members: - :show-inheritance: - :private-members: diff --git a/docs/source/modules/musicbrainzapi.api.lyrics.director.rst b/docs/source/modules/musicbrainzapi.api.lyrics.director.rst deleted file mode 100644 index f5dc1d2..0000000 --- a/docs/source/modules/musicbrainzapi.api.lyrics.director.rst +++ /dev/null @@ -1,8 +0,0 @@ -musicbrainzapi.api.lyrics.director -------------------------------------- - -.. automodule:: musicbrainzapi.api.lyrics.director - :members: - :undoc-members: - :show-inheritance: - :private-members: diff --git a/docs/source/modules/musicbrainzapi.api.lyrics.rst b/docs/source/modules/musicbrainzapi.api.lyrics.rst index 28bda3e..4ba0104 100644 --- a/docs/source/modules/musicbrainzapi.api.lyrics.rst +++ b/docs/source/modules/musicbrainzapi.api.lyrics.rst @@ -8,7 +8,10 @@ musicbrainzapi.api.lyrics package :private-members: Submodules -========== +---------- + +musicbrainzapi.api.lyrics.builder module +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. automodule:: musicbrainzapi.api.lyrics.builder :members: @@ -16,12 +19,18 @@ Submodules :show-inheritance: :private-members: +musicbrainzapi.api.lyrics.concrete_builder module +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + .. automodule:: musicbrainzapi.api.lyrics.concrete_builder :members: :undoc-members: :show-inheritance: :private-members: +musicbrainzapi.api.lyrics.director module +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + .. automodule:: musicbrainzapi.api.lyrics.director :members: :undoc-members: diff --git a/docs/source/modules/musicbrainzapi.api.rst b/docs/source/modules/musicbrainzapi.api.rst index d0080a9..9df8cfe 100644 --- a/docs/source/modules/musicbrainzapi.api.rst +++ b/docs/source/modules/musicbrainzapi.api.rst @@ -8,16 +8,18 @@ musicbrainzapi.api package :private-members: Subpackages -=========== +----------- .. toctree:: + :maxdepth: 1 + musicbrainzapi.api.lyrics Submodules -========== +---------- -musicbrainzapi.api.authenticate -------------------------------- +musicbrainzapi.api.authenticate module +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. automodule:: musicbrainzapi.api.authenticate :members: diff --git a/docs/source/modules/musicbrainzapi.rst b/docs/source/modules/musicbrainzapi.rst index d6e76ac..109766f 100644 --- a/docs/source/modules/musicbrainzapi.rst +++ b/docs/source/modules/musicbrainzapi.rst @@ -7,10 +7,13 @@ musicbrainzapi :show-inheritance: :private-members: + Subpackages -=========== +----------- .. toctree:: + :maxdepth: 1 + musicbrainzapi.api musicbrainzapi.wordcloud From 76a5d580abf894ab736c1038c0377d67e9308df6 Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Mon, 9 Mar 2020 00:11:55 +0000 Subject: [PATCH 12/14] updating toc tree --- docs/source/index.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/source/index.rst b/docs/source/index.rst index a351198..a41a5ec 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -11,7 +11,6 @@ Table of Contents changelog .. toctree:: - :maxdepth: 2 :caption: API modules/modules From 3fecf9d723461b05cfa7389fb90e212847205ece Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Mon, 9 Mar 2020 00:22:02 +0000 Subject: [PATCH 13/14] updating toctree --- docs/source/modules/musicbrainzapi.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/source/modules/musicbrainzapi.rst b/docs/source/modules/musicbrainzapi.rst index 109766f..09b9363 100644 --- a/docs/source/modules/musicbrainzapi.rst +++ b/docs/source/modules/musicbrainzapi.rst @@ -12,7 +12,6 @@ Subpackages ----------- .. toctree:: - :maxdepth: 1 musicbrainzapi.api musicbrainzapi.wordcloud From 8fcb0d8704892e61f3d1d46b176ed93b8892fff7 Mon Sep 17 00:00:00 2001 From: dtomlinson Date: Mon, 9 Mar 2020 01:15:20 +0000 Subject: [PATCH 14/14] updating latest documentation --- docs/source/conf.py | 1 + docs/source/index.rst | 8 ++++++++ docs/source/modules/modules.rst | 2 +- .../modules/musicbrainzapi.api.lyrics.rst | 2 +- .../source/modules/musicbrainzapi.cli.cli.rst | 10 ---------- ...musicbrainzapi.cli.commands.cmd_lyrics.rst | 16 ---------------- .../modules/musicbrainzapi.cli.commands.rst | 14 -------------- docs/source/modules/musicbrainzapi.cli.rst | 18 ------------------ docs/source/modules/musicbrainzapi.rst | 1 + .../musicbrainzapi.wordcloud.resources.rst | 10 ---------- .../modules/musicbrainzapi.wordcloud.rst | 19 +++++++------------ 11 files changed, 19 insertions(+), 82 deletions(-) delete mode 100644 docs/source/modules/musicbrainzapi.cli.cli.rst delete mode 100644 docs/source/modules/musicbrainzapi.cli.commands.cmd_lyrics.rst delete mode 100644 docs/source/modules/musicbrainzapi.cli.commands.rst delete mode 100644 docs/source/modules/musicbrainzapi.cli.rst delete mode 100644 docs/source/modules/musicbrainzapi.wordcloud.resources.rst diff --git a/docs/source/conf.py b/docs/source/conf.py index 801b4a1..06e73fa 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -89,6 +89,7 @@ html_theme_options = { 'collapse_navigation': True, 'display_version': True, 'prev_next_buttons_location': 'both', + 'navigation_depth': -1, #'navigation_depth': 3, } diff --git a/docs/source/index.rst b/docs/source/index.rst index a41a5ec..566e559 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -12,6 +12,7 @@ Table of Contents .. toctree:: :caption: API + :maxdepth: 2 modules/modules @@ -19,3 +20,10 @@ Table of Contents :caption: Table of Contents self + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` diff --git a/docs/source/modules/modules.rst b/docs/source/modules/modules.rst index 7c27e42..4c2e61f 100644 --- a/docs/source/modules/modules.rst +++ b/docs/source/modules/modules.rst @@ -2,6 +2,6 @@ musicbrainzapi -------------- .. toctree:: - :maxdepth: 4 + :maxdepth: 3 musicbrainzapi diff --git a/docs/source/modules/musicbrainzapi.api.lyrics.rst b/docs/source/modules/musicbrainzapi.api.lyrics.rst index 4ba0104..1c1f4ad 100644 --- a/docs/source/modules/musicbrainzapi.api.lyrics.rst +++ b/docs/source/modules/musicbrainzapi.api.lyrics.rst @@ -1,7 +1,7 @@ musicbrainzapi.api.lyrics package ================================= -.. autmodule:: musicbrainzapi.api.lyrics +.. automodule:: musicbrainzapi.api.lyrics :members: :undoc-members: :show-inheritance: diff --git a/docs/source/modules/musicbrainzapi.cli.cli.rst b/docs/source/modules/musicbrainzapi.cli.cli.rst deleted file mode 100644 index 9b6e813..0000000 --- a/docs/source/modules/musicbrainzapi.cli.cli.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. include:: ../global.rst - -musicbrainzapi.cli.cli :modname:`musicbrainzapi.cli.cli` --------------------------------------------------------------------------- - -.. automodule:: musicbrainzapi.cli.cli - :members: - :undoc-members: - :show-inheritance: - :private-members: diff --git a/docs/source/modules/musicbrainzapi.cli.commands.cmd_lyrics.rst b/docs/source/modules/musicbrainzapi.cli.commands.cmd_lyrics.rst deleted file mode 100644 index 86946a1..0000000 --- a/docs/source/modules/musicbrainzapi.cli.commands.cmd_lyrics.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. include:: ../global.rst - -musicbrainzapi.cli.commands.cmd_lyrics :modname:`musicbrainzapi.cli.commands.cmd_lyrics` ------------------------------------------------------------------------------------------- - -.. automodule:: musicbrainzapi.cli.commands.cmd_lyrics - :members: - :undoc-members: - :show-inheritance: - :private-members: - -lyrics subcommand. Use with... - -.. click:: musicbrainzapi.cli.cli:cli - :prog: musicbrainzapi - :show-nested: diff --git a/docs/source/modules/musicbrainzapi.cli.commands.rst b/docs/source/modules/musicbrainzapi.cli.commands.rst deleted file mode 100644 index 5dce26c..0000000 --- a/docs/source/modules/musicbrainzapi.cli.commands.rst +++ /dev/null @@ -1,14 +0,0 @@ -.. include:: ../global.rst - -musicbrainzapi.cli.commands :modname:`musicbrainzapi.cli.commands` --------------------------------------------------------------------------- - -.. automodule:: musicbrainzapi.cli.commands - :members: - :undoc-members: - :show-inheritance: - :private-members: - -.. toctree:: - - musicbrainzapi.cli.commands.cmd_lyrics diff --git a/docs/source/modules/musicbrainzapi.cli.rst b/docs/source/modules/musicbrainzapi.cli.rst deleted file mode 100644 index c3f2276..0000000 --- a/docs/source/modules/musicbrainzapi.cli.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. include:: ../global.rst - -musicbrainzapi.cli :modname:`musicbrainzapi.cli` --------------------------------------------------------------------------- - -.. automodule:: musicbrainzapi.cli - :members: - :undoc-members: - :show-inheritance: - :private-members: - -.. toctree:: - - musicbrainzapi.cli.commands - -.. toctree:: - - musicbrainzapi.cli.cli diff --git a/docs/source/modules/musicbrainzapi.rst b/docs/source/modules/musicbrainzapi.rst index 09b9363..109766f 100644 --- a/docs/source/modules/musicbrainzapi.rst +++ b/docs/source/modules/musicbrainzapi.rst @@ -12,6 +12,7 @@ Subpackages ----------- .. toctree:: + :maxdepth: 1 musicbrainzapi.api musicbrainzapi.wordcloud diff --git a/docs/source/modules/musicbrainzapi.wordcloud.resources.rst b/docs/source/modules/musicbrainzapi.wordcloud.resources.rst deleted file mode 100644 index 8a64ee0..0000000 --- a/docs/source/modules/musicbrainzapi.wordcloud.resources.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. include:: ../global.rst - -musicbrainzapi.wordcloud.resources :modname:`musicbrainzapi.wordcloud.resources` ---------------------------------------------------------------------------------- - -.. automodule:: musicbrainzapi.wordcloud.resources - :members: - :undoc-members: - :show-inheritance: - :private-members: diff --git a/docs/source/modules/musicbrainzapi.wordcloud.rst b/docs/source/modules/musicbrainzapi.wordcloud.rst index 9c42b3d..00d077a 100644 --- a/docs/source/modules/musicbrainzapi.wordcloud.rst +++ b/docs/source/modules/musicbrainzapi.wordcloud.rst @@ -1,14 +1,9 @@ -.. include:: ../global.rst - -musicbrainzapi.wordcloud :modname:`musicbrainzapi.wordcloud` --------------------------------------------------------------------------- +******************************** +musicbrainzapi.wordcloud package +******************************** .. automodule:: musicbrainzapi.wordcloud - :members: - :undoc-members: - :show-inheritance: - :private-members: - -.. toctree:: - - musicbrainzapi.wordcloud.resources + :members: + :undoc-members: + :show-inheritance: + :private-members: