diff --git a/UPGRADE.md b/UPGRADE.md
index 7483741c..df4aff05 100644
--- a/UPGRADE.md
+++ b/UPGRADE.md
@@ -2,10 +2,10 @@
## Next
-### Configuration file structure change
+### Configuration file structure changes
The 2.0 version introduces many configuration changes. Most of them will
-gracefuly fallback to older version until 3.0, but some have been removed
+gracefully fallback to older version until 3.0, but some have been removed
and will cause exceptions.
Rationale is that now, all top-level configuration options can be directly
@@ -16,7 +16,7 @@ Please read carefully the new sample configuration files:
- For Symfony: [config/packages/db_tools.yaml](./config/packages/db_tools.yaml)
- For standalone: [config/db_tools.standalone.yaml](./config/db_tools.standalone.yaml)
-And the the [CHANGELOG.md](./CHANGELOG.md) file and fix your configuration accordingly.
+And the [changelog](./changelog) file and fix your configuration accordingly.
The `backupper_binaries` and `backupper_options` as well as the `restorer_binaries`
and `restorer_options` options have been removed and will raise exception when
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index 600553b8..9f55fd73 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -1,10 +1,12 @@
import { defineConfig } from 'vitepress'
+import MarkdownItContainer from 'markdown-it-container'
+import { flavorList } from './theme/components/flavor'
// https://vitepress.dev/reference/site-config
export default defineConfig({
lang: 'en',
title: 'DbToolsBundle',
- description: 'A Symfony bundle to backup, restore and anonymize your data',
+ description: 'A PHP library to backup, restore and anonymize databases',
srcDir: "content",
base: "/",
metaChunk: false,
@@ -27,31 +29,6 @@ export default defineConfig({
nav: [
{ text: 'Home', link: '/' },
],
- editLink: {
- pattern: 'https://github.com/makinacorpus/DbToolsBundle/blob/main/docs/content/:path',
- text: 'Edit this page on Github'
- },
- docFooter: {
- prev: 'Previous page',
- next: 'Next page'
- },
- outlineTitle: 'On this page',
- lastUpdated: {
- text: 'Last updated',
- formatOptions: {
- dateStyle: 'short'
- }
- },
- search: {
- provider: 'local'
- },
- footer: {
- message: 'Released under the MIT License.',
- copyright: 'Copyright © 2023-present Makina Corpus'
- },
- socialLinks: [
- { icon: 'github', link: 'https://github.com/makinacorpus/DbToolsBundle' }
- ],
sidebar: [
{
text: 'Getting Started',
@@ -87,6 +64,8 @@ export default defineConfig({
{ text: 'Statistics', link: '/stats' },
{ text: 'Configuration basics', link: '/configuration/basics' },
{ text: 'Configuration reference', link: '/configuration/reference' },
+ { text: 'Changelog', link: '/changelog'},
+ { text: 'Upgrade guide', link: '/upgrade'},
]
},
{
@@ -96,8 +75,54 @@ export default defineConfig({
{ text: 'How to help ?', link: '/contribute/contribute' },
{ text: 'Development guide', link: '/contribute/guide' },
{ text: 'Creating a pack of anonymizers', link: '/contribute/pack' },
+ { text: 'Code of conduct', link: '/contribute/code-of-conduct' },
]
},
- ]
+ ],
+ editLink: {
+ pattern: 'https://github.com/makinacorpus/DbToolsBundle/blob/main/docs/content/:path',
+ text: 'Edit this page on Github'
+ },
+ docFooter: {
+ prev: 'Previous page',
+ next: 'Next page'
+ },
+ outlineTitle: 'On this page',
+ lastUpdated: {
+ text: 'Last updated',
+ formatOptions: {
+ dateStyle: 'short'
+ }
+ },
+ search: {
+ provider: 'local'
+ },
+ footer: {
+ message: 'Released under the MIT License.',
+ copyright: 'Copyright © 2023-present Makina Corpus'
+ },
+ socialLinks: [
+ { icon: 'github', link: 'https://github.com/makinacorpus/DbToolsBundle' }
+ ],
+ },
+ markdown: {
+ config: (md) => {
+ function render(tokens, idx) {
+ const m: string = tokens[idx].info.trim()
+
+ if (tokens[idx].nesting === 1) {
+ const flavors = m.split(' ').join('-')
+ // opening tag
+ return '
\n'
+ } else {
+ // closing tag
+ return '
\n'
+ }
+ }
+
+ flavorList.forEach(f => {
+ md.use(MarkdownItContainer, f, { marker: '@', render })
+ })
+ }
}
})
diff --git a/docs/.vitepress/theme/components/DbToolsBundleFlavorSwitcher.vue b/docs/.vitepress/theme/components/DbToolsBundleFlavorSwitcher.vue
index 26a486f3..26c2aeee 100644
--- a/docs/.vitepress/theme/components/DbToolsBundleFlavorSwitcher.vue
+++ b/docs/.vitepress/theme/components/DbToolsBundleFlavorSwitcher.vue
@@ -1,5 +1,7 @@
@@ -19,22 +21,29 @@ const id = Math.random().toString(36).substring(2, 6);
Symfony
-
+
+
+
+
- Docker
- (soon)
-
+ Laravel
+ (experimental)
+
@@ -60,29 +69,25 @@ input[type="radio"] {
opacity: 0;
pointer-events: none;
}
-input[type="radio"] + label {
+input[type="radio"] + label, .flavor-switch .button {
cursor: pointer;
padding: 0px 4px;
border-radius: 4px;
border: solid 1px transparent;
- /* var(--vp-c-text-1); */
display: flex;
gap: 2px;
align-items: center;
+ text-decoration: none;
+ color: var(--vp-c-text-1);
+ font-weight: 400;
}
-input[type="radio"] + label > svg {
+input[type="radio"] + label > svg, .flavor-switch .button > svg {
fill: var(--vp-c-text-1);
}
-
-input[type="radio"][disabled] + label {
- color: var(--vp-c-border);
- /* border-color: var(--vp-c-border); */
- cursor: not-allowed;
-}
-input[type="radio"][disabled] + label > svg {
- fill: var(--vp-c-border);
+input[type="radio"]:hover:not(:checked) + label, .flavor-switch .button:hover {
+ background-color: color-mix(in oklab, var(--vp-makina-logo-text) 20%, transparent);
+ color: var(--vp-c-text-1);
}
-
input[type="radio"]:checked + label {
color: var(--vp-c-brand-lighter);
background-color: var(--vp-c-brand-1);
@@ -91,6 +96,43 @@ input[type="radio"]:checked + label {
input[type="radio"]:checked + label > svg {
fill: var(--vp-c-brand-lighter);
}
+
+input[value="symfony"]:checked + label {
+ color: #FFFFFF;
+ background-color: #000000;
+ border-color: #000000;
+}
+input[value="symfony"]:checked + label > svg {
+ fill: #FFFFFF;
+}
+.dark {
+ input[value="symfony"]:checked + label {
+ color: #000000;
+ background-color: #FFFFFF;
+ border-color: #FFFFFF;
+ }
+ input[value="symfony"]:checked + label > svg {
+ fill: #000000;
+ }
+}
+
+input[value="laravel"]:checked + label {
+ color: #FFFFFF;
+ background-color: #F5382E;
+ border-color: #F5382E;
+}
+input[value="laravel"]:checked + label > svg {
+ fill: #FFFFFF;
+}
+
+input[value="docker"]:checked + label {
+ color: #FFFFFF;
+ background-color: #1D63ED;
+ border-color: #1D63ED;
+}
+input[value="docker"]:checked + label > svg {
+ fill: #FFFFFF;
+}
small {
font-size: 10px;
}
diff --git a/docs/.vitepress/theme/components/DbToolsBundleFlavorSwitcherWrapper.vue b/docs/.vitepress/theme/components/DbToolsBundleFlavorSwitcherWrapper.vue
index 16db2de0..b36c13c8 100644
--- a/docs/.vitepress/theme/components/DbToolsBundleFlavorSwitcherWrapper.vue
+++ b/docs/.vitepress/theme/components/DbToolsBundleFlavorSwitcherWrapper.vue
@@ -1,5 +1,5 @@
@@ -21,7 +21,7 @@ details {
border-bottom: 1px solid var(--vt-c-divider-light);
transition: border-color .5s,background-color .5s ease;
position: sticky;
- top: -.5px;
+ top: -33px;
background-color: var(--vp-c-bg-alt);
padding-top: 10px;
padding-bottom: 1px;
@@ -48,4 +48,10 @@ a.info {
border-radius: 100%;
line-height: 14px;
}
+
+@media (min-width: 960px) {
+ details {
+ top: -.5px;
+ }
+}
diff --git a/docs/.vitepress/theme/components/DbToolsBundleHomeImage.vue b/docs/.vitepress/theme/components/DbToolsBundleHomeImage.vue
index 71411a2e..38beccf6 100644
--- a/docs/.vitepress/theme/components/DbToolsBundleHomeImage.vue
+++ b/docs/.vitepress/theme/components/DbToolsBundleHomeImage.vue
@@ -7,20 +7,21 @@
+ d="M 11.52,162 C 11.52,81.677 135.31,16.56 288,16.56 440.69,16.56 564.48,81.676 564.48,162 564.48,242.322 440.69,307.44 288,307.44 135.31,307.44 11.52,242.323 11.52,162"
+ id="path182" />
-
-
-
-
-
+
+
+
+
-
+
-
+
@@ -47,62 +48,79 @@
d="m130.09 105.43a0.67505 0.67505 0 0 0-1.0835-0.24302l-3.4006 3.1382-1.4539-0.31221-0.31221-1.4539 3.1381-3.4006a0.67505 0.67505 0 0 0-0.24302-1.0835 6.0755 6.0755 0 0 0-8.3538 5.6333 6.1042 6.1042 0 0 0 0.50629 2.442l-5.0806 4.3929c-0.0127 0.0101-0.0245 0.0219-0.0363 0.0329a2.7005 2.7005 0 0 0 3.8191 3.8191c0.011-0.011 0.0228-0.0236 0.0329-0.0354l4.392-5.0823a6.0755 6.0755 0 0 0 8.5175-5.5692 6.0383 6.0383 0 0 0-0.44216-2.2783zm-5.6333 7.0037a4.7372 4.7372 0 0 1-2.2842-0.59068 0.67505 0.67505 0 0 0-0.83706 0.14936l-4.7169 5.4629a1.3501 1.3501 0 0 1-1.9087-1.9087l5.4586-4.7161a0.67505 0.67505 0 0 0 0.14936-0.83791 4.7254 4.7254 0 0 1 4.9245-6.9454l-2.6327 2.8529a0.67505 0.67505 0 0 0-0.1637 0.59911l0.4776 2.2218a0.67505 0.67505 0 0 0 0.5181 0.5181l2.2235 0.4776a0.67505 0.67505 0 0 0 0.5991-0.1637l2.8529-2.6327a4.7304 4.7304 0 0 1-4.6604 5.5135z"
style="fill:var(--vp-c-brand);" stroke-width=".08444" />
-
-
+
+
+
+ d="m 155.95,84.448 c 0,30.976 -25.109,56.087 -56.084,56.087 -30.973,0 -56.081,-25.111 -56.081,-56.087 0,-30.971 25.107,-56.079 56.081,-56.079 30.975,0 56.084,25.108 56.084,56.079 z"
+ id="path217" />
+ d="m 124.39,49.119 c -5.697,0.195 -10.67,3.34 -14.373,7.68 -4.1,4.765 -6.824,10.411 -8.791,16.18 -3.514,-2.882 -6.223,-6.611 -11.864,-8.233 -4.359,-1.253 -8.936,-0.737 -13.146,2.399 -1.992,1.489 -3.367,3.738 -4.02,5.859 -1.692,5.498 1.778,10.396 3.354,12.151 l 3.447,3.691 c 0.709,0.725 2.422,2.613 1.584,5.319 -0.9,2.947 -4.451,4.85 -8.092,3.731 -1.627,-0.499 -3.963,-1.71 -3.439,-3.413 0.215,-0.699 0.715,-1.225 0.984,-1.821 0.244,-0.521 0.363,-0.907 0.438,-1.14 0.665,-2.169 -0.245,-4.994 -2.57,-5.713 -2.171,-0.666 -4.391,-0.138 -5.252,2.655 -0.977,3.174 0.543,8.935 8.681,11.441 9.535,2.935 17.597,-2.259 18.742,-9.026 0.721,-4.239 -1.195,-7.392 -4.701,-11.441 l -2.859,-3.163 c -1.73,-1.729 -2.324,-4.677 -0.533,-6.942 1.512,-1.912 3.664,-2.726 7.191,-1.768 5.15,1.396 7.443,4.969 11.271,7.851 -1.578,5.187 -2.613,10.392 -3.547,15.059 l -0.574,3.481 c -2.736,14.352 -4.826,22.235 -10.256,26.76 -1.094,0.779 -2.658,1.943 -5.014,2.027 -1.238,0.037 -1.637,-0.814 -1.654,-1.186 -0.027,-0.865 0.703,-1.264 1.188,-1.652 0.727,-0.396 1.824,-1.053 1.748,-3.156 -0.078,-2.484 -2.137,-4.639 -5.111,-4.541 -2.229,0.075 -5.625,2.171 -5.497,6.011 0.131,3.967 3.827,6.938 9.401,6.75 2.979,-0.102 9.633,-1.312 16.188,-9.105 7.631,-8.935 9.766,-19.175 11.372,-26.671 l 1.793,-9.897 c 0.992,0.119 2.059,0.2 3.217,0.228 9.504,0.201 14.256,-4.72 14.328,-8.302 0.049,-2.167 -1.42,-4.302 -3.479,-4.251 -1.471,0.041 -3.32,1.022 -3.762,3.057 -0.436,1.995 3.023,3.798 0.32,5.553 -1.92,1.242 -5.361,2.116 -10.209,1.407 l 0.881,-4.872 c 1.799,-9.238 4.018,-20.6 12.436,-20.878 0.615,-0.029 2.857,0.026 2.91,1.512 0.014,0.493 -0.109,0.623 -0.689,1.757 -0.592,0.884 -0.814,1.64 -0.785,2.504 0.08,2.356 1.873,3.908 4.471,3.818 3.473,-0.116 4.469,-3.496 4.412,-5.233 -0.146,-4.085 -4.449,-6.665 -10.14,-6.477 z"
+ fill="#ffffff" id="path219" />
-
-
-
+
+
+
+ d="M 11.52,162 C 11.52,81.677 135.31,16.56 288,16.56 440.69,16.56 564.48,81.676 564.48,162 564.48,242.322 440.69,307.44 288,307.44 135.31,307.44 11.52,242.323 11.52,162"
+ fill="url(#a)" id="path224" style="fill:url(#a)" />
-
-
+
+
+ d="m 0,0 c 146.73,0 265.68,60.281 265.68,134.64 0,74.359 -118.95,134.64 -265.68,134.64 -146.73,0 -265.68,-60.282 -265.68,-134.64 C -265.68,60.28 -146.73,0 0,0"
+ fill="#777bb3" id="path228" />
-
-
+
+
+ d="m 0,0 c 12.065,0 21.072,2.225 26.771,6.611 5.638,4.341 9.532,11.862 11.573,22.353 1.903,9.806 1.178,16.653 -2.154,20.348 C 32.783,53.086 25.417,55 14.297,55 H -4.984 L -15.673,0 Z m -63.063,-67.75 c -0.895,0 -1.745,0.4 -2.314,1.092 -0.57,0.691 -0.801,1.601 -0.63,2.48 l 28.328,145.75 c 0.274,1.409 1.509,2.427 2.945,2.427 H 26.32 c 19.188,0 33.47,-5.21 42.447,-15.487 C 77.792,58.181 80.579,43.74 77.05,25.591 75.614,18.197 73.144,11.33 69.709,5.182 66.27,-0.973 61.725,-6.668 56.198,-11.748 49.582,-17.94 42.094,-22.43 33.962,-25.072 25.959,-27.679 15.681,-29.001 3.414,-29.001 h -24.722 l -7.06,-36.322 c -0.274,-1.41 -1.508,-2.428 -2.944,-2.428 z"
+ id="path234" />
-
+
+ d="m 0,0 h 16.808 c 13.421,0 18.083,-2.945 19.667,-4.7 2.628,-2.914 3.124,-9.058 1.435,-17.767 C 36.012,-32.217 32.494,-39.13 27.452,-43.012 22.29,-46.986 13.898,-49 2.511,-49 H -9.523 Z m 28.831,35 h -61.055 c -2.872,0 -5.341,-2.036 -5.889,-4.855 l -28.328,-145.75 c -0.342,-1.759 0.12,-3.578 1.259,-4.961 1.14,-1.383 2.838,-2.183 4.63,-2.183 h 31.75 c 2.873,0 5.342,2.036 5.89,4.855 l 6.588,33.895 H 5.925 c 12.582,0 23.174,1.372 31.479,4.077 8.541,2.775 16.399,7.48 23.354,13.984 5.752,5.292 10.49,11.232 14.08,17.657 3.591,6.427 6.171,13.594 7.668,21.302 3.715,19.104 0.697,34.402 -8.969,45.466 -9.572,10.958 -24.614,16.514 -44.706,16.514 m -45.633,-90 H 2.511 c 12.801,0 22.336,2.411 28.601,7.234 6.266,4.824 10.492,12.875 12.688,24.157 2.101,10.832 1.144,18.476 -2.871,22.929 -4.02,4.453 -12.059,6.68 -24.121,6.68 H -4.946 l -11.856,-61 m 45.633,84 c 18.367,0 31.766,-4.82 40.188,-14.461 8.421,-9.641 10.957,-23.098 7.597,-40.375 -1.383,-7.117 -3.722,-13.624 -7.015,-19.519 -3.297,-5.899 -7.602,-11.293 -12.922,-16.184 -6.34,-5.933 -13.383,-10.161 -21.133,-12.679 -7.75,-2.525 -17.621,-3.782 -29.621,-3.782 h -27.196 l -7.531,-38.75 h -31.75 l 28.328,145.75 h 61.055"
+ fill="#ffffff" id="path238" />
-
+
+ d="m 0,0 c -0.896,0 -1.745,0.4 -2.314,1.092 -0.571,0.691 -0.802,1.6 -0.631,2.48 L 9.586,68.061 C 10.778,74.194 10.484,78.596 8.759,80.456 7.703,81.593 4.531,83.5 -4.848,83.5 H -27.55 L -43.305,2.428 C -43.579,1.018 -44.814,0 -46.25,0 h -31.5 c -0.896,0 -1.745,0.4 -2.315,1.092 -0.57,0.691 -0.801,1.601 -0.63,2.48 l 28.328,145.75 c 0.274,1.409 1.509,2.427 2.945,2.427 h 31.5 c 0.896,0 1.745,-0.4 2.315,-1.091 0.57,-0.692 0.801,-1.601 0.63,-2.481 l -6.836,-35.178 H 2.609 c 18.605,0 31.221,-3.28 38.569,-10.028 7.49,-6.884 9.827,-17.891 6.947,-32.719 L 34.945,2.427 C 34.671,1.017 33.437,-0.001 32,-0.001 Z"
+ id="path242" />
-
+
+ d="m 0,0 h -31.5 c -2.873,0 -5.342,-2.036 -5.89,-4.855 l -28.328,-145.75 c -0.342,-1.759 0.12,-3.578 1.26,-4.961 1.14,-1.383 2.838,-2.183 4.63,-2.183 h 31.5 c 2.872,0 5.342,2.036 5.89,4.855 l 15.283,78.645 h 20.229 c 9.363,0 11.328,-2 11.407,-2.086 0.568,-0.611 1.315,-3.441 0.082,-9.781 l -12.531,-64.489 c -0.342,-1.759 0.12,-3.578 1.26,-4.961 1.14,-1.383 2.838,-2.183 4.63,-2.183 h 32 c 2.872,0 5.342,2.036 5.89,4.855 l 13.179,67.825 c 3.093,15.921 0.447,27.864 -7.861,35.5 -7.928,7.281 -21.208,10.82 -40.599,10.82 H -0.253 L 5.89,-7.144 C 6.231,-5.385 5.77,-3.565 4.63,-2.183 3.49,-0.8 1.792,0.001 0,0.001 m 0,-6 -7.531,-38.75 h 28.062 c 17.657,0 29.836,-3.082 36.539,-9.238 6.703,-6.16 8.711,-16.141 6.032,-29.938 l -13.18,-67.824 h -32 l 12.531,64.488 c 1.426,7.336 0.902,12.34 -1.574,15.008 -2.477,2.668 -7.746,4.004 -15.805,4.004 h -25.176 l -16.226,-83.5 h -31.5 L -31.5,-5.999 H 0"
+ fill="#ffffff" id="path246" />
-
+
+ d="m 0,0 c 12.065,0 21.072,2.225 26.771,6.611 5.638,4.34 9.532,11.861 11.574,22.353 1.903,9.806 1.178,16.653 -2.155,20.348 C 32.783,53.086 25.417,55 14.297,55 H -4.984 L -15.673,0 Z m -63.062,-67.75 c -0.895,0 -1.745,0.4 -2.314,1.092 -0.57,0.691 -0.802,1.601 -0.631,2.48 l 28.328,145.75 c 0.275,1.409 1.509,2.427 2.946,2.427 H 26.32 c 19.189,0 33.47,-5.21 42.448,-15.487 C 77.793,58.182 80.579,43.741 77.051,25.591 75.613,18.197 73.144,11.33 69.709,5.182 66.27,-0.973 61.725,-6.668 56.198,-11.748 49.582,-17.94 42.094,-22.43 33.962,-25.072 25.959,-27.679 15.681,-29.001 3.414,-29.001 h -24.723 l -7.057,-36.322 c -0.275,-1.41 -1.509,-2.428 -2.946,-2.428 z"
+ id="path250" />
-
+
+ d="M 0,0 H 16.808 C 30.229,0 34.891,-2.945 36.475,-4.7 39.104,-7.614 39.6,-13.758 37.91,-22.466 36.012,-32.217 32.493,-39.13 27.452,-43.012 22.29,-46.986 13.898,-49 2.511,-49 H -9.522 Z m 28.831,35 h -61.054 c -2.872,0 -5.341,-2.036 -5.889,-4.855 l -28.328,-145.75 c -0.342,-1.759 0.12,-3.578 1.259,-4.961 1.14,-1.383 2.838,-2.183 4.63,-2.183 h 31.75 c 2.872,0 5.342,2.036 5.89,4.855 l 6.587,33.895 H 5.925 c 12.582,0 23.174,1.372 31.479,4.077 8.541,2.775 16.401,7.481 23.356,13.986 5.752,5.291 10.488,11.23 14.078,17.655 3.591,6.427 6.171,13.594 7.668,21.302 3.715,19.105 0.697,34.403 -8.969,45.467 -9.572,10.957 -24.613,16.513 -44.706,16.513 m -45.632,-90 H 2.511 c 12.801,0 22.336,2.411 28.601,7.234 6.267,4.824 10.492,12.875 12.688,24.157 2.102,10.832 1.145,18.476 -2.871,22.929 -4.02,4.453 -12.059,6.68 -24.121,6.68 H -4.946 l -11.855,-61 m 45.632,84 c 18.367,0 31.766,-4.82 40.188,-14.461 8.422,-9.641 10.957,-23.098 7.597,-40.375 -1.383,-7.117 -3.722,-13.624 -7.015,-19.519 -3.297,-5.899 -7.602,-11.293 -12.922,-16.184 -6.34,-5.933 -13.383,-10.161 -21.133,-12.679 -7.75,-2.525 -17.621,-3.782 -29.621,-3.782 h -27.196 l -7.53,-38.75 h -31.75 l 28.328,145.75 h 61.054"
+ fill="#ffffff" id="path254" />
+
+
+
+
+
+
+