Compare commits
No commits in common. "master" and "feature/folders" have entirely different histories.
master
...
feature/fo
|
|
@ -1,381 +0,0 @@
|
||||||
#!/usr/bin/python
|
|
||||||
# -*- coding: utf-8 -*-
|
|
||||||
|
|
||||||
# Copyright: (c) 2018, Rafael Bodill <justrafi at google mail>
|
|
||||||
# Copyright: (c) 2020, Borjan Tchakaloff <first name at last name dot fr>
|
|
||||||
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
||||||
|
|
||||||
ANSIBLE_METADATA = {
|
|
||||||
'metadata_version': '1.1',
|
|
||||||
'status': ['preview'],
|
|
||||||
'supported_by': 'community'
|
|
||||||
}
|
|
||||||
|
|
||||||
DOCUMENTATION = '''
|
|
||||||
---
|
|
||||||
module: folder_defaults
|
|
||||||
|
|
||||||
short_description: Manage Syncthing folder default configurations
|
|
||||||
|
|
||||||
version_added: "2.7"
|
|
||||||
|
|
||||||
description:
|
|
||||||
- "This module allows you to manage Syncthing folder default configurations.
|
|
||||||
You can update the default configurations using this module.
|
|
||||||
It uses the Syncthing REST API to perform these operations."
|
|
||||||
|
|
||||||
options:
|
|
||||||
id:
|
|
||||||
description:
|
|
||||||
- The ID of the module.
|
|
||||||
type: str
|
|
||||||
required: false
|
|
||||||
label:
|
|
||||||
description:
|
|
||||||
- The label for the module.
|
|
||||||
type: str
|
|
||||||
required: false
|
|
||||||
filesystemType:
|
|
||||||
description:
|
|
||||||
- The filesystem type for the module.
|
|
||||||
type: str
|
|
||||||
required: false
|
|
||||||
default: basic
|
|
||||||
path:
|
|
||||||
description:
|
|
||||||
- The path for the module.
|
|
||||||
type: str
|
|
||||||
required: false
|
|
||||||
default: ~
|
|
||||||
type:
|
|
||||||
description:
|
|
||||||
- The type of the module.
|
|
||||||
type: str
|
|
||||||
required: false
|
|
||||||
default: sendreceive
|
|
||||||
choices: [sendreceive, sendonly, receiveonly]
|
|
||||||
devices:
|
|
||||||
description:
|
|
||||||
- List of devices for the module.
|
|
||||||
type: list
|
|
||||||
required: false
|
|
||||||
default: []
|
|
||||||
rescanIntervalS:
|
|
||||||
description:
|
|
||||||
- The rescan interval for the module in seconds.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 3600
|
|
||||||
fsWatcherEnabled:
|
|
||||||
description:
|
|
||||||
- Whether the filesystem watcher is enabled for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: true
|
|
||||||
fsWatcherDelayS:
|
|
||||||
description:
|
|
||||||
- The filesystem watcher delay for the module in seconds.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 10
|
|
||||||
ignorePerms:
|
|
||||||
description:
|
|
||||||
- Whether to ignore permissions for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
autoNormalize:
|
|
||||||
description:
|
|
||||||
- Whether to automatically normalize for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: true
|
|
||||||
minDiskFree:
|
|
||||||
description:
|
|
||||||
- The minimum disk free for the module.
|
|
||||||
type: dict
|
|
||||||
required: false
|
|
||||||
default: {value: 1, unit: '%'}
|
|
||||||
versioning:
|
|
||||||
description:
|
|
||||||
- The versioning for the module.
|
|
||||||
type: dict
|
|
||||||
required: false
|
|
||||||
default: {type: '', params: {}, cleanupIntervalS: 3600, fsPath: '', fsType: 'basic'}
|
|
||||||
copiers:
|
|
||||||
description:
|
|
||||||
- The number of copiers for the module.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 0
|
|
||||||
pullerMaxPendingKiB:
|
|
||||||
description:
|
|
||||||
- The maximum pending puller size for the module in KiB.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 0
|
|
||||||
hashers:
|
|
||||||
description:
|
|
||||||
- The number of hashers for the module.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 0
|
|
||||||
order:
|
|
||||||
description:
|
|
||||||
- The order for the module.
|
|
||||||
type: str
|
|
||||||
required: false
|
|
||||||
default: random
|
|
||||||
ignoreDelete:
|
|
||||||
description:
|
|
||||||
- Whether to ignore delete for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
scanProgressIntervalS:
|
|
||||||
description:
|
|
||||||
- The scan progress interval for the module in seconds.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 0
|
|
||||||
pullerPauseS:
|
|
||||||
description:
|
|
||||||
- The puller pause for the module in seconds.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 0
|
|
||||||
maxConflicts:
|
|
||||||
description:
|
|
||||||
- The maximum number of conflicts for the module.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 10
|
|
||||||
disableSparseFiles:
|
|
||||||
description:
|
|
||||||
- Whether to disable sparse files for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
disableTempIndexes:
|
|
||||||
description:
|
|
||||||
- Whether to disable temporary indexes for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
paused:
|
|
||||||
description:
|
|
||||||
- Whether the module is paused.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
weakHashThresholdPct:
|
|
||||||
description:
|
|
||||||
- The weak hash threshold for the module in percentage.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 25
|
|
||||||
markerName:
|
|
||||||
description:
|
|
||||||
- The marker name for the module.
|
|
||||||
type: str
|
|
||||||
required: false
|
|
||||||
default: .stfolder
|
|
||||||
copyOwnershipFromParent:
|
|
||||||
description:
|
|
||||||
- Whether to copy ownership from parent for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
modTimeWindowS:
|
|
||||||
description:
|
|
||||||
- The modification time window for the module in seconds.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 0
|
|
||||||
maxConcurrentWrites:
|
|
||||||
description:
|
|
||||||
- The maximum number of concurrent writes for the module.
|
|
||||||
type: int
|
|
||||||
required: false
|
|
||||||
default: 2
|
|
||||||
disableFsync:
|
|
||||||
description:
|
|
||||||
- Whether to disable fsync for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
blockPullOrder:
|
|
||||||
description:
|
|
||||||
- The block pull order for the module.
|
|
||||||
type: str
|
|
||||||
required: false
|
|
||||||
default: standard
|
|
||||||
copyRangeMethod:
|
|
||||||
description:
|
|
||||||
- The copy range method for the module.
|
|
||||||
type: str
|
|
||||||
required: false
|
|
||||||
default: standard
|
|
||||||
caseSensitiveFS:
|
|
||||||
description:
|
|
||||||
- Whether the filesystem is case sensitive for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
junctionsAsDirs:
|
|
||||||
description:
|
|
||||||
- Whether to treat junctions as directories for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
syncOwnership:
|
|
||||||
description:
|
|
||||||
- Whether to synchronize ownership for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
sendOwnership:
|
|
||||||
description:
|
|
||||||
- Whether to send ownership for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
syncXattrs:
|
|
||||||
description:
|
|
||||||
- Whether to synchronize extended attributes for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
sendXattrs:
|
|
||||||
description:
|
|
||||||
- Whether to send extended attributes for the module.
|
|
||||||
type: bool
|
|
||||||
required: false
|
|
||||||
default: false
|
|
||||||
xattrFilter:
|
|
||||||
description:
|
|
||||||
- The extended attribute filter for the module.
|
|
||||||
type: dict
|
|
||||||
required: false
|
|
||||||
default: {entries: [], maxSingleEntrySize: 1024, maxTotalSize: 4096}
|
|
||||||
|
|
||||||
author:
|
|
||||||
- Rafael Bodill (@rafi)
|
|
||||||
'''
|
|
||||||
|
|
||||||
EXAMPLES = '''
|
|
||||||
# Get/Update folder_defaults
|
|
||||||
- name: Get folder_defaults
|
|
||||||
become: yes
|
|
||||||
become_user: syncthing
|
|
||||||
community.syncthing.folder_defaults:
|
|
||||||
host: http://localhost
|
|
||||||
unix_socket: /run/syncthing/syncthing.sock
|
|
||||||
config_file: /var/lib/syncthing/.config/syncthing/config.xml
|
|
||||||
id: "default"
|
|
||||||
label: "default"
|
|
||||||
path: "/"
|
|
||||||
paused: false
|
|
||||||
register: folder_defaults
|
|
||||||
'''
|
|
||||||
|
|
||||||
RETURN = '''
|
|
||||||
folder_defaults:
|
|
||||||
description: The default configuration of the folder after the operation.
|
|
||||||
type: dict
|
|
||||||
changed:
|
|
||||||
description: Whether any changes were made.
|
|
||||||
type: bool
|
|
||||||
response:
|
|
||||||
description: The API response, in-case of an error.
|
|
||||||
type: dict
|
|
||||||
'''
|
|
||||||
|
|
||||||
from ansible_collections.community.syncthing.plugins.module_utils.syncthing_api import SyncthingModule
|
|
||||||
import json
|
|
||||||
|
|
||||||
def deep_equal(a, b):
|
|
||||||
return json.dumps(a, sort_keys=True) == json.dumps(b, sort_keys=True)
|
|
||||||
|
|
||||||
def run_module():
|
|
||||||
module_args = dict(
|
|
||||||
id=dict(type='str', required=False),
|
|
||||||
label=dict(type='str', required=False),
|
|
||||||
filesystemType=dict(type='str', required=False, default='basic'),
|
|
||||||
path=dict(type='str', required=False, default='~'),
|
|
||||||
type=dict(type='str', default='sendreceive',
|
|
||||||
choices=['sendreceive', 'sendonly', 'receiveonly']),
|
|
||||||
devices=dict(type='list', required=False, default=[]),
|
|
||||||
rescanIntervalS=dict(type='int', required=False, default=3600),
|
|
||||||
fsWatcherEnabled=dict(type='bool', required=False, default=True),
|
|
||||||
fsWatcherDelayS=dict(type='int', required=False, default=10),
|
|
||||||
ignorePerms=dict(type='bool', required=False, default=False),
|
|
||||||
autoNormalize=dict(type='bool', required=False, default=True),
|
|
||||||
minDiskFree=dict(type='dict', required=False, default=dict(value=1, unit='%')),
|
|
||||||
versioning=dict(type='dict', required=False,
|
|
||||||
default=dict(type='', params={}, cleanupIntervalS=3600, fsPath='', fsType='basic')),
|
|
||||||
copiers=dict(type='int', required=False, default=0),
|
|
||||||
pullerMaxPendingKiB=dict(type='int', required=False, default=0),
|
|
||||||
hashers=dict(type='int', required=False, default=0),
|
|
||||||
order=dict(type='str', required=False, default='random'),
|
|
||||||
ignoreDelete=dict(type='bool', required=False, default=False),
|
|
||||||
scanProgressIntervalS=dict(type='int', required=False, default=0),
|
|
||||||
pullerPauseS=dict(type='int', required=False, default=0),
|
|
||||||
maxConflicts=dict(type='int', required=False, default=10),
|
|
||||||
disableSparseFiles=dict(type='bool', required=False, default=False),
|
|
||||||
disableTempIndexes=dict(type='bool', required=False, default=False),
|
|
||||||
paused=dict(type='bool', required=False, default=False),
|
|
||||||
weakHashThresholdPct=dict(type='int', required=False, default=25),
|
|
||||||
markerName=dict(type='str', required=False, default='.stfolder'),
|
|
||||||
copyOwnershipFromParent=dict(type='bool', required=False, default=False),
|
|
||||||
modTimeWindowS=dict(type='int', required=False, default=0),
|
|
||||||
maxConcurrentWrites=dict(type='int', required=False, default=2),
|
|
||||||
disableFsync=dict(type='bool', required=False, default=False),
|
|
||||||
blockPullOrder=dict(type='str', required=False, default='standard'),
|
|
||||||
copyRangeMethod=dict(type='str', required=False, default='standard'),
|
|
||||||
caseSensitiveFS=dict(type='bool', required=False, default=False),
|
|
||||||
junctionsAsDirs=dict(type='bool', required=False, default=False),
|
|
||||||
syncOwnership=dict(type='bool', required=False, default=False),
|
|
||||||
sendOwnership=dict(type='bool', required=False, default=False),
|
|
||||||
syncXattrs=dict(type='bool', required=False, default=False),
|
|
||||||
sendXattrs=dict(type='bool', required=False, default=False),
|
|
||||||
xattrFilter=dict(type='dict', required=False,
|
|
||||||
default=dict(entries=[], maxSingleEntrySize=1024, maxTotalSize=4096)),
|
|
||||||
)
|
|
||||||
|
|
||||||
module = SyncthingModule(
|
|
||||||
api_url='/rest/config/defaults/folder',
|
|
||||||
argument_spec=module_args,
|
|
||||||
)
|
|
||||||
|
|
||||||
current_config = module.get_call()
|
|
||||||
|
|
||||||
module_args_keys_list = list(module_args.keys())
|
|
||||||
|
|
||||||
changes = {}
|
|
||||||
|
|
||||||
for key, value in module.params.items():
|
|
||||||
# Check if the key is in module_args_keys_list
|
|
||||||
if key in module_args_keys_list:
|
|
||||||
# Check if the value is not None
|
|
||||||
if value is not None:
|
|
||||||
# Check if the value is different from the current_config
|
|
||||||
if not deep_equal(value, current_config.get(key)):
|
|
||||||
# If all conditions are met, add the key-value pair to changes
|
|
||||||
changes[key] = value
|
|
||||||
|
|
||||||
if module.check_mode or len(changes.keys()) == 0:
|
|
||||||
module.result['folder_defaults'] = current_config
|
|
||||||
module.exit_json()
|
|
||||||
|
|
||||||
module.patch_call(data=module.params)
|
|
||||||
module.result['folder_defaults'] = module.get_call()
|
|
||||||
module.result['changed'] = True
|
|
||||||
module.result['changes'] = changes
|
|
||||||
module.exit_json()
|
|
||||||
|
|
||||||
def main():
|
|
||||||
run_module()
|
|
||||||
|
|
||||||
if __name__ == '__main__':
|
|
||||||
main()
|
|
||||||
Loading…
Reference in New Issue
Block a user