Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dgroup/vcs4sql
Organizing version control for the database(s) in a simple, elegant way.
https://github.com/dgroup/vcs4sql
changelog changeset database-control database-management gem liquibase ruby ruby-gem ruby-library sql sqlite vcs
Last synced: 14 days ago
JSON representation
Organizing version control for the database(s) in a simple, elegant way.
- Host: GitHub
- URL: https://github.com/dgroup/vcs4sql
- Owner: dgroup
- License: mit
- Created: 2020-01-13T21:44:22.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2020-03-29T14:24:46.000Z (over 4 years ago)
- Last Synced: 2024-10-26T00:37:15.567Z (22 days ago)
- Topics: changelog, changeset, database-control, database-management, gem, liquibase, ruby, ruby-gem, ruby-library, sql, sqlite, vcs
- Language: Ruby
- Homepage:
- Size: 78.1 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 12
-
Metadata Files:
- Readme: readme.md
- Changelog: changelog.md
- Contributing: .github/CONTRIBUTING.md
- License: license.txt
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://rubygems.org/gems/vcs4sql)
[](./license.txt)
[](https://github.com/dgroup/vcs4sql/graphs/commit-activity)
[](https://hitsofcode.com/view/github/dgroup/vcs4sql)
[](https://rubygems.org/gems/vcs4sql)
[](https://circleci.com/gh/dgroup/vcs4sql)
[](http://www.0pdd.com/p?name=dgroup/vcs4sql)
[](https://requires.io/github/dgroup/vcs4sql/requirements/?branch=master)
[](https://codeclimate.com/github/dgroup/vcs4sql/maintainability)
[](http://www.rultor.com/p/dgroup/vcs4sql)
[](http://www.elegantobjects.org/#principles)
In the last few years, version control for database became best practice.
There are several implementations/ways for ruby, however, most of them are focused/dependent on particular
frameworks that restrict the migration outside the framework.
vcs4sql allows organizing version control for the database(s) in a simple, elegant and lightweight way without any dependencies on existing frameworks.
The main idea is to keep changes as simple as possible and be able to have full control of the database structure without hidden frameworks "magic".
Initial PoC is designed for [sqlite](https://www.sqlite.org).
---
- [Quick start](#quick-start)
- [Support](#support)
- [License](#license)
- [Code of conduct](#code-of-conduct)
- [Contribution guide](#contribution-guide)
### Quick start
```
$ gem install vcs4sql
```
```bash
# Define the database migration scripts
$ tree
.
├── bin
├── Gemfile
├── Guardfile
├── Rakefile
├── ...
│ ├── ...
├── sqlite.db
├── ...
└── upgrades
└── sqlite
├── 001-install-main-tables.sql
├── 002-add-missing-indexes.sql
├── 003-add-missing-foreigh-keys.sql
├── ...
└── 999.testdata.sql
```
```ruby
require "vcs4sql"
Vcs4sql::Sqlite::Migration.new "sqlite.db"
.upgrade "upgrades/sqlite"
```
The scripts will be executed in a natural order based on name, so far.
### Support
If you want to report a bug, or have ideas, feedback or questions about the gem, [let me know via GitHub issues](https://github.com/dgroup/vcs4sql/issues/new) and I will do my best to provide a helpful answer. Happy hacking!
### License
The gem is available as open source under the terms of the [MIT License](license.txt).
### Code of conduct
Everyone interacting in this project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](.github/CODE_OF_CONDUCT.md).
### Contribution guide
Pull requests are welcome!