v1.2

Lots of smaller bits in this release and massive improvement to the documentation.

Operation & fact updates:

• Deprecate init.* operations, renamed to: systemd.service, upstart.service, launchd.service, bsdinit.service, sysvinit.service, sysvinit.enable, server.service
• Add systemd.daemon_reload operation
• Add files.rsync operation
• Add port and user arguments to all ssh.* operations
• Add apt_keys fact and use in apt.key operation
• Add GPG facts: gkg_key, gpg_keys and gpg_secret_keys
• Add additional_ips in network_devices fact
• Add ipv4_addrs and ipv6_addrs facts to replace ipv[46]_addresses
• Add linux_gui & has_gui facts

Other bits:

• Add global chdir, preserve_su_env and su_shell arguments
• Add Config.REQUIRE_PACKAGES to check requirements befor execution
• Add host_before_connect and host_connect_error state callback methods
• Support multiple --limit CLI arguments
• Allow passing an integer in files.replace replacement lines (@vindarel)
• Use curl if wget not present in apt.key operation
• Completely remove use of use_default_on_error in facts
• Many updates/tweaks to documentation + theme
• Allow functions in/as group/host data (CLI)
• Implement/use Angolia docsearch on documentation

v1.1.2

• Add port=22 argument to the ssh.keyscan operation
• Add extra_install_args argument to the pip.packages operation
• Support uninstalling a requirements file in the pip.packages operation
• Use state in files.replace operation, enabling noop support where appropriate
• Add a warning when using use_su_login
• Fix parsing stat output when groups contain spaces (file, directory, link facts)
• Fix minimum gevent version (@alexandervdm)

v1.1.1

• Don't fail for user error facts when the user will be added earlier in the deploy
• Support shasum command in files.download operation
• Consider waiting systemd units to be running (@i-do-cpp)
• Improve regex for systemd units (support ones with .) (@i-do-cpp)
• Fix sudo passwords with special characters (@sysadmin75)
• Fix typo in host arg warning (@weakish)

v1.1

This is a big release with some major additions & improvements on v1.

Highlights:

• Start modifying facts during fact gathering phase, resolving common issues with interdependent operations, expand documentation on this (docs)
• Implement state callback classes dramatically improving the API experience (see examples/api_deploy.py)
• Add @dockerssh connector that enables pyinfra to build Docker containers on remote machines over SSH (@charles-l)
• Add global precondition and postcondition operation arguments
• Fix using su_user on BSD/MacOS systems
• Rework verbosity flags and add noop logging (ie package X is already installed) (docs)

Notable change:

The yum.packages and dnf.packages operations have changed their "version join" string value - both package managers use - to join name + version while allowing - in the name. This leads to ambiguous behaviour for packages containing dashes, as such the version join value has been changed to = - meaning it can now actually be used! This means to specify a specific version of a yum/dnf package you should use <name>=<version> rather than <name>-<version>.

Smaller bits:

• Add REQUIRE_PYINFRA_VERSION config option (& deprecate MIN_PYINFRA_VERSION)
• Validate existing files in file.download with checksum arguments (@sysadmin75)
• Stop stripping fact output (fixes command fact, @sysadmin75)
• Add extra_install_args and extra_uninstall_args kwargs to apt.packages operation
• Add --use-sudo-password CLI argument
• Normalise server.sysctl handling of string/int values
• Improve autocomplete/intellisense handling of pseudo modules pyinfra.[host|state|inventory]
• Fix using sudo password with a SSH user that doesn't have access to /tmp
• Fix python.call docstring (@leahneukirchen)
• Fix --serial and --no-wait executing operations twice
• Fix server.sysctl usage with multiple values

v1.0.4

• Add selinux fact (@FooBarQuaxx)
• Improve/fix rpm_packages fact parsing (@FooBarQuaxx)
• Stop showing arguments on operations with names

v1.0.3

• Reimplement file/directory/link facts using stat
  • No breaking changes
  • Adds ctime and atime to the output dictionary
• Add backup argument to the files.line and files.replace operations
• Add SimpleNamespace to the list of allowed data types
• Don't fail when the destination directory is a symlink in the files.sync operation
• Fix running the same fact in CLI w/different arguments
• Add local integration tests that check idempotency (of files operations only for now)

v1.0.2

• Further improve fact output when errors are encountered
  • Will now output stdout + stderr when a fact command fails unexpectedly
  • This brings the same instant debugging feel to facts that operations have
• Fix wget failure handling in files.download operation (@artizirk)
• Improve files facts handling when file/directory/link does not exist

v1.0.1

• Log host fact errors/warnings
• Switch to distro package for linux_distribution fact (@FooBarQuaxx)
• Expand support for os.PathLike path variables (@FooBarQuaxx)
• Improve checking state/host presence when calling operations (@FooBarQuaxx)
• Don't error in sha1_file fact when no file exists

v1.0

The first 1.x release!

This release deprecates a lot of old/legacy pyinfra code and brings fourth a new, stable API. So long as you see no warnings when executing pyinfra, upgrading should require no chanages.

What's new:

• Add new global name argument to name operations (deprecate set as the first argument)
• Improve unexpected fact error handling, bad exit codes will be treated as errors unless the fact explicitly expects this could happen (system package managers for example)
• [CLI] write progress/user info/logs to stderr only
• [API] Consistent ordering when add_op and add_deploy functions
• [API] Return a dictionary of host -> OperationMeta when using add_op
• Enable passing a list of modules to server.modprobe (@FooBarQuaxx)
• Support Path objects in files.[file|directory|link] operations
• Support shasum (MacOS) in sha1_file fact

Breaking changes:

• Deprecate using set as the first/name argument for operations
• Rename files.* arguments (name -> path, destination -> dest)
• Rename server.* arguments (name -> user|group|cron_name|key|path, filename -> src)
• Rename mysql.* + postgresql.* arguments (name -> user|database|role)
• Rename init.* arguments (name -> service)
• Rename lxd.container argument name -> id
• Rename git.repo argumenets source -> src & target -> dest
• Rename iptables.chain argument name -> chain
• Rename python.call argument func -> function
• Rename size -> mask_bits inside network_devices fact
• Change default of interpolate_variables from True -> False
• Remove deprecatedhosts/when/op global operation arguments
• Rename reprecated Config.TIMEOUT -> Config.CONNECT_TIMEOUT
• Remove deprecated use_ssh_user argument from git.repo operation
• Remove deprecated python.execute operation
• Remove deprecated Inventory.<__getitem__> & Inventory.<__getattr__> methods
• Remove deprecated add_limited_op function
• Remove deprecated legacy CLI support

v0.16.2

• Add special_time argument to server.crontab operation
• Support public key filenames in server.user
• Support BusyBox style ls time formats for file/directory/link facts
• Fix uninstalling packages with pip.packages (@FooBarQuaxx)
• Fix compatibility with older gevent versions
• Fix typo in deploys doc (@harold-b)