Nora is a Firebase abstraction layer designed to make your development process with FirebaseDatabase and FirebaseStorage seamless. It’s like having a magical assistant that handles the intricate details while you focus on crafting great apps. Let’s dive into the installation and usage of Nora, so you can save time and effort!

Installation

The recommended way to install Nora is via CocoaPods. Simply include the line in your Podfile:

pod Nora

Working with FirebaseDatabase

Setting up a target and making requests with Nora is straightforward. Here’s how you can fetch user data effortlessly:

let database = DatabaseProviderUsers()
database.request(.getUser(id: 1)) { result in
    switch result {
    case .success(let response):
        let snapshot = response.snapshot
    case .failure(let error):
        print(error.localizedDescription)
    }
}

Decoding Database Responses

Nora makes it easy to convert database responses into your custom types using a JSON initializer. This process can be understood with an analogy: think of it as someone who sorts and organizes your incoming mail based on your specifications. Here’s how you can convert the user data:

let database = DatabaseProviderUsers()
database.request(.getUser(id: 1)) { result in
    switch result {
    case .success(let response):
        let user = try? response.mapTo(User.init)
    case .failure(let error):
        print(error.localizedDescription)
    }
}

Working with FirebaseStorage

Uploading data is equally simple with Nora. Here’s an example of how to upload an avatar image:

let storage = StorageProviderAvatars()
let avatarData = Data() // Your avatar data here
var meta = FIRStorageMetadata?()
storage.request(.upload(avatarData, meta)) { result in
    switch result {
    case .success(_):
        print("Upload Success!")
    case .failure(let error):
        print(error.localizedDescription)
    }
}

Documentation

For more detailed instructions, you can check the following:

• DatabaseTarget Documentation
• DatabaseProvider Documentation

Troubleshooting

When using Nora, you may encounter some issues. Here are a few troubleshooting ideas:

• Check your Pod installation: Ensure you have included Nora correctly in your Podfile and run `pod install`.
• Firebase Configuration: Verify that your Firebase is properly set up in your project. This includes adding your `GoogleService-Info.plist` file.
• Update Dependencies: Ensure all your dependencies, including CocoaPods, are up to date.
• Error Handling: Use proper error handling in your code to capture and understand failures.

For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.

Get Involved

We encourage everyone to participate in this open-source project, whether through code contributions, improving documentation, or simply sharing your feedback. No matter your experience level, your input is invaluable!

Inspiration

Nora is inspired by the Moya networking abstraction layer in Swift. If you’re using traditional networking, definitely give Moya a look!

License

Nora is released under an MIT license. For more information, see LICENSE.md.

At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.