XDG directories #562

New Issue

Open

opened 2022-07-09 19:36:22 +00:00 by pikeas · 5 comments

pikeas commented 2022-07-09 19:36:22 +00:00

Copy Link

It would be nice if Borgmatic supported the XDG spec (~/.config, ~/.local, etc). There's a Python package that can be used to enable this: https://github.com/ActiveState/appdirs

It would be nice if Borgmatic supported the XDG spec (`~/.config`, `~/.local`, etc). There's a Python package that can be used to enable this: https://github.com/ActiveState/appdirs

witten commented 2022-07-09 22:46:40 +00:00

Owner

Copy Link

Thanks for filing this! By default, borgmatic already looks in ~/.config/borgmatic/config.yaml and ~/.config/borgmatic.d/ for configuration files. And the ~/.config prefix is customizable via the standard XDG_CONFIG_HOME environment variable. Is the idea that you'd like other paths to be used by default on non-Linux OSes, e.g. MacOS?

And for ~/.local, is the the thinking that's where the existing ~/.borgmatic user data would be stored instead?

Thanks for filing this! By default, borgmatic already looks in `~/.config/borgmatic/config.yaml` and `~/.config/borgmatic.d/` for configuration files. And the `~/.config` prefix is customizable via the standard `XDG_CONFIG_HOME` environment variable. Is the idea that you'd like other paths to be used by default on non-Linux OSes, e.g. MacOS? And for `~/.local`, is the the thinking that's where the existing `~/.borgmatic` user data would be stored instead?

pikeas commented 2022-07-30 17:57:20 +00:00

Author

Copy Link

And for ~/.local, is the the thinking that's where the existing ~/.borgmatic user data would be stored instead?

Yes, sorry for the late reply. XDG_DATA_HOME (defaulting to ~/.local/share) is the XDG-compliant directory for user-specific app data. It would be nice-to-have if borgmatic fully implemented XDG.

> And for `~/.local`, is the the thinking that's where the existing `~/.borgmatic` user data would be stored instead? Yes, sorry for the late reply. `XDG_DATA_HOME` (defaulting to `~/.local/share`) is the XDG-compliant directory for user-specific app data. It would be nice-to-have if borgmatic fully implemented XDG.

pikeas commented 2022-07-30 17:59:40 +00:00

Author

Copy Link

There's also XDG_DATA_STATE_HOME, depending on whether Borgmatic's checks/ is considered "user data" or "user state".

There's also `XDG_DATA_STATE_HOME`, depending on whether Borgmatic's `checks/` is considered "user data" or "user state".

witten commented 2023-03-26 22:02:44 +00:00

Owner

Copy Link

I apologize for the delay here. I think this would be a good change in terms of standardization. The main difficulty is that the ~/.borgmatic path currently gets encoded into database backup archives in the form of dump file paths. So if changing those paths (either implicitly by default or explicitly with an option), the database restore logic might need to be updated to probe both paths within a backup archive.

Note that there is an existing borgmatic_source_directory that configures this ~/.borgmatic directory, and changing that will just unceremoneously break restores of any existing backups. However this is a comment warning of this above the option.

I apologize for the delay here. I think this would be a good change in terms of standardization. The main difficulty is that the `~/.borgmatic` path currently gets encoded into database backup archives in the form of dump file paths. So if changing those paths (either implicitly by default or explicitly with an option), the database restore logic might need to be updated to probe both paths within a backup archive. Note that there is an existing `borgmatic_source_directory` that configures this `~/.borgmatic` directory, and changing that will just unceremoneously break restores of any existing backups. However this is a comment warning of this above the option.

witten referenced this issue 2024-03-12 04:04:07 +00:00

Nicer structure for auto-added files #838

witten commented 2024-03-12 04:04:31 +00:00

Owner

Copy Link

Relevant reference: https://wiki.archlinux.org/title/XDG_Base_Directory

Also see #838 for a related ticket.

EDIT: #638 is also related.

Relevant reference: https://wiki.archlinux.org/title/XDG_Base_Directory Also see #838 for a related ticket. EDIT: #638 is also related.

Sign in to join this conversation.

No Branch/Tag Specified

Branches Tags

main

spot-check

1.8.10

1.8.9

1.8.8

1.8.7

1.8.6

1.8.5

1.8.4

1.8.3

1.8.2

1.8.1

1.8.0

1.7.15

1.7.14

1.7.13

1.7.12

1.7.11

1.7.10

1.7.9

1.7.8

1.7.7

1.7.6

1.7.5

1.7.4

1.7.3

1.7.2

1.7.1

1.7.0

1.6.6

1.6.5

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.5.24

1.5.23

1.5.22

1.5.21

1.5.20

1.5.19

1.5.18

1.5.17

1.5.16

1.5.15

1.5.14

1.5.13

1.5.12

1.5.11

1.5.10

1.5.9

1.5.8

1.5.7

1.5.7.dev0

1.5.6

1.5.5

1.5.4

1.5.3

1.5.2

1.5.1

1.5.0

1.4.22

1.4.21

1.4.20

1.4.19

1.4.18

1.4.17

1.4.16

1.4.15

1.4.14

1.4.13

1.4.12

1.4.11

1.4.10

1.4.9

1.4.8

1.4.7

1.4.6

1.4.5

1.4.4

1.4.3

1.4.2

1.4.1

1.4.0

1.3.26

1.3.25

1.3.24

1.3.23

1.3.22

1.3.21

1.3.20

1.3.19

1.3.18

1.3.17

1.3.16

1.3.15

1.3.14

1.3.13

1.3.12

1.3.11

1.3.10

1.3.9

1.3.8

1.3.7

1.3.6

1.3.5

1.3.4

1.3.3

1.3.2

1.3.1

1.3.0

1.2.18

1.2.17

1.2.16

1.2.15

1.2.14

1.2.13

1.2.12

1.2.11

1.2.10

1.2.9

1.2.8

1.2.7

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.15

1.1.14

1.1.13

1.1.12

1.1.11

1.1.10

1.1.9

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.3

1.0.2

1.0.1

1.0.0

0.1.8

0.1.7

0.1.6

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

0.0.7

0.0.6

0.0.5

0.0.4

0.0.3

0.0.2

Labels

Clear labels   

bug

  

data loss

  

design finalized

  

good first issue

  

new feature area

  

question / support

  

security

  

waiting for response

No Label

bug

data loss

design finalized

good first issue

new feature area

question / support

security

waiting for response

Milestone

Clear milestone

No items

No Milestone

Assignees

Clear assignees

No Assignees

2 Participants

Notifications

Subscribe

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: borgmatic-collective/borgmatic#562

No description provided.