Package: kinto-wizard
kinto-wizardkinto-wizard is a tool that lets you setup an entire Kinto server from
a Yaml file, or inspect an existing server and output a Yaml file.You can define Kinto objects (bucket, collection, groups, records)
and configure their attributes and permissions.Read more information about the file structureInstallationThe last releasepipinstallkinto-wizardThe development versionAfter having cloned the repo:pipinstall-e.How to use it?Loadkinto-wizardload\--serverhttps://kinto-writer.stage.mozaws.net/v1\--authadmin:credentials\new-config.ymlDumpkinto-wizarddump\--serverhttps://kinto-writer.stage.mozaws.net/v1\--authadmin:credentials\>current-config.ymlThe dump command also accepts these options:--data- Include buckets, collections and groups data (attachments, schemas, display fields, uischema etc.).--records- Include collections` records.--full- Combination of data and records.Validate a dumpThe way Kinto works is by letting you change a collection schema but
won’t enforce the new schema for existing records.When you dump a collection and its records, you can end-up having
records that Kinto won’t let you upload back because the schema
changed and they are invalid with the current schema.This can lead to unexpected behavior on loading time which is a bit
cumbersome because depending of the size of the file you are loading,
it can takes a long time before getting an actual error.In order to fix the file before loading, you can use the validate
command that would give you the error Kinto would return if you were
to load the file on a Kinto server.kinto-wizardvalidatecurrent-config.ymlChangelogThis document describes changes between each past release.4.0.2 (2023-11-30)Internal ChangesRemove usage of deprecatedruamel.yamlloading and dumping function (now requires >0.15, released in 2019) (#296)Fix tests coverage.4.0.1 (2018-12-10)Bug fixesHandle Draftv4 schema validation for empty required.4.0.0 (2018-12-10)Breaking changeskinto-wizardloadnow expects to find abuckets:root level in
the YAML file.  Andkinto-wizarddumpwill now add it (fixes #59)New featureAdd avalidatecommand to run JSON schema validation on the records
locally. (fixes #61)Internal changesTo ease the transition between kinto-wizard 3 and kinto-wizard 4,
handle both for a couple of releases. (#64)3.0.0 (2018-10-17)Breaking changesUpgrade to kinto-http.py 10.0 means that the batch will fail if one
of the server responses has a 4XX status, use the--ignore-batch-4xxto keep the previous behaviour.New featuresAdd an--ignore-batch-4xxoption to explicitly ask for silent
4xx errors.Bug fixesHandle YAML date and datetime values. (#51)Internal changesAdd test for YAML node anchors support (#52)
Seehttps://en.wikipedia.org/wiki/YAML#Advanced_components2.4.0 (2018-05-23)Add a--dry-runfor the load command to see how many records
would be deleted. (#46)Add a--delete-recordto delete the existing records that are
not in the YAML file. (#47)2.3.0 (2017-10-04)Add--dataand--recordsoptions to be able to dump objects
data without dumping records. (#33)2.2.0 (2017-09-01)New featuresUseasyncioto add parallelism to theloadcommand (#18).2.1.0 (2017-06-28)New featuresAdd logger configuration for kinto-http.py (#26)Add an option to force the update with a CLIENT_WINS strategy (#28)Add an option to select the bucket or collection to export (#30)2.0.0 (2017-05-22)Breaking changesUpgrade to kinto-http 8.0.0 with Python 3.5+ support.The--fulloption of thedumpcommand now outputs records (#16)New featuresTheloadcommand now supports records (#16)1.0.0 (2016-11-22)Initial versionSupports dumping/loading groups and permissions from/to a YAML file.ContributorsRémy Hubscher <rhubscher@mozilla.com>Mathieu Leplatre <mathieu@mozilla.com>Gabriela Surita <gabsurita@gmail.com>