Home

CoreStore

Unleashing the real power of Core Data with the elegance and safety of Swift (Swift, iOS 8+)

What CoreStore does better:

• Heavily supports multiple persistent stores per data stack, just the way .xcdatamodeld files are designed to. CoreStore will also manage one data stack by default, but you can create and manage as many as you need.
• New in 1.0.0: Incremental Migrations! Just tell the data stack the sequence of model versions and CoreStore will automatically use incremental migrations if needed on stores added to that stack.
• Ability to plug-in your own logging framework
• Gets around a limitation with other Core Data wrappers where the entity name should be the same as the NSManagedObject subclass name. CoreStore loads entity-to-class mappings from the managed object model file, so you are free to name them independently.
• Provides type-safe, easy to configure observers to replace NSFetchedResultsController and KVO
• Exposes API not just for fetching, but also for querying aggregates and property values
• Makes it hard to fall into common concurrency mistakes. All NSManagedObjectContext tasks are encapsulated into safer, higher-level abstractions without sacrificing flexibility and customizability.
• Exposes clean and convenient API designed around Swift’s code elegance and type safety.
• Documentation! No magic here; all public classes, functions, properties, etc. have detailed Apple Docs. This README also introduces a lot of concepts and explains a lot of CoreStore's behavior.

CoreStore's goal is not to expose shorter, magical syntax, but to provide an API that focuses on readability, consistency, and safety.

Contents

• TL;DR (a.k.a. sample codes)
• Architecture
• CoreStore Tutorials (All of these have demos in the CoreStoreDemo app project!)
  • Setting up
  • Migrations
    • Incremental migrations
    • Forecasting migrations
  • Saving and processing transactions
    • Transaction types
      • Asynchronous transactions
      • Synchronous transactions
      • Detached transactions
    • Creating objects
    • Updating objects
    • Deleting objects
  • Fetching and querying
    • From clause
    • Fetching
      • Where clause
      • OrderBy clause
      • Tweak clause
    • Querying
      • Select<T> clause
      • GroupBy clause
  • Logging and error handling
  • Observing changes and notifications
    • Observe a single object
    • Observe a list of objects
• Installation
• Changesets
  • Upgrading from v0.2.0 to 1.0.0

Roadmap

• Data importing utilities for transactions
• Support iCloud stores

Contributions

While CoreStore's design is pretty solid and the unit test and demo app work well, CoreStore is pretty much still in its early stage. With more exposure to production code usage and criticisms from the developer community, CoreStore hopes to mature as well. Please feel free to report any issues, suggestions, or criticisms! 日本語で連絡していただいても構いません！

License

CoreStore is released under an MIT license. See the LICENSE file for more information