TweetieFeed

Twitter feeds for SwiftUI

Supports:

• Twitter API v1.1 and v2
• iOS 14+
• Xcode 13+

Installation

Add the package to Package.swift dependencies:

dependencies: [
    .package(url: "https://github.com/ugalek/TweetieFeed.git", from: "0.1.0")
]

Usage

Import TweetieFeed:

import TweetieFeed

In your App struct, initialize a TweetieFeedUISettings instance as StateObject, then give this instance to environmentObject:

struct MyApp: App {
    @StateObject var uiSettings = TweetieFeedUISettings()
    
    var body: some Scene {
        WindowGroup {
            ContentView(viewModel: ExampleViewModel())
                .environmentObject(uiSettings)
        }
    }
}

TweetieFeedUISettings takes the following optional parameters to customize the view:

In your view model, use TweetieFeedDecoder to decode the data according the API version:

class YourViewModel: ObservableObject {
    var feedDecoder: TweetieFeedDecoder?
    
    init(feedDecoder: TweetieFeedDecoder? = nil) {
        self.feedDecoder = feedDecoder
    }
    
    func getData(version: TwitterAPIVersion = .v1) {
        // Fetch Twitter API data here
        ...
        let task = URLSession.shared.dataTask(with: request) { data, _, _ in
            DispatchQueue.main.async {
                self.feedDecoder = TweetieFeedDecoder(data: data, version: version)
            }
        }
        task.resume()
        ...
    }
}

In your SwiftUI view, declare a TweetieFeedView with the TweetieFeedDecoder instance created before:

VStack {
    ...
    TweetieFeedView(tweetieDecoder: viewModel.feedDecoder)
    ...
}
.onAppear {
    viewModel.getData()
}

Don't forget to add the onAppear modifier that calls the view model method that handles data fetching and decoding.

You can find an example in the Example folder.

Twitter API fields (required / recommended)

v1.1

tweet_mode=extended is required.

v2

These fields are recommended for best display but not required.

expansions:

• attachments.media_keys
• author_id is required
• entities.mentions.username
• in_reply_to_user_id
• referenced_tweets.id

tweet.fields:

• attachments
• author_id
• created_at is required
• entities
• id
• in_reply_to_user_id
• possibly_sensitive
• public_metrics
• reply_settings
• text

user.fields:

• created_at
• description
• entities
• id
• name
• profile_image_url
• username

media.fields:

• heigh
• media_key
• preview_image_url
• type
• url
• width

License

TweetieFeed is under MIT license. See the LICENSE file for more info.