community.general.macports module – Package manager for MacPorts

Note

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

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)

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)