Release 1.0.0

.editorconfig

@@ -0,0 +1,16 @@
+# http://editorconfig.org
+root = true
+
+[*]
+indent_style = tab
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.yml]
+indent_style = space
+indent_size = 2

.flake8

@@ -0,0 +1,10 @@
+[flake8]
+ignore = W191, F403, F405
+max-line-length = 150
+import-order-style = tbm
+exclude =
+	conf.py
+	*_pb2.py
+enable-plugins =
+	builtins
+	import_order

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1 @@
+**Please read the contributing guidelines linked above and delete this message before opening an issue.**

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1 @@
+**Please read the contributing guidelines linked above and delete this message before creating a pull request.**

.gitignore

@@ -0,0 +1,70 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Ipython Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# poetry
+poetry.lock
+

.readthedocs.yml

@@ -0,0 +1,6 @@
+build:
+  image: latest
+
+python:
+  version: 3.6
+  pip_install: true

CHANGELOG.md

@@ -0,0 +1,5 @@
+# Change Log
+
+## [1.0.0](https://github.com/thebigmunch/google-music-proto/releases/tag/1.0.0) (2018-10-19)
+
+* Initial release.

CONTRIBUTING.md

@@ -0,0 +1,47 @@
+## Submitting an issue
+
+Bug reports and feature requests can be submitted to the
+[Issue Tracker](https://github.com/thebigmunch/google-music-proto/issues).
+For discussion and support, use the [Discourse forum](https://forum.thebigmunch.me).
+
+Some general guidelines to follow:
+
+* Use an appropriate, descriptive title.
+* Provide as many details as possible.
+* Don't piggy-back. Keep separate topics in separate issues.
+
+## Submitting code
+
+Patches are welcome.
+Keep your code consistent with the rest of the project.
+[PEP8](https://www.python.org/dev/peps/pep-0008/) is a good guide,
+but with the following exceptions to keep in mind for coding/linting:
+
+* Tabs should be used for indentation of code.
+* Don't use line continuation that aligns with opening delimiter.
+* I set a high maximum line length in flake8 to avoid unnecessary warnings.
+  Use judgement based on readability/understandability, not an arbitrary number.
+
+Some linter errors may need to be ignored to accommodate these differences.
+
+### Pull Requests
+
+[Pull Requests](https://help.github.com/articles/creating-a-pull-request) should originate from a
+[feature branch][fb] in your [fork][fork], not from the **master** branch.
+
+Commit messages should be written in a
+[well-formed, consistent](https://sethrobertson.github.io/GitBestPractices/#usemsg) manner.
+See the [commit log](https://github.com/thebigmunch/google-music-proto/commits) for acceptable examples.
+
+Each commit should encompass the smallest logical changeset.
+E.g. changing two unrelated things in the same file would be two commits rather than one commit of "Change filename".
+
+If you made a mistake in a commit in your Pull Request, you should
+[amend or rebase](https://www.atlassian.com/git/tutorials/rewriting-history) to change your previous commit(s)
+then [force push](http://stackoverflow.com/a/12610763) to the [feature branch][fb] in your [fork][fork].
+
+[fb]: https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/#creating-a-branch
+[fork]: https://help.github.com/articles/fork-a-repo
+
+## Misc
+For anything else, contact the author by e-mail at <mail@thebigmunch.me>.

LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 thebigmunch <mail@thebigmunch.me>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,41 @@
+# google-music-proto
+
+[google-music-proto](https://github.com/thebigmunch/google-music-proto) is a [sans-I/O](https://sans-io.readthedocs.io/)
+library for interacting with Google Music.
+
+
+## Installation
+
+``pip install google-music-proto``
+
+
+## Usage
+
+See the [docs](https://google-music-proto.readthedocs.io).
+
+
+## Appreciation
+
+Showing appreciation is always welcome.
+
+#### Thank
+
+[![Say Thanks](https://img.shields.io/badge/thank-thebigmunch-blue.svg?style=flat-square)](https://saythanks.io/to/thebigmunch)
+
+Get your own thanks inbox at [SayThanks.io](https://saythanks.io/).
+
+#### Contribute
+
+[Contribute](https://github.com/thebigmunch/google-music-proto/blob/master/CONTRIBUTING.md) by submitting bug reports, feature requests, or code.
+
+#### Help Others/Stay Informed
+
+[Discourse forum](https://forum.thebigmunch.me/)
+
+#### Referrals/Donations
+
+[![Coinbase](https://img.shields.io/badge/Coinbase-referral-orange.svg?style=flat-square)](https://www.coinbase.com/join/52502f01e0fdd4d3ef000253) [![Digital Ocean](https://img.shields.io/badge/Digital_Ocean-referral-orange.svg?style=flat-square)](https://m.do.co/c/3823208a0597) [![Namecheap](https://img.shields.io/badge/Namecheap-referral-orange.svg?style=flat-square)](https://www.namecheap.com/?aff=67208) [![PayPal](https://img.shields.io/badge/PayPal-donate-brightgreen.svg?style=flat-square)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=DHDVLSYW8V8N4&lc=US&item_name=thebigmunch&currency_code=USD)
+
+**BTC:** ``1BMLCFPcX8YHE1He2t3aBrsNDGr1pKhfFa``  
+**ETH:** ``0x8E3f8d8eAedeA61Bf34A998A2104954FE508D5d0``  
+**LTC:** ``LgsQU1YaY4a4s7m9efjn6m35XhVEpW1xoP``

SUPPORT.md

@@ -0,0 +1,3 @@
+The issue tracker is for feature requests and bug reports only.
+
+For discussion and support, use the [Discourse forum](https://forum.thebigmunch.me).

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = google-music-proto
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/conf.py

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+
+import os
+import sys
+
+project_dir = os.path.abspath(os.pardir)
+sys.path.insert(0, os.path.join(project_dir, 'src'))
+
+about = {}
+with open(os.path.join(project_dir, 'src', 'google_music_proto', '__about__.py')) as f:
+	exec(f.read(), about)
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+	'sphinx.ext.autodoc',
+	'sphinx.ext.extlinks',
+	'sphinx.ext.ifconfig',
+	'sphinx.ext.intersphinx',
+	'sphinx.ext.napoleon',
+	'sphinx.ext.todo',
+	'sphinx.ext.viewcode'
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = ['.rst', '.md']
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = about['__title__']
+copyright = about['__copyright__']
+author = about['__author__']
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = about['__version__']
+# The full version, including alpha/beta/rc tags.
+release = about['__version__']
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This patterns also effect to html_static_path and html_extra_path
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+add_function_parentheses = False
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+add_module_names = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+highlight_language = 'python3'
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+	'python': ('https://docs.python.org/3', None),
+	'audio_metadata': ('https://audio-metadata.readthedocs.io/en/latest', None),
+	'marshmallow': ('https://marshmallow.readthedocs.io/en/latest/', None),
+}
+
+# -- Options for HTML output ----------------------------------------------
+
+html_theme = 'alabaster'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#
+# html_theme_options = {}
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# If true, links to the reST sources are added to the pages.
+html_show_sourcelink = False
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+html_show_sphinx = False

docs/index.rst

@@ -0,0 +1,27 @@
+==================
+google-music-proto
+==================
+
+
+google-music-proto is a `sans-I/O <https://sans-io.readthedocs.io/>`_
+library for interacting with Google Music.
+
+
+Getting Started
+===============
+
+Install google-music-proto with `pip <https://pip.pypa.io/en/stable/>`_.
+
+.. code-block:: console
+
+	$ pip install google-music-proto
+
+
+API Reference
+=============
+
+.. toctree::
+	:maxdepth: 1
+
+	mobileclient
+	musicmanager