{"id":15048166,"url":"https://github.com/github/skeema","last_synced_at":"2025-10-04T07:31:43.188Z","repository":{"id":37497346,"uuid":"206270194","full_name":"github/skeema","owner":"github","description":"Schema management CLI for MySQL","archived":false,"fork":true,"pushed_at":"2024-07-01T21:08:27.000Z","size":5645,"stargazers_count":23,"open_issues_count":1,"forks_count":12,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-09-30T00:20:21.639Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"skeema/skeema","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/github.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null}},"created_at":"2019-09-04T08:29:11.000Z","updated_at":"2024-07-31T03:10:02.000Z","dependencies_parsed_at":"2023-09-25T03:52:17.816Z","dependency_job_id":null,"html_url":"https://github.com/github/skeema","commit_stats":{"total_commits":345,"total_committers":9,"mean_commits":"38.333333333333336","dds":0.255072463768116,"last_synced_commit":"fbbd0d5658807777e8e0df5cdb090e55b789a588"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fskeema","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fskeema/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fskeema/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github%2Fskeema/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/github","download_url":"https://codeload.github.com/github/skeema/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235227462,"owners_count":18956137,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-24T21:08:54.123Z","updated_at":"2025-10-04T07:31:42.198Z","avatar_url":"https://github.com/github.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Skeema](https://www.skeema.io/img/logo.png)](https://www.skeema.io)\n\n[![build status](https://img.shields.io/travis/skeema/skeema/master.svg)](https://travis-ci.org/skeema/skeema)\n[![code coverage](https://img.shields.io/coveralls/skeema/skeema.svg)](https://coveralls.io/r/skeema/skeema)\n[![downloads](https://img.shields.io/github/downloads/skeema/skeema/total.svg)](https://github.com/skeema/skeema/releases)\n[![latest release](https://img.shields.io/github/release/skeema/skeema.svg)](https://github.com/skeema/skeema/releases)\n\nSkeema is a tool for managing MySQL tables and schema changes in a declarative fashion using pure SQL. It provides a CLI tool allowing you to:\n\n* Export CREATE TABLE statements to the filesystem, for tracking in a repo (git, hg, svn, etc)\n* Diff changes in the schema repo against live DBs to automatically generate DDL\n* Manage multiple environments (e.g. dev, staging, prod) and keep them in sync with ease\n* Configure use of online schema change tools, such as pt-online-schema-change, for performing ALTERs\n* Convert non-online migrations from frameworks like Rails or Django into online schema changes in production\n\nSkeema supports a pull-request-based workflow for schema change submission, review, and execution. This permits your team to manage schema changes in exactly the same way as you manage code changes. Our new companion [CI app for GitHub repos](https://github.com/apps/skeema-io) even provides automatic linting of schema change pull requests.\n\n## Downloading\n\nPre-built `skeema` binaries for Linux and macOS can be downloaded from the [releases](https://github.com/skeema/skeema/releases) page.\n\n## Compiling\n\nCompiling from scratch requires the [Go programming language toolchain](https://golang.org/dl/), version 1.12 or higher.\n\nTo download, build from master, and install (or upgrade) Skeema, run:\n\n`go get -u github.com/skeema/skeema`\n\n## Documentation\n\n* [Getting started](doc/examples.md): usage examples and screencasts\n* [Recommended workflow](doc/workflow.md)\n* [Configuration how-to](doc/config.md)\n* [Options reference](doc/options.md)\n* [Requirements](doc/requirements.md)\n* [Frequently asked questions](doc/faq.md)\n* [Skeema.io CI beta](https://www.skeema.io/ci) -- **new**\n\n## Status\n\nThe Skeema CLI tool is generally available, having reached the v1 release milestone in July 2018. Prior to that, it was in public beta since October 2016.\n\nThe `skeema` binary is supported on macOS and Linux. No native Windows version is available yet, though the Linux binary works properly under WSL.\n\nTagged releases are tested against the following databases, all running on Linux:\n\n* MySQL 5.5, 5.6, 5.7, 8.0\n* Percona Server 5.5, 5.6, 5.7, 8.0\n* MariaDB 10.1, 10.2, 10.3, 10.4\n\nOutside of a tagged release, every commit to the master branch is automatically tested against MySQL 5.6 and 5.7.\n\nA few uncommon MySQL features -- such as spatial indexes and subpartitioning -- are not supported yet. Skeema is able to *create* or *drop* tables using these features, but not *alter* them. The output of `skeema diff` and `skeema push` clearly displays when this is the case. You may still make such alters directly/manually (outside of Skeema), and then update the corresponding CREATE TABLE files via `skeema pull`.\n\n## Credits\n\nCreated and maintained by [@evanelias](https://github.com/evanelias).\n\nAdditional [contributions](https://github.com/skeema/skeema/graphs/contributors) by:\n\n* [@tomkrouper](https://github.com/tomkrouper)\n* [@efixler](https://github.com/efixler)\n* [@chrisjpalmer](https://github.com/chrisjpalmer)\n* [@johlo](https://github.com/johlo)\n* [@blueish](https://github.com/blueish)\n* [@thinQ-skeema](https://github.com/thinQ-skeema)\n\nSupport for stored procedures and functions generously sponsored by [Psyonix](https://psyonix.com).\n\nSupport for partitioned tables generously sponsored by [Etsy](https://www.etsy.com).\n\n## License\n\n**Copyright 2020 Skeema LLC**\n\n```text\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithub%2Fskeema","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgithub%2Fskeema","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithub%2Fskeema/lists"}