ruby-xcdm
This is a tool for generating the same xcdatamodeld files that XCode does when designing a datamodel for Core Data. It is written in pure ruby, but it will be of particular interest to RubyMotion developers. It offers the essential features that XCode does, plus a text-based workflow (nicer for git, among other things) and some niceties, like automatic inverse relationships.
Installation
Add this line to your application's Gemfile:
gem 'ruby-xcdm'
And then execute:
$ bundle
Or install it yourself as:
$ gem install ruby-xcdm
Usage (RubyMotion)
- Make a directory called "schemas" inside your RubyMotion project
- Create one schema version per file within the directory
- To build the schema, run
rake schema:build
If you want to build the schema every time you run the simulator, add this to your Rakefile:
task :"build:simulator" => :"schema:build"
Usage (Plain Ruby)
- Make a directory to hold your schemas (a.k.a. data model in XCode parlance)
- Create one schema version per file within the directory
- Run the command to generate a datamodel:
xcdm MyApplicationName schemadir datamodeldestdir
Schema File Format
Here's a sample schema file:
schema "0.0.1" do
entity "Article" do
string :body, optional: false
integer32 :length
boolean :published, default: false
datetime :publishedAt, default: false
string :title, optional: false
belongs_to :author
end
entity "Author" do
float :fee
string :name, optional: false
has_many :articles
end
end
All the built-in data types are supported, and inverse relationships are generated automatically. If you need to set some of the more esoteric options on properties or relationships, you can include the raw parameters, like renamingIdentifier or defaultValueString.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request