test_create.py 33 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859
  1. import logging
  2. from flexmock import flexmock
  3. from borgmatic.borg import create as module
  4. from ..test_verbosity import insert_logging_mock
  5. def test_expand_directory_with_basic_path_passes_it_through():
  6. flexmock(module.os.path).should_receive('expanduser').and_return('foo')
  7. flexmock(module.glob).should_receive('glob').and_return([])
  8. paths = module._expand_directory('foo')
  9. assert paths == ['foo']
  10. def test_expand_directory_with_glob_expands():
  11. flexmock(module.os.path).should_receive('expanduser').and_return('foo*')
  12. flexmock(module.glob).should_receive('glob').and_return(['foo', 'food'])
  13. paths = module._expand_directory('foo*')
  14. assert paths == ['foo', 'food']
  15. def test_expand_directories_flattens_expanded_directories():
  16. flexmock(module).should_receive('_expand_directory').with_args('~/foo').and_return(
  17. ['/root/foo']
  18. )
  19. flexmock(module).should_receive('_expand_directory').with_args('bar*').and_return(
  20. ['bar', 'barf']
  21. )
  22. paths = module._expand_directories(('~/foo', 'bar*'))
  23. assert paths == ('/root/foo', 'bar', 'barf')
  24. def test_expand_directories_considers_none_as_no_directories():
  25. paths = module._expand_directories(None)
  26. assert paths == ()
  27. def test_expand_home_directories_expands_tildes():
  28. flexmock(module.os.path).should_receive('expanduser').with_args('~/bar').and_return('/foo/bar')
  29. flexmock(module.os.path).should_receive('expanduser').with_args('baz').and_return('baz')
  30. paths = module._expand_home_directories(('~/bar', 'baz'))
  31. assert paths == ('/foo/bar', 'baz')
  32. def test_expand_home_directories_considers_none_as_no_directories():
  33. paths = module._expand_home_directories(None)
  34. assert paths == ()
  35. def test_write_pattern_file_does_not_raise():
  36. temporary_file = flexmock(name='filename', write=lambda mode: None, flush=lambda: None)
  37. flexmock(module.tempfile).should_receive('NamedTemporaryFile').and_return(temporary_file)
  38. module._write_pattern_file(['exclude'])
  39. def test_write_pattern_file_with_empty_exclude_patterns_does_not_raise():
  40. module._write_pattern_file([])
  41. def test_make_pattern_flags_includes_pattern_filename_when_given():
  42. pattern_flags = module._make_pattern_flags(
  43. location_config={'patterns': ['R /', '- /var']}, pattern_filename='/tmp/patterns'
  44. )
  45. assert pattern_flags == ('--patterns-from', '/tmp/patterns')
  46. def test_make_pattern_flags_includes_patterns_from_filenames_when_in_config():
  47. pattern_flags = module._make_pattern_flags(
  48. location_config={'patterns_from': ['patterns', 'other']}
  49. )
  50. assert pattern_flags == ('--patterns-from', 'patterns', '--patterns-from', 'other')
  51. def test_make_pattern_flags_includes_both_filenames_when_patterns_given_and_patterns_from_in_config():
  52. pattern_flags = module._make_pattern_flags(
  53. location_config={'patterns_from': ['patterns']}, pattern_filename='/tmp/patterns'
  54. )
  55. assert pattern_flags == ('--patterns-from', 'patterns', '--patterns-from', '/tmp/patterns')
  56. def test_make_pattern_flags_considers_none_patterns_from_filenames_as_empty():
  57. pattern_flags = module._make_pattern_flags(location_config={'patterns_from': None})
  58. assert pattern_flags == ()
  59. def test_make_exclude_flags_includes_exclude_patterns_filename_when_given():
  60. exclude_flags = module._make_exclude_flags(
  61. location_config={'exclude_patterns': ['*.pyc', '/var']}, exclude_filename='/tmp/excludes'
  62. )
  63. assert exclude_flags == ('--exclude-from', '/tmp/excludes')
  64. def test_make_exclude_flags_includes_exclude_from_filenames_when_in_config():
  65. exclude_flags = module._make_exclude_flags(
  66. location_config={'exclude_from': ['excludes', 'other']}
  67. )
  68. assert exclude_flags == ('--exclude-from', 'excludes', '--exclude-from', 'other')
  69. def test_make_exclude_flags_includes_both_filenames_when_patterns_given_and_exclude_from_in_config():
  70. exclude_flags = module._make_exclude_flags(
  71. location_config={'exclude_from': ['excludes']}, exclude_filename='/tmp/excludes'
  72. )
  73. assert exclude_flags == ('--exclude-from', 'excludes', '--exclude-from', '/tmp/excludes')
  74. def test_make_exclude_flags_considers_none_exclude_from_filenames_as_empty():
  75. exclude_flags = module._make_exclude_flags(location_config={'exclude_from': None})
  76. assert exclude_flags == ()
  77. def test_make_exclude_flags_includes_exclude_caches_when_true_in_config():
  78. exclude_flags = module._make_exclude_flags(location_config={'exclude_caches': True})
  79. assert exclude_flags == ('--exclude-caches',)
  80. def test_make_exclude_flags_does_not_include_exclude_caches_when_false_in_config():
  81. exclude_flags = module._make_exclude_flags(location_config={'exclude_caches': False})
  82. assert exclude_flags == ()
  83. def test_make_exclude_flags_includes_exclude_if_present_when_in_config():
  84. exclude_flags = module._make_exclude_flags(location_config={'exclude_if_present': 'exclude_me'})
  85. assert exclude_flags == ('--exclude-if-present', 'exclude_me')
  86. def test_make_exclude_flags_is_empty_when_config_has_no_excludes():
  87. exclude_flags = module._make_exclude_flags(location_config={})
  88. assert exclude_flags == ()
  89. DEFAULT_ARCHIVE_NAME = '{hostname}-{now:%Y-%m-%dT%H:%M:%S.%f}'
  90. CREATE_COMMAND = ('borg', 'create', 'repo::{}'.format(DEFAULT_ARCHIVE_NAME), 'foo', 'bar')
  91. def test_create_archive_calls_borg_with_parameters():
  92. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  93. flexmock(module).should_receive('_expand_home_directories').and_return(())
  94. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  95. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  96. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  97. flexmock(module).should_receive('execute_command').with_args(
  98. CREATE_COMMAND, capture_output=False
  99. )
  100. module.create_archive(
  101. dry_run=False,
  102. repository='repo',
  103. location_config={
  104. 'source_directories': ['foo', 'bar'],
  105. 'repositories': ['repo'],
  106. 'exclude_patterns': None,
  107. },
  108. storage_config={},
  109. )
  110. def test_create_archive_with_patterns_calls_borg_with_patterns():
  111. pattern_flags = ('--patterns-from', 'patterns')
  112. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  113. flexmock(module).should_receive('_expand_home_directories').and_return(())
  114. flexmock(module).should_receive('_write_pattern_file').and_return(
  115. flexmock(name='/tmp/patterns')
  116. ).and_return(None)
  117. flexmock(module).should_receive('_make_pattern_flags').and_return(pattern_flags)
  118. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  119. flexmock(module).should_receive('execute_command').with_args(
  120. CREATE_COMMAND + pattern_flags, capture_output=False
  121. )
  122. module.create_archive(
  123. dry_run=False,
  124. repository='repo',
  125. location_config={
  126. 'source_directories': ['foo', 'bar'],
  127. 'repositories': ['repo'],
  128. 'patterns': ['pattern'],
  129. },
  130. storage_config={},
  131. )
  132. def test_create_archive_with_exclude_patterns_calls_borg_with_excludes():
  133. exclude_flags = ('--exclude-from', 'excludes')
  134. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  135. flexmock(module).should_receive('_expand_home_directories').and_return(('exclude',))
  136. flexmock(module).should_receive('_write_pattern_file').and_return(None).and_return(
  137. flexmock(name='/tmp/excludes')
  138. )
  139. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  140. flexmock(module).should_receive('_make_exclude_flags').and_return(exclude_flags)
  141. flexmock(module).should_receive('execute_command').with_args(
  142. CREATE_COMMAND + exclude_flags, capture_output=False
  143. )
  144. module.create_archive(
  145. dry_run=False,
  146. repository='repo',
  147. location_config={
  148. 'source_directories': ['foo', 'bar'],
  149. 'repositories': ['repo'],
  150. 'exclude_patterns': ['exclude'],
  151. },
  152. storage_config={},
  153. )
  154. def test_create_archive_with_log_info_calls_borg_with_info_parameter():
  155. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  156. flexmock(module).should_receive('_expand_home_directories').and_return(())
  157. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  158. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  159. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  160. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  161. flexmock(module).should_receive('execute_command').with_args(
  162. CREATE_COMMAND + ('--list', '--filter', 'AME-', '--info', '--stats'), capture_output=False
  163. )
  164. insert_logging_mock(logging.INFO)
  165. module.create_archive(
  166. dry_run=False,
  167. repository='repo',
  168. location_config={
  169. 'source_directories': ['foo', 'bar'],
  170. 'repositories': ['repo'],
  171. 'exclude_patterns': None,
  172. },
  173. storage_config={},
  174. )
  175. def test_create_archive_with_log_info_and_json_suppresses_most_borg_output():
  176. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  177. flexmock(module).should_receive('_expand_home_directories').and_return(())
  178. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  179. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  180. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  181. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  182. flexmock(module).should_receive('execute_command').with_args(
  183. CREATE_COMMAND + ('--json',), capture_output=True
  184. )
  185. insert_logging_mock(logging.INFO)
  186. module.create_archive(
  187. dry_run=False,
  188. repository='repo',
  189. location_config={
  190. 'source_directories': ['foo', 'bar'],
  191. 'repositories': ['repo'],
  192. 'exclude_patterns': None,
  193. },
  194. storage_config={},
  195. json=True,
  196. )
  197. def test_create_archive_with_log_debug_calls_borg_with_debug_parameter():
  198. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  199. flexmock(module).should_receive('_expand_home_directories').and_return(())
  200. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  201. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  202. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  203. flexmock(module).should_receive('execute_command').with_args(
  204. CREATE_COMMAND + ('--list', '--filter', 'AME-', '--stats', '--debug', '--show-rc'),
  205. capture_output=False,
  206. )
  207. insert_logging_mock(logging.DEBUG)
  208. module.create_archive(
  209. dry_run=False,
  210. repository='repo',
  211. location_config={
  212. 'source_directories': ['foo', 'bar'],
  213. 'repositories': ['repo'],
  214. 'exclude_patterns': None,
  215. },
  216. storage_config={},
  217. )
  218. def test_create_archive_with_log_debug_and_json_suppresses_most_borg_output():
  219. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  220. flexmock(module).should_receive('_expand_home_directories').and_return(())
  221. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  222. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  223. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  224. flexmock(module).should_receive('execute_command').with_args(
  225. CREATE_COMMAND + ('--json',), capture_output=True
  226. )
  227. insert_logging_mock(logging.DEBUG)
  228. module.create_archive(
  229. dry_run=False,
  230. repository='repo',
  231. location_config={
  232. 'source_directories': ['foo', 'bar'],
  233. 'repositories': ['repo'],
  234. 'exclude_patterns': None,
  235. },
  236. storage_config={},
  237. json=True,
  238. )
  239. def test_create_archive_with_dry_run_calls_borg_with_dry_run_parameter():
  240. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  241. flexmock(module).should_receive('_expand_home_directories').and_return(())
  242. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  243. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  244. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  245. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  246. flexmock(module).should_receive('execute_command').with_args(
  247. CREATE_COMMAND + ('--dry-run',), capture_output=False
  248. )
  249. module.create_archive(
  250. dry_run=True,
  251. repository='repo',
  252. location_config={
  253. 'source_directories': ['foo', 'bar'],
  254. 'repositories': ['repo'],
  255. 'exclude_patterns': None,
  256. },
  257. storage_config={},
  258. )
  259. def test_create_archive_with_dry_run_and_log_info_calls_borg_without_stats_parameter():
  260. # --dry-run and --stats are mutually exclusive, see:
  261. # https://borgbackup.readthedocs.io/en/stable/usage/create.html#description
  262. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  263. flexmock(module).should_receive('_expand_home_directories').and_return(())
  264. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  265. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  266. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  267. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  268. flexmock(module).should_receive('execute_command').with_args(
  269. CREATE_COMMAND + ('--list', '--filter', 'AME-', '--info', '--dry-run'), capture_output=False
  270. )
  271. insert_logging_mock(logging.INFO)
  272. module.create_archive(
  273. dry_run=True,
  274. repository='repo',
  275. location_config={
  276. 'source_directories': ['foo', 'bar'],
  277. 'repositories': ['repo'],
  278. 'exclude_patterns': None,
  279. },
  280. storage_config={},
  281. )
  282. def test_create_archive_with_dry_run_and_log_debug_calls_borg_without_stats_parameter():
  283. # --dry-run and --stats are mutually exclusive, see:
  284. # https://borgbackup.readthedocs.io/en/stable/usage/create.html#description
  285. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  286. flexmock(module).should_receive('_expand_home_directories').and_return(())
  287. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  288. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  289. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  290. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  291. flexmock(module).should_receive('execute_command').with_args(
  292. CREATE_COMMAND + ('--list', '--filter', 'AME-', '--debug', '--show-rc', '--dry-run'),
  293. capture_output=False,
  294. )
  295. insert_logging_mock(logging.DEBUG)
  296. module.create_archive(
  297. dry_run=True,
  298. repository='repo',
  299. location_config={
  300. 'source_directories': ['foo', 'bar'],
  301. 'repositories': ['repo'],
  302. 'exclude_patterns': None,
  303. },
  304. storage_config={},
  305. )
  306. def test_create_archive_with_checkpoint_interval_calls_borg_with_checkpoint_interval_parameters():
  307. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  308. flexmock(module).should_receive('_expand_home_directories').and_return(())
  309. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  310. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  311. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  312. flexmock(module).should_receive('execute_command').with_args(
  313. CREATE_COMMAND + ('--checkpoint-interval', '600'), capture_output=False
  314. )
  315. module.create_archive(
  316. dry_run=False,
  317. repository='repo',
  318. location_config={
  319. 'source_directories': ['foo', 'bar'],
  320. 'repositories': ['repo'],
  321. 'exclude_patterns': None,
  322. },
  323. storage_config={'checkpoint_interval': 600},
  324. )
  325. def test_create_archive_with_chunker_params_calls_borg_with_chunker_params_parameters():
  326. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  327. flexmock(module).should_receive('_expand_home_directories').and_return(())
  328. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  329. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  330. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  331. flexmock(module).should_receive('execute_command').with_args(
  332. CREATE_COMMAND + ('--chunker-params', '1,2,3,4'), capture_output=False
  333. )
  334. module.create_archive(
  335. dry_run=False,
  336. repository='repo',
  337. location_config={
  338. 'source_directories': ['foo', 'bar'],
  339. 'repositories': ['repo'],
  340. 'exclude_patterns': None,
  341. },
  342. storage_config={'chunker_params': '1,2,3,4'},
  343. )
  344. def test_create_archive_with_compression_calls_borg_with_compression_parameters():
  345. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  346. flexmock(module).should_receive('_expand_home_directories').and_return(())
  347. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  348. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  349. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  350. flexmock(module).should_receive('execute_command').with_args(
  351. CREATE_COMMAND + ('--compression', 'rle'), capture_output=False
  352. )
  353. module.create_archive(
  354. dry_run=False,
  355. repository='repo',
  356. location_config={
  357. 'source_directories': ['foo', 'bar'],
  358. 'repositories': ['repo'],
  359. 'exclude_patterns': None,
  360. },
  361. storage_config={'compression': 'rle'},
  362. )
  363. def test_create_archive_with_remote_rate_limit_calls_borg_with_remote_ratelimit_parameters():
  364. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  365. flexmock(module).should_receive('_expand_home_directories').and_return(())
  366. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  367. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  368. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  369. flexmock(module).should_receive('execute_command').with_args(
  370. CREATE_COMMAND + ('--remote-ratelimit', '100'), capture_output=False
  371. )
  372. module.create_archive(
  373. dry_run=False,
  374. repository='repo',
  375. location_config={
  376. 'source_directories': ['foo', 'bar'],
  377. 'repositories': ['repo'],
  378. 'exclude_patterns': None,
  379. },
  380. storage_config={'remote_rate_limit': 100},
  381. )
  382. def test_create_archive_with_one_file_system_calls_borg_with_one_file_system_parameter():
  383. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  384. flexmock(module).should_receive('_expand_home_directories').and_return(())
  385. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  386. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  387. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  388. flexmock(module).should_receive('execute_command').with_args(
  389. CREATE_COMMAND + ('--one-file-system',), capture_output=False
  390. )
  391. module.create_archive(
  392. dry_run=False,
  393. repository='repo',
  394. location_config={
  395. 'source_directories': ['foo', 'bar'],
  396. 'repositories': ['repo'],
  397. 'one_file_system': True,
  398. 'exclude_patterns': None,
  399. },
  400. storage_config={},
  401. )
  402. def test_create_archive_with_numeric_owner_calls_borg_with_numeric_owner_parameter():
  403. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  404. flexmock(module).should_receive('_expand_home_directories').and_return(())
  405. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  406. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  407. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  408. flexmock(module).should_receive('execute_command').with_args(
  409. CREATE_COMMAND + ('--numeric-owner',), capture_output=False
  410. )
  411. module.create_archive(
  412. dry_run=False,
  413. repository='repo',
  414. location_config={
  415. 'source_directories': ['foo', 'bar'],
  416. 'repositories': ['repo'],
  417. 'numeric_owner': True,
  418. 'exclude_patterns': None,
  419. },
  420. storage_config={},
  421. )
  422. def test_create_archive_with_read_special_calls_borg_with_read_special_parameter():
  423. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  424. flexmock(module).should_receive('_expand_home_directories').and_return(())
  425. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  426. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  427. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  428. flexmock(module).should_receive('execute_command').with_args(
  429. CREATE_COMMAND + ('--read-special',), capture_output=False
  430. )
  431. module.create_archive(
  432. dry_run=False,
  433. repository='repo',
  434. location_config={
  435. 'source_directories': ['foo', 'bar'],
  436. 'repositories': ['repo'],
  437. 'read_special': True,
  438. 'exclude_patterns': None,
  439. },
  440. storage_config={},
  441. )
  442. def test_create_archive_with_bsd_flags_true_calls_borg_without_nobsdflags_parameter():
  443. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  444. flexmock(module).should_receive('_expand_home_directories').and_return(())
  445. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  446. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  447. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  448. flexmock(module).should_receive('execute_command').with_args(
  449. CREATE_COMMAND, capture_output=False
  450. )
  451. module.create_archive(
  452. dry_run=False,
  453. repository='repo',
  454. location_config={
  455. 'source_directories': ['foo', 'bar'],
  456. 'repositories': ['repo'],
  457. 'bsd_flags': True,
  458. 'exclude_patterns': None,
  459. },
  460. storage_config={},
  461. )
  462. def test_create_archive_with_bsd_flags_false_calls_borg_with_nobsdflags_parameter():
  463. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  464. flexmock(module).should_receive('_expand_home_directories').and_return(())
  465. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  466. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  467. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  468. flexmock(module).should_receive('execute_command').with_args(
  469. CREATE_COMMAND + ('--nobsdflags',), capture_output=False
  470. )
  471. module.create_archive(
  472. dry_run=False,
  473. repository='repo',
  474. location_config={
  475. 'source_directories': ['foo', 'bar'],
  476. 'repositories': ['repo'],
  477. 'bsd_flags': False,
  478. 'exclude_patterns': None,
  479. },
  480. storage_config={},
  481. )
  482. def test_create_archive_with_files_cache_calls_borg_with_files_cache_parameters():
  483. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  484. flexmock(module).should_receive('_expand_home_directories').and_return(())
  485. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  486. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  487. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  488. flexmock(module).should_receive('execute_command').with_args(
  489. CREATE_COMMAND + ('--files-cache', 'ctime,size'), capture_output=False
  490. )
  491. module.create_archive(
  492. dry_run=False,
  493. repository='repo',
  494. location_config={
  495. 'source_directories': ['foo', 'bar'],
  496. 'repositories': ['repo'],
  497. 'files_cache': 'ctime,size',
  498. 'exclude_patterns': None,
  499. },
  500. storage_config={},
  501. )
  502. def test_create_archive_with_local_path_calls_borg_via_local_path():
  503. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  504. flexmock(module).should_receive('_expand_home_directories').and_return(())
  505. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  506. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  507. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  508. flexmock(module).should_receive('execute_command').with_args(
  509. ('borg1',) + CREATE_COMMAND[1:], capture_output=False
  510. )
  511. module.create_archive(
  512. dry_run=False,
  513. repository='repo',
  514. location_config={
  515. 'source_directories': ['foo', 'bar'],
  516. 'repositories': ['repo'],
  517. 'exclude_patterns': None,
  518. },
  519. storage_config={},
  520. local_path='borg1',
  521. )
  522. def test_create_archive_with_remote_path_calls_borg_with_remote_path_parameters():
  523. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  524. flexmock(module).should_receive('_expand_home_directories').and_return(())
  525. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  526. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  527. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  528. flexmock(module).should_receive('execute_command').with_args(
  529. CREATE_COMMAND + ('--remote-path', 'borg1'), capture_output=False
  530. )
  531. module.create_archive(
  532. dry_run=False,
  533. repository='repo',
  534. location_config={
  535. 'source_directories': ['foo', 'bar'],
  536. 'repositories': ['repo'],
  537. 'exclude_patterns': None,
  538. },
  539. storage_config={},
  540. remote_path='borg1',
  541. )
  542. def test_create_archive_with_umask_calls_borg_with_umask_parameters():
  543. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  544. flexmock(module).should_receive('_expand_home_directories').and_return(())
  545. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  546. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  547. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  548. flexmock(module).should_receive('execute_command').with_args(
  549. CREATE_COMMAND + ('--umask', '740'), capture_output=False
  550. )
  551. module.create_archive(
  552. dry_run=False,
  553. repository='repo',
  554. location_config={
  555. 'source_directories': ['foo', 'bar'],
  556. 'repositories': ['repo'],
  557. 'exclude_patterns': None,
  558. },
  559. storage_config={'umask': 740},
  560. )
  561. def test_create_archive_with_lock_wait_calls_borg_with_lock_wait_parameters():
  562. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  563. flexmock(module).should_receive('_expand_home_directories').and_return(())
  564. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  565. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  566. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  567. flexmock(module).should_receive('execute_command').with_args(
  568. CREATE_COMMAND + ('--lock-wait', '5'), capture_output=False
  569. )
  570. module.create_archive(
  571. dry_run=False,
  572. repository='repo',
  573. location_config={
  574. 'source_directories': ['foo', 'bar'],
  575. 'repositories': ['repo'],
  576. 'exclude_patterns': None,
  577. },
  578. storage_config={'lock_wait': 5},
  579. )
  580. def test_create_archive_with_json_calls_borg_with_json_parameter():
  581. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  582. flexmock(module).should_receive('_expand_home_directories').and_return(())
  583. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  584. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  585. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  586. flexmock(module).should_receive('execute_command').with_args(
  587. CREATE_COMMAND + ('--json',), capture_output=True
  588. ).and_return('[]')
  589. json_output = module.create_archive(
  590. dry_run=False,
  591. repository='repo',
  592. location_config={
  593. 'source_directories': ['foo', 'bar'],
  594. 'repositories': ['repo'],
  595. 'exclude_patterns': None,
  596. },
  597. storage_config={},
  598. json=True,
  599. )
  600. assert json_output == '[]'
  601. def test_create_archive_with_source_directories_glob_expands():
  602. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'food'))
  603. flexmock(module).should_receive('_expand_home_directories').and_return(())
  604. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  605. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  606. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  607. flexmock(module).should_receive('execute_command').with_args(
  608. ('borg', 'create', 'repo::{}'.format(DEFAULT_ARCHIVE_NAME), 'foo', 'food'),
  609. capture_output=False,
  610. )
  611. flexmock(module.glob).should_receive('glob').with_args('foo*').and_return(['foo', 'food'])
  612. module.create_archive(
  613. dry_run=False,
  614. repository='repo',
  615. location_config={
  616. 'source_directories': ['foo*'],
  617. 'repositories': ['repo'],
  618. 'exclude_patterns': None,
  619. },
  620. storage_config={},
  621. )
  622. def test_create_archive_with_non_matching_source_directories_glob_passes_through():
  623. flexmock(module).should_receive('_expand_directories').and_return(('foo*',))
  624. flexmock(module).should_receive('_expand_home_directories').and_return(())
  625. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  626. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  627. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  628. flexmock(module).should_receive('execute_command').with_args(
  629. ('borg', 'create', 'repo::{}'.format(DEFAULT_ARCHIVE_NAME), 'foo*'), capture_output=False
  630. )
  631. flexmock(module.glob).should_receive('glob').with_args('foo*').and_return([])
  632. module.create_archive(
  633. dry_run=False,
  634. repository='repo',
  635. location_config={
  636. 'source_directories': ['foo*'],
  637. 'repositories': ['repo'],
  638. 'exclude_patterns': None,
  639. },
  640. storage_config={},
  641. )
  642. def test_create_archive_with_glob_calls_borg_with_expanded_directories():
  643. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'food'))
  644. flexmock(module).should_receive('_expand_home_directories').and_return(())
  645. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  646. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  647. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  648. flexmock(module).should_receive('execute_command').with_args(
  649. ('borg', 'create', 'repo::{}'.format(DEFAULT_ARCHIVE_NAME), 'foo', 'food'),
  650. capture_output=False,
  651. )
  652. module.create_archive(
  653. dry_run=False,
  654. repository='repo',
  655. location_config={
  656. 'source_directories': ['foo*'],
  657. 'repositories': ['repo'],
  658. 'exclude_patterns': None,
  659. },
  660. storage_config={},
  661. )
  662. def test_create_archive_with_archive_name_format_calls_borg_with_archive_name():
  663. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  664. flexmock(module).should_receive('_expand_home_directories').and_return(())
  665. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  666. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  667. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  668. flexmock(module).should_receive('execute_command').with_args(
  669. ('borg', 'create', 'repo::ARCHIVE_NAME', 'foo', 'bar'), capture_output=False
  670. )
  671. module.create_archive(
  672. dry_run=False,
  673. repository='repo',
  674. location_config={
  675. 'source_directories': ['foo', 'bar'],
  676. 'repositories': ['repo'],
  677. 'exclude_patterns': None,
  678. },
  679. storage_config={'archive_name_format': 'ARCHIVE_NAME'},
  680. )
  681. def test_create_archive_with_archive_name_format_accepts_borg_placeholders():
  682. flexmock(module).should_receive('_expand_directories').and_return(('foo', 'bar'))
  683. flexmock(module).should_receive('_expand_home_directories').and_return(())
  684. flexmock(module).should_receive('_write_pattern_file').and_return(None)
  685. flexmock(module).should_receive('_make_pattern_flags').and_return(())
  686. flexmock(module).should_receive('_make_exclude_flags').and_return(())
  687. flexmock(module).should_receive('execute_command').with_args(
  688. ('borg', 'create', 'repo::Documents_{hostname}-{now}', 'foo', 'bar'), capture_output=False
  689. )
  690. module.create_archive(
  691. dry_run=False,
  692. repository='repo',
  693. location_config={
  694. 'source_directories': ['foo', 'bar'],
  695. 'repositories': ['repo'],
  696. 'exclude_patterns': None,
  697. },
  698. storage_config={'archive_name_format': 'Documents_{hostname}-{now}'},
  699. )