+/*
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+*/
+
properties([
parameters([
string(defaultValue: env.BRANCH_NAME, description: '', name: 'GERRIT_BRANCH'),
+++ /dev/null
-modules/libjuju/juju
\ No newline at end of file
+++ /dev/null
-*.sw[mnop]
-.venv/
-*.pyc
-*.py~
-docs/_build/
-__pycache__/
-.tox/
-*.egg-info/
-.cache/
-.\#*
-dist/
-dev/
-.pytest_cache
-pytestdebug.log
-.vscode/
+++ /dev/null
-dist: xenial
-sudo: required
-language: python
-cache: pip
-before_install:
- - if [[ $TRAVIS_PYTHON_VERSION == '3.6' ]]; then sudo add-apt-repository -y ppa:jonathonf/python-3.6; fi
- - if [[ $TRAVIS_PYTHON_VERSION == '3.7-dev' ]]; then sudo add-apt-repository -y ppa:deadsnakes/ppa; fi
- - sudo apt-get update -q
- - sudo apt-get remove -qy lxd lxd-client
- - sudo apt-get install snapd libsodium-dev -y
-install:
- - sudo snap install lxd || true # ignore failures so that unit tests will still run, at least
- - sudo sh -c 'echo PATH=/snap/bin:$PATH >> /etc/environment';
- - sudo snap install jq || true
- - sudo snap install juju --classic --$JUJU_CHANNEL || true
- - sudo snap install juju-wait --classic || true
- - pip install tox-travis
-env:
- global: >
- TEST_AGENTS='{"agents":[{"url":"https://api.staging.jujucharms.com/identity","username":"libjuju-ci@yellow"}],"key":{"private":"88OOCxIHQNguRG7zFg2y2Hx5Ob0SeVKKBRnjyehverc=","public":"fDn20+5FGyN2hYO7z0rFUyoHGUnfrleslUNtoYsjNSs="}}'
- PATH="/snap/bin:$PATH"
-
-matrix:
- include:
- - python: 3.6
- env: JUJU_CHANNEL=edge
- - python: 3.6
- env: JUJU_CHANNEL=stable
- - python: 3.7-dev
- env: JUJU_CHANNEL=stable
- - python: 3.7-dev
- env: JUJU_CHANNEL=edge
-before_script:
- # Run lint before performing more expensive operations (fail fast/early)
- - tox -e lint
-
- # init lxd for tests
- - sudo lxd waitready --timeout 30
- - sudo chmod 666 /var/snap/lxd/common/lxd/unix.socket
- - lxd init --auto --network-address='[::]' --network-port=8443 --storage-backend=dir
-
- # Horrible workaround to LP Bug #1738614
- - sudo mkdir /var/snap/lxd/common/lxd/storage-pools/juju-zfs
- - lxc storage create juju-zfs dir source=/var/snap/lxd/common/lxd/storage-pools/juju-zfs
-
-script:
- - juju bootstrap localhost test --config 'identity-url=https://api.staging.jujucharms.com/identity' --config 'allow-model-access=true'
- - tox -e py3,integration,serial
+++ /dev/null
-Benjamin Saller
-Tim Van Steenburgh
-Cory Johns
-Pete VanderGiessen
+++ /dev/null
- Apache License
- Version 2.0, January 2004
- http://www.apache.org/licenses/
-
- TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
- 1. Definitions.
-
- "License" shall mean the terms and conditions for use, reproduction,
- and distribution as defined by Sections 1 through 9 of this document.
-
- "Licensor" shall mean the copyright owner or entity authorized by
- the copyright owner that is granting the License.
-
- "Legal Entity" shall mean the union of the acting entity and all
- other entities that control, are controlled by, or are under common
- control with that entity. For the purposes of this definition,
- "control" means (i) the power, direct or indirect, to cause the
- direction or management of such entity, whether by contract or
- otherwise, or (ii) ownership of fifty percent (50%) or more of the
- outstanding shares, or (iii) beneficial ownership of such entity.
-
- "You" (or "Your") shall mean an individual or Legal Entity
- exercising permissions granted by this License.
-
- "Source" form shall mean the preferred form for making modifications,
- including but not limited to software source code, documentation
- source, and configuration files.
-
- "Object" form shall mean any form resulting from mechanical
- transformation or translation of a Source form, including but
- not limited to compiled object code, generated documentation,
- and conversions to other media types.
-
- "Work" shall mean the work of authorship, whether in Source or
- Object form, made available under the License, as indicated by a
- copyright notice that is included in or attached to the work
- (an example is provided in the Appendix below).
-
- "Derivative Works" shall mean any work, whether in Source or Object
- form, that is based on (or derived from) the Work and for which the
- editorial revisions, annotations, elaborations, or other modifications
- represent, as a whole, an original work of authorship. For the purposes
- of this License, Derivative Works shall not include works that remain
- separable from, or merely link (or bind by name) to the interfaces of,
- the Work and Derivative Works thereof.
-
- "Contribution" shall mean any work of authorship, including
- the original version of the Work and any modifications or additions
- to that Work or Derivative Works thereof, that is intentionally
- submitted to Licensor for inclusion in the Work by the copyright owner
- or by an individual or Legal Entity authorized to submit on behalf of
- the copyright owner. For the purposes of this definition, "submitted"
- means any form of electronic, verbal, or written communication sent
- to the Licensor or its representatives, including but not limited to
- communication on electronic mailing lists, source code control systems,
- and issue tracking systems that are managed by, or on behalf of, the
- Licensor for the purpose of discussing and improving the Work, but
- excluding communication that is conspicuously marked or otherwise
- designated in writing by the copyright owner as "Not a Contribution."
-
- "Contributor" shall mean Licensor and any individual or Legal Entity
- on behalf of whom a Contribution has been received by Licensor and
- subsequently incorporated within the Work.
-
- 2. Grant of Copyright License. Subject to the terms and conditions of
- this License, each Contributor hereby grants to You a perpetual,
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
- copyright license to reproduce, prepare Derivative Works of,
- publicly display, publicly perform, sublicense, and distribute the
- Work and such Derivative Works in Source or Object form.
-
- 3. Grant of Patent License. Subject to the terms and conditions of
- this License, each Contributor hereby grants to You a perpetual,
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
- (except as stated in this section) patent license to make, have made,
- use, offer to sell, sell, import, and otherwise transfer the Work,
- where such license applies only to those patent claims licensable
- by such Contributor that are necessarily infringed by their
- Contribution(s) alone or by combination of their Contribution(s)
- with the Work to which such Contribution(s) was submitted. If You
- institute patent litigation against any entity (including a
- cross-claim or counterclaim in a lawsuit) alleging that the Work
- or a Contribution incorporated within the Work constitutes direct
- or contributory patent infringement, then any patent licenses
- granted to You under this License for that Work shall terminate
- as of the date such litigation is filed.
-
- 4. Redistribution. You may reproduce and distribute copies of the
- Work or Derivative Works thereof in any medium, with or without
- modifications, and in Source or Object form, provided that You
- meet the following conditions:
-
- (a) You must give any other recipients of the Work or
- Derivative Works a copy of this License; and
-
- (b) You must cause any modified files to carry prominent notices
- stating that You changed the files; and
-
- (c) You must retain, in the Source form of any Derivative Works
- that You distribute, all copyright, patent, trademark, and
- attribution notices from the Source form of the Work,
- excluding those notices that do not pertain to any part of
- the Derivative Works; and
-
- (d) If the Work includes a "NOTICE" text file as part of its
- distribution, then any Derivative Works that You distribute must
- include a readable copy of the attribution notices contained
- within such NOTICE file, excluding those notices that do not
- pertain to any part of the Derivative Works, in at least one
- of the following places: within a NOTICE text file distributed
- as part of the Derivative Works; within the Source form or
- documentation, if provided along with the Derivative Works; or,
- within a display generated by the Derivative Works, if and
- wherever such third-party notices normally appear. The contents
- of the NOTICE file are for informational purposes only and
- do not modify the License. You may add Your own attribution
- notices within Derivative Works that You distribute, alongside
- or as an addendum to the NOTICE text from the Work, provided
- that such additional attribution notices cannot be construed
- as modifying the License.
-
- You may add Your own copyright statement to Your modifications and
- may provide additional or different license terms and conditions
- for use, reproduction, or distribution of Your modifications, or
- for any such Derivative Works as a whole, provided Your use,
- reproduction, and distribution of the Work otherwise complies with
- the conditions stated in this License.
-
- 5. Submission of Contributions. Unless You explicitly state otherwise,
- any Contribution intentionally submitted for inclusion in the Work
- by You to the Licensor shall be under the terms and conditions of
- this License, without any additional terms or conditions.
- Notwithstanding the above, nothing herein shall supersede or modify
- the terms of any separate license agreement you may have executed
- with Licensor regarding such Contributions.
-
- 6. Trademarks. This License does not grant permission to use the trade
- names, trademarks, service marks, or product names of the Licensor,
- except as required for reasonable and customary use in describing the
- origin of the Work and reproducing the content of the NOTICE file.
-
- 7. Disclaimer of Warranty. Unless required by applicable law or
- agreed to in writing, Licensor provides the Work (and each
- Contributor provides its Contributions) on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
- implied, including, without limitation, any warranties or conditions
- of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
- PARTICULAR PURPOSE. You are solely responsible for determining the
- appropriateness of using or redistributing the Work and assume any
- risks associated with Your exercise of permissions under this License.
-
- 8. Limitation of Liability. In no event and under no legal theory,
- whether in tort (including negligence), contract, or otherwise,
- unless required by applicable law (such as deliberate and grossly
- negligent acts) or agreed to in writing, shall any Contributor be
- liable to You for damages, including any direct, indirect, special,
- incidental, or consequential damages of any character arising as a
- result of this License or out of the use or inability to use the
- Work (including but not limited to damages for loss of goodwill,
- work stoppage, computer failure or malfunction, or any and all
- other commercial damages or losses), even if such Contributor
- has been advised of the possibility of such damages.
-
- 9. Accepting Warranty or Additional Liability. While redistributing
- the Work or Derivative Works thereof, You may choose to offer,
- and charge a fee for, acceptance of support, warranty, indemnity,
- or other liability obligations and/or rights consistent with this
- License. However, in accepting such obligations, You may act only
- on Your own behalf and on Your sole responsibility, not on behalf
- of any other Contributor, and only if You agree to indemnify,
- defend, and hold each Contributor harmless for any liability
- incurred by, or claims asserted against, such Contributor by reason
- of your accepting any such warranty or additional liability.
-
- END OF TERMS AND CONDITIONS
-
- APPENDIX: How to apply the Apache License to your work.
-
- To apply the Apache License to your work, attach the following
- boilerplate notice, with the fields enclosed by brackets "{}"
- replaced with your own identifying information. (Don't include
- the brackets!) The text should be enclosed in the appropriate
- comment syntax for the file format. We also recommend that a
- file or class name and description of purpose be included on the
- same "printed page" as the copyright notice for easier
- identification within third-party archives.
-
- Copyright {yyyy} {name of copyright owner}
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
+++ /dev/null
-include *.py CONTRIBUTORS LICENSE README.rst VERSION
-recursive-include juju *.py
-recursive-include examples *.py
-recursive-include docs *.rst
-exclude Makefile
+++ /dev/null
-BIN := .tox/py3/bin
-PY := $(BIN)/python
-PIP := $(BIN)/pip
-SCHEMAGEN := $(shell which schemagen)
-VERSION=$(shell cat VERSION)
-
-clean:
- find . -name __pycache__ -type d -exec rm -r {} +
- find . -name *.pyc -delete
- rm -rf .tox
- rm -rf docs/_build/
-
-.tox:
- tox -r --notest
-
-client: .tox
-ifndef SCHEMAGEN
- $(error "schemagen is not available, please install from https://github.com/juju/schemagen")
-endif
- $(PY) -m juju.client.facade -s "juju/client/schemas*" -o juju/client/
-
-test:
- tox
-
-.PHONY: lint
-lint:
- tox -e lint --notest
-
-docs: .tox
- $(PIP) install -r docs/requirements.txt
- rm -rf docs/_build/
- $(BIN)/sphinx-build -b html docs/ docs/_build/
- cd docs/_build/ && zip -r docs.zip *
-
-release:
- git fetch --tags
- rm dist/*.tar.gz
- $(PY) setup.py sdist
- $(BIN)/twine upload --repository-url https://upload.pypi.org/legacy/ dist/*
- git tag ${VERSION}
- git push --tags
-
-upload: release
-
-
-.PHONY: clean client test docs upload release
+++ /dev/null
-TODO
-====
-
-- Add a LogWatcher coroutine that yields from debug-log api
-- Add a way to exit the event loop when a Model matches a bundle yaml
+++ /dev/null
-# Makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
-SPHINXOPTS =
-SPHINXBUILD = sphinx-build
-PAPER =
-BUILDDIR = _build
-
-# User-friendly check for sphinx-build
-ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
- $(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don\'t have Sphinx installed, grab it from http://sphinx-doc.org/)
-endif
-
-# Internal variables.
-PAPEROPT_a4 = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-# the i18n builder cannot share the environment and doctrees with the others
-I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-
-.PHONY: help
-help:
- @echo "Please use \`make <target>' where <target> is one of"
- @echo " html to make standalone HTML files"
- @echo " dirhtml to make HTML files named index.html in directories"
- @echo " singlehtml to make a single large HTML file"
- @echo " pickle to make pickle files"
- @echo " json to make JSON files"
- @echo " htmlhelp to make HTML files and a HTML help project"
- @echo " qthelp to make HTML files and a qthelp project"
- @echo " applehelp to make an Apple Help Book"
- @echo " devhelp to make HTML files and a Devhelp project"
- @echo " epub to make an epub"
- @echo " epub3 to make an epub3"
- @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
- @echo " latexpdf to make LaTeX files and run them through pdflatex"
- @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
- @echo " text to make text files"
- @echo " man to make manual pages"
- @echo " texinfo to make Texinfo files"
- @echo " info to make Texinfo files and run them through makeinfo"
- @echo " gettext to make PO message catalogs"
- @echo " changes to make an overview of all changed/added/deprecated items"
- @echo " xml to make Docutils-native XML files"
- @echo " pseudoxml to make pseudoxml-XML files for display purposes"
- @echo " linkcheck to check all external links for integrity"
- @echo " doctest to run all doctests embedded in the documentation (if enabled)"
- @echo " coverage to run coverage check of the documentation (if enabled)"
- @echo " dummy to check syntax errors of document sources"
-
-.PHONY: clean
-clean:
- rm -rf $(BUILDDIR)/*
-
-.PHONY: html
-html:
- $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
- @echo
- @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
-
-.PHONY: dirhtml
-dirhtml:
- $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
- @echo
- @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
-
-.PHONY: singlehtml
-singlehtml:
- $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
- @echo
- @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
-
-.PHONY: pickle
-pickle:
- $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
- @echo
- @echo "Build finished; now you can process the pickle files."
-
-.PHONY: json
-json:
- $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
- @echo
- @echo "Build finished; now you can process the JSON files."
-
-.PHONY: htmlhelp
-htmlhelp:
- $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
- @echo
- @echo "Build finished; now you can run HTML Help Workshop with the" \
- ".hhp project file in $(BUILDDIR)/htmlhelp."
-
-.PHONY: qthelp
-qthelp:
- $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
- @echo
- @echo "Build finished; now you can run "qcollectiongenerator" with the" \
- ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
- @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/libjuju.qhcp"
- @echo "To view the help file:"
- @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/libjuju.qhc"
-
-.PHONY: applehelp
-applehelp:
- $(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp
- @echo
- @echo "Build finished. The help book is in $(BUILDDIR)/applehelp."
- @echo "N.B. You won't be able to view it unless you put it in" \
- "~/Library/Documentation/Help or install it in your application" \
- "bundle."
-
-.PHONY: devhelp
-devhelp:
- $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
- @echo
- @echo "Build finished."
- @echo "To view the help file:"
- @echo "# mkdir -p $$HOME/.local/share/devhelp/libjuju"
- @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/libjuju"
- @echo "# devhelp"
-
-.PHONY: epub
-epub:
- $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
- @echo
- @echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-.PHONY: epub3
-epub3:
- $(SPHINXBUILD) -b epub3 $(ALLSPHINXOPTS) $(BUILDDIR)/epub3
- @echo
- @echo "Build finished. The epub3 file is in $(BUILDDIR)/epub3."
-
-.PHONY: latex
-latex:
- $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
- @echo
- @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
- @echo "Run \`make' in that directory to run these through (pdf)latex" \
- "(use \`make latexpdf' here to do that automatically)."
-
-.PHONY: latexpdf
-latexpdf:
- $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
- @echo "Running LaTeX files through pdflatex..."
- $(MAKE) -C $(BUILDDIR)/latex all-pdf
- @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-.PHONY: latexpdfja
-latexpdfja:
- $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
- @echo "Running LaTeX files through platex and dvipdfmx..."
- $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
- @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-.PHONY: text
-text:
- $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
- @echo
- @echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-.PHONY: man
-man:
- $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
- @echo
- @echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-.PHONY: texinfo
-texinfo:
- $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
- @echo
- @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
- @echo "Run \`make' in that directory to run these through makeinfo" \
- "(use \`make info' here to do that automatically)."
-
-.PHONY: info
-info:
- $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
- @echo "Running Texinfo files through makeinfo..."
- make -C $(BUILDDIR)/texinfo info
- @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
-
-.PHONY: gettext
-gettext:
- $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
- @echo
- @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
-
-.PHONY: changes
-changes:
- $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
- @echo
- @echo "The overview file is in $(BUILDDIR)/changes."
-
-.PHONY: linkcheck
-linkcheck:
- $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
- @echo
- @echo "Link check complete; look for any errors in the above output " \
- "or in $(BUILDDIR)/linkcheck/output.txt."
-
-.PHONY: doctest
-doctest:
- $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
- @echo "Testing of doctests in the sources finished, look at the " \
- "results in $(BUILDDIR)/doctest/output.txt."
-
-.PHONY: coverage
-coverage:
- $(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage
- @echo "Testing of coverage in the sources finished, look at the " \
- "results in $(BUILDDIR)/coverage/python.txt."
-
-.PHONY: xml
-xml:
- $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
- @echo
- @echo "Build finished. The XML files are in $(BUILDDIR)/xml."
-
-.PHONY: pseudoxml
-pseudoxml:
- $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
- @echo
- @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
-
-.PHONY: dummy
-dummy:
- $(SPHINXBUILD) -b dummy $(ALLSPHINXOPTS) $(BUILDDIR)/dummy
- @echo
- @echo "Build finished. Dummy builder generates no files."
+++ /dev/null
-# Copyright 2014-2015 Canonical Limited.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-
-import importlib
-import inspect
-import textwrap
-
-from docutils import nodes
-from docutils.statemachine import ViewList
-from sphinx.errors import SphinxError
-from sphinx.util.compat import Directive
-from sphinx.util.nodes import nested_parse_with_titles
-
-
-class AutoMemberSummary(Directive):
- required_arguments = 1
-
- def run(self):
- module_name = self.arguments[0]
-
- try:
- module = importlib.import_module(module_name)
- except ImportError:
- raise SphinxError("Unable to generate reference docs for %s, "
- "could not import" % (module_name))
-
- divider = '+{:-<80}+'.format('')
- row = '| {:<78} |'.format
- lines = []
- for member_name, member in inspect.getmembers(module):
- if not self._filter(module_name, member_name, member):
- continue
- summary = textwrap.wrap(self._get_summary(member), 78) or ['']
- link = '`{} <#{}>`_'.format(member_name,
- '.'.join([module_name,
- member_name]))
- methods = ['* `{} <#{}>`_'.format(n,
- '.'.join([module_name,
- member_name,
- n]))
- for n, m in inspect.getmembers(member)
- if not n.startswith('_') and inspect.isfunction(m)]
-
- lines.append(divider)
- lines.append(row(link))
- lines.append(divider)
- for line in summary:
- lines.append(row(line))
- if methods:
- lines.append(row(''))
- lines.append(row('Methods:'))
- lines.append(row(''))
- for i, method in enumerate(methods):
- lines.append(row(method))
- lines.append(divider)
- content = '\n'.join(lines)
-
- result = self._parse(content, '<automembersummary>')
- return result
-
- def _get_summary(self, member):
- doc = (member.__doc__ or '').splitlines()
-
- # strip any leading blank lines
- while doc and not doc[0].strip():
- doc.pop(0)
-
- # strip anything after the first blank line
- for i, piece in enumerate(doc):
- if not piece.strip():
- doc = doc[:i]
- break
-
- return " ".join(doc).strip()
-
- def _filter(self, module_name, member_name, member):
- if member_name.startswith('_'):
- return False
- if hasattr(member, '__module__'):
- # skip imported classes & functions
- return member.__module__.startswith(module_name)
- elif hasattr(member, '__name__'):
- # skip imported modules
- return member.__name__.startswith(module_name)
- else:
- return False # skip instances
- return True
-
- def _parse(self, rst_text, annotation):
- result = ViewList()
- for line in rst_text.split("\n"):
- result.append(line, annotation)
- node = nodes.paragraph()
- node.document = self.state.document
- nested_parse_with_titles(self.state, result, node)
- return node.children
-
-
-def setup(app):
- app.add_directive('automembersummary', AutoMemberSummary)
+++ /dev/null
-.wy-table-responsive table td,
-.wy-table-responsive table th
-{
- white-space: normal !important;
-}
+++ /dev/null
-juju.action
-===========
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.action
-
-.. rubric:: Reference
-
-.. automodule:: juju.action
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.annotation
-===============
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.annotation
-
-.. rubric:: Reference
-
-.. automodule:: juju.annotation
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.application
-================
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.application
-
-.. rubric:: Reference
-
-.. automodule:: juju.application
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-Internal APIs
-=============
-
-These packages are for internal use in communicating with the low-level
-API. You should use the object oriented API instead. They are documented
-here for developer reference.
-
-
-juju\.client\.client module
----------------------------
-
-.. automodule:: juju.client.client
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\._definitions module
----------------------------------
-
-.. automodule:: juju.client._definitions
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\._client module
-----------------------------
-
-.. automodule:: juju.client._client
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\._client1 module
------------------------------
-
-.. automodule:: juju.client._client1
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\._client2 module
------------------------------
-
-.. automodule:: juju.client._client2
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\._client3 module
------------------------------
-
-.. automodule:: juju.client._client3
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\._client4 module
------------------------------
-
-.. automodule:: juju.client._client4
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\._client5 module
------------------------------
-
-.. automodule:: juju.client._client5
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\.codegen module
-----------------------------
-
-.. automodule:: juju.client.codegen
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\.connection module
--------------------------------
-
-.. automodule:: juju.client.connection
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\.facade module
----------------------------
-
-.. automodule:: juju.client.facade
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\.overrides module
-------------------------------
-
-.. automodule:: juju.client.overrides
- :members:
- :undoc-members:
- :show-inheritance:
-
-juju\.client\.runner module
----------------------------
-
-.. automodule:: juju.client.runner
- :members:
- :undoc-members:
- :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: juju.client
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.cloud
-==========
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.cloud
-
-.. rubric:: Reference
-
-.. automodule:: juju.cloud
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.constraints
-================
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.constraints
-
-.. rubric:: Reference
-
-.. automodule:: juju.constraints
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.controller
-===============
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.controller
-
-.. rubric:: Reference
-
-.. automodule:: juju.controller
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.delta
-==========
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.delta
-
-.. rubric:: Reference
-
-.. automodule:: juju.delta
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.errors
-===========
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.errors
-
-.. rubric:: Reference
-
-.. automodule:: juju.errors
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.exceptions
-===============
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.exceptions
-
-.. rubric:: Reference
-
-.. automodule:: juju.exceptions
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.juju
-=========
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.juju
-
-.. rubric:: Reference
-
-.. automodule:: juju.juju
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.loop
-=========
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.loop
-
-.. rubric:: Reference
-
-.. automodule:: juju.loop
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.machine
-============
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.machine
-
-.. rubric:: Reference
-
-.. automodule:: juju.machine
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.model
-==========
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.model
-
-.. rubric:: Reference
-
-.. automodule:: juju.model
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.placement
-==============
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.placement
-
-.. rubric:: Reference
-
-.. automodule:: juju.placement
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.relation
-=============
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.relation
-
-.. rubric:: Reference
-
-.. automodule:: juju.relation
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.tag
-========
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.tag
-
-.. rubric:: Reference
-
-.. automodule:: juju.tag
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.unit
-=========
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.unit
-
-.. rubric:: Reference
-
-.. automodule:: juju.unit
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-juju.utils
-==========
-
-.. rubric:: Summary
-
-.. automembersummary:: juju.utils
-
-.. rubric:: Reference
-
-.. automodule:: juju.utils
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-Public APIs
-===========
-
-It is recommended that you start with :doc:`juju.model` or :doc:`juju.controller`.
-If you need helpers to manage the asyncio loop, try :doc:`juju.loop`.
-
-.. toctree::
-
- juju.action
- juju.annotation
- juju.application
- juju.cloud
- juju.constraints
- juju.controller
- juju.delta
- juju.errors
- juju.exceptions
- juju.juju
- juju.loop
- juju.machine
- juju.model
- juju.placement
- juju.relation
- juju.tag
- juju.unit
- juju.utils
-
-.. automodule:: juju
- :members:
- :undoc-members:
- :show-inheritance:
+++ /dev/null
-Changelog
----------
-
-0.11.3
-^^^^^^
-Wednesday March 13 2019
-
-* k8s bundles no longer have application placement (#293)
-* Add retry for connection if all endpoints fail (#288)
-* Support generation of registration string for model sharing. (#279)
-* Add Twine for dist upload on release (#284)
-
-
-0.11.2
-^^^^^^
-Wednesday January 16 2019
-
-* update facade methods for Juju 2.5-rc2 (#281)
-* Add test case for redirect during connect (#275)
-* Implement App.get_resources and pinned resources in bundles (#278)
-
-
-0.11.1
-^^^^^^
-Thursday December 13 2018
-
-* Fix bundles with subordinates for Juju <2.5 (#277)
-
-
-0.11.0
-^^^^^^
-Tuesday December 11 2018
-
-* Updates for new Juju version (#274)
-* Fix wrong variable name in revoke_model function (#271)
-
-
-0.10.2
-^^^^^^
-Tuesday September 18 2018
-
-* set include_stats to false to reduce request time (#266)
-
-
-0.10.1
-^^^^^^
-Monday September 17 2018
-
-* Retry ssh in manual provision test (#265)
-* Clean up lint and add lint coverage to travis config (#263)
-* Increase the timeout for charmstore connections (#262)
-* Fix log level of `Driver connected to juju` message (#258)
-
-
-0.10.0
-^^^^^^
-Thursday August 16 2018
-
-* Fix error due to scp extra opts order (#260)
-* Implement set/get model constraints (#253)
-
-
->>>>>>> b8a8281b1785358bd5632a119c016f21811172c6
-0.9.1
-^^^^^
-Monday July 16 2018
-
-* Update websockets to 6.0 to fix OS X support due to Brew update to Py3.7 (#254)
-
-
-0.9.0
-^^^^^
-Friday June 29 2018
-
-* python3.7 compatibility updates (#251)
-* Handle juju not installed in is_bootstrapped for tests (#250)
-* Add app.reset_config(list). (#249)
-* Implement model.get_action_status (#248)
-* Fix `make client` in Python 3.6 (#247)
-
-
-0.8.0
-^^^^^
-Thursday June 14 2018
-
-* Add support for adding a manual (ssh) machine (#240)
-* Backwards compatibility fixes (#213)
-* Implement model.get_action_output (#242)
-* Fix JSON serialization error for bundle with lxd to unit placement (#243)
-* Fix reference in docs to connect_current (#239)
-* Wrap machine agent status workaround in version check (#238)
-* Convert seconds to nanoseconds for juju.unit.run (#237)
-* Fix spurious intermittent failure in test_machines.py::test_status (#236)
-* Define an unused juju-zfs lxd storage pool for Travis (#235)
-* Add support for Application get_actions (#234)
-
-
-0.7.5
-^^^^^
-Friday May 18 2018
-
-* Surface errors from bundle plan (#233)
-* Always send auth-tag even with macaroon auth (#217)
-* Inline jsonfile credential when sending to controller (#231)
-
-0.7.4
-^^^^^
-Tuesday Apr 24 2018
-
-* Always parse tags and spaces constraints to lists (#228)
-* Doc index improvements (#211)
-* Add doc req to force newer pymacaroons to fix RTD builds
-* Fix dependency conflict for building docs
-
-0.7.3
-^^^^^
-Tuesday Feb 20 2018
-
-* Full macaroon bakery support (#206)
-* Fix regression with deploying local charm, add test case (#209)
-* Expose a machines series (#208)
-* Automated test runner fixes (#205)
-
-0.7.2
-^^^^^
-Friday Feb 9 2018
-
-* Support deploying bundle YAML file directly (rather than just directory) (#202)
-
-0.7.1
-^^^^^
-Monday Dec 18 2017
-
-* Fix missed renames of model_uuids (#197)
-
-0.7.0
-^^^^^
-Fri Dec 15 2017
-
-* Fix race condition in adding relations (#192)
-* Fix race condition in connection monitor test (#183)
-* Fix example in README (#178)
-* Fix rare hang during Unit.run (#177)
-* Fix licensing quirks (#176)
-* Refactor model handling (#171)
-* Refactor users handling, add get_users (#170)
-* Upload credential to controller when adding model (#168)
-* Support 'applications' key in bundles (#165)
-* Improve handling of thread error handling for loop.run() (#169)
-* Fix encoding when using to_json() (#166)
-* Fix intermittent test failures (#167)
-
-0.6.1
-^^^^^
-Fri Sept 29 2017
-
-* Fix failure when controller supports newer facade version (#145)
-* Fix test failures (#163)
-* Fix SSH key handling when adding a new model (#161)
-* Make Application.upgrade_charm upgrade resources (#158)
-* Expand integration tests to use stable/edge versions of juju (#155)
-* Move docs to ReadTheDocs (https://pythonlibjuju.readthedocs.io/en/latest/)
-
-0.6.0
-^^^^^
-Thu June 29 2017
-
-* Implement scp functionality (#149)
-* Add Unit.public_address property (#153)
-* Adds support for getting/setting config on a model (#152)
-
-0.5.3
-^^^^^
-Thu June 22 2017
-
-* Improve handling of closed connections (#148)
-* Configurable and larger max message size (#146)
-
-0.5.2
-^^^^^
-Wed June 14 2017
-
-* Fix deploying non-stable channels and explicit revs (#144)
-
-0.5.1
-^^^^^
-Tue June 13 2017
-
-* Update schema for Juju 2.3 alpha1 (#142)
-* Improve API doc navigation and coverage (#141)
-* Add type info to Model.add_machine docs (#138)
-
-0.5.0
-^^^^^
-Thu June 8 2017
-
-* Add machine status properties (#133)
-* Add model context manager (#128)
-* Implement Application.upgrade_charm method (#132)
-
-0.4.3
-^^^^^
-Thu June 1 2017
-
-* Accept new / unknown API fields gracefully (#131)
-* Add support for new agent-version field in ModelInfo (#131)
-* Replace pip with pip3 in install instructions (#129)
-* Strip local:-prefix from local charm urls (#121)
-
-0.4.2
-^^^^^
-Wed May 10 2017
-
-* Support (and prefer) per-controller macaroon files (#125)
-
-0.4.1
-^^^^^
-Wed Apr 27 2017
-
-* Remove VERSION_MAP and rely on facade list from controller (#118)
-* Refactor connection task management to avoid cancels (#117)
-* Refactored login code to better handle redirects (#116)
-
-0.4.0
-^^^^^
-Wed Apr 19 2017
-
-* Feature/api version support (#109)
-* Expanding controller.py with basic user functions, get_models and
- destroy (#89)
-* Added Monitor class to Connection. (#105)
-* Support placement lists (#103)
-* Include resources from store when deploying (#102)
-* Allow underscore to dash translation when accessing model
- attributes (#101)
-* Added controller to ssh fix. (#100)
-* Regen schema to pick up missing APIs
-* Improve error handling
-* Fix issue where we do not check to make sure that we are receiving the
- correct response.
-* Retry calls to charmstore and increase timeout to 5s
-* Make connect_model and deploy a bit more friendly
-* Fix model name not including user
-* Implement Model.get_status
-* Add integration tests.
-
-0.3.0
-^^^^^
-Mon Feb 27 2017
-
-* Fix docstrings for placement directives.
-* Implement Model.add_machine()
-* Bug fix - "to" parameter to Model.deploy() was broken
-* Add docs and examples for adding machines and containers and deploying
- charms to them.
-* Make Machine.destroy() block the current coroutine, returning only after
- the machine is actually removed from the remote model. This is more
- consistent with the way the other apis work (e.g. Model.deploy(),
- Application.add_unit(), etc).
-* Raise NotImplementedError in all unimplemented method stubs instead of
- silently passing.
-
-0.2.0
-^^^^^
-Thu Feb 16 2017
-
-* Add default ssh key to newly created model.
-* Add loop helpers and simplify examples/deploy.py
-* Add support for deploying local charms, and bundles containing local charm paths.
-* Add ability to get cloud name for controller.
-* Bug fix - fix wrong api used in Model.destroy_unit()
-* Add error detection in bundle deploy.
-
-0.1.2
-^^^^^
-Thu Dec 22 2016
-
-* Bug fix - Include docs in package
-
-0.1.1
-^^^^^
-Thu Dec 22 2016
-
-* Bug fix - Include VERSION file in package
-
-0.1.0
-^^^^^
-Wed Dec 21 2016
-
-* Initial Release
+++ /dev/null
-# -*- coding: utf-8 -*-
-#
-# libjuju documentation build configuration file, created by
-# sphinx-quickstart on Thu May 19 11:21:38 2016.
-#
-# This file is execfile()d with the current directory set to its
-# containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-import sys
-import os
-
-from pathlib import Path
-
-here = Path(__file__).absolute().parent
-version = (here.parent / 'VERSION').read_text().strip()
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('..'))
-
-# -- General configuration ------------------------------------------------
-
-# If your documentation needs a minimal Sphinx version, state it here.
-#needs_sphinx = '1.0'
-
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
-sys.path.append(os.path.abspath('_extensions/'))
-extensions = [
- 'sphinx.ext.autodoc',
- 'sphinx.ext.autosummary',
- 'sphinx.ext.intersphinx',
- 'sphinx.ext.todo',
- 'sphinx.ext.viewcode',
- 'sphinxcontrib.asyncio',
- 'automembersummary',
-]
-
-# 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 encoding of source files.
-#source_encoding = 'utf-8-sig'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = u'juju'
-copyright = u'2016, Canonical Ltd.'
-author = u'Canonical'
-
-# 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 = version
-# The full version, including alpha/beta/rc tags.
-release = 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
-
-# There are two options for replacing |today|: either, you set today to some
-# non-false value, then it is used:
-#today = ''
-# Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
-
-# 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']
-
-# The reST default role (used for this markup: `text`) to use for all
-# documents.
-#default_role = None
-
-# If true, '()' will be appended to :func: etc. cross-reference text.
-#add_function_parentheses = True
-
-# If true, the current module name will be prepended to all description
-# unit titles (such as .. function::).
-#add_module_names = True
-
-# If true, sectionauthor and moduleauthor directives will be shown in the
-# output. They are ignored by default.
-#show_authors = False
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
-
-# A list of ignored prefixes for module index sorting.
-#modindex_common_prefix = []
-
-# If true, keep warnings as "system message" paragraphs in the built documents.
-#keep_warnings = False
-
-# If true, `todo` and `todoList` produce output, else they produce nothing.
-todo_include_todos = True
-
-
-# -- Options for HTML output ----------------------------------------------
-
-# The theme to use for HTML and HTML Help pages. See the documentation for
-# a list of builtin themes.
-html_theme = 'sphinx_rtd_theme'
-
-# 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 themes here, relative to this directory.
-#html_theme_path = []
-
-# The name for this set of Sphinx documents.
-# "<project> v<release> documentation" by default.
-#html_title = u'libjuju v0.0.0'
-
-# A shorter title for the navigation bar. Default is the same as html_title.
-#html_short_title = None
-
-# The name of an image file (relative to this directory) to place at the top
-# of the sidebar.
-#html_logo = None
-
-# The name of an image file (relative to this directory) to use as a favicon of
-# the docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
-# pixels large.
-#html_favicon = None
-
-# 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']
-
-# Add any extra paths that contain custom files (such as robots.txt or
-# .htaccess) here, relative to this directory. These files are copied
-# directly to the root of the documentation.
-#html_extra_path = []
-
-# If not None, a 'Last updated on:' timestamp is inserted at every page
-# bottom, using the given strftime format.
-# The empty string is equivalent to '%b %d, %Y'.
-#html_last_updated_fmt = None
-
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-#html_use_smartypants = True
-
-# Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
-
-# Additional templates that should be rendered to pages, maps page names to
-# template names.
-#html_additional_pages = {}
-
-# If false, no module index is generated.
-#html_domain_indices = True
-
-# If false, no index is generated.
-#html_use_index = True
-
-# If true, the index is split into individual pages for each letter.
-#html_split_index = False
-
-# If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
-
-# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#html_show_sphinx = True
-
-# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#html_show_copyright = True
-
-# If true, an OpenSearch description file will be output, and all pages will
-# contain a <link> tag referring to it. The value of this option must be the
-# base URL from which the finished HTML is served.
-#html_use_opensearch = ''
-
-# This is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = None
-
-# Language to be used for generating the HTML full-text search index.
-# Sphinx supports the following languages:
-# 'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
-# 'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr', 'zh'
-#html_search_language = 'en'
-
-# A dictionary with options for the search language support, empty by default.
-# 'ja' uses this config value.
-# 'zh' user can custom change `jieba` dictionary path.
-#html_search_options = {'type': 'default'}
-
-# The name of a javascript file (relative to the configuration directory) that
-# implements a search results scorer. If empty, the default will be used.
-#html_search_scorer = 'scorer.js'
-
-# Output file base name for HTML help builder.
-htmlhelp_basename = 'libjujudoc'
-
-# -- Options for LaTeX output ---------------------------------------------
-
-latex_elements = {
-# The paper size ('letterpaper' or 'a4paper').
-#'papersize': 'letterpaper',
-
-# The font size ('10pt', '11pt' or '12pt').
-#'pointsize': '10pt',
-
-# Additional stuff for the LaTeX preamble.
-#'preamble': '',
-
-# Latex figure (float) alignment
-#'figure_align': 'htbp',
-}
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title,
-# author, documentclass [howto, manual, or own class]).
-latex_documents = [
- (master_doc, 'libjuju.tex', u'libjuju Documentation',
- u'Canonical', 'manual'),
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-#latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-#latex_use_parts = False
-
-# If true, show page references after internal links.
-#latex_show_pagerefs = False
-
-# If true, show URL addresses after external links.
-#latex_show_urls = False
-
-# Documents to append as an appendix to all manuals.
-#latex_appendices = []
-
-# If false, no module index is generated.
-#latex_domain_indices = True
-
-
-# -- Options for manual page output ---------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
- (master_doc, 'libjuju', u'libjuju Documentation',
- [author], 1)
-]
-
-# If true, show URL addresses after external links.
-#man_show_urls = False
-
-
-# -- Options for Texinfo output -------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-# dir menu entry, description, category)
-texinfo_documents = [
- (master_doc, 'libjuju', u'libjuju Documentation',
- author, 'libjuju', 'One line description of project.',
- 'Miscellaneous'),
-]
-
-# Documents to append as an appendix to all manuals.
-#texinfo_appendices = []
-
-# If false, no module index is generated.
-#texinfo_domain_indices = True
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-#texinfo_show_urls = 'footnote'
-
-# If true, do not generate a @detailmenu in the "Top" node's menu.
-#texinfo_no_detailmenu = False
-
-def setup(app):
- app.add_stylesheet('custom.css')
+++ /dev/null
-.. libjuju documentation master file, created by
- sphinx-quickstart on Thu May 19 11:21:38 2016.
- You can adapt this file completely to your liking, but it should at least
- contain the root `toctree` directive.
-
-
-.. include:: readme.rst
-
-
-Table of Contents
------------------
-
-.. toctree::
- :caption: Overview
- :glob:
- :maxdepth: 3
-
- narrative/index
-
-
-.. toctree::
- :caption: API Documentation
- :glob:
- :maxdepth: 3
-
- api/modules
- api/juju.client
-
-.. toctree::
- :caption: Project
- :glob:
- :maxdepth: 3
-
- upstream-updates/index
- changelog
-
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-
+++ /dev/null
-Applications
-============
-For api docs, see :class:`juju.application.Application`.
-
-
-Deploying
----------
-To deploy a new application, connect a model and then call its
-:meth:`~juju.model.Model.deploy` method. An
-:class:`~juju.application.Application` instance is returned.
-
-.. code:: python
-
- from juju.model import Model
-
- model = Model()
- await model.connect_current()
-
- mysql_app = await model.deploy(
- # If a revision number is not included in the charm url,
- # the latest revision from the Charm Store will be used.
- 'cs:mysql-55',
- application_name='mysql',
- series='trusty',
- channel='stable',
- config={
- 'tuning-level': 'safest',
- },
- constraints={
- 'mem': 256 * MB,
- },
- )
-
-
-Deploying a Local Charm
------------------------
-To deploy a local charm, pass the charm directory path to
-`Model.deploy()`.
-
-.. code:: python
-
- from juju.model import Model
-
- model = Model()
- await model.connect_current()
-
- # Deploy a local charm using a path to the charm directory
- await model.deploy(
- '/home/tvansteenburgh/src/charms/ubuntu',
- application_name='ubuntu',
- series='trusty',
- )
-
-
-Adding Units
-------------
-To add units to a deployed application, use the
-:meth:`juju.application.Application.add_units` method. A list of the newly
-added units (:class:`~juju.unit.Unit` objects) is returned.
-
-.. code:: python
-
- ubuntu_app = await model.deploy(
- 'ubuntu',
- application_name='ubuntu',
- series='trusty',
- channel='stable',
- )
-
- unit_a, unit_b = await ubuntu_app.add_units(count=2)
-
-
-Updating Config and Constraints
--------------------------------
-Example showing how to update configuration and constraints on a deployed
-application. The `mysql_app` object is an instance of
-:class:`juju.application.Application`.
-
-.. code:: python
-
- MB = 1024 * 1024
-
- # Update and check app config
- await mysql_app.set_config({'tuning-level': 'fast'})
- config = await mysql_app.get_config()
-
- assert(config['tuning-level']['value'] == 'fast')
-
- # update and check app constraints
- await mysql_app.set_constraints({'mem': 512 * MB})
- constraints = await mysql_app.get_constraints()
-
- assert(constraints['mem'] == 512 * MB)
-
-
-Adding and Removing Relations
------------------------------
-The :meth:`juju.application.Application.add_relation` method returns a
-:class:`juju.relation.Relation` instance.
-
-.. code:: python
-
- from juju.model import Model
-
- model = Model()
- await model.connect_current()
-
- # Deploy mysql-master application
- mysql_master = await model.deploy(
- 'cs:mysql-55',
- application_name='mysql-master',
- series='trusty',
- channel='stable',
- )
-
- # Deploy mysql-slave application
- mysql_slave = await model.deploy(
- 'cs:mysql-55',
- application_name='mysql-slave',
- series='trusty',
- channel='stable',
- )
-
- # Add the master-slave relation
- relation = await mysql_master.add_relation(
- # Name of the relation on the local (mysql-master) side
- 'master',
- # Name of the app:relation on the remote side
- 'mysql-slave:slave',
- )
-
- # Remove the relation
- await mysql_master.remove_relation(
- 'master',
- 'mysql-slave:slave',
- )
+++ /dev/null
-Controllers
-===========
-A Juju controller provides websocket endpoints for itself and each of its
-models. In order to do anything useful, the juju lib must connect to one of
-these endpoints.
-
-Connecting to the controller endpoint is useful if you want to programmatically
-create a new model. If the model you want to use already exists, you can
-connect directly to it (see py:doc:`model`).
-
-For API docs, see py:class:`juju.controller.Controller`.
-
-
-Connecting to the Current Controller
-------------------------------------
-Connect to the currently active Juju controller (the one returned by
-`juju switch`). This only works if you have the Juju CLI client installed.
-
-.. code:: python
-
- from juju.controller import Controller
-
- controller = Controller()
- await controller.connect()
-
-
-Connecting to a Named Controller
---------------------------------
-Connect to a controller by name.
-
-.. code:: python
-
- from juju.controller import Controller
-
- controller = Controller()
- await controller.connect('mycontroller')
-
-
-Connecting with Authentication
-------------------------------
-You can control what user you are connecting with by specifying either a
-username/password pair, or a macaroon or bakery client that can provide
-a macaroon.
-
-
-.. code:: python
-
- controller = Controller()
- await controller.connect(username='admin',
- password='f53f08cfc32a2e257fe5393271d89d62')
-
- # or with a macaroon
- await controller.connect(macaroons=[
- {
- "Name": "macaroon-218d87053ad19626bcd5a0eef0bc9ba8bd4fbd80a968f52a5fd430b2aa8660df",
- "Value": "W3siY2F2ZWF0cyI6 ... jBkZiJ9XQ==",
- "Domain": "10.130.48.27",
- "Path": "/auth",
- "Secure": false,
- "HostOnly": true,
- "Expires": "2018-03-07T22:07:23Z",
- },
- ])
-
- # or with a bakery client
- from macaroonbakery.httpbakery import Client
- from http.cookiejar import FileCookieJar
-
- bakery_client=Client()
- bakery_client.cookies = FileCookieJar('cookies.txt')
- controller = Controller()
- await controller.connect(bakery_client=bakery_client)
-
-
-
-Connecting with an Explicit Endpoint
-------------------------------------
-The most flexible, but also most verbose, way to connect is using the API
-endpoint url and credentials directly. This method does NOT require the
-Juju CLI client to be installed.
-
-.. code:: python
-
- controller = Controller()
- await controller.connect(
- endpoint='10.0.4.171:17070',
- username='admin',
- password='f53f08cfc32a2e257fe5393271d89d62',
- cacert=None, # Left out for brevity, but if you have a cert string you
- # should pass it in. You can get the cert from the output
- # of The `juju show-controller` command.
- )
+++ /dev/null
-**Overview**
-
-.. toctree::
- :glob:
- :maxdepth: 2
-
- controller
- model
- application
- unit
+++ /dev/null
-Models
-======
-A Juju controller provides websocket endpoints for each of its
-models. In order to do anything useful with a model, the juju lib must
-connect to one of these endpoints. There are several ways to do this.
-
-For api docs, see py:class:`juju.model.Model`.
-
-
-Connecting to the Current Model
--------------------------------
-Connect to the currently active Juju model (the one returned by
-`juju switch`). This only works if you have the Juju CLI client installed.
-
-.. code:: python
-
- model = Model()
- await model.connect()
-
-
-Connecting to a Named Model
----------------------------
-Connect to a model by name, using the same format as that returned from the
-`juju switch` command. The accepted format is '[controller:][user/]model'.
-This only works if you have the Juju CLI client installed.
-
-.. code:: python
-
- model = Model()
- await model.connect('juju-2.0.1:admin/libjuju')
-
-
-Connecting with Authentication
-------------------------------
-You can control what user you are connecting with by specifying either a
-username/password pair, or a macaroon or bakery client that can provide
-a macaroon.
-
-
-.. code:: python
-
- model = Model()
- await model.connect(username='admin',
- password='f53f08cfc32a2e257fe5393271d89d62')
-
- # or with a macaroon
- await model.connect(macaroons=[
- {
- "Name": "macaroon-218d87053ad19626bcd5a0eef0bc9ba8bd4fbd80a968f52a5fd430b2aa8660df",
- "Value": "W3siY2F2ZWF0cyI6 ... jBkZiJ9XQ==",
- "Domain": "10.130.48.27",
- "Path": "/auth",
- "Secure": false,
- "HostOnly": true,
- "Expires": "2018-03-07T22:07:23Z",
- },
- ])
-
- # or with a bakery client
- from macaroonbakery.httpbakery import Client
- from http.cookiejar import FileCookieJar
-
- bakery_client=Client()
- bakery_client.cookies = FileCookieJar('cookies.txt')
- model = Model()
- await model.connect(bakery_client=bakery_client)
-
-
-
-Connecting with an Explicit Endpoint
-------------------------------------
-The most flexible, but also most verbose, way to connect is using the API
-endpoint url, model UUID, and credentials directly. This method does NOT
-require the Juju CLI client to be installed.
-
-.. code:: python
-
- from juju.model import Model
-
- model = Model()
- await model.connect(
- endpoint='10.0.4.171:17070',
- uuid='e8399ac7-078c-4817-8e5e-32316d55b083',
- username='admin',
- password='f53f08cfc32a2e257fe5393271d89d62',
- cacert=None, # Left out for brevity, but if you have a cert string you
- # should pass it in. You can get the cert from the output
- # of The `juju show-controller` command.
- )
-
-
-Creating and Destroying a Model
--------------------------------
-Example of creating a new model and then destroying it. See
-py:method:`juju.controller.Controller.add_model` and
-py:method:`juju.controller.Controller.destroy_model` for more info.
-
-.. code:: python
-
- from juju.controller import Controller
-
- controller = Controller()
- await controller.connect_current()
-
- # Create our new model
- model = await controller.add_model(
- 'mymodel', # name of your new model
- )
-
- # Do stuff with our model...
-
- # Destroy the model
- await model.disconnect()
- await controller.destroy_model(model.info.uuid)
- model = None
-
-
-Adding Machines and Containers
-------------------------------
-To add a machine or container, connect to a model and then call its
-py:method:`~juju.model.Model.add_machine` method. A
-py:class:`~juju.machine.Machine` instance is returned. The machine id
-can be used to deploy a charm to a specific machine or container.
-
-.. code:: python
-
- from juju.model import Model
-
- MB = 1
- GB = 1024
-
-
- model = Model()
- await model.connect_current()
-
- # add a new default machine
- machine1 = await model.add_machine()
-
- # add a machine with constraints, disks, and series specified
- machine2 = await model.add_machine(
- constraints={
- 'mem': 256 * MB,
- },
- disks=[{
- 'pool': 'rootfs',
- 'size': 10 * GB,
- 'count': 1,
- }],
- series='xenial',
- )
-
- # add a lxd container to machine2
- machine3 = await model.add_machine(
- 'lxd:{}'.format(machine2.id))
-
- # deploy charm to the lxd container
- application = await model.deploy(
- 'ubuntu-10',
- application_name='ubuntu',
- series='xenial',
- channel='stable',
- to=machine3.id
- )
-
- # remove application
- await application.remove()
-
- # destroy machines - note that machine3 must be destroyed before machine2
- # since it's a container on machine2
- await machine3.destroy(force=True)
- await machine2.destroy(force=True)
- await machine1.destroy(force=True)
-
-
-Reacting to Changes in a Model
-------------------------------
-To watch for and respond to changes in a model, register an observer with the
-model. The easiest way to do this is by creating a
-py:class:`juju.model.ModelObserver` subclass.
-
-.. code:: python
-
- from juju.model import Model, ModelObserver
-
- class MyModelObserver(ModelObserver):
- async def on_change(self, delta, old, new, model):
- # The raw change data (dict) from the websocket.
- print(delta.data)
-
- # The entity type (str) affected by this change.
- # One of ('action', 'application', 'annotation', 'machine',
- # 'unit', 'relation')
- print(delta.entity)
-
- # The type (str) of change.
- # One of ('add', 'change', 'remove')
- print(delta.type)
-
- # The 'old' and 'new' parameters are juju.model.ModelEntity
- # instances which represent an entity in the model both before
- # this change was applied (old) and after (new).
-
- # If an entity is being added to the model, the 'old' param
- # will be None.
- if delta.type == 'add':
- assert(old is None)
-
- # If an entity is being removed from the model, the 'new' param
- # will be None.
- if delta.type == 'remove':
- assert(new is None)
-
- # The 'old' and 'new' parameters, when not None, will be instances
- # of a juju.model.ModelEntity subclass. The type of the subclass
- # depends on the value of 'delta.entity', for example:
- #
- # delta.entity type
- # ------------ ----
- # 'action' -> juju.action.Action
- # 'application' -> juju.application.Application
- # 'annotation' -> juju.annotation.Annotation
- # 'machine' -> juju.machine.Machine
- # 'unit' -> juju.unit.Unit
- # 'relation' -> juju.relation.Relation
-
- # Finally, the 'model' parameter is a reference to the
- # juju.model.Model instance to which this observer is attached.
- print(id(model))
-
-
- model = Model()
- await model.connect_current()
-
- model.add_observer(MyModelObserver())
-
-
-Every change in the model will result in a call to the `on_change()`
-method of your observer(s).
-
-To target your code more precisely, define method names that correspond
-to the entity and type of change that you wish to handle.
-
-.. code:: python
-
- from juju.model import Model, ModelObserver
-
- class MyModelObserver(ModelObserver):
- async def on_application_change(self, delta, old, new, model):
- # Both 'old' and 'new' params will be instances of
- # juju.application.Application
- pass
-
- async def on_unit_remove(self, delta, old, new, model):
- # Since a unit is being removed, the 'new' param will always
- # be None in this handler. The 'old' param will be an instance
- # of juju.unit.Unit - the state of the unit before it was removed.
- pass
-
- async def on_machine_add(self, delta, old, new, model):
- # Since a machine is being added, the 'old' param will always be
- # None in this handler. The 'new' param will be an instance of
- # juju.machine.Machine.
- pass
-
- async def on_change(self, delta, old, new, model):
- # The catch-all handler - will be called whenever a more
- # specific handler method is not defined.
-
-
-Any py:class:`juju.model.ModelEntity` object can be observed directly by
-registering callbacks on the object itself.
-
-.. code:: python
-
- import logging
-
- async def on_app_change(delta, old, new, model):
- logging.debug('App changed: %r', new)
-
- async def on_app_remove(delta, old, new, model):
- logging.debug('App removed: %r', old)
-
- ubuntu_app = await model.deploy(
- 'ubuntu',
- application_name='ubuntu',
- series='trusty',
- channel='stable',
- )
- ubuntu_app.on_change(on_app_change)
- ubuntu_app.on_remove(on_app_remove)
+++ /dev/null
-Units
-=====
-For api docs, see :class:`juju.unit.Unit`.
-
-
-Running Commands
-----------------
-Run arbitrary commands on a unit with the
-:meth:`juju.unit.Unit.run` method. This method blocks
-the current coroutine until a result is available, and
-returns a :class:`juju.action.Action` instance.
-
-
-.. code:: python
-
- from juju.model import Model
-
- model = Model()
- await model.connect_current()
-
- app = await model.deploy(
- 'ubuntu',
- application_name='ubuntu',
- series='trusty',
- channel='stable',
- )
-
- for unit in app.units:
- action = await unit.run('unit-get public-address')
- print(action.results)
-
- action = await unit.run('uname -a')
- print(action.results)
-
-
-Running Actions
----------------
-Run actions on a unit with the
-:meth:`juju.unit.Unit.run_action` method. This method
-returns a :class:`juju.action.Action` instance immediately. To block until
-the action completes, use the :meth:`juju.action.Action.wait` method, as
-in the example below.
-
-
-.. code:: python
-
- from juju.model import Model
-
- model = Model()
- await model.connect_current()
-
- app = await model.deploy(
- 'git',
- application_name='git',
- series='trusty',
- channel='stable',
- )
-
- for unit in app.units:
- # run the 'add-repo' action, passing a 'repo' param
- action = await unit.run_action('add-repo', repo='myrepo')
- # wait for the action to complete
- action = await action.wait()
-
- print(action.results)
+++ /dev/null
-A Python library for Juju
-=========================
-
-Source code: https://github.com/juju/python-libjuju
-
-Bug reports: https://github.com/juju/python-libjuju/issues
-
-Documentation: https://pythonlibjuju.readthedocs.io/en/latest/
-
-
-Requirements
-------------
-
-* Python 3.5+
-* Juju 2.0+
-
-
-Design Notes
-------------
-
-* Asynchronous - uses asyncio and async/await features of python 3.5
-* Websocket-level bindings are programmatically generated (indirectly) from the
- Juju golang code, ensuring full api coverage
-* Provides an OO layer which encapsulates much of the websocket api and
- provides familiar nouns and verbs (e.g. Model.deploy(), Application.add_unit(),
- etc.)
-
-
-Installation
-------------
-
-.. code:: bash
-
- pip3 install juju
-
-
-Quickstart
-----------
-Here's a simple example that shows basic usage of the library. The example
-connects to the currently active Juju model, deploys a single unit of the
-ubuntu charm, then exits:
-
-
-.. code:: python
-
- #!/usr/bin/python3
-
- import logging
- import sys
-
- from juju import loop
- from juju.model import Model
-
-
- async def deploy():
- # Create a Model instance. We need to connect our Model to a Juju api
- # server before we can use it.
- model = Model()
-
- # Connect to the currently active Juju model
- await model.connect_current()
-
- try:
- # Deploy a single unit of the ubuntu charm, using the latest revision
- # from the stable channel of the Charm Store.
- ubuntu_app = await model.deploy(
- 'ubuntu',
- application_name='ubuntu',
- series='xenial',
- channel='stable',
- )
-
- if '--wait' in sys.argv:
- # optionally block until the application is ready
- await model.block_until(lambda: ubuntu_app.status == 'active')
- finally:
- # Disconnect from the api server and cleanup.
- await model.disconnect()
-
-
- def main():
- logging.basicConfig(level=logging.INFO)
-
- # If you want to see everything sent over the wire, set this to DEBUG.
- ws_logger = logging.getLogger('websockets.protocol')
- ws_logger.setLevel(logging.INFO)
-
- # Run the deploy coroutine in an asyncio event loop, using a helper
- # that abstracts loop creation and teardown.
- loop.run(deploy())
-
-
- if __name__ == '__main__':
- main()
-
-
-More examples can be found in the docs, as well as in the ``examples/``
-directory of the source tree which can be run using ``tox``. For
-example, to run ``examples/connect_current_model.py``, use:
-
-.. code:: bash
-
- tox -e example -- examples/connect_current_model.py
+++ /dev/null
-pytz<2018.0,>=2017.2 # conflict between sphinx and macaroonbakery
-pymacaroons>=0.13.0,<1.0 # force new version with pynacl instead of libnacl
-sphinx==1.6.5
-sphinxcontrib-asyncio
-sphinx_rtd_theme
+++ /dev/null
-Syncing Upstream Updates
-========================
-
-Updating the facade and definitions code generated from the schema
-to reflect changes in upstream Juju consists of two steps:
-
-* Creating a new `schemas-juju-<version>.json` file from the Juju code-base
-* Generating the libjuju Python code from that schema
-
-Rarely, you may also have to add or update an override.
-
-
-Creating a Schema File
-----------------------
-
-First, you will need to fetch SchemaGen_ and a copy of the Juju source.
-Once your copy of the Juju source is at the version you want to update to
-(probably the `develop` branch, or a release tag) and you have updated
-and reinstalled SchemaGen to reflect those changes, you just need to send
-the output into a file in the libjuju repository:
-
-.. code:: bash
-
- schemagen > juju/client/schemas-juju-2.2-rc1.json
-
-The version number you use in the filename should match the upstream
-version of Juju. You should then also move the `latest` pointer to
-the new file:
-
-.. code:: bash
-
- rm juju/client/schemas-juju-latest.json
- ln -s schemas-juju-2.2-rc1.json juju/client/schemas-juju-latest.json
-
-
-Generating the Python Code
---------------------------
-
-Once you have a new schema file, you can update the Python code
-using the `client` make target:
-
-.. code:: bash
-
- make client
-
-You should expect to see updates to the `juju/client/_definitions.py` file,
-as well as one or more of the `juju/client/_clientX.py` files, depending on
-which facades were touched.
-
-
-Integrating into the Object Layer
----------------------------------
-
-Once the raw client APIs are synced, you may need to integrate any new or
-changed API calls into the object layer, to provide a clean, Pythonic way
-to interact with the model. This may be as simple as adding an optional
-parameter to an existing model method, tweaking what manipulations, if any
-the model method does to the data before it is sent to the API, or it may
-require adding an entirely new model method to capture the new functionality.
-
-In general, the approach should be to make the interactions with the model
-layer use the same patterns as when you use the CLI, just with Python idioms
-and OO approaches.
-
-When trying to determine what client calls need to be made and what data to
-be sent for a given Juju CLI action, it is very useful to add
-`--debug --logging-config TRACE` to any Juju CLI command to view the full
-conversation between the CLI client and the API server. For example:
-
-```
-[johnsca@murdoch:~] $ juju deploy --debug --logging-config TRACE ./builds/test
-11:51:20 INFO juju.cmd supercommand.go:56 running juju [2.3.5 gc go1.10]
-11:51:20 DEBUG juju.cmd supercommand.go:57 args: []string{"/snap/juju/3884/bin/juju", "deploy", "--debug", "--logging-config", "TRACE", "./builds/test"}
-11:51:20 INFO juju.juju api.go:67 connecting to API addresses: [35.172.119.191:17070 172.31.94.16:17070 252.94.16.1:17070]
-11:51:20 TRACE juju.api certpool.go:49 cert dir "/etc/juju/certs.d" does not exist
-11:51:20 DEBUG juju.api apiclient.go:843 successfully dialed "wss://35.172.119.191:17070/model/a7317969-6dab-4ba4-844b-af3d661c228d/api"
-11:51:20 INFO juju.api apiclient.go:597 connection established to "wss://35.172.119.191:17070/model/a7317969-6dab-4ba4-844b-af3d661c228d/api"
-...
-11:51:20 INFO juju.cmd.juju.application series_selector.go:71 with the configured model default series "xenial"
-11:51:20 DEBUG httpbakery client.go:244 client do POST https://35.172.119.191:17070/model/a7317969-6dab-4ba4-844b-af3d661c228d/charms?revision=0&schema=local&series=xenial {
-11:51:21 DEBUG httpbakery client.go:246 } -> error <nil>
-11:51:21 INFO cmd deploy.go:1096 Deploying charm "local:xenial/test-0".
-11:51:21 TRACE juju.rpc.jsoncodec codec.go:225 -> {"request-id":3,"type":"Charms","version":2,"request":"CharmInfo","params":{"url":"local:xenial/test-0"}}
-11:51:21 TRACE juju.rpc.jsoncodec codec.go:120 <- {"request-id":3,"response":{"revision":0,"url":"local:xenial/test-0","config":{"test":{"type":"string","default":""}},"meta":{"name":"test","summary":"test","description":"test","subordinate":false,"series":["xenial"],"resources":{"dummy":{"name":"dummy","type":"file","path":"dummy.snap","description":"dummy snap"}},"min-juju-version":"0.0.0"},"actions":{}}}
-11:51:21 TRACE juju.rpc.jsoncodec codec.go:225 -> {"request-id":4,"type":"Charms","version":2,"request":"IsMetered","params":{"url":"local:xenial/test-0"}}
-11:51:21 TRACE juju.rpc.jsoncodec codec.go:120 <- {"request-id":4,"response":{"metered":false}}
-11:51:21 TRACE juju.rpc.jsoncodec codec.go:225 -> {"request-id":5,"type":"Resources","version":1,"request":"AddPendingResources","params":{"tag":"application-test","url":"local:xenial/test-0","channel":"","macaroon":null,"resources":[{"name":"dummy","type":"file","path":"dummy.snap","description":"dummy snap","origin":"store","revision":-1,"fingerprint":"","size":0}]}}
-11:51:21 TRACE juju.rpc.jsoncodec codec.go:120 <- {"request-id":5,"response":{"pending-ids":["c0ffdd92-da23-4fb2-8d41-d82d58423447"]}}
-11:51:21 TRACE juju.rpc.jsoncodec codec.go:225 -> {"request-id":6,"type":"Application","version":5,"request":"Deploy","params":{"applications":[{"application":"test","series":"xenial","charm-url":"local:xenial/test-0","channel":"","num-units":1,"config-yaml":"","constraints":{},"resources":{"dummy":"c0ffdd92-da23-4fb2-8d41-d82d58423447"}}]}}
-11:51:21 TRACE juju.rpc.jsoncodec codec.go:120 <- {"request-id":6,"response":{"results":[{}]}}
-11:51:21 TRACE juju.rpc.jsoncodec codec.go:123 <- error: read tcp 192.168.1.102:52168->35.172.119.191:17070: use of closed network connection (closing true)
-11:51:21 DEBUG juju.api monitor.go:35 RPC connection died
-11:51:21 INFO cmd supercommand.go:465 command finished
-```
-
-Note that this will contain login information (which has been removed from the above).
-
-
-Overrides
----------
-
-It should be quite rare, but occasionally the generated Python code does
-not capture all of the logic needed to properly parse the output from the API
-or may otherwise need some small amount of tweaking. This is what the
-`juju/client/overrides.py` file is for. An example of this is the `Number`
-type, which isn't standard JSON and must be parsed slightly differently.
-
-At the top of that file are two lists, `__all__` and `__patches__`. The
-former replaces entire class implementations, while the latter patches
-the attributes of the override classes into the matching generated class,
-leaving the rest of the generated class untouched.
-
-
-.. _SchemaGen: https://github.com/juju/schemagen
+++ /dev/null
-"""
-This example:
-
-1. Connects to current model and resets it.
-2. Deploys a git unit.
-3. Runs an action against the unit.
-4. Waits for the action results to come back, then exits.
-
-"""
-import logging
-
-from juju import loop
-from juju.model import Model
-
-
-async def run_action(unit):
- logging.debug('Running action on unit %s', unit.name)
-
- # unit.run() returns a juju.action.Action instance
- action = await unit.run_action('add-repo', repo='myrepo')
- # wait for the action to complete
- action = await action.wait()
-
- logging.debug("Action results: %s", action.results)
-
-
-async def main():
- model = Model()
- # connect to current model with current user, per Juju CLI
- await model.connect()
-
- app = await model.deploy(
- 'git',
- application_name='git',
- series='trusty',
- channel='stable',
- )
-
- for unit in app.units:
- await run_action(unit)
-
- await model.disconnect()
-
-
-if __name__ == '__main__':
- logging.basicConfig(level=logging.DEBUG)
- ws_logger = logging.getLogger('websockets.protocol')
- ws_logger.setLevel(logging.INFO)
- loop.run(main())
+++ /dev/null
-#!/usr/bin/env python3.5
-
-"""
-This example:
-
-1. Connects to the current model
-2. Creates two machines and a lxd container
-3. Deploys charm to the lxd container
-
-"""
-import logging
-
-from juju import loop
-from juju.model import Model
-
-MB = 1
-GB = 1024
-
-
-async def main():
- model = Model()
- await model.connect()
-
- try:
- # add a new default machine
- machine1 = await model.add_machine()
- # add a machine with constraints, disks, and series
- machine2 = await model.add_machine(
- constraints={
- 'mem': 256 * MB,
- },
- disks=[{
- 'pool': 'rootfs',
- 'size': 10 * GB,
- 'count': 1,
- }],
- series='xenial',
- )
- # add a lxd container to machine2
- machine3 = await model.add_machine(
- 'lxd:{}'.format(machine2.id))
-
- # deploy charm to the lxd container
- application = await model.deploy(
- 'ubuntu-10',
- application_name='ubuntu',
- series='xenial',
- channel='stable',
- to=machine3.id
- )
-
- await model.block_until(
- lambda: all(unit.workload_status == 'active'
- for unit in application.units))
-
- await application.remove()
-
- await machine3.destroy(force=True)
- await machine2.destroy(force=True)
- await machine1.destroy(force=True)
- finally:
- await model.disconnect()
-
-
-if __name__ == '__main__':
- logging.basicConfig(level=logging.DEBUG)
- ws_logger = logging.getLogger('websockets.protocol')
- ws_logger.setLevel(logging.INFO)
-
- loop.run(main())
+++ /dev/null
-"""
-This example:
-
-1. Creates a model on the current controller
-2. Deploys a charm to it.
-3. Attempts to ssh into the charm
-
-"""
-from juju import loop
-from juju import utils
-from juju.controller import Controller
-import asyncio
-from logging import getLogger
-import uuid
-
-LOG = getLogger(__name__)
-
-
-async def main():
- controller = Controller()
- print("Connecting to controller")
- # connect to current controller with current user, per Juju CLI
- await controller.connect()
-
- try:
- model_name = "addmodeltest-{}".format(uuid.uuid4())
- print("Adding model {}".format(model_name))
- model = await controller.add_model(model_name)
-
- print('Deploying ubuntu')
- application = await model.deploy(
- 'ubuntu-10',
- application_name='ubuntu',
- series='trusty',
- channel='stable',
- )
-
- print('Waiting for active')
- await asyncio.sleep(10)
- await model.block_until(
- lambda: all(unit.workload_status == 'active'
- for unit in application.units))
-
- print("Verifying that we can ssh into the created model")
- ret = await utils.execute_process(
- 'juju', 'ssh', '-m', model_name, 'ubuntu/0', 'ls /', log=LOG)
- assert ret
-
- print('Removing ubuntu')
- await application.remove()
-
- print("Destroying model")
- await controller.destroy_model(model.info.uuid)
-
- except Exception:
- LOG.exception(
- "Test failed! Model {} may not be cleaned up".format(model_name))
-
- finally:
- print('Disconnecting from controller')
- if model:
- await model.disconnect()
- await controller.disconnect()
-
-
-if __name__ == '__main__':
- loop.run(main())
+++ /dev/null
-"""
-This example:
-
-1. Connects to the current model
-2. Starts an AllWatcher
-3. Prints all changes received from the AllWatcher
-4. Runs forever (kill with Ctrl-C)
-
-"""
-import asyncio
-import logging
-
-from juju.client.connection import Connection
-from juju.client import client
-from juju import loop
-
-
-async def watch():
- conn = await Connection.connect()
- allwatcher = client.AllWatcherFacade.from_connection(conn)
- while True:
- change = await allwatcher.Next()
- for delta in change.deltas:
- print(delta.deltas)
-
-
-if __name__ == '__main__':
- logging.basicConfig(level=logging.DEBUG)
- # Run loop until the process is manually stopped (watch will loop
- # forever).
- loop.run(watch())
+++ /dev/null
-"""
-This example:
-
-1. Connects to the current model
-2. Resets it
-3. Deploys a charm and prints its config and constraints
-
-"""
-import logging
-
-from juju.model import Model
-from juju import loop
-
-log = logging.getLogger(__name__)
-
-MB = 1
-
-
-async def main():
- model = Model()
- # connect to current model with current user, per Juju CLI
- await model.connect()
-
- ubuntu_app = await model.deploy(
- 'mysql',
- application_name='mysql',
- series='trusty',
- channel='stable',
- config={
- 'tuning-level': 'safest',
- },
- constraints={
- 'mem': 256 * MB,
- },
- )
-
- # update and check app config
- await ubuntu_app.set_config({'tuning-level': 'fast'})
- config = await ubuntu_app.get_config()
- assert(config['tuning-level']['value'] == 'fast')
-
- # update and check app constraints
- await ubuntu_app.set_constraints({'mem': 512 * MB})
- constraints = await ubuntu_app.get_constraints()
- assert(constraints['mem'] == 512 * MB)
-
- await model.disconnect()
-
-
-if __name__ == '__main__':
- logging.basicConfig(level=logging.DEBUG)
- ws_logger = logging.getLogger('websockets.protocol')
- ws_logger.setLevel(logging.INFO)
- loop.run(main())
+++ /dev/null
-"""
-This is a very basic example that connects to the currently selected model
-and prints the number of applications deployed to it.
-"""
-import logging
-
-from juju import loop
-from juju.model import Model
-
-log = logging.getLogger(__name__)
-
-
-async def main():
- model = Model()
- try:
- # connect to the current model with the current user, per the Juju CLI
- await model.connect()
- print('There are {} applications'.format(len(model.applications)))
- finally:
- if model.is_connected():
- print('Disconnecting from model')
- await model.disconnect()
-
-
-if __name__ == '__main__':
- logging.basicConfig(level=logging.INFO)
- loop.run(main())
+++ /dev/null
-"""
-This example:
-
-1. Connects to current controller.
-2. Creates a new model.
-3. Deploys an application on the new model.
-4. Disconnects from the model
-5. Destroys the model
-
-"""
-import logging
-
-from juju.controller import Controller
-from juju import loop
-
-
-async def main():
- controller = Controller()
- # connect to current controller with current user, per Juju CLI
- await controller.connect()
- model = await controller.add_model(
- 'my-test-model',
- 'aws',
- 'aws-tim',
- )
- await model.deploy(
- 'ubuntu-0',
- application_name='ubuntu',
- series='trusty',
- channel='stable',
- )
- await model.disconnect()
- await controller.destroy_model(model.info.uuid)
- await controller.disconnect()
-
-
-if __name__ == '__main__':
- logging.basicConfig(level=logging.DEBUG)
- ws_logger = logging.getLogger('websockets.protocol')
- ws_logger.setLevel(logging.INFO)
- loop.run(main())
+++ /dev/null
-import sys
-from juju import loop
-from juju.controller import Controller
-
-
-async def main(cloud_name, credential_name):
- controller = Controller()
- model = None
- print('Connecting to controller')
- # connect to current controller with current user, per Juju CLI
- await controller.connect()
- try:
- print('Adding model')
- model = await controller.add_model(
- 'test',
- cloud_name=cloud_name,
- credential_name=credential_name)
-
- # verify credential
- print("Verify model's credential: {}".format(
- model.info.cloud_credential_tag))
-
- # verify we can deploy
- print('Deploying ubuntu')
- app = await model.deploy('ubuntu-10')
-
- print('Waiting for active')
- await model.block_until(
- lambda: app.units and all(unit.workload_status == 'active'
- for unit in app.units))
-
- print('Removing ubuntu')
- await app.remove()
- finally:
- print('Cleaning up')
- if model:
- print('Removing model')
- model_uuid = model.info.uuid
- await model.disconnect()
- await controller.destroy_model(model_uuid)
- print('Disconnecting')
- await controller.disconnect()
-
-
-if __name__ == '__main__':
- assert len(sys.argv) > 2, 'Please provide a cloud and credential name'
- loop.run(main(sys.argv[1], sys.argv[2]))
+++ /dev/null
-"""
-This example:
-
-1. Connects to the current model
-2. Deploy a charm and waits until it reports itself active
-3. Destroys the unit and application
-
-"""
-from juju import loop
-from juju.model import Model
-
-
-async def main():
- model = Model()
- print('Connecting to model')
- # connect to current model with current user, per Juju CLI
- await model.connect()
-
- try:
- print('Deploying ubuntu')
- application = await model.deploy(
- 'ubuntu-10',
- application_name='ubuntu',
- series='trusty',
- channel='stable',
- )
-
- print('Waiting for active')
- await model.block_until(
- lambda: all(unit.workload_status == 'active'
- for unit in application.units))
-
- print('Removing ubuntu')
- await application.remove()
- finally:
- print('Disconnecting from model')
- await model.disconnect()
-
-
-if __name__ == '__main__':
- loop.run(main())
+++ /dev/null
-import asyncio
-
-from juju.client.connection import Connection
-from juju.client.client import ClientFacade
-from juju import loop
-
-async def status():
- conn = await Connection.connect()
- client = ClientFacade.from_connection(conn)
-
- patterns = None
- status = await client.FullStatus(patterns)
- await conn.close()
-
- print('Applications:', list(status.applications.keys()))
- print('Machines:', list(status.machines.keys()))
- print('Relations:', status.relations)
-
- return status
-
-if __name__ == '__main__':
- loop.run(status())
-
+++ /dev/null
-"""
-This example doesn't work - it demonstrates features that don't exist yet.
-
-"""
-import logging
-
-from juju.model import Model
-from juju import loop
-
-
-async def main():
- model = Model()
- # connect to current model with current user, per Juju CLI
- await model.connect()
-
- goal_state = Model.from_yaml('bundle-like-thing')
- ubuntu_app = await model.deploy(
- 'ubuntu-0',
- application_name='ubuntu',
- series='trusty',
- channel='stable',
- )
- ubuntu_app.on_unit_added(callback=lambda unit: True)
-
- await model.deploy(
- 'nrpe-11',
- application_name='nrpe',
- series='trusty',
- channel='stable',
- num_units=0,
- )
- await model.add_relation(
- 'ubuntu',
- 'nrpe',
- )
-
- result, ok = await model.block_until(
- lambda: model.matches(goal_state),
- timeout=600
- )
-
-
-if __name__ == '__main__':
- logging.basicConfig(level=logging.DEBUG)
- ws_logger = logging.getLogger('websockets.protocol')
- ws_logger.setLevel(logging.INFO)
- loop.run(main())
+++ /dev/null
-"""
-This example:
-
-1. Connects to the current model.
-2. Prints out leadership status for all deployed units in the model.
-3. Cleanly disconnects.
-
-"""
-import asyncio
-
-from juju.model import Model
-from juju import loop
-
-async def report_leadership():
- model = Model()
- await model.connect()
-
- print("Leadership: ")
- for app in model.applications.values():
- for unit in app.units:
- print("{}: {}".format(
- unit.name, await unit.is_leader_from_status()))
-
- await model.disconnect()
-
-
-if __name__ == '__main__':
- loop.run(report_leadership())
+++ /dev/null
-"""
-This example:
-
-1. Connects to the current model
-2. Watches the model and prints all changes
-3. Runs forever (kill with Ctrl-C)
-
-"""
-from juju.model import Model
-from juju import loop
-
-
-async def on_model_change(delta, old, new, model):
- print(delta.entity, delta.type, delta.data)
- print(old)
- print(new)
- print(model)
-
-
-async def watch_model():
- model = Model()
- # connect to current model with current user, per Juju CLI
- await model.connect()
-
- model.add_observer(on_model_change)
-
-
-if __name__ == '__main__':
- # Run loop until the process is manually stopped (watch_model will loop
- # forever).
- loop.run(watch_model())
+++ /dev/null
-"""
-This example shows how to deploy a local charm. It:
-
-1. Connects to current model.
-2. Uploads a local charm (directory on filesystem) to the model.
-3. Deploys the uploaded charm.
-
-"""
-import asyncio
-import logging
-
-from juju.model import Model
-from juju import loop
-
-
-async def main():
- model = Model()
- await model.connect()
-
- # Deploy a local charm using a path to the charm directory
- await model.deploy(
- '/home/tvansteenburgh/src/charms/ubuntu',
- application_name='ubuntu',
- series='trusty',
- )
-
- await model.disconnect()
-
-
-if __name__ == '__main__':
- logging.basicConfig(level=logging.DEBUG)
- ws_logger = logging.getLogger('websockets.protocol')
- ws_logger.setLevel(logging.INFO)
- loop.run(main())
+++ /dev/null
-"""
-This example:
-
-1. Connects to the current model
-2. Resets it
-3. Deploys two charms and relates them
-4. Waits for units to be idle, then exits
-
-"""
-import asyncio
-import logging
-
-from juju.model import Model, ModelObserver
-from juju import loop
-
-
-class MyRemoveObserver(ModelObserver):
- async def on_change(self, delta, old, new, model):
- if delta.type == 'remove':
- assert(new.latest() == new)
- assert(new.next() is None)
- assert(new.dead)
- assert(new.current)
- assert(new.connected)
- assert(new.previous().dead)
- assert(not new.previous().current)
- assert(not new.previous().connected)
-
-
-class MyModelObserver(ModelObserver):
- _shutting_down = False
-
- async def on_change(self, delta, old, new, model):
- if model.units and model.all_units_idle() and not self._shutting_down:
- self._shutting_down = True
- logging.debug('All units idle, disconnecting')
- await model.reset(force=True)
- await model.disconnect()
-
-
-async def main():
- model = Model()
- # connect to current model with current user, per Juju CLI
- await model.connect()
-
- try:
- model.add_observer(MyRemoveObserver())
- await model.reset(force=True)
- model.add_observer(MyModelObserver())
-
- ubuntu_app = await model.deploy(
- 'ubuntu',
- application_name='ubuntu',
- series='trusty',
- channel='stable',
- )
- ubuntu_app.on_change(asyncio.coroutine(
- lambda delta, old_app, new_app, model:
- print('App changed: {}'.format(new_app.entity_id))
- ))
- ubuntu_app.on_remove(asyncio.coroutine(
- lambda delta, old_app, new_app, model:
- print('App removed: {}'.format(old_app.entity_id))
- ))
- ubuntu_app.on_unit_add(asyncio.coroutine(
- lambda delta, old_unit, new_unit, model:
- print('Unit added: {}'.format(new_unit.entity_id))
- ))
- ubuntu_app.on_unit_remove(asyncio.coroutine(
- lambda delta, old_unit, new_unit, model:
- print('Unit removed: {}'.format(old_unit.entity_id))
- ))
- unit_a, unit_b = await ubuntu_app.add_units(count=2)
- unit_a.on_change(asyncio.coroutine(
- lambda delta, old_unit, new_unit, model:
- print('Unit changed: {}'.format(new_unit.entity_id))
- ))
- await model.deploy(
- 'nrpe',
- application_name='nrpe',
- series='trusty',
- channel='stable',
- # subordinates must be deployed without units
- num_units=0,
- )
- my_relation = await model.add_relation(
- 'ubuntu',
- 'nrpe',
- )
- my_relation.on_remove(asyncio.coroutine(
- lambda delta, old_rel, new_rel, model:
- print('Relation removed: {}'.format(old_rel.endpoints))
- ))
- finally:
- await model.disconnect()
-
-
-if __name__ == '__main__':
- logging.basicConfig(level=logging.INFO)
- ws_logger = logging.getLogger('websockets.protocol')
- ws_logger.setLevel(logging.INFO)
- loop.run(main())
+++ /dev/null
-"""
-This example:
-
-1. Connects to current model and resets it.
-2. Deploys one ubuntu unit.
-3. Runs an action against the unit.
-4. Waits for the action results to come back, then exits.
-
-"""
-import logging
-
-from juju.model import Model
-from juju import loop
-
-
-async def run_command(unit):
- logging.debug('Running command on unit %s', unit.name)
-
- # unit.run() returns a juju.action.Action instance
- action = await unit.run('unit-get public-address')
- logging.debug("Action results: %s", action.results)
-
-
-async def main():
- model = Model()
- # connect to current model with current user, per Juju CLI
- await model.connect()
-
- app = await model.deploy(
- 'ubuntu-0',
- application_name='ubuntu',
- series='trusty',
- channel='stable',
- )
-
- for unit in app.units:
- await run_command(unit)
-
- await model.disconnect()
-
-
-if __name__ == '__main__':
- logging.basicConfig(level=logging.DEBUG)
- ws_logger = logging.getLogger('websockets.protocol')
- ws_logger.setLevel(logging.INFO)
- loop.run(main())
+++ /dev/null
-from . import model
-
-
-class Action(model.ModelEntity):
- @property
- def status(self):
- return self.data['status']
-
- async def wait(self):
- return await self.model.wait_for_action(self.id)
+++ /dev/null
-import logging
-
-from . import model
-
-log = logging.getLogger(__name__)
-
-
-class Annotation(model.ModelEntity):
- pass
+++ /dev/null
-# Copyright 2016 Canonical Ltd.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-import asyncio
-import logging
-
-from . import model
-from .client import client
-from .errors import JujuError
-from .placement import parse as parse_placement
-
-log = logging.getLogger(__name__)
-
-
-class Application(model.ModelEntity):
- @property
- def _unit_match_pattern(self):
- return r'^{}.*$'.format(self.entity_id)
-
- def on_unit_add(self, callable_):
- """Add a "unit added" observer to this entity, which will be called
- whenever a unit is added to this application.
-
- """
- self.model.add_observer(
- callable_, 'unit', 'add', self._unit_match_pattern)
-
- def on_unit_remove(self, callable_):
- """Add a "unit removed" observer to this entity, which will be called
- whenever a unit is removed from this application.
-
- """
- self.model.add_observer(
- callable_, 'unit', 'remove', self._unit_match_pattern)
-
- @property
- def units(self):
- return [
- unit for unit in self.model.units.values()
- if unit.application == self.name
- ]
-
- @property
- def relations(self):
- return [rel for rel in self.model.relations if rel.matches(self.name)]
-
- def related_applications(self, endpoint_name=None):
- apps = {}
- for rel in self.relations:
- if rel.is_peer:
- local_ep, remote_ep = rel.endpoints[0]
- else:
- def is_us(ep):
- return ep.application.name == self.name
- local_ep, remote_ep = sorted(rel.endpoints, key=is_us)
- if endpoint_name is not None and endpoint_name != local_ep.name:
- continue
- apps[remote_ep.application.name] = remote_ep.application
- return apps
-
- @property
- def status(self):
- """Get the application status, as set by the charm's leader.
-
- """
- return self.safe_data['status']['current']
-
- @property
- def status_message(self):
- """Get the application status message, as set by the charm's leader.
-
- """
- return self.safe_data['status']['message']
-
- @property
- def tag(self):
- return 'application-%s' % self.name
-
- async def add_relation(self, local_relation, remote_relation):
- """Add a relation to another application.
-
- :param str local_relation: Name of relation on this application
- :param str remote_relation: Name of relation on the other
- application in the form '<application>[:<relation_name>]'
-
- """
- if ':' not in local_relation:
- local_relation = '{}:{}'.format(self.name, local_relation)
-
- return await self.model.add_relation(local_relation, remote_relation)
-
- async def add_unit(self, count=1, to=None):
- """Add one or more units to this application.
-
- :param int count: Number of units to add
- :param str to: Placement directive, e.g.::
- '23' - machine 23
- 'lxc:7' - new lxc container on machine 7
- '24/lxc/3' - lxc container 3 or machine 24
-
- If None, a new machine is provisioned.
-
- """
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- log.debug(
- 'Adding %s unit%s to %s',
- count, '' if count == 1 else 's', self.name)
-
- result = await app_facade.AddUnits(
- application=self.name,
- placement=parse_placement(to) if to else None,
- num_units=count,
- )
-
- return await asyncio.gather(*[
- asyncio.ensure_future(self.model._wait_for_new('unit', unit_id))
- for unit_id in result.units
- ])
-
- add_units = add_unit
-
- async def scale(self, scale=None, scale_change=None):
- """
- Set or adjust the scale of this (K8s) application.
-
- One or the other of scale or scale_change must be provided.
-
- :param int scale: Scale to which to set this application.
- :param int scale_change: Amount by which to adjust the scale of this
- application (can be positive or negative).
- """
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- if (scale, scale_change) == (None, None):
- raise ValueError('Must provide either scale or scale_change')
-
- log.debug(
- 'Scaling application %s %s %s',
- self.name, 'to' if scale else 'by', scale or scale_change)
-
- await app_facade.ScaleApplications([
- client.ScaleApplicationParam(application_tag=self.tag,
- scale=scale,
- scale_change=scale_change)
- ])
-
- def allocate(self, budget, value):
- """Allocate budget to this application.
-
- :param str budget: Name of budget
- :param int value: Budget limit
-
- """
- raise NotImplementedError()
-
- def attach(self, resource_name, file_path):
- """Upload a file as a resource for this application.
-
- :param str resource: Name of the resource
- :param str file_path: Path to the file to upload
-
- """
- raise NotImplementedError()
-
- def collect_metrics(self):
- """Collect metrics on this application.
-
- """
- raise NotImplementedError()
-
- async def destroy_relation(self, local_relation, remote_relation):
- """Remove a relation to another application.
-
- :param str local_relation: Name of relation on this application
- :param str remote_relation: Name of relation on the other
- application in the form '<application>[:<relation_name>]'
-
- """
- if ':' not in local_relation:
- local_relation = '{}:{}'.format(self.name, local_relation)
-
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- log.debug(
- 'Destroying relation %s <-> %s', local_relation, remote_relation)
-
- return await app_facade.DestroyRelation([
- local_relation, remote_relation])
- remove_relation = destroy_relation
-
- async def destroy_unit(self, *unit_names):
- """Destroy units by name.
-
- """
- return await self.model.destroy_units(*unit_names)
- destroy_units = destroy_unit
-
- async def destroy(self):
- """Remove this application from the model.
-
- """
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- log.debug(
- 'Destroying %s', self.name)
-
- return await app_facade.Destroy(self.name)
- remove = destroy
-
- async def expose(self):
- """Make this application publicly available over the network.
-
- """
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- log.debug(
- 'Exposing %s', self.name)
-
- return await app_facade.Expose(self.name)
-
- async def get_config(self):
- """Return the configuration settings dict for this application.
-
- """
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- log.debug(
- 'Getting config for %s', self.name)
-
- return (await app_facade.Get(self.name)).config
-
- async def get_constraints(self):
- """Return the machine constraints dict for this application.
-
- """
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- log.debug(
- 'Getting constraints for %s', self.name)
-
- result = (await app_facade.Get(self.name)).constraints
- return vars(result) if result else result
-
- async def get_actions(self, schema=False):
- """Get actions defined for this application.
-
- :param bool schema: Return the full action schema
- :return dict: The charms actions, empty dict if none are defined.
- """
- actions = {}
- entity = [{"tag": self.tag}]
- action_facade = client.ActionFacade.from_connection(self.connection)
- results = (
- await action_facade.ApplicationsCharmsActions(entity)).results
- for result in results:
- if result.application_tag == self.tag and result.actions:
- actions = result.actions
- break
- if not schema:
- actions = {k: v['description'] for k, v in actions.items()}
- return actions
-
- async def get_resources(self):
- """Return resources for this application.
-
- Returns a dict mapping resource name to
- :class:`~juju._definitions.CharmResource` instances.
- """
- facade = client.ResourcesFacade.from_connection(self.connection)
- response = await facade.ListResources([client.Entity(self.tag)])
-
- resources = dict()
- for result in response.results:
- for resource in result.charm_store_resources or []:
- resources[resource.name] = resource
- for resource in result.resources or []:
- if resource.charmresource:
- resource = resource.charmresource
- resources[resource.name] = resource
- return resources
-
- async def run(self, command, timeout=None):
- """Run command on all units for this application.
-
- :param str command: The command to run
- :param int timeout: Time to wait before command is considered failed
-
- """
- action = client.ActionFacade.from_connection(self.connection)
-
- log.debug(
- 'Running `%s` on all units of %s', command, self.name)
-
- # TODO this should return a list of Actions
- return await action.Run(
- [self.name],
- command,
- [],
- timeout,
- [],
- )
-
- async def set_annotations(self, annotations):
- """Set annotations on this application.
-
- :param annotations map[string]string: the annotations as key/value
- pairs.
-
- """
- log.debug('Updating annotations on application %s', self.name)
-
- self.ann_facade = client.AnnotationsFacade.from_connection(
- self.connection)
-
- ann = client.EntityAnnotations(
- entity=self.tag,
- annotations=annotations,
- )
- return await self.ann_facade.Set([ann])
-
- async def set_config(self, config):
- """Set configuration options for this application.
-
- :param config: Dict of configuration to set
- """
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- log.debug(
- 'Setting config for %s: %s', self.name, config)
-
- return await app_facade.Set(self.name, config)
-
- async def reset_config(self, to_default):
- """
- Restore application config to default values.
-
- :param list to_default: A list of config options to be reset to their
- default value.
- """
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- log.debug(
- 'Restoring default config for %s: %s', self.name, to_default)
-
- return await app_facade.Unset(self.name, to_default)
-
- async def set_constraints(self, constraints):
- """Set machine constraints for this application.
-
- :param dict constraints: Dict of machine constraints
-
- """
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- log.debug(
- 'Setting constraints for %s: %s', self.name, constraints)
-
- return await app_facade.SetConstraints(self.name, constraints)
-
- def set_meter_status(self, status, info=None):
- """Set the meter status on this status.
-
- :param str status: Meter status, e.g. 'RED', 'AMBER'
- :param str info: Extra info message
-
- """
- raise NotImplementedError()
-
- def set_plan(self, plan_name):
- """Set the plan for this application, effective immediately.
-
- :param str plan_name: Name of plan
-
- """
- raise NotImplementedError()
-
- async def unexpose(self):
- """Remove public availability over the network for this application.
-
- """
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- log.debug(
- 'Unexposing %s', self.name)
-
- return await app_facade.Unexpose(self.name)
-
- def update_allocation(self, allocation):
- """Update existing allocation for this application.
-
- :param int allocation: The allocation to set
-
- """
- raise NotImplementedError()
-
- async def upgrade_charm(
- self, channel=None, force_series=False, force_units=False,
- path=None, resources=None, revision=None, switch=None):
- """Upgrade the charm for this application.
-
- :param str channel: Channel to use when getting the charm from the
- charm store, e.g. 'development'
- :param bool force_series: Upgrade even if series of deployed
- application is not supported by the new charm
- :param bool force_units: Upgrade all units immediately, even if in
- error state
- :param str path: Uprade to a charm located at path
- :param dict resources: Dictionary of resource name/filepath pairs
- :param int revision: Explicit upgrade revision
- :param str switch: Crossgrade charm url
-
- """
- # TODO: Support local upgrades
- if path is not None:
- raise NotImplementedError("path option is not implemented")
- if resources is not None:
- raise NotImplementedError("resources option is not implemented")
-
- if switch is not None and revision is not None:
- raise ValueError("switch and revision are mutually exclusive")
-
- client_facade = client.ClientFacade.from_connection(self.connection)
- resources_facade = client.ResourcesFacade.from_connection(
- self.connection)
- app_facade = client.ApplicationFacade.from_connection(self.connection)
-
- charmstore = self.model.charmstore
- charmstore_entity = None
-
- if switch is not None:
- charm_url = switch
- if not charm_url.startswith('cs:'):
- charm_url = 'cs:' + charm_url
- else:
- charm_url = self.data['charm-url']
- charm_url = charm_url.rpartition('-')[0]
- if revision is not None:
- charm_url = "%s-%d" % (charm_url, revision)
- else:
- charmstore_entity = await charmstore.entity(charm_url,
- channel=channel)
- charm_url = charmstore_entity['Id']
-
- if charm_url == self.data['charm-url']:
- raise JujuError('already running charm "%s"' % charm_url)
-
- # Update charm
- await client_facade.AddCharm(
- url=charm_url,
- channel=channel
- )
-
- # Update resources
- if not charmstore_entity:
- charmstore_entity = await charmstore.entity(charm_url,
- channel=channel)
- store_resources = charmstore_entity['Meta']['resources']
-
- request_data = [client.Entity(self.tag)]
- response = await resources_facade.ListResources(request_data)
- existing_resources = {
- resource.name: resource
- for resource in response.results[0].resources
- }
-
- resources_to_update = [
- resource for resource in store_resources
- if resource['Name'] not in existing_resources or
- existing_resources[resource['Name']].origin != 'upload'
- ]
-
- if resources_to_update:
- request_data = [
- client.CharmResource(
- description=resource.get('Description'),
- fingerprint=resource['Fingerprint'],
- name=resource['Name'],
- path=resource['Path'],
- revision=resource['Revision'],
- size=resource['Size'],
- type_=resource['Type'],
- origin='store',
- ) for resource in resources_to_update
- ]
- response = await resources_facade.AddPendingResources(
- self.tag,
- charm_url,
- request_data
- )
- pending_ids = response.pending_ids
- resource_ids = {
- resource['Name']: id
- for resource, id in zip(resources_to_update, pending_ids)
- }
- else:
- resource_ids = None
-
- # Update application
- await app_facade.SetCharm(
- application=self.entity_id,
- channel=channel,
- charm_url=charm_url,
- config_settings=None,
- config_settings_yaml=None,
- force_series=force_series,
- force_units=force_units,
- resource_ids=resource_ids,
- storage_constraints=None
- )
-
- await self.model.block_until(
- lambda: self.data['charm-url'] == charm_url
- )
-
- async def get_metrics(self):
- """Get metrics for this application's units.
-
- :return: Dictionary of unit_name:metrics
-
- """
- return await self.model.get_metrics(self.tag)
+++ /dev/null
-# DO NOT CHANGE THIS FILE! This file is auto-generated by facade.py.
-# Changes will be overwritten/lost when the file is regenerated.
-
-from juju.client._definitions import *
-
-from juju.client import _client2, _client1, _client3, _client4, _client5, _client8, _client7, _client9
-
-
-CLIENTS = {
- "2": _client2,
- "1": _client1,
- "3": _client3,
- "4": _client4,
- "5": _client5,
- "8": _client8,
- "7": _client7,
- "9": _client9
-}
-
-
-def lookup_facade(name, version):
- """
- Given a facade name and version, attempt to pull that facade out
- of the correct client<version>.py file.
-
- """
- for _version in range(int(version), 0, -1):
- try:
- facade = getattr(CLIENTS[str(_version)], name)
- return facade
- except (KeyError, AttributeError):
- continue
- else:
- raise ImportError("No supported version for facade: "
- "{}".format(name))
-
-
-class TypeFactory:
- @classmethod
- def from_connection(cls, connection):
- """
- Given a connected Connection object, return an initialized and
- connected instance of an API Interface matching the name of
- this class.
-
- @param connection: initialized Connection object.
-
- """
- facade_name = cls.__name__
- if not facade_name.endswith('Facade'):
- raise TypeError('Unexpected class name: {}'.format(facade_name))
- facade_name = facade_name[:-len('Facade')]
- version = connection.facades.get(facade_name)
- if version is None:
- raise Exception('No facade {} in facades {}'.format(facade_name,
- connection.facades))
-
- c = lookup_facade(cls.__name__, version)
- c = c()
- c.connect(connection)
-
- return c
-
-
-class ActionFacade(TypeFactory):
- pass
-
-
-class ActionPrunerFacade(TypeFactory):
- pass
-
-
-class AgentFacade(TypeFactory):
- pass
-
-
-class AgentToolsFacade(TypeFactory):
- pass
-
-
-class AllModelWatcherFacade(TypeFactory):
- pass
-
-
-class AllWatcherFacade(TypeFactory):
- pass
-
-
-class AnnotationsFacade(TypeFactory):
- pass
-
-
-class ApplicationFacade(TypeFactory):
- pass
-
-
-class ApplicationOffersFacade(TypeFactory):
- pass
-
-
-class ApplicationRelationsWatcherFacade(TypeFactory):
- pass
-
-
-class ApplicationScalerFacade(TypeFactory):
- pass
-
-
-class BackupsFacade(TypeFactory):
- pass
-
-
-class BlockFacade(TypeFactory):
- pass
-
-
-class BundleFacade(TypeFactory):
- pass
-
-
-class CAASAgentFacade(TypeFactory):
- pass
-
-
-class CAASFirewallerFacade(TypeFactory):
- pass
-
-
-class CAASOperatorFacade(TypeFactory):
- pass
-
-
-class CAASOperatorProvisionerFacade(TypeFactory):
- pass
-
-
-class CAASUnitProvisionerFacade(TypeFactory):
- pass
-
-
-class CharmRevisionUpdaterFacade(TypeFactory):
- pass
-
-
-class CharmsFacade(TypeFactory):
- pass
-
-
-class CleanerFacade(TypeFactory):
- pass
-
-
-class ClientFacade(TypeFactory):
- pass
-
-
-class CloudFacade(TypeFactory):
- pass
-
-
-class ControllerFacade(TypeFactory):
- pass
-
-
-class CredentialManagerFacade(TypeFactory):
- pass
-
-
-class CredentialValidatorFacade(TypeFactory):
- pass
-
-
-class CrossControllerFacade(TypeFactory):
- pass
-
-
-class CrossModelRelationsFacade(TypeFactory):
- pass
-
-
-class DeployerFacade(TypeFactory):
- pass
-
-
-class DiscoverSpacesFacade(TypeFactory):
- pass
-
-
-class DiskManagerFacade(TypeFactory):
- pass
-
-
-class EntityWatcherFacade(TypeFactory):
- pass
-
-
-class ExternalControllerUpdaterFacade(TypeFactory):
- pass
-
-
-class FanConfigurerFacade(TypeFactory):
- pass
-
-
-class FilesystemAttachmentsWatcherFacade(TypeFactory):
- pass
-
-
-class FirewallRulesFacade(TypeFactory):
- pass
-
-
-class FirewallerFacade(TypeFactory):
- pass
-
-
-class HighAvailabilityFacade(TypeFactory):
- pass
-
-
-class HostKeyReporterFacade(TypeFactory):
- pass
-
-
-class ImageManagerFacade(TypeFactory):
- pass
-
-
-class ImageMetadataFacade(TypeFactory):
- pass
-
-
-class InstancePollerFacade(TypeFactory):
- pass
-
-
-class KeyManagerFacade(TypeFactory):
- pass
-
-
-class KeyUpdaterFacade(TypeFactory):
- pass
-
-
-class LeadershipServiceFacade(TypeFactory):
- pass
-
-
-class LifeFlagFacade(TypeFactory):
- pass
-
-
-class LogForwardingFacade(TypeFactory):
- pass
-
-
-class LoggerFacade(TypeFactory):
- pass
-
-
-class MachineActionsFacade(TypeFactory):
- pass
-
-
-class MachineManagerFacade(TypeFactory):
- pass
-
-
-class MachineUndertakerFacade(TypeFactory):
- pass
-
-
-class MachinerFacade(TypeFactory):
- pass
-
-
-class MeterStatusFacade(TypeFactory):
- pass
-
-
-class MetricsAdderFacade(TypeFactory):
- pass
-
-
-class MetricsDebugFacade(TypeFactory):
- pass
-
-
-class MetricsManagerFacade(TypeFactory):
- pass
-
-
-class MigrationFlagFacade(TypeFactory):
- pass
-
-
-class MigrationMasterFacade(TypeFactory):
- pass
-
-
-class MigrationMinionFacade(TypeFactory):
- pass
-
-
-class MigrationStatusWatcherFacade(TypeFactory):
- pass
-
-
-class MigrationTargetFacade(TypeFactory):
- pass
-
-
-class ModelConfigFacade(TypeFactory):
- pass
-
-
-class ModelManagerFacade(TypeFactory):
- pass
-
-
-class ModelUpgraderFacade(TypeFactory):
- pass
-
-
-class NotifyWatcherFacade(TypeFactory):
- pass
-
-
-class OfferStatusWatcherFacade(TypeFactory):
- pass
-
-
-class PayloadsFacade(TypeFactory):
- pass
-
-
-class PayloadsHookContextFacade(TypeFactory):
- pass
-
-
-class PingerFacade(TypeFactory):
- pass
-
-
-class ProvisionerFacade(TypeFactory):
- pass
-
-
-class ProxyUpdaterFacade(TypeFactory):
- pass
-
-
-class RebootFacade(TypeFactory):
- pass
-
-
-class RelationStatusWatcherFacade(TypeFactory):
- pass
-
-
-class RelationUnitsWatcherFacade(TypeFactory):
- pass
-
-
-class RemoteApplicationWatcherFacade(TypeFactory):
- pass
-
-
-class RemoteRelationsFacade(TypeFactory):
- pass
-
-
-class RemoteRelationsWatcherFacade(TypeFactory):
- pass
-
-
-class ResourcesFacade(TypeFactory):
- pass
-
-
-class ResourcesHookContextFacade(TypeFactory):
- pass
-
-
-class ResumerFacade(TypeFactory):
- pass
-
-
-class RetryStrategyFacade(TypeFactory):
- pass
-
-
-class SSHClientFacade(TypeFactory):
- pass
-
-
-class SingularFacade(TypeFactory):
- pass
-
-
-class SpacesFacade(TypeFactory):
- pass
-
-
-class StatusHistoryFacade(TypeFactory):
- pass
-
-
-class StorageFacade(TypeFactory):
- pass
-
-
-class StorageProvisionerFacade(TypeFactory):
- pass
-
-
-class StringsWatcherFacade(TypeFactory):
- pass
-
-
-class SubnetsFacade(TypeFactory):
- pass
-
-
-class UndertakerFacade(TypeFactory):
- pass
-
-
-class UnitAssignerFacade(TypeFactory):
- pass
-
-
-class UniterFacade(TypeFactory):
- pass
-
-
-class UpgradeSeriesFacade(TypeFactory):
- pass
-
-
-class UpgraderFacade(TypeFactory):
- pass
-
-
-class UserManagerFacade(TypeFactory):
- pass
-
-
-class VolumeAttachmentPlansWatcherFacade(TypeFactory):
- pass
-
-
-class VolumeAttachmentsWatcherFacade(TypeFactory):
- pass
+++ /dev/null
-# DO NOT CHANGE THIS FILE! This file is auto-generated by facade.py.
-# Changes will be overwritten/lost when the file is regenerated.
-
-from juju.client._definitions import *
-from juju.client.facade import ReturnMapping, Type
-
-
-class ActionPrunerFacade(Type):
- name = 'ActionPruner'
- version = 1
- schema = {'definitions': {'ActionPruneArgs': {'additionalProperties': False,
- 'properties': {'max-history-mb': {'type': 'integer'},
- 'max-history-time': {'type': 'integer'}},
- 'required': ['max-history-time',
- 'max-history-mb'],
- 'type': 'object'},
- 'Error': {'additionalProperties': False,
- 'properties': {'code': {'type': 'string'},
- 'info': {'$ref': '#/definitions/ErrorInfo'},
- 'message': {'type': 'string'}},
- 'required': ['message', 'code'],
- 'type': 'object'},
- 'ErrorInfo': {'additionalProperties': False,
- 'properties': {'macaroon': {'$ref': '#/definitions/Macaroon'},
- 'macaroon-path': {'type': 'string'}},
- 'type': 'object'},
- 'Macaroon': {'additionalProperties': False, 'type': 'object'},
- 'ModelConfigResult': {'additionalProperties': False,
- 'properties': {'config': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'}},
- 'required': ['config'],
- 'type': 'object'},
- 'NotifyWatchResult': {'additionalProperties': False,
- 'properties': {'NotifyWatcherId': {'type': 'string'},
- 'error': {'$ref': '#/definitions/Error'}},
- 'required': ['NotifyWatcherId'],
- 'type': 'object'}},
- 'properties': {'ModelConfig': {'properties': {'Result': {'$ref': '#/definitions/ModelConfigResult'}},
- 'type': 'object'},
- 'Prune': {'properties': {'Params': {'$ref': '#/definitions/ActionPruneArgs'}},
- 'type': 'object'},
- 'WatchForModelConfigChanges': {'properties': {'Result': {'$ref': '#/definitions/NotifyWatchResult'}},
- 'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(ModelConfigResult)
- async def ModelConfig(self):
- '''
-
- Returns -> typing.Mapping[str, typing.Any]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='ActionPruner',
- request='ModelConfig',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(None)
- async def Prune(self, max_history_mb, max_history_time):
- '''
- max_history_mb : int
- max_history_time : int
- Returns -> None
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='ActionPruner',
- request='Prune',
- version=1,
- params=_params)
- _params['max-history-mb'] = max_history_mb
- _params['max-history-time'] = max_history_time
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(NotifyWatchResult)
- async def WatchForModelConfigChanges(self):
- '''
-
- Returns -> typing.Union[str, _ForwardRef('Error')]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='ActionPruner',
- request='WatchForModelConfigChanges',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
-class AgentToolsFacade(Type):
- name = 'AgentTools'
- version = 1
- schema = {'properties': {'UpdateToolsAvailable': {'type': 'object'}}, 'type': 'object'}
-
-
- @ReturnMapping(None)
- async def UpdateToolsAvailable(self):
- '''
-
- Returns -> None
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='AgentTools',
- request='UpdateToolsAvailable',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
-class AllWatcherFacade(Type):
- name = 'AllWatcher'
- version = 1
- schema = {'definitions': {'AllWatcherNextResults': {'additionalProperties': False,
- 'properties': {'deltas': {'items': {'$ref': '#/definitions/Delta'},
- 'type': 'array'}},
- 'required': ['deltas'],
- 'type': 'object'},
- 'Delta': {'additionalProperties': False,
- 'properties': {'entity': {'additionalProperties': True,
- 'type': 'object'},
- 'removed': {'type': 'boolean'}},
- 'required': ['removed', 'entity'],
- 'type': 'object'}},
- 'properties': {'Next': {'properties': {'Result': {'$ref': '#/definitions/AllWatcherNextResults'}},
- 'type': 'object'},
- 'Stop': {'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(AllWatcherNextResults)
- async def Next(self):
- '''
-
- Returns -> typing.Sequence[~Delta]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='AllWatcher',
- request='Next',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(None)
- async def Stop(self):
- '''
-
- Returns -> None
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='AllWatcher',
- request='Stop',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
-class ApplicationRelationsWatcherFacade(Type):
- name = 'ApplicationRelationsWatcher'
- version = 1
- schema = {'definitions': {'ApplicationRelationsChange': {'additionalProperties': False,
- 'properties': {'changed': {'items': {'$ref': '#/definitions/RelationChange'},
- 'type': 'array'},
- 'removed': {'items': {'type': 'integer'},
- 'type': 'array'}},
- 'type': 'object'},
- 'ApplicationRelationsWatchResult': {'additionalProperties': False,
- 'properties': {'ApplicationRelationsWatcherId': {'type': 'string'},
- 'changes': {'$ref': '#/definitions/ApplicationRelationsChange'},
- 'error': {'$ref': '#/definitions/Error'}},
- 'required': ['ApplicationRelationsWatcherId'],
- 'type': 'object'},
- 'Error': {'additionalProperties': False,
- 'properties': {'code': {'type': 'string'},
- 'info': {'$ref': '#/definitions/ErrorInfo'},
- 'message': {'type': 'string'}},
- 'required': ['message', 'code'],
- 'type': 'object'},
- 'ErrorInfo': {'additionalProperties': False,
- 'properties': {'macaroon': {'$ref': '#/definitions/Macaroon'},
- 'macaroon-path': {'type': 'string'}},
- 'type': 'object'},
- 'Macaroon': {'additionalProperties': False, 'type': 'object'},
- 'RelationChange': {'additionalProperties': False,
- 'properties': {'changedunits': {'patternProperties': {'.*': {'$ref': '#/definitions/RelationUnitChange'}},
- 'type': 'object'},
- 'departedunits': {'items': {'type': 'string'},
- 'type': 'array'},
- 'id': {'type': 'integer'},
- 'life': {'type': 'string'}},
- 'required': ['id', 'life'],
- 'type': 'object'},
- 'RelationUnitChange': {'additionalProperties': False,
- 'properties': {'settings': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'}},
- 'type': 'object'}},
- 'properties': {'Next': {'properties': {'Result': {'$ref': '#/definitions/ApplicationRelationsWatchResult'}},
- 'type': 'object'},
- 'Stop': {'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(ApplicationRelationsWatchResult)
- async def Next(self):
- '''
-
- Returns -> typing.Union[str, _ForwardRef('ApplicationRelationsChange'), _ForwardRef('Error')]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='ApplicationRelationsWatcher',
- request='Next',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(None)
- async def Stop(self):
- '''
-
- Returns -> None
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='ApplicationRelationsWatcher',
- request='Stop',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
-class ApplicationScalerFacade(Type):
- name = 'ApplicationScaler'
- version = 1
- schema = {'definitions': {'Entities': {'additionalProperties': False,
- 'properties': {'entities': {'items': {'$ref': '#/definitions/Entity'},
- 'type': 'array'}},
- 'required': ['entities'],
- 'type': 'object'},
- 'Entity': {'additionalProperties': False,
- 'properties': {'tag': {'type': 'string'}},
- 'required': ['tag'],
- 'type': 'object'},
- 'Error': {'additionalProperties': False,
- 'properties': {'code': {'type': 'string'},
- 'info': {'$ref': '#/definitions/ErrorInfo'},
- 'message': {'type': 'string'}},
- 'required': ['message', 'code'],
- 'type': 'object'},
- 'ErrorInfo': {'additionalProperties': False,
- 'properties': {'macaroon': {'$ref': '#/definitions/Macaroon'},
- 'macaroon-path': {'type': 'string'}},
- 'type': 'object'},
- 'ErrorResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'}},
- 'type': 'object'},
- 'ErrorResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/ErrorResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'Macaroon': {'additionalProperties': False, 'type': 'object'},
- 'StringsWatchResult': {'additionalProperties': False,
- 'properties': {'changes': {'items': {'type': 'string'},
- 'type': 'array'},
- 'error': {'$ref': '#/definitions/Error'},
- 'watcher-id': {'type': 'string'}},
- 'required': ['watcher-id'],
- 'type': 'object'}},
- 'properties': {'Rescale': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/ErrorResults'}},
- 'type': 'object'},
- 'Watch': {'properties': {'Result': {'$ref': '#/definitions/StringsWatchResult'}},
- 'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(ErrorResults)
- async def Rescale(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~ErrorResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='ApplicationScaler',
- request='Rescale',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(StringsWatchResult)
- async def Watch(self):
- '''
-
- Returns -> typing.Union[typing.Sequence[str], _ForwardRef('Error'), str]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='ApplicationScaler',
- request='Watch',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
-class BackupsFacade(Type):
- name = 'Backups'
- version = 1
- schema = {'definitions': {'BackupsCreateArgs': {'additionalProperties': False,
- 'properties': {'notes': {'type': 'string'}},
- 'required': ['notes'],
- 'type': 'object'},
- 'BackupsInfoArgs': {'additionalProperties': False,
- 'properties': {'id': {'type': 'string'}},
- 'required': ['id'],
- 'type': 'object'},
- 'BackupsListArgs': {'additionalProperties': False,
- 'type': 'object'},
- 'BackupsListResult': {'additionalProperties': False,
- 'properties': {'list': {'items': {'$ref': '#/definitions/BackupsMetadataResult'},
- 'type': 'array'}},
- 'required': ['list'],
- 'type': 'object'},
- 'BackupsMetadataResult': {'additionalProperties': False,
- 'properties': {'ca-cert': {'type': 'string'},
- 'ca-private-key': {'type': 'string'},
- 'checksum': {'type': 'string'},
- 'checksum-format': {'type': 'string'},
- 'finished': {'format': 'date-time',
- 'type': 'string'},
- 'hostname': {'type': 'string'},
- 'id': {'type': 'string'},
- 'machine': {'type': 'string'},
- 'model': {'type': 'string'},
- 'notes': {'type': 'string'},
- 'series': {'type': 'string'},
- 'size': {'type': 'integer'},
- 'started': {'format': 'date-time',
- 'type': 'string'},
- 'stored': {'format': 'date-time',
- 'type': 'string'},
- 'version': {'$ref': '#/definitions/Number'}},
- 'required': ['id',
- 'checksum',
- 'checksum-format',
- 'size',
- 'stored',
- 'started',
- 'finished',
- 'notes',
- 'model',
- 'machine',
- 'hostname',
- 'version',
- 'series',
- 'ca-cert',
- 'ca-private-key'],
- 'type': 'object'},
- 'BackupsRemoveArgs': {'additionalProperties': False,
- 'properties': {'id': {'type': 'string'}},
- 'required': ['id'],
- 'type': 'object'},
- 'Number': {'additionalProperties': False,
- 'properties': {'Build': {'type': 'integer'},
- 'Major': {'type': 'integer'},
- 'Minor': {'type': 'integer'},
- 'Patch': {'type': 'integer'},
- 'Tag': {'type': 'string'}},
- 'required': ['Major',
- 'Minor',
- 'Tag',
- 'Patch',
- 'Build'],
- 'type': 'object'},
- 'RestoreArgs': {'additionalProperties': False,
- 'properties': {'backup-id': {'type': 'string'}},
- 'required': ['backup-id'],
- 'type': 'object'}},
- 'properties': {'Create': {'properties': {'Params': {'$ref': '#/definitions/BackupsCreateArgs'},
- 'Result': {'$ref': '#/definitions/BackupsMetadataResult'}},
- 'type': 'object'},
- 'FinishRestore': {'type': 'object'},
- 'Info': {'properties': {'Params': {'$ref': '#/definitions/BackupsInfoArgs'},
- 'Result': {'$ref': '#/definitions/BackupsMetadataResult'}},
- 'type': 'object'},
- 'List': {'properties': {'Params': {'$ref': '#/definitions/BackupsListArgs'},
- 'Result': {'$ref': '#/definitions/BackupsListResult'}},
- 'type': 'object'},
- 'PrepareRestore': {'type': 'object'},
- 'Remove': {'properties': {'Params': {'$ref': '#/definitions/BackupsRemoveArgs'}},
- 'type': 'object'},
- 'Restore': {'properties': {'Params': {'$ref': '#/definitions/RestoreArgs'}},
- 'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(BackupsMetadataResult)
- async def Create(self, notes):
- '''
- notes : str
- Returns -> typing.Union[str, int, _ForwardRef('Number')]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='Backups',
- request='Create',
- version=1,
- params=_params)
- _params['notes'] = notes
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(None)
- async def FinishRestore(self):
- '''
-
- Returns -> None
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='Backups',
- request='FinishRestore',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(BackupsMetadataResult)
- async def Info(self, id_):
- '''
- id_ : str
- Returns -> typing.Union[str, int, _ForwardRef('Number')]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='Backups',
- request='Info',
- version=1,
- params=_params)
- _params['id'] = id_
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(BackupsListResult)
- async def List(self):
- '''
-
- Returns -> typing.Sequence[~BackupsMetadataResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='Backups',
- request='List',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(None)
- async def PrepareRestore(self):
- '''
-
- Returns -> None
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='Backups',
- request='PrepareRestore',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(None)
- async def Remove(self, id_):
- '''
- id_ : str
- Returns -> None
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='Backups',
- request='Remove',
- version=1,
- params=_params)
- _params['id'] = id_
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(None)
- async def Restore(self, backup_id):
- '''
- backup_id : str
- Returns -> None
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='Backups',
- request='Restore',
- version=1,
- params=_params)
- _params['backup-id'] = backup_id
- reply = await self.rpc(msg)
- return reply
-
-
-
-class BundleFacade(Type):
- name = 'Bundle'
- version = 1
- schema = {'definitions': {'BundleChange': {'additionalProperties': False,
- 'properties': {'args': {'items': {'additionalProperties': True,
- 'type': 'object'},
- 'type': 'array'},
- 'id': {'type': 'string'},
- 'method': {'type': 'string'},
- 'requires': {'items': {'type': 'string'},
- 'type': 'array'}},
- 'required': ['id',
- 'method',
- 'args',
- 'requires'],
- 'type': 'object'},
- 'BundleChangesParams': {'additionalProperties': False,
- 'properties': {'yaml': {'type': 'string'}},
- 'required': ['yaml'],
- 'type': 'object'},
- 'BundleChangesResults': {'additionalProperties': False,
- 'properties': {'changes': {'items': {'$ref': '#/definitions/BundleChange'},
- 'type': 'array'},
- 'errors': {'items': {'type': 'string'},
- 'type': 'array'}},
- 'type': 'object'}},
- 'properties': {'GetChanges': {'properties': {'Params': {'$ref': '#/definitions/BundleChangesParams'},
- 'Result': {'$ref': '#/definitions/BundleChangesResults'}},
- 'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(BundleChangesResults)
- async def GetChanges(self, yaml):
- '''
- yaml : str
- Returns -> typing.Union[typing.Sequence[~BundleChange], typing.Sequence[str]]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='Bundle',
- request='GetChanges',
- version=1,
- params=_params)
- _params['yaml'] = yaml
- reply = await self.rpc(msg)
- return reply
-
-
-
-class CAASAgentFacade(Type):
- name = 'CAASAgent'
- version = 1
- schema = {'definitions': {'CloudCredential': {'additionalProperties': False,
- 'properties': {'attrs': {'patternProperties': {'.*': {'type': 'string'}},
- 'type': 'object'},
- 'auth-type': {'type': 'string'},
- 'redacted': {'items': {'type': 'string'},
- 'type': 'array'}},
- 'required': ['auth-type'],
- 'type': 'object'},
- 'CloudSpec': {'additionalProperties': False,
- 'properties': {'cacertificates': {'items': {'type': 'string'},
- 'type': 'array'},
- 'credential': {'$ref': '#/definitions/CloudCredential'},
- 'endpoint': {'type': 'string'},
- 'identity-endpoint': {'type': 'string'},
- 'name': {'type': 'string'},
- 'region': {'type': 'string'},
- 'storage-endpoint': {'type': 'string'},
- 'type': {'type': 'string'}},
- 'required': ['type', 'name'],
- 'type': 'object'},
- 'CloudSpecResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'result': {'$ref': '#/definitions/CloudSpec'}},
- 'type': 'object'},
- 'CloudSpecResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/CloudSpecResult'},
- 'type': 'array'}},
- 'type': 'object'},
- 'Entities': {'additionalProperties': False,
- 'properties': {'entities': {'items': {'$ref': '#/definitions/Entity'},
- 'type': 'array'}},
- 'required': ['entities'],
- 'type': 'object'},
- 'Entity': {'additionalProperties': False,
- 'properties': {'tag': {'type': 'string'}},
- 'required': ['tag'],
- 'type': 'object'},
- 'Error': {'additionalProperties': False,
- 'properties': {'code': {'type': 'string'},
- 'info': {'$ref': '#/definitions/ErrorInfo'},
- 'message': {'type': 'string'}},
- 'required': ['message', 'code'],
- 'type': 'object'},
- 'ErrorInfo': {'additionalProperties': False,
- 'properties': {'macaroon': {'$ref': '#/definitions/Macaroon'},
- 'macaroon-path': {'type': 'string'}},
- 'type': 'object'},
- 'Macaroon': {'additionalProperties': False, 'type': 'object'},
- 'ModelConfigResult': {'additionalProperties': False,
- 'properties': {'config': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'}},
- 'required': ['config'],
- 'type': 'object'},
- 'ModelTag': {'additionalProperties': False, 'type': 'object'},
- 'NotifyWatchResult': {'additionalProperties': False,
- 'properties': {'NotifyWatcherId': {'type': 'string'},
- 'error': {'$ref': '#/definitions/Error'}},
- 'required': ['NotifyWatcherId'],
- 'type': 'object'}},
- 'properties': {'CloudSpec': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/CloudSpecResults'}},
- 'type': 'object'},
- 'GetCloudSpec': {'properties': {'Params': {'$ref': '#/definitions/ModelTag'},
- 'Result': {'$ref': '#/definitions/CloudSpecResult'}},
- 'type': 'object'},
- 'ModelConfig': {'properties': {'Result': {'$ref': '#/definitions/ModelConfigResult'}},
- 'type': 'object'},
- 'WatchForModelConfigChanges': {'properties': {'Result': {'$ref': '#/definitions/NotifyWatchResult'}},
- 'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(CloudSpecResults)
- async def CloudSpec(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~CloudSpecResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASAgent',
- request='CloudSpec',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(CloudSpecResult)
- async def GetCloudSpec(self):
- '''
-
- Returns -> typing.Union[_ForwardRef('Error'), _ForwardRef('CloudSpec')]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASAgent',
- request='GetCloudSpec',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(ModelConfigResult)
- async def ModelConfig(self):
- '''
-
- Returns -> typing.Mapping[str, typing.Any]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASAgent',
- request='ModelConfig',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(NotifyWatchResult)
- async def WatchForModelConfigChanges(self):
- '''
-
- Returns -> typing.Union[str, _ForwardRef('Error')]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASAgent',
- request='WatchForModelConfigChanges',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
-class CAASFirewallerFacade(Type):
- name = 'CAASFirewaller'
- version = 1
- schema = {'definitions': {'ApplicationGetConfigResults': {'additionalProperties': False,
- 'properties': {'Results': {'items': {'$ref': '#/definitions/ConfigResult'},
- 'type': 'array'}},
- 'required': ['Results'],
- 'type': 'object'},
- 'BoolResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'result': {'type': 'boolean'}},
- 'required': ['result'],
- 'type': 'object'},
- 'BoolResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/BoolResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'ConfigResult': {'additionalProperties': False,
- 'properties': {'config': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'},
- 'error': {'$ref': '#/definitions/Error'}},
- 'required': ['config'],
- 'type': 'object'},
- 'Entities': {'additionalProperties': False,
- 'properties': {'entities': {'items': {'$ref': '#/definitions/Entity'},
- 'type': 'array'}},
- 'required': ['entities'],
- 'type': 'object'},
- 'Entity': {'additionalProperties': False,
- 'properties': {'tag': {'type': 'string'}},
- 'required': ['tag'],
- 'type': 'object'},
- 'Error': {'additionalProperties': False,
- 'properties': {'code': {'type': 'string'},
- 'info': {'$ref': '#/definitions/ErrorInfo'},
- 'message': {'type': 'string'}},
- 'required': ['message', 'code'],
- 'type': 'object'},
- 'ErrorInfo': {'additionalProperties': False,
- 'properties': {'macaroon': {'$ref': '#/definitions/Macaroon'},
- 'macaroon-path': {'type': 'string'}},
- 'type': 'object'},
- 'LifeResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'life': {'type': 'string'}},
- 'required': ['life'],
- 'type': 'object'},
- 'LifeResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/LifeResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'Macaroon': {'additionalProperties': False, 'type': 'object'},
- 'NotifyWatchResult': {'additionalProperties': False,
- 'properties': {'NotifyWatcherId': {'type': 'string'},
- 'error': {'$ref': '#/definitions/Error'}},
- 'required': ['NotifyWatcherId'],
- 'type': 'object'},
- 'NotifyWatchResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/NotifyWatchResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'StringsWatchResult': {'additionalProperties': False,
- 'properties': {'changes': {'items': {'type': 'string'},
- 'type': 'array'},
- 'error': {'$ref': '#/definitions/Error'},
- 'watcher-id': {'type': 'string'}},
- 'required': ['watcher-id'],
- 'type': 'object'}},
- 'properties': {'ApplicationsConfig': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/ApplicationGetConfigResults'}},
- 'type': 'object'},
- 'IsExposed': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/BoolResults'}},
- 'type': 'object'},
- 'Life': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/LifeResults'}},
- 'type': 'object'},
- 'Watch': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/NotifyWatchResults'}},
- 'type': 'object'},
- 'WatchApplications': {'properties': {'Result': {'$ref': '#/definitions/StringsWatchResult'}},
- 'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(ApplicationGetConfigResults)
- async def ApplicationsConfig(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~ConfigResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASFirewaller',
- request='ApplicationsConfig',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(BoolResults)
- async def IsExposed(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~BoolResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASFirewaller',
- request='IsExposed',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(LifeResults)
- async def Life(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~LifeResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASFirewaller',
- request='Life',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(NotifyWatchResults)
- async def Watch(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~NotifyWatchResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASFirewaller',
- request='Watch',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(StringsWatchResult)
- async def WatchApplications(self):
- '''
-
- Returns -> typing.Union[typing.Sequence[str], _ForwardRef('Error'), str]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASFirewaller',
- request='WatchApplications',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
-class CAASOperatorFacade(Type):
- name = 'CAASOperator'
- version = 1
- schema = {'definitions': {'APIHostPortsResult': {'additionalProperties': False,
- 'properties': {'servers': {'items': {'items': {'$ref': '#/definitions/HostPort'},
- 'type': 'array'},
- 'type': 'array'}},
- 'required': ['servers'],
- 'type': 'object'},
- 'Address': {'additionalProperties': False,
- 'properties': {'scope': {'type': 'string'},
- 'space-name': {'type': 'string'},
- 'type': {'type': 'string'},
- 'value': {'type': 'string'}},
- 'required': ['value', 'type', 'scope'],
- 'type': 'object'},
- 'ApplicationCharm': {'additionalProperties': False,
- 'properties': {'charm-modified-version': {'type': 'integer'},
- 'force-upgrade': {'type': 'boolean'},
- 'sha256': {'type': 'string'},
- 'url': {'type': 'string'}},
- 'required': ['url',
- 'sha256',
- 'charm-modified-version'],
- 'type': 'object'},
- 'ApplicationCharmResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'result': {'$ref': '#/definitions/ApplicationCharm'}},
- 'type': 'object'},
- 'ApplicationCharmResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/ApplicationCharmResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'Binary': {'additionalProperties': False,
- 'properties': {'Arch': {'type': 'string'},
- 'Number': {'$ref': '#/definitions/Number'},
- 'Series': {'type': 'string'}},
- 'required': ['Number', 'Series', 'Arch'],
- 'type': 'object'},
- 'Entities': {'additionalProperties': False,
- 'properties': {'entities': {'items': {'$ref': '#/definitions/Entity'},
- 'type': 'array'}},
- 'required': ['entities'],
- 'type': 'object'},
- 'EntitiesVersion': {'additionalProperties': False,
- 'properties': {'agent-tools': {'items': {'$ref': '#/definitions/EntityVersion'},
- 'type': 'array'}},
- 'required': ['agent-tools'],
- 'type': 'object'},
- 'Entity': {'additionalProperties': False,
- 'properties': {'tag': {'type': 'string'}},
- 'required': ['tag'],
- 'type': 'object'},
- 'EntityStatusArgs': {'additionalProperties': False,
- 'properties': {'data': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'},
- 'info': {'type': 'string'},
- 'status': {'type': 'string'},
- 'tag': {'type': 'string'}},
- 'required': ['tag',
- 'status',
- 'info',
- 'data'],
- 'type': 'object'},
- 'EntityString': {'additionalProperties': False,
- 'properties': {'tag': {'type': 'string'},
- 'value': {'type': 'string'}},
- 'required': ['tag', 'value'],
- 'type': 'object'},
- 'EntityVersion': {'additionalProperties': False,
- 'properties': {'tag': {'type': 'string'},
- 'tools': {'$ref': '#/definitions/Version'}},
- 'required': ['tag', 'tools'],
- 'type': 'object'},
- 'Error': {'additionalProperties': False,
- 'properties': {'code': {'type': 'string'},
- 'info': {'$ref': '#/definitions/ErrorInfo'},
- 'message': {'type': 'string'}},
- 'required': ['message', 'code'],
- 'type': 'object'},
- 'ErrorInfo': {'additionalProperties': False,
- 'properties': {'macaroon': {'$ref': '#/definitions/Macaroon'},
- 'macaroon-path': {'type': 'string'}},
- 'type': 'object'},
- 'ErrorResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'}},
- 'type': 'object'},
- 'ErrorResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/ErrorResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'HostPort': {'additionalProperties': False,
- 'properties': {'Address': {'$ref': '#/definitions/Address'},
- 'port': {'type': 'integer'}},
- 'required': ['Address', 'port'],
- 'type': 'object'},
- 'LifeResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'life': {'type': 'string'}},
- 'required': ['life'],
- 'type': 'object'},
- 'LifeResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/LifeResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'Macaroon': {'additionalProperties': False, 'type': 'object'},
- 'ModelResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'name': {'type': 'string'},
- 'type': {'type': 'string'},
- 'uuid': {'type': 'string'}},
- 'required': ['name', 'uuid', 'type'],
- 'type': 'object'},
- 'NotifyWatchResult': {'additionalProperties': False,
- 'properties': {'NotifyWatcherId': {'type': 'string'},
- 'error': {'$ref': '#/definitions/Error'}},
- 'required': ['NotifyWatcherId'],
- 'type': 'object'},
- 'NotifyWatchResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/NotifyWatchResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'Number': {'additionalProperties': False,
- 'properties': {'Build': {'type': 'integer'},
- 'Major': {'type': 'integer'},
- 'Minor': {'type': 'integer'},
- 'Patch': {'type': 'integer'},
- 'Tag': {'type': 'string'}},
- 'required': ['Major',
- 'Minor',
- 'Tag',
- 'Patch',
- 'Build'],
- 'type': 'object'},
- 'SetPodSpecParams': {'additionalProperties': False,
- 'properties': {'specs': {'items': {'$ref': '#/definitions/EntityString'},
- 'type': 'array'}},
- 'required': ['specs'],
- 'type': 'object'},
- 'SetStatus': {'additionalProperties': False,
- 'properties': {'entities': {'items': {'$ref': '#/definitions/EntityStatusArgs'},
- 'type': 'array'}},
- 'required': ['entities'],
- 'type': 'object'},
- 'StringResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'result': {'type': 'string'}},
- 'required': ['result'],
- 'type': 'object'},
- 'StringsResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'result': {'items': {'type': 'string'},
- 'type': 'array'}},
- 'type': 'object'},
- 'StringsWatchResult': {'additionalProperties': False,
- 'properties': {'changes': {'items': {'type': 'string'},
- 'type': 'array'},
- 'error': {'$ref': '#/definitions/Error'},
- 'watcher-id': {'type': 'string'}},
- 'required': ['watcher-id'],
- 'type': 'object'},
- 'StringsWatchResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/StringsWatchResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'Version': {'additionalProperties': False,
- 'properties': {'version': {'$ref': '#/definitions/Binary'}},
- 'required': ['version'],
- 'type': 'object'}},
- 'properties': {'APIAddresses': {'properties': {'Result': {'$ref': '#/definitions/StringsResult'}},
- 'type': 'object'},
- 'APIHostPorts': {'properties': {'Result': {'$ref': '#/definitions/APIHostPortsResult'}},
- 'type': 'object'},
- 'Charm': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/ApplicationCharmResults'}},
- 'type': 'object'},
- 'CurrentModel': {'properties': {'Result': {'$ref': '#/definitions/ModelResult'}},
- 'type': 'object'},
- 'Life': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/LifeResults'}},
- 'type': 'object'},
- 'ModelUUID': {'properties': {'Result': {'$ref': '#/definitions/StringResult'}},
- 'type': 'object'},
- 'Remove': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/ErrorResults'}},
- 'type': 'object'},
- 'SetPodSpec': {'properties': {'Params': {'$ref': '#/definitions/SetPodSpecParams'},
- 'Result': {'$ref': '#/definitions/ErrorResults'}},
- 'type': 'object'},
- 'SetStatus': {'properties': {'Params': {'$ref': '#/definitions/SetStatus'},
- 'Result': {'$ref': '#/definitions/ErrorResults'}},
- 'type': 'object'},
- 'SetTools': {'properties': {'Params': {'$ref': '#/definitions/EntitiesVersion'},
- 'Result': {'$ref': '#/definitions/ErrorResults'}},
- 'type': 'object'},
- 'Watch': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/NotifyWatchResults'}},
- 'type': 'object'},
- 'WatchAPIHostPorts': {'properties': {'Result': {'$ref': '#/definitions/NotifyWatchResult'}},
- 'type': 'object'},
- 'WatchUnits': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/StringsWatchResults'}},
- 'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(StringsResult)
- async def APIAddresses(self):
- '''
-
- Returns -> typing.Union[_ForwardRef('Error'), typing.Sequence[str]]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='APIAddresses',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(APIHostPortsResult)
- async def APIHostPorts(self):
- '''
-
- Returns -> typing.Sequence[~HostPort]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='APIHostPorts',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(ApplicationCharmResults)
- async def Charm(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~ApplicationCharmResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='Charm',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(ModelResult)
- async def CurrentModel(self):
- '''
-
- Returns -> typing.Union[_ForwardRef('Error'), str]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='CurrentModel',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(LifeResults)
- async def Life(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~LifeResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='Life',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(StringResult)
- async def ModelUUID(self):
- '''
-
- Returns -> typing.Union[_ForwardRef('Error'), str]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='ModelUUID',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(ErrorResults)
- async def Remove(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~ErrorResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='Remove',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(ErrorResults)
- async def SetPodSpec(self, specs):
- '''
- specs : typing.Sequence[~EntityString]
- Returns -> typing.Sequence[~ErrorResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='SetPodSpec',
- version=1,
- params=_params)
- _params['specs'] = specs
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(ErrorResults)
- async def SetStatus(self, entities):
- '''
- entities : typing.Sequence[~EntityStatusArgs]
- Returns -> typing.Sequence[~ErrorResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='SetStatus',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(ErrorResults)
- async def SetTools(self, agent_tools):
- '''
- agent_tools : typing.Sequence[~EntityVersion]
- Returns -> typing.Sequence[~ErrorResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='SetTools',
- version=1,
- params=_params)
- _params['agent-tools'] = agent_tools
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(NotifyWatchResults)
- async def Watch(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~NotifyWatchResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='Watch',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(NotifyWatchResult)
- async def WatchAPIHostPorts(self):
- '''
-
- Returns -> typing.Union[str, _ForwardRef('Error')]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='WatchAPIHostPorts',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(StringsWatchResults)
- async def WatchUnits(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~StringsWatchResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperator',
- request='WatchUnits',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
-class CAASOperatorProvisionerFacade(Type):
- name = 'CAASOperatorProvisioner'
- version = 1
- schema = {'definitions': {'APIHostPortsResult': {'additionalProperties': False,
- 'properties': {'servers': {'items': {'items': {'$ref': '#/definitions/HostPort'},
- 'type': 'array'},
- 'type': 'array'}},
- 'required': ['servers'],
- 'type': 'object'},
- 'Address': {'additionalProperties': False,
- 'properties': {'scope': {'type': 'string'},
- 'space-name': {'type': 'string'},
- 'type': {'type': 'string'},
- 'value': {'type': 'string'}},
- 'required': ['value', 'type', 'scope'],
- 'type': 'object'},
- 'Entities': {'additionalProperties': False,
- 'properties': {'entities': {'items': {'$ref': '#/definitions/Entity'},
- 'type': 'array'}},
- 'required': ['entities'],
- 'type': 'object'},
- 'Entity': {'additionalProperties': False,
- 'properties': {'tag': {'type': 'string'}},
- 'required': ['tag'],
- 'type': 'object'},
- 'EntityPassword': {'additionalProperties': False,
- 'properties': {'password': {'type': 'string'},
- 'tag': {'type': 'string'}},
- 'required': ['tag', 'password'],
- 'type': 'object'},
- 'EntityPasswords': {'additionalProperties': False,
- 'properties': {'changes': {'items': {'$ref': '#/definitions/EntityPassword'},
- 'type': 'array'}},
- 'required': ['changes'],
- 'type': 'object'},
- 'Error': {'additionalProperties': False,
- 'properties': {'code': {'type': 'string'},
- 'info': {'$ref': '#/definitions/ErrorInfo'},
- 'message': {'type': 'string'}},
- 'required': ['message', 'code'],
- 'type': 'object'},
- 'ErrorInfo': {'additionalProperties': False,
- 'properties': {'macaroon': {'$ref': '#/definitions/Macaroon'},
- 'macaroon-path': {'type': 'string'}},
- 'type': 'object'},
- 'ErrorResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'}},
- 'type': 'object'},
- 'ErrorResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/ErrorResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'HostPort': {'additionalProperties': False,
- 'properties': {'Address': {'$ref': '#/definitions/Address'},
- 'port': {'type': 'integer'}},
- 'required': ['Address', 'port'],
- 'type': 'object'},
- 'KubernetesFilesystemAttachmentParams': {'additionalProperties': False,
- 'properties': {'mount-point': {'type': 'string'},
- 'provider': {'type': 'string'},
- 'read-only': {'type': 'boolean'}},
- 'required': ['provider'],
- 'type': 'object'},
- 'KubernetesFilesystemParams': {'additionalProperties': False,
- 'properties': {'attachment': {'$ref': '#/definitions/KubernetesFilesystemAttachmentParams'},
- 'attributes': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'},
- 'provider': {'type': 'string'},
- 'size': {'type': 'integer'},
- 'storagename': {'type': 'string'},
- 'tags': {'patternProperties': {'.*': {'type': 'string'}},
- 'type': 'object'}},
- 'required': ['storagename',
- 'size',
- 'provider'],
- 'type': 'object'},
- 'LifeResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'life': {'type': 'string'}},
- 'required': ['life'],
- 'type': 'object'},
- 'LifeResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/LifeResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'Macaroon': {'additionalProperties': False, 'type': 'object'},
- 'NotifyWatchResult': {'additionalProperties': False,
- 'properties': {'NotifyWatcherId': {'type': 'string'},
- 'error': {'$ref': '#/definitions/Error'}},
- 'required': ['NotifyWatcherId'],
- 'type': 'object'},
- 'Number': {'additionalProperties': False,
- 'properties': {'Build': {'type': 'integer'},
- 'Major': {'type': 'integer'},
- 'Minor': {'type': 'integer'},
- 'Patch': {'type': 'integer'},
- 'Tag': {'type': 'string'}},
- 'required': ['Major',
- 'Minor',
- 'Tag',
- 'Patch',
- 'Build'],
- 'type': 'object'},
- 'OperatorProvisioningInfo': {'additionalProperties': False,
- 'properties': {'api-addresses': {'items': {'type': 'string'},
- 'type': 'array'},
- 'charm-storage': {'$ref': '#/definitions/KubernetesFilesystemParams'},
- 'image-path': {'type': 'string'},
- 'tags': {'patternProperties': {'.*': {'type': 'string'}},
- 'type': 'object'},
- 'version': {'$ref': '#/definitions/Number'}},
- 'required': ['image-path',
- 'version',
- 'api-addresses',
- 'charm-storage'],
- 'type': 'object'},
- 'StringResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'result': {'type': 'string'}},
- 'required': ['result'],
- 'type': 'object'},
- 'StringsResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'result': {'items': {'type': 'string'},
- 'type': 'array'}},
- 'type': 'object'},
- 'StringsWatchResult': {'additionalProperties': False,
- 'properties': {'changes': {'items': {'type': 'string'},
- 'type': 'array'},
- 'error': {'$ref': '#/definitions/Error'},
- 'watcher-id': {'type': 'string'}},
- 'required': ['watcher-id'],
- 'type': 'object'}},
- 'properties': {'APIAddresses': {'properties': {'Result': {'$ref': '#/definitions/StringsResult'}},
- 'type': 'object'},
- 'APIHostPorts': {'properties': {'Result': {'$ref': '#/definitions/APIHostPortsResult'}},
- 'type': 'object'},
- 'Life': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/LifeResults'}},
- 'type': 'object'},
- 'ModelUUID': {'properties': {'Result': {'$ref': '#/definitions/StringResult'}},
- 'type': 'object'},
- 'OperatorProvisioningInfo': {'properties': {'Result': {'$ref': '#/definitions/OperatorProvisioningInfo'}},
- 'type': 'object'},
- 'SetPasswords': {'properties': {'Params': {'$ref': '#/definitions/EntityPasswords'},
- 'Result': {'$ref': '#/definitions/ErrorResults'}},
- 'type': 'object'},
- 'WatchAPIHostPorts': {'properties': {'Result': {'$ref': '#/definitions/NotifyWatchResult'}},
- 'type': 'object'},
- 'WatchApplications': {'properties': {'Result': {'$ref': '#/definitions/StringsWatchResult'}},
- 'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(StringsResult)
- async def APIAddresses(self):
- '''
-
- Returns -> typing.Union[_ForwardRef('Error'), typing.Sequence[str]]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperatorProvisioner',
- request='APIAddresses',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(APIHostPortsResult)
- async def APIHostPorts(self):
- '''
-
- Returns -> typing.Sequence[~HostPort]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperatorProvisioner',
- request='APIHostPorts',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(LifeResults)
- async def Life(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~LifeResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperatorProvisioner',
- request='Life',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(StringResult)
- async def ModelUUID(self):
- '''
-
- Returns -> typing.Union[_ForwardRef('Error'), str]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperatorProvisioner',
- request='ModelUUID',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(OperatorProvisioningInfo)
- async def OperatorProvisioningInfo(self):
- '''
-
- Returns -> typing.Union[typing.Sequence[str], _ForwardRef('KubernetesFilesystemParams'), str, typing.Mapping[str, str], _ForwardRef('Number')]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperatorProvisioner',
- request='OperatorProvisioningInfo',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(ErrorResults)
- async def SetPasswords(self, changes):
- '''
- changes : typing.Sequence[~EntityPassword]
- Returns -> typing.Sequence[~ErrorResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperatorProvisioner',
- request='SetPasswords',
- version=1,
- params=_params)
- _params['changes'] = changes
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(NotifyWatchResult)
- async def WatchAPIHostPorts(self):
- '''
-
- Returns -> typing.Union[str, _ForwardRef('Error')]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperatorProvisioner',
- request='WatchAPIHostPorts',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(StringsWatchResult)
- async def WatchApplications(self):
- '''
-
- Returns -> typing.Union[typing.Sequence[str], _ForwardRef('Error'), str]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASOperatorProvisioner',
- request='WatchApplications',
- version=1,
- params=_params)
-
- reply = await self.rpc(msg)
- return reply
-
-
-
-class CAASUnitProvisionerFacade(Type):
- name = 'CAASUnitProvisioner'
- version = 1
- schema = {'definitions': {'Address': {'additionalProperties': False,
- 'properties': {'scope': {'type': 'string'},
- 'space-name': {'type': 'string'},
- 'type': {'type': 'string'},
- 'value': {'type': 'string'}},
- 'required': ['value', 'type', 'scope'],
- 'type': 'object'},
- 'ApplicationGetConfigResults': {'additionalProperties': False,
- 'properties': {'Results': {'items': {'$ref': '#/definitions/ConfigResult'},
- 'type': 'array'}},
- 'required': ['Results'],
- 'type': 'object'},
- 'ApplicationUnitParams': {'additionalProperties': False,
- 'properties': {'address': {'type': 'string'},
- 'data': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'},
- 'filesystem-info': {'items': {'$ref': '#/definitions/KubernetesFilesystemInfo'},
- 'type': 'array'},
- 'info': {'type': 'string'},
- 'ports': {'items': {'type': 'string'},
- 'type': 'array'},
- 'provider-id': {'type': 'string'},
- 'status': {'type': 'string'},
- 'unit-tag': {'type': 'string'}},
- 'required': ['provider-id',
- 'unit-tag',
- 'address',
- 'ports',
- 'status',
- 'info'],
- 'type': 'object'},
- 'ConfigResult': {'additionalProperties': False,
- 'properties': {'config': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'},
- 'error': {'$ref': '#/definitions/Error'}},
- 'required': ['config'],
- 'type': 'object'},
- 'Entities': {'additionalProperties': False,
- 'properties': {'entities': {'items': {'$ref': '#/definitions/Entity'},
- 'type': 'array'}},
- 'required': ['entities'],
- 'type': 'object'},
- 'Entity': {'additionalProperties': False,
- 'properties': {'tag': {'type': 'string'}},
- 'required': ['tag'],
- 'type': 'object'},
- 'EntityStatusArgs': {'additionalProperties': False,
- 'properties': {'data': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'},
- 'info': {'type': 'string'},
- 'status': {'type': 'string'},
- 'tag': {'type': 'string'}},
- 'required': ['tag',
- 'status',
- 'info',
- 'data'],
- 'type': 'object'},
- 'Error': {'additionalProperties': False,
- 'properties': {'code': {'type': 'string'},
- 'info': {'$ref': '#/definitions/ErrorInfo'},
- 'message': {'type': 'string'}},
- 'required': ['message', 'code'],
- 'type': 'object'},
- 'ErrorInfo': {'additionalProperties': False,
- 'properties': {'macaroon': {'$ref': '#/definitions/Macaroon'},
- 'macaroon-path': {'type': 'string'}},
- 'type': 'object'},
- 'ErrorResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'}},
- 'type': 'object'},
- 'ErrorResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/ErrorResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'IntResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'result': {'type': 'integer'}},
- 'required': ['result'],
- 'type': 'object'},
- 'IntResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/IntResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'KubernetesDeviceParams': {'additionalProperties': False,
- 'properties': {'Attributes': {'patternProperties': {'.*': {'type': 'string'}},
- 'type': 'object'},
- 'Count': {'type': 'integer'},
- 'Type': {'type': 'string'}},
- 'required': ['Type',
- 'Count',
- 'Attributes'],
- 'type': 'object'},
- 'KubernetesFilesystemAttachmentParams': {'additionalProperties': False,
- 'properties': {'mount-point': {'type': 'string'},
- 'provider': {'type': 'string'},
- 'read-only': {'type': 'boolean'}},
- 'required': ['provider'],
- 'type': 'object'},
- 'KubernetesFilesystemInfo': {'additionalProperties': False,
- 'properties': {'data': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'},
- 'filesystem-id': {'type': 'string'},
- 'info': {'type': 'string'},
- 'mount-point': {'type': 'string'},
- 'pool': {'type': 'string'},
- 'read-only': {'type': 'boolean'},
- 'size': {'type': 'integer'},
- 'status': {'type': 'string'},
- 'storagename': {'type': 'string'},
- 'volume': {'$ref': '#/definitions/KubernetesVolumeInfo'}},
- 'required': ['storagename',
- 'pool',
- 'size',
- 'filesystem-id',
- 'status',
- 'info',
- 'volume'],
- 'type': 'object'},
- 'KubernetesFilesystemParams': {'additionalProperties': False,
- 'properties': {'attachment': {'$ref': '#/definitions/KubernetesFilesystemAttachmentParams'},
- 'attributes': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'},
- 'provider': {'type': 'string'},
- 'size': {'type': 'integer'},
- 'storagename': {'type': 'string'},
- 'tags': {'patternProperties': {'.*': {'type': 'string'}},
- 'type': 'object'}},
- 'required': ['storagename',
- 'size',
- 'provider'],
- 'type': 'object'},
- 'KubernetesProvisioningInfo': {'additionalProperties': False,
- 'properties': {'constraints': {'$ref': '#/definitions/Value'},
- 'devices': {'items': {'$ref': '#/definitions/KubernetesDeviceParams'},
- 'type': 'array'},
- 'filesystems': {'items': {'$ref': '#/definitions/KubernetesFilesystemParams'},
- 'type': 'array'},
- 'placement': {'type': 'string'},
- 'pod-spec': {'type': 'string'},
- 'tags': {'patternProperties': {'.*': {'type': 'string'}},
- 'type': 'object'},
- 'volumes': {'items': {'$ref': '#/definitions/KubernetesVolumeParams'},
- 'type': 'array'}},
- 'required': ['pod-spec',
- 'constraints'],
- 'type': 'object'},
- 'KubernetesProvisioningInfoResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'result': {'$ref': '#/definitions/KubernetesProvisioningInfo'}},
- 'required': ['result'],
- 'type': 'object'},
- 'KubernetesProvisioningInfoResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/KubernetesProvisioningInfoResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'KubernetesVolumeAttachmentParams': {'additionalProperties': False,
- 'properties': {'provider': {'type': 'string'},
- 'read-only': {'type': 'boolean'}},
- 'required': ['provider'],
- 'type': 'object'},
- 'KubernetesVolumeInfo': {'additionalProperties': False,
- 'properties': {'data': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'},
- 'info': {'type': 'string'},
- 'persistent': {'type': 'boolean'},
- 'pool': {'type': 'string'},
- 'size': {'type': 'integer'},
- 'status': {'type': 'string'},
- 'volume-id': {'type': 'string'}},
- 'required': ['volume-id',
- 'size',
- 'persistent',
- 'status',
- 'info'],
- 'type': 'object'},
- 'KubernetesVolumeParams': {'additionalProperties': False,
- 'properties': {'attachment': {'$ref': '#/definitions/KubernetesVolumeAttachmentParams'},
- 'attributes': {'patternProperties': {'.*': {'additionalProperties': True,
- 'type': 'object'}},
- 'type': 'object'},
- 'provider': {'type': 'string'},
- 'size': {'type': 'integer'},
- 'storagename': {'type': 'string'},
- 'tags': {'patternProperties': {'.*': {'type': 'string'}},
- 'type': 'object'}},
- 'required': ['storagename',
- 'size',
- 'provider'],
- 'type': 'object'},
- 'LifeResult': {'additionalProperties': False,
- 'properties': {'error': {'$ref': '#/definitions/Error'},
- 'life': {'type': 'string'}},
- 'required': ['life'],
- 'type': 'object'},
- 'LifeResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/LifeResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'Macaroon': {'additionalProperties': False, 'type': 'object'},
- 'NotifyWatchResult': {'additionalProperties': False,
- 'properties': {'NotifyWatcherId': {'type': 'string'},
- 'error': {'$ref': '#/definitions/Error'}},
- 'required': ['NotifyWatcherId'],
- 'type': 'object'},
- 'NotifyWatchResults': {'additionalProperties': False,
- 'properties': {'results': {'items': {'$ref': '#/definitions/NotifyWatchResult'},
- 'type': 'array'}},
- 'required': ['results'],
- 'type': 'object'},
- 'SetStatus': {'additionalProperties': False,
- 'properties': {'entities': {'items': {'$ref': '#/definitions/EntityStatusArgs'},
- 'type': 'array'}},
- 'required': ['entities'],
- 'type': 'object'},
- 'StringsWatchResult': {'additionalProperties': False,
- 'properties': {'changes': {'items': {'type': 'string'},
- 'type': 'array'},
- 'error': {'$ref': '#/definitions/Error'},
- 'watcher-id': {'type': 'string'}},
- 'required': ['watcher-id'],
- 'type': 'object'},
- 'UpdateApplicationServiceArg': {'additionalProperties': False,
- 'properties': {'addresses': {'items': {'$ref': '#/definitions/Address'},
- 'type': 'array'},
- 'application-tag': {'type': 'string'},
- 'provider-id': {'type': 'string'}},
- 'required': ['application-tag',
- 'provider-id',
- 'addresses'],
- 'type': 'object'},
- 'UpdateApplicationServiceArgs': {'additionalProperties': False,
- 'properties': {'args': {'items': {'$ref': '#/definitions/UpdateApplicationServiceArg'},
- 'type': 'array'}},
- 'required': ['args'],
- 'type': 'object'},
- 'UpdateApplicationUnitArgs': {'additionalProperties': False,
- 'properties': {'args': {'items': {'$ref': '#/definitions/UpdateApplicationUnits'},
- 'type': 'array'}},
- 'required': ['args'],
- 'type': 'object'},
- 'UpdateApplicationUnits': {'additionalProperties': False,
- 'properties': {'application-tag': {'type': 'string'},
- 'units': {'items': {'$ref': '#/definitions/ApplicationUnitParams'},
- 'type': 'array'}},
- 'required': ['application-tag',
- 'units'],
- 'type': 'object'},
- 'Value': {'additionalProperties': False,
- 'properties': {'arch': {'type': 'string'},
- 'container': {'type': 'string'},
- 'cores': {'type': 'integer'},
- 'cpu-power': {'type': 'integer'},
- 'instance-type': {'type': 'string'},
- 'mem': {'type': 'integer'},
- 'root-disk': {'type': 'integer'},
- 'spaces': {'items': {'type': 'string'},
- 'type': 'array'},
- 'tags': {'items': {'type': 'string'},
- 'type': 'array'},
- 'virt-type': {'type': 'string'},
- 'zones': {'items': {'type': 'string'},
- 'type': 'array'}},
- 'type': 'object'}},
- 'properties': {'ApplicationsConfig': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/ApplicationGetConfigResults'}},
- 'type': 'object'},
- 'ApplicationsScale': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/IntResults'}},
- 'type': 'object'},
- 'Life': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/LifeResults'}},
- 'type': 'object'},
- 'ProvisioningInfo': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/KubernetesProvisioningInfoResults'}},
- 'type': 'object'},
- 'SetOperatorStatus': {'properties': {'Params': {'$ref': '#/definitions/SetStatus'},
- 'Result': {'$ref': '#/definitions/ErrorResults'}},
- 'type': 'object'},
- 'UpdateApplicationsService': {'properties': {'Params': {'$ref': '#/definitions/UpdateApplicationServiceArgs'},
- 'Result': {'$ref': '#/definitions/ErrorResults'}},
- 'type': 'object'},
- 'UpdateApplicationsUnits': {'properties': {'Params': {'$ref': '#/definitions/UpdateApplicationUnitArgs'},
- 'Result': {'$ref': '#/definitions/ErrorResults'}},
- 'type': 'object'},
- 'WatchApplications': {'properties': {'Result': {'$ref': '#/definitions/StringsWatchResult'}},
- 'type': 'object'},
- 'WatchApplicationsScale': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/NotifyWatchResults'}},
- 'type': 'object'},
- 'WatchPodSpec': {'properties': {'Params': {'$ref': '#/definitions/Entities'},
- 'Result': {'$ref': '#/definitions/NotifyWatchResults'}},
- 'type': 'object'}},
- 'type': 'object'}
-
-
- @ReturnMapping(ApplicationGetConfigResults)
- async def ApplicationsConfig(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~ConfigResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASUnitProvisioner',
- request='ApplicationsConfig',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(IntResults)
- async def ApplicationsScale(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~IntResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASUnitProvisioner',
- request='ApplicationsScale',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(LifeResults)
- async def Life(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~LifeResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASUnitProvisioner',
- request='Life',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(KubernetesProvisioningInfoResults)
- async def ProvisioningInfo(self, entities):
- '''
- entities : typing.Sequence[~Entity]
- Returns -> typing.Sequence[~KubernetesProvisioningInfoResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASUnitProvisioner',
- request='ProvisioningInfo',
- version=1,
- params=_params)
- _params['entities'] = entities
- reply = await self.rpc(msg)
- return reply
-
-
-
- @ReturnMapping(ErrorResults)
- async def SetOperatorStatus(self, entities):
- '''
- entities : typing.Sequence[~EntityStatusArgs]
- Returns -> typing.Sequence[~ErrorResult]
- '''
- # map input types to rpc msg
- _params = dict()
- msg = dict(type='CAASUnitProvisioner',
- request='SetOperatorStatus',
- version=1,
-