PyPI · #3655 most downloaded on PyPI

molecule

26.9.01.2M downloads/moansible/molecule ↗New releases in your daily digest, changelog included.

Molecule aids in the development and testing of Ansible roles

Last release 12 days ago
22 Sep 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
126 releases · first in 2017

Release timeline

126 releases since 2017

2017201920212023

Releases

3.2.416 Mar 2021
Add ansible-core version string parsing (#3068) @tadeboro
Changes

Bugfixes

Add ansible-core version string parsing (#3068) @tadeboro

Document use of newer toolset container image (#3059) @brianhelba
Open source →
3.2.329 Jan 2021
Assure image is included for containers driver #3040 @ssbarnea
Changes

Assure image is included for containers driver #3040 @ssbarnea
Open source →
3.2.28 Jan 2021
Fix base config default when not using vcs (#3030) @lebauce

3.2.119 Dec 2020

Extend run_command implementation (#3007) @ssbarnea

Changes

Minor Changes

Extend run_command implementation (#3007) @ssbarnea
Refactor logging (#3000) @tadeboro

Bugfixes

Refactored use of console for logging (#3013) @ssbarnea
Fix typos in docs (#3011) @0xflotus
Avoid using lock unless parallel mode is present (#3014) @ssbarnea
Narrow down dependency versions (#3015) @ssbarnea
Avoid use of property decorator for project_directory (#3006) @ssbarnea
Avoid misleading user about load of missing config (#3002) @ssbarnea
Acknowledge click 8.0 incompatibility (#3001) @ssbarnea
Assure provisioner logging is enabled by default (#2996) @ssbarnea

Open source →

3.2.0a120 Nov 2020pre-release

Refactored text functions out of util module (#2969) @ssbarnea

Changes

Major Changes

Refactored text functions out of util module (#2969) @ssbarnea
Remove molecule container building from core (#2935) @ssbarnea
Replace internal logger with rich logger (#2929) @ssbarnea

Minor Changes

Display each command as a collapsable section under CI (#2976) @cognifloyd
Refactor version printing (#2977) @ssbarnea
Refactor execute to use wrapper for logging (#2975) @ssbarnea
Adds ability to produce html reports (#2958) @ssbarnea
Remove debug message about schema validation (#2939) @ssbarnea
Improved styling of logging (#2938) @ssbarnea
Make use of internal run_command (#2937) @ssbarnea
Log matrix sequence as a single line (#2936) @ssbarnea
Display scenario and action on a single log line (#2934) @ssbarnea
Add verbosity argument (#2933) @ssbarnea
Improve coloring control (#2932) @ssbarnea
Removed use of colorama from debug printing (#2928) @ssbarnea
Move pexpect from a runtime dependency to test (#2921) @ssbarnea

Bugfixes

docs/getting-started.rst: Add missing argument to init role (#2986) @apatard
Remove mock as a dependency (#2985) @clickthisnick
Assure we install dataclasses on py36 (#2982) @ssbarnea
Consolidated use of rich console (#2980) @ssbarnea
Fix click ANSI support regression (#2979) @ssbarnea
Prevent Ansible args from leaking to create and destroy (#2966) @tadeboro
Switch from inventory file to directory for testinfra call (#2962) @amarao
Document toolset container (#2964) @ssbarnea
Improve output when Ansible is missing (#2956) @ssbarnea
Set ansible_ssh_pass with ansible_password because of a testinfra issue (#2927) @lmesz-bitrise
Use new testinfra package name (#2945) @ssbarnea
Prevent ansible from becoming a dependency (#2954) @ssbarnea
Fixed Manifest file (#2943) @ssbarnea
Fix indentation of example gitlab-ci configuration (#2940) @santiagoroman
Documentation: Remove extra empty line in Drivers section (#2941) @santiagoroman
Avoid duplicate stdout on playbook failures (#2930) @ssbarnea
Harden smoketest to avoid ansible becoming a python dependency (#2926) @ssbarnea
Removed run_command test helper (#2925) @ssbarnea

Deprecations

Moved more text functions to text module (#2983) @ssbarnea
Removed custom logger (#2978) @ssbarnea
Removed print_info from command base class (#2981) @ssbarnea

Open source →

3.1.420 Oct 2020

Replace tabulate with rich (#2906) @ssbarnea

Changes

Minor Changes

Replace tabulate with rich (#2906) @ssbarnea
Include driver information alongside version (#2900) @ssbarnea
Move molecule package under lib folder (#2899) @ssbarnea

Bugfixes

Run pip check at the end of container building (#2910) @ssbarnea
Remove hetznerdriver from container (#2908) @ssbarnea
Avoid building molecule container with version 0.0.0 (#2907) @ssbarnea
Reflect changes in the molecule core in the documentation (#2903) @fourstepper
Avoid using broken pip 2020-resolver (#2904) @ssbarnea

Open source →

3.1.115 Oct 2020

Remove molecule ansible filters (#2869) @ssbarnea

Changes

Major Changes

Remove molecule ansible filters (#2869) @ssbarnea
Remove support for gilt (#2814) @ssbarnea
Remove podman driver from core (#2812) @ssbarnea
Remove docker driver from core (#2811) @ssbarnea
Remove dependency on ansible library (#2805) @ssbarnea

Minor Changes

Enable py39 support (#2873) @ssbarnea
Include filename with validation failures (#2829) @ssbarnea

Bugfixes

Remove test dependency on external galaxy role (#2813) @ssbarnea
Update docs about .env.yml (#2803) @ssbarnea
Fixed linters (#2802) @ssbarnea
Add driver-name parameter to init_scenario test helper (#2798) @lod
Update docs to recommend docker:stable-dind (#2795) @fourstepper
Removed ansible plugin testing support (#2881) @ssbarnea
Allow external drivers to have their own embedded playbooks (#2879) @ssbarnea
Assured dependency installed collections are isolated (#2875) @ssbarnea
export DEBIAN_FRONTEND when building image (#2868) @hluaces
Fixed CustomLogger super call (#2849) @mattp-
Update molecule tag in examples.rst (#2848) @malodie
Remove unnecessary commands in ci docs (#2850) @aminvakil
Sort tests files for testinfra by filename (#2846) @atmaniak
Fixed build-containers (#2852) @ssbarnea
Added hint about current directory for "initialization" (#2842) @wouterj
Update ci.rst (#2830) @OyvindLGjesdal
Correct docstring for init role command class (#2826) @1efty
Correct GitHub Actions example (#2821) @sestrella

Deprecations

Removed ansible plugin testing support (#2881) @ssbarnea

Open source →

3.1.0a112 Oct 2020pre-release

Removed molecule ansible filters (#2869) @ssbarnea

Changes

Major Changes

Removed molecule ansible filters (#2869) @ssbarnea

Minor Changes

Enable py39 support (#2873) @ssbarnea
Include filename with validation failures (#2829) @ssbarnea

Bugfixes

Assured dependency installed collections are isolated (#2875) @ssbarnea
export DEBIAN_FRONTEND when building image (#2868) @hluaces
Fixed CustomLogger super call (#2849) @mattp-
Update molecule tag in examples.rst (#2848) @malodie
Remove unnecessary commands in ci docs (#2850) @aminvakil
Sort tests files for testinfra by filename (#2846) @atmaniak
Fixed build-containers (#2852) @ssbarnea
Added hint about current directory for "initialization" (#2842) @wouterj
Update ci.rst (#2830) @OyvindLGjesdal
Correct docstring for init role command class (#2826) @1efty
Correct GitHub Actions example (#2821) @sestrella

Open source →

3.0.717 Aug 2020

Passdown ANSIBLE_LIBRARY shell environment variable (#2754) @ssbarnea

Changes

Passdown ANSIBLE_LIBRARY shell environment variable (#2754) @ssbarnea
Remove hardcoded test files for docker and podman (#2728) @ssbarnea

Minor Changes

Add -f alias for --force on prepare command (#2767) @greg-hellings

Bugfixes

Add environment dict to lint calls (#2770) @greg-hellings
Avoid abridged click output (#2768) @ssbarnea
Removed default provisioner lint configuration (#2775) @anatolek
Document needed tweaks for podman-in-docker (#2762) @Yajo
Fix minor typo on examples.rst (#2760) @qoreQyaS
Remove custom callbacks from our tests (#2753) @ssbarnea
Remove universal wheel setting (#2752) @brianhelba

Open source →

3.0.614 Jul 2020Deprecated

Avoid failing tests due to docker deprecations (#2742) @ssbarnea

Changes

Clear the APT package index files in default test images (#2748) @brianhelba
Updated version packaging (#2741) @ssbarnea

Bugfixes

Make container building more reliable (#2749) @ssbarnea
Improve help text about base configuration loading (#2746) @evgeni
Enable isort (#2747) @ssbarnea
Correct ANSIBLE_COLLECTIONS_PATH (#2745) @ssbarnea
Avoid failing tests due to docker deprecations (#2742) @ssbarnea

Open source →

3.0.59 Jul 2020

Set correct default directory for tests (#2732) @jyoder-deloitte

Changes

Set correct default directory for tests (#2732) @jyoder-deloitte
Documentation cleanup (#2736) @ssbarnea
Allow configuration of docker_network in platforms (#2696) @actatux
Set DEBIAN_FRONTEND=noninteractive in the default Dockerfile (#2708) @JamesWrigley
podman: remove reference to "volumes" setting (#2699) @ktdreyer
Added second example for Sharing Across Scenarios (#2725) @seocam
Replace most centos:7 refereces with 8 (#2691) @ssbarnea
Remove py2 leftovers (#2695) @ssbarnea
Speed-up CI/CD on docs only changes (#2686) @ssbarnea

Minor Changes

Add mol command alias (#2737) @ssbarnea
Support root containers for podman (#2716) @sshnaidm
Add cgroup-manager storage-opt storage-driver to podman driver (#2715) @sshnaidm

Bugfixes

Adopt sphinx_ansible_theme (#2730) @ssbarnea
Add article how to use molecule and why (#2731) @ultral
Workaround pip editable install bug (#2729) @ssbarnea
Pass ansible_args to idempotence command (#2709) @liuyangc3
Clarify Docker bind-mount (#2701) @bradshjg
Treat warnings as errors during testing (#2685) @ssbarnea
Replace mailing list with github discussions (#2710) @ssbarnea
Fixes around ansible-devel testing (#2722) @ssbarnea
Update monolith-repo link in faq (#2706) @jokajak
docs: fix typos in examples (#2707) @jokajak
Remove use of distutils (#2608) @ssbarnea
Enable type checking using mypy (#2694) @ssbarnea
Fix issue with finding collections (#2690) @ericsysmin
docs: Dockerfile no longer created by default (#2689) @geerlingguy
Documentation refactoring (#2687) @ssbarnea
Document use of GitHub Actions with private repositories (#2688) @rgarrigue

Open source →

3.0.429 Apr 2020

Allow drivers to overwrite template (#2666) @nikParasyr

Changes

Minor Changes

Allow drivers to overwrite template (#2666) @nikParasyr
Add memory-swap to create docker driver (#2645) @ElfoLiNk

Bugfixes

Update pinned version for sh dependency (#2679) @robinmulder
Improve dependencies (#2663) @ssbarnea
docs: update python-libselinux to python3-libselinux EL8 (#2661) @jeffcpullen
Remove quick start stub and links from docs (#2644) @njvrzm
Fix formatting issue in galaxy requirements-file code block. (#2649) @geerlingguy

Open source →

3.0.38 Apr 2020

Make py36 minimal version needed for running molecule (#2628) @ssbarnea

Changes

Major Changes

Make py36 minimal version needed for running molecule (#2628) @ssbarnea
Removed --driver-template option (#2642) @ssbarnea

Minor Changes

Add support for memory and kernel_memory module parameters (#2615) @guerzon
Implemented reset for docker driver (#2639) @ssbarnea
Add support for collections as dependencies (#2609) @greg-hellings
Ansible 2.10 compatibility changes (#2620) @ssbarnea
Avoid ssh connection warnings (#2573) @ssbarnea

Bugfixes

Correct typo in collection argument roles-file -> role-file (#2640) @greg-hellings
Enable podman testing (#2632) @ssbarnea
Avoid errors with delegated create and destroy templates (#2623) @ssbarnea
Fix removal of ANSI control characters when PY_COLORS=0 (#2611) @kevingentile
Install Python 3 in non-RPM test images (#2577) @brianhelba
Inline RUN in Dockerfile to fix apk calls (#2582) @dduportal
Install rsync in Docker Image (#2584) @dduportal
Ensure testinfra is installed in Docker image (#2579) @brianhelba
added example for gitlab-ci using virtenv and tags, requested in issu… (#2634) @belfast77
Fix Getting Started docs as default verifier is now Ansible not testinfra (#2625) @matthewcosgrove
Update Gitlab CI example (#2627) @matthewcosgrove
Fix a missing ":" before the reference to "galaxy". (#2606) @shuuji3
Add missing spaces in gitlab-ci example (#2604) @ryandaniels
Suggest using python3 and pip3 in example docs (#2578) @brianhelba
set -e for Lint Example (#2575) @hswong3i
Fix container build (#2603) @ssbarnea
Fix dependency on pre-commit (#2601) @ssbarnea
Inline RUN in Dockerfile to fix apk calls (#2582) @dduportal
Install rsync in Docker Image (#2584) @dduportal

Open source →

3.0a917 Feb 2020pre-releaseDeprecated

Corrects playbook.yml deprecation message (#2559) @ssbarnea

Changes

Major Changes

Remove scenario name from molecule.yml (#2556) @ssbarnea

Minor Changes

Remove scenario name from molecule.yml (#2556) @ssbarnea
Mention container_default_behavior value (#2547) @ssbarnea
Implement reset command (#2544) @ssbarnea

Bugfixes

Corrects playbook.yml deprecation message (#2559) @ssbarnea
Fixes playbook to converge rename regressions (#2554) @ssbarnea
Avoid breaking pytest collection with testinfra (#2555) @ssbarnea
Assure verify step is not skipped with testinfra (#2545) @ssbarnea
Add missing dependencies to docker image (#2546) @ssbarnea
Fix converge to playbook rename fallback logic (#2542) @ssbarnea

Open source →

3.0a514 Jan 2020pre-release

Remove username (#2481) @decentral1se

Changes

Remove username (#2481) @decentral1se
docker: Add labels parameter in create (#2467) @jojo221119
Enabled GitHub Sponsorship (#2464) @ssbarnea
Removed ansible27 with py38 testing (#2452) @ssbarnea
Disable podman testing on MacOS (#2454) @ssbarnea
Remove GitHub Actions (#2443) @ssbarnea
Avoid adding UUID twice to platform in parallel mode (#2429) @tadeboro
Removed migration and vagrant driver (#2414) @ssbarnea

Major Changes

Switch Ansible support model to N/N-1 (#2487) @ssbarnea
Remove init template command (#2479) @ssbarnea
Use ansible-galaxy to create roles (#2342) @ssbarnea

Minor Changes

Disable DCO (#2416) @gundalow

Bugfixes

Remove anyconfig dependency (#2437) @tadeboro
updated docker_image buildargs with new format build.args (#2427) @Shaps
Fixed molecule init scenario (#2419) @ssbarnea
Fix wrong template path for drivers (#2417) @shortmann
Switch Ansible support model to N/N-1 (#2487) @ssbarnea
Clarify unprivileged docker user usage (#2465) @tpraxl
docs: avoid simplejson error (#2423) @ssbarnea
docs: fixed broken link to galaxy docs (#2428) @ssbarnea
docs: fix removed porting guide (#2422) @ssbarnea
New Ansible style docs layout (#2415) @decentral1se
Remove anyconfig dependency (#2437) @tadeboro
Fix wrong template path for drivers (#2417) @shortmann
Bump ansible-lint (#2418) @ssbarnea
Switch Ansible support model to N/N-1 (#2487) @ssbarnea
test: detect broken podman (#2483) @ssbarnea
test: prevent running functional tests when not installed (#2482) @ssbarnea
tests: use is_subset to validate loaded data (#2480) @ssbarnea
Avoid running docker tests with podman-docker (#2457) @ssbarnea
Remove --delegated pytest option (#2458) @ssbarnea
test: run destroy instead of full test command for templates (#2459) @ssbarnea
lint refresh (#2436) @ssbarnea
docs: fixed broken link to galaxy docs (#2428) @ssbarnea

Open source →

3.0a427 Oct 2019pre-releaseDeprecated

Disable deprecation warnings from own dependencies (#2289) @ssbarnea

Changes

Added support for internal CIDR (#2389) @jmpsf
Adds vpc_id to ec2_group, from subnet facts, and allows to specify SG ip cidr (#2405) @vinicyusmacedo
Moved linode driver to molecule-linode (#2402) @ssbarnea
Add podman functional tests (#2159) (#2323) @sshnaidm
Removed logical branch (#2355) (#2364) @houtd
Modify the type of winrm_server_cert_validation described in the docu… (#2339) @sky-joker
Disable galaxy role installation during testing (#2336) @ssbarnea
faq.rst: Add a couple of FAQ entries (#2325) @perlun
Dockerfile.j2: add python-apt aptitude packages for Debian-based distros (#2328) @perlun
Added missing space in delegated template (#2326) @ssbarnea
refactoring: inspec removed from core (#2303) @ssbarnea
refactoring: plugins can report their template dir (#2300) @ssbarnea
refactoring: removed remaining goss bits (#2299) @ssbarnea
Avoid futures SyntaxError (#2291) @ssbarnea
Migrate to new linode_v4 module (#2276) @decentral1se
verifier: goss removed (#2298) @ssbarnea
refactoring: each verifier to expose its own schema (#2294) @ssbarnea
deps: remove pinning of anyconfig (#2296) @ssbarnea
Fix auto-completion of choices (#2295) @ssbarnea
deps: refresh click dependencies (#2297) @ssbarnea
refactoring: verifiers should expose their own linters (#2292) @ssbarnea
refactoring: driver listing (#2281) @ssbarnea
Disable deprecation warnings from own dependencies (#2289) @ssbarnea
Pass merged configuration to provisioner playbooks (#2287) @tadeboro
refactoring: transformed verifiers into plugins (#2288) @ssbarnea
refactoring: rename api.molecule_drivers to api.drivers (#2286) @ssbarnea
refactoring: driver.base.Base -> api.Driver (#2285) @ssbarnea
drivers: refactored sanity_check (#2284) @ssbarnea
Improve new issue templates (#2283) @ssbarnea
Informs of the DOCKER_HOST environment variable with the Docker driver. (#2265) @flowgunso
Clean up CODEOWNERS file (#2273) @decentral1se
Refactor "role:" block in cookiecutter template (#2280) @mjlshen
ec2: per-platform ansible_connection overrides and win password lookup (#2271) @troyready
Add note about collections for now (#2274) @decentral1se
fix(provisioner): Expand ANSIBLE_ variables with Ansible default locations (#2258) @wilmardo
Use pluggy to load plugins (#2272) @decentral1se
Do not prune when --destroy=never (#2270) @seandst
fix(tox.ini): Adds pyup ignore for packaging (#2269) @wilmardo
Resolve pytest deprecation warnings (#2263) @ssbarnea
Removal of embedded azure driver (#2252) @ssbarnea
Bash style variable expension in env var supports defaults using variables (#2223) @wilmardo

Major Changes

Moved openstack driver to molecule-openstack (#2413) @ssbarnea
Moved ec2 driver to molecule-ec2 (#2407) @ssbarnea
Moved gce driver to molecule-gce (#2406) @ssbarnea
Moved linode driver to molecule-linode (#2403) @ssbarnea
Moved digitalocean driver to molecule-digitalocean (#2401) @ssbarnea
Remove Hetzner Cloud driver from core (#2391) @decentral1se
Fixed typo on OVERRIDEN (#2338) @ssbarnea
Removed LXC and LXD providers (#2329) @ssbarnea
Adopts Ansible 2.9 as supported (#2301) @ssbarnea

Minor Changes

docker: add support for devices (#2308) @sprat

Minor Changes

ec2 provider: Add support for specifying ssh keypair (#2390) @jmpsf
Added instance_profile_name to ec2 driver (#2370) @vinicyusmacedo
fix deprecation in generated code for hetznercloud driver (#2365) @zauberpony
Remove use of future (#2372) @ssbarnea
Make default Dockerfile embedded (#2360) @ssbarnea
Fixing #1556 VERR_ACCESS_DENIED (#1600) @jonashackt
Fixed typo in tests init.py (#2306) @ssbarnea
Cache loaded drivers and adopt lru_cache (#2259) @ssbarnea

Bugfixes

Podman driver shouldn't define /sys/fs/cgroup vol (#2358) @maxamillion
Correct python package installation on Dockerfiles (#2362) @ssbarnea
tests: require minimal ansible 2.9 for podman (#2337) @ssbarnea
Add podman driver to cookiecutter (#2335) @sshnaidm
Makes driver loading more resilient (#2253) @ssbarnea

Bugfixes

Use sphinx_rtd_theme instead of alabaster (#2410) @decentral1se
Clean up outdated docs (#2411) @decentral1se
Point to travis-ci.com in docs (#2395) @gliptak
Add release drafter config file (#2378) @ssbarnea
Add note about random instance IDs (#2377) @decentral1se
Enable release drafter (#2367) @ssbarnea
Added 2.22 entry to CHANGELOG.rst (#2275) (#2363) @houtd
Update broken links on examples doc (#2346) @manics
Add quick note on how to get started (#2361) @decentral1se

Bugfixes

Moved openstack driver to molecule-openstack (#2413) @ssbarnea
Moved ec2 driver to molecule-ec2 (#2407) @ssbarnea
Moved gce driver to molecule-gce (#2406) @ssbarnea
Moved linode driver to molecule-linode (#2403) @ssbarnea
Moved digitalocean driver to molecule-digitalocean (#2401) @ssbarnea
Reverts setuptools workaround (#2384) @ssbarnea
Fix packaging (#2381) @bristea
Bump tabulate (#2330) @ssbarnea
Fix version parsing error with Ansible prereleases (#2327) @ssbarnea

Bugfixes

Fixed linters (#2412) @ssbarnea
test: move default environment variables (#2397) @ssbarnea
test: implement workaround for galaxy-install 401 errors (#2398) @ssbarnea
Include registry in default base test images (#2394) @ssbarnea
Run unit tests against Python 3.8 (#2392) @decentral1se
Made base image fully configurable (#2385) @ssbarnea
Implement tox setup idempotency test (#2382) @ssbarnea
Enable testing of dockerfile template (#2368) @ssbarnea
Test ansible 2.9 from stable-2.9 (#2371) @ssbarnea
Bumped linting (#2369) @ssbarnea
Focus on CentOS 7 for CI testing (#2354) @decentral1se
Ignore Twine pyup upgrades for now (#2353) @decentral1se
Temporarily limit setuptools version (#2351) @decentral1se
Scheduled weekly dependency update for week 36 (#2277) @pyup-bot
travis: switch to 2 shards instead of 3 (#2255) @ssbarnea

Deprecations

Removed LXC and LXD providers (#2329) @ssbarnea

Open source →

2.2219 Aug 2019

molecule dependency now has a retry and timed back-off by default for flaky network connections.

molecule dependency now has a retry and timed back-off by default for flaky network connections.
Add the --parallel flag to experimentally allow molecule to be run in parallel.
dependency step is now run by default before any playbook sequence step, including create and destroy. This allows the use of roles in all sequence step playbooks.
Removed validation regex for docker registry passwords, all string values are now valid.
Add tty option to the Docker driver.
Specify new lower bound of 3.0.2 for testinfra which uses the new Ansible test runner.
Place upper bounds on inspec and rubocop for CI testing.
Support pruning of docker volumes in 'destroy' phase for docker driver
Update Goss to 0.3.7
Add SSH password to delegated driver instance_dict
Add WinRM connections options to delegated driver instance_dict
Update testinfra to 3.0.6 so we can use ansible verbosity
Add sysctls option to the Docker driver.

Open source →

2.22rc16 Jun 2019pre-release

Pass etc_hosts through to docker_container module

Added docker-machine support
Pass etc_hosts through to docker_container module
Fixed dependency gem for rubocop
Use selinux shim library for testing
Bumbed multiple requirements
Add ansible_args support back to converge command
Fix Deprecations
Support pruning of docker volumes in 'destroy' phase
CI Fixes for ansible 2.8
Other minor fixes

Open source →