Package: schemaman
# SchemaManSchemaMan is a schema manager for multiple databases, so that schema confguration can be stored in meta data files, and applied equally to any database.SchemaMan can be used as a generic wrapper for working with databases, or migrating data between databases, who have SchemaMan schemas defined.The focus of SchemaMan is on smaller low-volume data sets, such as found in System or Network Configuration management systems.## Version ManagementAllows versioning data.## Change ManagamentApprovals can be required to commit data from a Working Version into the datasource.## Version and Change Management Definitions* **VMCM** - Version Management and Change Management system* **Working Change Set** - A list of record fields that a Data Set User is making edits to.  These are not applied to any live datasource, and are not integration until all the edits are finished, a Pending Change Set is created, for review.* **Pending Change Set** - A list of record fields that a Data Set User has specified as edits in a Working Change Set, and promoted to a Pending Change Set for review.  The approval process starts here.* **Approved Change Set** - A list of record fields that a Data Set User promoted to a Pending Change Set, and then all required approvers marked "Approved" moving the state from Pending to Approved.  The next step is Deployed Change Set.* **Deployed Change Set** - A list of record fields that has been approved.  A Data Set will need to trigger a Deployment of the changes, which is when the changes are actually applied into the Data Set's data sources.  Before this point, no data changes were made to the Data Set's data sources.  This write must be done by the Data Set itself, as ChangeIn has no knowledge of how this would happen or authorization to perform this work.  Call backs should be implemented for pre- and post- deployment scripts, so that they stages can be processed in ChangeIn, tracking the progress of the work.* **Committed Change Set** - A list of record fields that has been deployed and written into a Data Set's data sources.  The committed data is kept in ChangeIn to provide auditing functionality, and also for retrieval for use in Roll Backs.* **Collected Change Set** - A list of record fields that was either rejected or otherwise brought out of the approval process, but is still collected together for editing purposes.* **Approval Group** - All record field changes have an Approval Group consisting of 1 or more Approvers, which is provided by the Data Set at Working Change Set update or before the Pending Change Set promotion through a call to the Data Set API which takes all the record field changes and returns the list of Approval Groups and Approvers in the ChangeIn specified format.* **Approvers** - Members of an approval group.  Human or role accounts.  This could also be a Service based authorization, through API call-back.## Security, Owners, and ActionsThe Change Management can invoke scripts against data for owners, groups to provide security and proper approvals, and can invoke scripts as actions to perform pre- and post- commit work at various levels.# Command Line Usage```Schema Actions:info                                       Print info on current schema directoryinit <path>                                Initialize a path for new schemasschema create <schema>                     Create a schema interactivelyschema export <schema> <source>            Export a database schema from a sourceschema update <schema> <source> <target>   Migrate schema/data from source to targetdata export <schema> <source>              Export all the data from the schema/sourcedata import <schema> <source>              Import data into the schema/sourcePrimary Data Actions:put <schema> <source> <json>        Put JSON data into a Schema instanceget <schema> <source> <json>        Get Schema instance records from JSON keysfilter <schema> <source> <json>     Filter Schema instance recordsdelete <schema> <source> <json>     Delete records from Schema instanceAdditional Data Actions:action config version_change_management <target_schema>  Configure Version and Change Managementaction populate schema_into_db <target_schema>           Populate Schema Into DBOptions:-d <path>, --dir=<path>             Directory for SchemaMan data/conf/schemas(Default is current working directory)-y, --yes                           Answer Yes to all prompts-h, -?, --help                      This usage information-v, --verbose                       Verbose output```# Docs* [Overview](docs/overview.md)* [Getting Started](docs/getting_started.md)* [To-Do List](docs/todo.md)