zelo72
/
mastodon-ios
mirror of https://github.com/mastodon/mastodon-ios
2
2
Fork 1
Code Issues 19 Releases Wiki Activity

feat: add hashtag timeline API

This commit is contained in:
jk234ert 2021-03-30 14:16:08 +08:00
parent 379884b001
commit 8c3040c0f9
1 changed files with 73 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

73
MastodonSDK/Sources/MastodonSDK/API/Mastodon+API+Timeline.swift
View File

@ -16,6 +16,10 @@ extension Mastodon.API.Timeline {
static func homeTimelineEndpointURL(domain: String) -> URL {
return Mastodon.API.endpointURL(domain: domain).appendingPathComponent("timelines/home")
}
static func hashtagTimelineEndpointURL(domain: String, hashtag: String) -> URL {
return Mastodon.API.endpointURL(domain: domain)
.appendingPathComponent("tag/\(hashtag)")
}
/// View public timeline statuses
///
@ -81,6 +85,38 @@ extension Mastodon.API.Timeline {
.eraseToAnyPublisher()
}
/// View public statuses containing the given hashtag.
///
/// - Since: 0.0.0
/// - Version: 3.3.0
/// # Last Update
/// 2021/3/29
/// # Reference
/// [Document](https://https://docs.joinmastodon.org/methods/timelines/)
/// - Parameters:
/// - session: `URLSession`
/// - domain: Mastodon instance domain. e.g. "example.com"
/// - query: `HashtagTimelineQuery` with query parameters
/// - hashtag: Content of a #hashtag, not including # symbol.
/// - Returns: `AnyPublisher` contains `Token` nested in the response
public static func hashtag(
session: URLSession,
domain: String,
query: HashtagTimelineQuery,
hashtag: String
) -> AnyPublisher<Mastodon.Response.Content<[Mastodon.Entity.Status]>, Error> {
let request = Mastodon.API.get(
url: hashtagTimelineEndpointURL(domain: domain, hashtag: hashtag),
query: query,
authorization: nil
)
return session.dataTaskPublisher(for: request)
.tryMap { data, response in
let value = try Mastodon.API.decode(type: [Mastodon.Entity.Status].self, from: data, response: response)
return Mastodon.Response.Content(value: value, response: response)
}
.eraseToAnyPublisher()
}
}
public protocol TimelineQueryType {
@ -167,4 +203,41 @@ extension Mastodon.API.Timeline {
}
}
public struct HashtagTimelineQuery: Codable, TimelineQuery, GetQuery {
public let maxID: Mastodon.Entity.Status.ID?
public let sinceID: Mastodon.Entity.Status.ID?
public let minID: Mastodon.Entity.Status.ID?
public let limit: Int?
public let local: Bool?
public let onlyMedia: Bool?
public init(
maxID: Mastodon.Entity.Status.ID? = nil,
sinceID: Mastodon.Entity.Status.ID? = nil,
minID: Mastodon.Entity.Status.ID? = nil,
limit: Int? = nil,
local: Bool? = nil,
onlyMedia: Bool? = nil
) {
self.maxID = maxID
self.sinceID = sinceID
self.minID = minID
self.limit = limit
self.local = local
self.onlyMedia = onlyMedia
}
var queryItems: [URLQueryItem]? {
var items: [URLQueryItem] = []
maxID.flatMap { items.append(URLQueryItem(name: "max_id", value: $0)) }
sinceID.flatMap { items.append(URLQueryItem(name: "since_id", value: $0)) }
minID.flatMap { items.append(URLQueryItem(name: "min_id", value: $0)) }
limit.flatMap { items.append(URLQueryItem(name: "limit", value: String($0))) }
local.flatMap { items.append(URLQueryItem(name: "local", value: $0.queryItemValue)) }
onlyMedia.flatMap { items.append(URLQueryItem(name: "only_media", value: $0.queryItemValue)) }
guard !items.isEmpty else { return nil }
return items
}
}
}