files

files.download(
    src,
    dest,
    user=None,
    group=None,
    mode=None,
    cache_time=None,
    force=False,
    sha256sum=None,
    headers=None,
    insecure=False,
)

files.put(
    src,
    dest,
    user=None,
    group=None,
    mode=None,
    add_deploy_dir=True,
    create_remote_dir=True,
    force=False,
)

files.template(
    src,
    dest,
    user=None,
    group=None,
    mode=None,
    create_remote_dir=True,
    **data
)

files.line(
    path,
    line,
    present=True,
    replace=None,
    flags=None,
    backup=False,
)

files.replace(
    path,
    text,
    replace,
    flags=None,
    backup=False,
)

files.sync(
    src,
    dest,
    user=None,
    group=None,
    mode=None,
    dir_mode=None,
    delete=False,
    exclude=None,
)

files.directory(
    path,
    present=True,
    user=None,
    group=None,
    mode=None,
    recursive=False,
)

files.file(
    path,
    present=True,
    user=None,
    group=None,
    mode=None,
    touch=False,
)

files.link(
    path,
    target=None,
    present=True,
    user=None,
    group=None,
    symbolic=True,
)

from pyinfra.operations import files

# Download a file
files.download(
    name="Download the Docker repo file",
    src="https://download.docker.com/linux/centos/docker-ce.repo",
    dest="/etc/yum.repos.d/docker-ce.repo",
)

# Upload a file
files.put(
    name="Update the message of the day file",
    src="files/motd",
    dest="/etc/motd",
    mode="644",
)

# Create a templated file
files.template(
    name="Create a templated file",
    src="templates/somefile.conf.j2",
    dest="/etc/somefile.conf",
)

# Ensure a line in a file
files.line(
    name="Add the down-for-maintenance line in /etc/motd",
    path="/etc/motd",
    line="SYSTEM IS DOWN FOR MAINTENANCE",
)

# Create a directory
files.directory(
    name="Ensure /opt/myapp exists",
    path="/opt/myapp",
    mode="755",
    user="www-data",
    group="www-data",
)