community.general.macports module – Package manager for MacPorts

Note

This module is part of the community.general collection (version 7.5.2).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.macports.

Synopsis

  • Manages MacPorts packages (ports)

Aliases: packaging.os.macports

Parameters

Parameter

Comments

name

aliases: port

list / elements=string

A list of port names.

selfupdate

aliases: update_cache, update_ports

boolean

Update Macports and the ports tree, either prior to installing ports or as a separate step.

Equivalent to running port selfupdate.

Choices:

  • false ← (default)

  • true

state

string

Indicates the desired state of the port.

Choices:

  • "present" ← (default)

  • "absent"

  • "active"

  • "inactive"

  • "installed"

  • "removed"

upgrade

boolean

Upgrade all outdated ports, either prior to installing ports or as a separate step.

Equivalent to running port upgrade outdated.

Choices:

  • false ← (default)

  • true

variant

aliases: variants

string

A port variant specification.

variant is only supported with state=installed and state=present.

Attributes

Attribute

Support

Description

check_mode

Support: none

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Examples

- name: Install the foo port
  community.general.macports:
    name: foo

- name: Install the universal, x11 variant of the foo port
  community.general.macports:
    name: foo
    variant: +universal+x11

- name: Install a list of ports
  community.general.macports:
    name: "{{ ports }}"
  vars:
    ports:
    - foo
    - foo-tools

- name: Update Macports and the ports tree, then upgrade all outdated ports
  community.general.macports:
    selfupdate: true
    upgrade: true

- name: Update Macports and the ports tree, then install the foo port
  community.general.macports:
    name: foo
    selfupdate: true

- name: Remove the foo port
  community.general.macports:
    name: foo
    state: absent

- name: Activate the foo port
  community.general.macports:
    name: foo
    state: active

- name: Deactivate the foo port
  community.general.macports:
    name: foo
    state: inactive

Authors

  • Jimmy Tang (@jcftang)