Package: mazer
MazerAnsible content managerA new command-line tool for managingAnsiblecontent.Expect breaking changes!Mazer is experimental, and currently only available for tech-preview. Use with lots of caution! It is not intended for use in
production environments, nor is it currently intended to replace theansible-galaxycommand-line tool.If you’re installing Ansible content in a production environment, or need assistance with Ansible, please visit theAnsible Project,
or theAnsible docs site.DocsFor additional documentation on mazer, view theMazer topic on Ansible Galaxy Docs.
Also see the moredetailed README at github.ExamplesInstalling rolesTo installgeerlingguy.nginxvia galaxy:$ mazer install geerlingguy.nginxSeemazer github repofor more examples.Installing MazerFrom sourceThe source code for mazer lives athttps://github.com/ansible/mazer$ git clonehttps://github.com/ansible/mazer.git$ cd mazer
$ python setup.py installOr install the requirements via pip:$ pip install -r requirements.txtVia pip (from git)pip install -v git+ssh://git@github.com/ansible/mazer.gitTestingunit testingmazer uses pytest for unit tests.test requirementsTo install test requirements, use pip to install the requirements in requirements_test.txt:pip install -r requirements_test.txtTo run unit tests viatoxfor default platforms (python 2.6, 2.7, 3.6):$ toxvia ‘pytest’ directly:$ pytest tests/PrerequisitesWhen installing content from an Ansible Galaxy server, requires Galaxy v3.0+.RoadmapTo see what we’re working on, and where we’re headed,view the roadmap.Getting helpIssues welcome! If you find a bug, or have a feature idea, please let us know byopening an issue.You can also reach out to us on irc.freenode.net in the #ansible-galaxy channel.Origin of “Mazer”The name Mazer comes from a character from Ender’s Game, Mazer Rackham, that Wikipedia describes as “the half-Māori captain who singlehandedly stopped the Second Invasion by realizing that the Buggers are a hive mind. Due to his inability to pass on his knowledge, he was forced to spend fifty years at relativistic speeds (eight years to Rackham) so that he could train the next commander — Ender Wiggin.”A mazer is also a hardwood drinking vessel.LicenseGNU General Public License v3.0Changelog1.0.0 (2019-05-30)Point to galaxy.ansible.com instead of galaxy-qa.ansible.com in docs.0.6.0 (2019-05-30)Add ‘request-id’ and user-agent to artifact download requests.Fix ‘mazer install /path/to/namespace-name-1.2.3.tar.gz’‘list’ now supports –lockfile, –frozen, and –full output formats.
–lockfile/–frozen are for creating lockfiles. –full is used in combo
with –content to see installed collections fully qualified names.SPDX data updated to 3.5-32-g5b1f683196 Improve ‘list’ output and add –full.173 Add lockfile support.266 Fix ‘install –force’.256 Fix –force failing to install anything.245 Show warning when user installs deprecated collection.249 Add ‘api_key’ to config.267 Set default log level to info, improve logs.251 Help blurb updates.255 Fix errors with conflicting collection deps.0.5.0 (2019-04-15)WARNING: Mazer now requires a Ansible Galaxy server that provides the ‘v2’ style REST API.
At time of release, that includes galaxy-dev.ansible.com and galaxy-qa.ansible.comWARNING: Support for directly installing ‘traditional’ style roles from Ansible Galaxy
is no longer supported. ie, ‘mazer install geerlingguy.ntp’ will no longer work.
However, roles can still be installed if they are included in a collectionWARNING: The config file items and cli options for specifying install pathshave changed and may break existing configs and scripts.The cli option ‘–content-root’ is now ‘–collections-path’The short cli option ‘-C’ is now shorthand for ‘–collections-path’ instead
of ‘–content-root’The config item ‘content_root’ has been replaced with ‘collections_path’The config item ‘global_content_root’ has been replaced with ‘global_collections_path’The new ‘collections_path’ value no longer needs to end with ‘ansible_collections’The new ‘global_collections_path’ value no longer needs to end with ‘ansible_collections’The new ‘collections_path’ defaults to ‘~/.ansible/collections’.
Note that this replaces the previous ‘content_root’ config item that
defaulted to ‘~/.ansible/collections/ansible_collections’The new ‘global_collections_path’ defaults to ‘/usr/share/ansible/collections’.
Note that this replaces the previous ‘global_content_root’ config item that
defaulted to ‘/usr/share/ansible/collections/ansible_collections’‘mazer install’ with default ‘collections_path’ (‘~/.ansible/collections’) will
still install to ‘~/.ansible/collections/ansible_collections’, but install
will add the require trailing ‘ansible_collections’ automatically.‘mazer install –global’ with default ‘globale_collections_path’
(‘/usr/share/ansible/collections’) will still install to
‘/usr/share/ansible/collections/ansible_collections’, but
‘install –global’ will add the require trailing
‘ansible_collections’ automatically.The REST API client now uses ‘requests’ python module instead of the ‘url’ module bundle from ansible.Add cli ‘–config’ option to specify a path to an alternative config file.Add support for ‘MAZER_HOME’ environment variable. MAZER_HOME defaults to ~/.ansible and
specifies where mazer looks for it’s config (mazer.yml and mazer-logging.yml)216 Use Galaxy REST API v2.239 Rename content-root to collections-path to be consistent with ansible.228 For envs w/no LANG/locale/text encoding, assume utf8.236 Partial fix for scm_url installs.0.4.0 (2019-03-28)The default path for collections to be installed
is now ‘~/.ansible/collections/ansible_collections’
which is also the default place ansible 2.8 or higher will search
for collections.Add the ‘mazer publish’ for publishing a collection artifact to Ansible Galaxy186 Implement ‘migrate_role’ command to convert traditional roles to collections.galaxy.yml ‘authors’ field is now a listgalaxy.yml ‘dependencies’ field is now a dict where the key is the
collection and the value is ahttps://github.com/rbarrois/python-semanticversionversion specgalaxy.yml ‘tags’ field (a list of tags) addedgalaxy.yml ‘readme’ field added. The value is the path to the README file.galaxy.yml optional new fields ‘repository’, ‘documentation’, ‘homepage’, ‘issues’galaxy.yml optional field ‘license_file’ added. It’s value is a path
to a file containing additional license informationcollection artifacts file manifest info is now in the generated FILES.jsonMANIFEST.json now includes path and sha256sum of new generated FILES.jsonDependency solving version matching now supports the python-semanticversion style version specsFixes and improvements for install of local collection artifacts.
ie.mazer install my_namespace-my_collection-1.2.3.tar.gzUpdates to the use Galaxy REST v2 APIUpdates to how SPDX data is loaded and used.SPDX data updated to 3.4-59-ga68ef3c0.3.0 (2018-11-06)155 Implement install of things with dep solving (for trad roles and collections).142 Add support for init of a collection, and make it the default.139 Add ‘editable’ installs via ‘install -e’ (ala, ‘python setup.py develop’).138 Install role requirements.136 Support global content install option.135 For multi-content archive, install all content.133 Add MAZER_CONFIG environment var for specifying config file location.116 Add a ‘mazer build’ command to build collection artifacts.151 Fix install of sdx_licenses.json.132 Fix log directory creation before initializing logger. Support multiple locations for mazer.yml config.127 Refactor ansible_galaxy.flat_rest_api.content.126 Finish replacing core data objects with ‘attrs’ based classes.124 Fix unneeded –roles-path option for init and install commands by removing it.119 Fix “‘mazer list’ on multi-content repos looks for install_info in the wrong places”.0.2.1 (2018-08-08)Add ‘attrs’ dep to setup.py. Update requirements.txt
to use setup.py requires.Add the default logging config to Manifest.in so
logging is setup correctly on pip install.
Fixeshttps://github.com/ansible/mazer/issues/114Fix install if a role name is substring of another role.
Fixeshttps://github.com/ansible/mazer/issues/112Create and send a X-Request-ID on http requests.0.2.0 (2018-07-26)Support new
~/.ansible/content/namespace/reponame/content_type/content_name layoutCreate install receipts (.galaxy_install_info) on
install of repos and roles.‘list’ and ‘info’ commands updated.Now requires and uses ‘attrs’ python module >=18.1.00.1.0 (2018-04-18)First release on PyPI.