RealFlags

🔧 Feature Flagging for Swift

Description

RealFlags makes it easy to configure feature flags in your codebase. It's designed for Swift and provides a simple and elegant abstraction layer over multiple providers you can query with your own priority. It also comes with an handy UI tool to browse and alter values directly at runtime!

Programming language: Swift

License: MIT License

Tags: Utility     iOS     Feature Toggle     SwiftLang     Firebase    

README

RealFlags makes it easy to configure feature flagsin your codebase.
It's designed for Swift and provides a simple and elegant abstraction layer over multiple providers you can query with your own priority.
It also comes with an handy UI tool to browse and alter values directly at runtime!

Features | What You Get | Flags Browser & Editor | Tests | Documentation | Requirements | Installation | Powered Apps | Support & Contribute | License

Features Highlights

• 💡 Simple & Elegant: Effectively describe and organize your own flags with a type-safe structure. It will abstract your implementation and consistently reduce the amount of code to manage your feature flags
• 💡 Extensible: You can use one of the default data providers or create your own. We support Firebase Remote and Local configurations too
• 💡 Complete: Feature Flags supports all primitive datatypes and complex objects: Int (and any numeric variant), String, Bool, Data, Date, URL, Dictionary, Array (values must conform to FlagProtocol), Optional Values and virtually any object conforms to Codable protocol!
• 💡 Configurable: Enable, disable and customize features at runtime
• 💡 Integrated UI Tool: the handy UI Tool allows you to customize and read flags at glance

What You Get

Our goal making RealFlags is to provide a type-safe abstract way to describe and query for feature flags.

The first step is to describe your collection of flags:

// Define the structure of your feature flags with type-safe properties!
struct UserFlags: FlagCollectionProtocol {
    @Flag(default: true, description: "Show social login options along native login form")
    var showSocialLogin: Bool

    @Flag(default: 0, description: "Maximum login attempts before blocking account")
    var maxLoginAttempts: Int

    @Flag(key: "rating_mode", default: "at_launch", description: "The behaviour to show the rating popup")
    var appReviewRating: String

    public init() {}
}

This represent a type-safe description of some flags grouped in a collection. Each feature flags property is identified by the @Flag annotation. It's time load values for this collection; using a new FlagsLoader you will be able to load and query collection's values from one or more data provider:

// Allocate your own data providers
let localProvider = LocalProvider(localURL: fileURL)
let fbProvider = FirebaseRemoteProvider()

// Loader is the point for query values
let userFlagsLoader = FlagsLoader(UserFlags.self, // load flags definition
                                  description: .init(name: "User Features", description: "Cool experimental features for user account"),
                                  providers: [fbProvider, localProvider]) // set providers

Now you can query values from userFlagsLoader by using the UserFlags structure (it suppports autocomplete and type-safe value thanks to @dynamicMemberLookup!).
Let me show it:

if userFlagsLoader.showSocialLogin { // query properties as type-safe with autocomplete!
    // do some stuff
}

Values are obtained respecting the order you have specified, in this case from Firebase Remote Config service then, when no value is found, into the local repository.
If no values are available the default value specified in @Flags annotation is returned.

This is just an overview of the library; if you want to know more follow the documentation below.

Flags Browser & Editor

RealFlags also comes with an handy tool you can use to browse and edit feature flags values directly in your client! It can be useful for testing purpose or allow product owners to enable/disable and verify features of the app.

[Checkout the doc for more infos!](./documentation/advanced_usage.md#3.5)

https://user-images.githubusercontent.com/235645/150638946-99646e96-d155-451f-a723-585ad7978c43.mp4

Tests

RealFlags includes an extensive collection of unit tests: you can found it into the Tests directory.

Documentation

The following documentation describe detailed usage of the library.

• 1.0 - [Introduction](./documentation/introduction.md)
  
  • 1.1 - [@Flag Annotation](./documentation/introduction.md#11-flag-annotation)
  • 1.2 - [@Flag Supported Datatypes](./documentation/introduction.md#12--flag-supported-data-types)
  • 1.3 - Codable types and @Flag
  • 1.4 - [Computed @Flag](./documentation/introduction.md#14-computed--flag)
  • 1.5 - [Load a Feature Flag Collection in a FlagLoader](./documentation/introduction.md#15-load-a-feature-flag-collection-in-a-flagloader)
  • 1.6 - [Configure Key Evaluation for FlagsLoader's @Flag](./documentation/introduction.md#16-configure-key-evaluation-for-flagsloaders-flag)
  • 1.7 - [Query a specific data provider](./documentation/introduction.md#17-query-a-specific-data-provider)
    
• 2.0 - [Organize Feature Flags](./documentation/organize_feature_flags.md)
  
  • 2.1 - [The @FlagCollection annotation](./documentation/organize_feature_flags.md#21-the-flagcollection-annotation)
  • 2.2 - [Nested Structures](./documentation/organize_feature_flags.md#22-nested-structures)
  • 2.3 - [Configure FlagCollection's contribution to properties keypath generation](./documentation/organize_feature_flags.md#23-configure-flagcollections-contribution-to-properties-keypath-generation)
• 3.0 - [Advanced Usage](./documentation/advanced_usage.md)
  
  • 3.1 - [Using FlagsManager](./documentation/advanced_usage.md#31-using-flagsmanager)
  • 3.2 - [Use and Creation of Data Providers](./documentation/advanced_usage.md#32---use-and-creation-of-data-providers)
  • 3.3 - [Firebase Remote Config with FirebaseRemoteProvider](./documentation/advanced_usage.md#33-firebase-remote-config-with-firebaseremoteprovider)
  • 3.4 - [Modify a feature flag at runtime](./documentation/advanced_usage.md#34-modify-a-feature-flag-at-runtime)
  • 3.5 - [Flags Browser & Editor](./documentation/advanced_usage.md#35-flags-browser--editor)

Requirements

RealFlags can be installed in any platform which supports Swift 5.4+ including Windows and Linux. On Apple platform the following configuration is required:

• iOS 12+
• Xcode 12.5+
• Swift 5.4+

Installation

To use RealFlags in your project you can use Swift Package Manager (our primary choice) or CocoaPods.

Swift Package Manager

Aadd it as a dependency in a Swift Package, add it to your Package.swift:

dependencies: [
    .package(url: "https://github.com/immobiliare/RealFlags.git", from: "1.0.0")
]

And add it as a dependency of your target:

targets: [
    .target(name: "MyTarget", dependencies: [
        .product(name: "https://github.com/immobiliare/RealFlags.git", package: "RealFlags")
    ])
]

In Xcode 11+ you can also navigate to the File menu and choose Swift Packages -> Add Package Dependency..., then enter the repository URL and version details.

CocoaPods

RealFlags can be installed with CocoaPods by adding pod 'RealFlags' to your Podfile.

pod 'RealFlags' // to import the core framework
pod 'RealFlagsFirebase' // to also import Firebase Data Provider

Powered Apps

RealFlags was created by the amazing mobile team at ImmobiliareLabs, the Tech dept at Immobiliare.it, the first real estate site in Italy.
We are currently using RealFlags in all of our products.

If you are using RealFlags in your app [drop us a message](mailto://[email protected]), we'll add below.

Support

Made with ❤️ by ImmobiliareLabs and Contributors

We'd love for you to contribute to RealFlags!
If you have any questions on how to use RealFlags, bugs and enhancement please feel free to reach out by opening a GitHub Issue.

License

RealFlags is licensed under the MIT license.
See the [LICENSE](./LICENSE) file for more information.