ActiveRecord ReadMe

About:

ActiveRecord is an insanely easy to use database framework written in objective-c It's obviously "inspired" by the infamous ActiveRecord that comes with Rails(http://rubyonrails.org) But it tries to be more versatile when it comes to working with multiple connections.

ActiveRecord was written by Fjölnir Ásgeirsson and is licensed with the BSD license.

Features:

• Supported databases

• SQLite 3
• MySQL 5.0 (Currently not maintained)

• Supported relationships

• Has many
• Has one
• Has and belongs to many
• Belongs to

• Almost no code required

Minitutorial

To create a model there are 2 steps.

• 1 Create the table in your database
• 2 Create a model class named as the singularized version of your table name (people -> person)

Example: Let's say I created a table called 'people' with 3 columns.

• id as the primary key
• firstName as varchar(255)
• lastName as varchar(255)

And loaded it using

[ARBase setDefaultConnection:[ARSQLiteConnection openConnectionWithInfo:[NSDictionary dictionaryWithObject:<path> forKey:@"path"] error:&err];

Then we'd create the following class definition:

@interface Person : ARBase
@end

And to prevent the compiler from complaining when we call custom accessors we also create properties to suppress 'method missing' warnings. So the class definition will look like:

@interface Person : ARBase
	@property(readwrite, assign) NSString *firstName, *lastName
@end

and the implementation:

@implementation Person
	@dynamic firstName, lastName
@end

That's it. Now we can get people like so:

NSArray *people = [Person find:ARFindAll];

and if we want the name of the second person we could:

Person *person = [people objectAtIndex:1];
NSLog(@"%@ %@", person.firstName, person.lastName);

Contributing:

If you wish to send patches you can email them to fjolnir@gmail.com

When writing patches please keep in mind the existing coding style Here's most of it:

- (id)aMethod:(int)argument
{
  int myVar = 123;
  if(myVar != 123)
    NSLog(@"impossible!");
  else
  {
    NSLog(@"Very possible..");
    // More lines of code!
  }
}