Skip to content

Commit

Permalink
Expanded on the README.
Browse files Browse the repository at this point in the history
  • Loading branch information
ziminji committed Mar 29, 2011
1 parent 5bca8dc commit a57ca12
Showing 1 changed file with 30 additions and 15 deletions.
45 changes: 30 additions & 15 deletions README.md
Expand Up @@ -12,21 +12,24 @@ All classes are designed to be used in iPhone/iOS applications.
The goal is to make these classes the "de facto" standard for communicating with SQLite databases on iPhone/iOS devices. The goal is to make these classes the "de facto" standard for communicating with SQLite databases on iPhone/iOS devices.


After looking at other Objective-C SQLite projects, it was obvious that there was a need for an Objective-C library that After looking at other Objective-C SQLite projects, it was obvious that there was a need for an Objective-C library that
offers more than just a set of wrapper classes. It was even more apparent that classes needed to be written very cleanly offers more than just a set of SQLite wrapper classes. It was even more apparent that classes needed to be written very
and with clear naming conventions similar to those in LINQ. With the abundance of third-party libraries for Objective-C, cleanly and with clear naming conventions similar to those in LINQ. With the abundance of third-party libraries for
developers are craving libraries that are simple to learn and are intuitive. Therefore, the classes in this repository Objective-C, developers are craving libraries that are simple to learn and are intuitive. Therefore, the classes in this
are written with these observations in mind. repository are written with these observations in mind.


## Features ## Features


The following is a short-list of some the features: The following is a short-list of some the features:


* Implements a very simple, but powerful, Data Access Object (DAO). * Implements a very simple, but powerful, Data Access Object (DAO).
* Executes an SQL statement with one line of code.
* Has a large collection of SQL builder classes with methods that mimics their SQL equivalent. * Has a large collection of SQL builder classes with methods that mimics their SQL equivalent.
* SQL builder classes help ensure that SQL is well-formed. * Helps ensure that SQL is well-formed.
* Execute an SQL statement or query using an SQL statement with one line of code. * Sanitizes data.
* Good performance. * Handles most complex queries.
* Classes are easily extendable. * Works with raw SQL.
* Requires only those classes that are needed. Great for mobile development.
* Classes are easily extendible.


## Getting Started ## Getting Started


Expand All @@ -36,8 +39,8 @@ Using these class in an Xcode project is easy to do. Here is how:
2. Navigate to the tarball in Finder. 2. Navigate to the tarball in Finder.
3. Unachieve the tarball by double-clicking it in a Finder window. 3. Unachieve the tarball by double-clicking it in a Finder window.
4. Open an Xcode project. 4. Open an Xcode project.
5. Right-click on the "Classes" folder and "Add >> Existing Files...". 5. Right-click on the "Classes" folder and click on the "Add >> Existing Files..." option.
6. Highlight the files, then click "Add". 6. Highlight the files, then click the "Add" button.
7. Check "Copy items into destination group's folder (if needed)". 7. Check "Copy items into destination group's folder (if needed)".
8. Select "Default" for the "Reference Type". 8. Select "Default" for the "Reference Type".
9. Choose "Recursively create groups for any added folders". 9. Choose "Recursively create groups for any added folders".
Expand All @@ -51,26 +54,38 @@ To use these classes in an Xcode project, add the following framework:


### Documentation ### Documentation


All classes are heavily documented. You can get familiar with each class by simply opening its respective ".h" file. All classes are heavily documented with [HeaderDoc](http://developer.apple.com/library/mac/#documentation/DeveloperTools/Conceptual/HeaderDoc/intro/intro.html#//apple_ref/doc/uid/TP40001215-CH345-SW1). You can get familiar with each class by simply opening its respective ".h" file. You can also
You can also find more information on this repository's Wiki. find more information on this repository's Wiki.


### Examples ### Examples


Checkout this repository's Wiki for a handful of examples. Checkout this repository's Wiki for a handful of examples. There, you will find examples on how to build Create, Read,
Update, and Delete (CRUD) statements.


## Reporting Bugs & Making Recommendations ## Reporting Bugs & Making Recommendations


Help debug the Objective-C classes in repository by reporting any bugs. The more detailed the report the better. If Help debug the Objective-C classes in repository by reporting any bugs. The more detailed the report the better. If
you have a bug-fix or a unit-test, please send a message to this repository's inbox. you have a bug-fix or a unit-test, please send a message to this repository's inbox.


Likewise, if you would like to make a recommendation on how to improve these classes, take the time to send a message Likewise, if you would like to make a recommendation on how to improve these classes, take the time to send a message
so that it can be considered for an upcoming release. This will help keep the repository active. so that it can be considered for an upcoming release. Or, if you would like to contribute to the development of this
repository, go ahead and create a fork.

## Future Development

This project is under heavy development. There are development plans to add:

* More SQL builder classes;
* Object Relation Modeling (ORM) that will utilize both the Data Mapper and Active Record design patterns;
* Unit-tests;
* Documentation generated via Doxygen; and,
* Additional tutorials.


## License (Apache v2.0) ## License (Apache v2.0)


Copyright 2011 Ziminji Copyright 2011 Ziminji


Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the Licensed under the Apache License, Version 2.0 (the "License"); you may not use these files except in compliance with the
License. You may obtain a copy of the License at: License. You may obtain a copy of the License at:


[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0) [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
Expand Down

0 comments on commit a57ca12

Please sign in to comment.