transmission/libtransmission/announce-list.h

143 lines
3.9 KiB
C
Raw Normal View History

// This file Copyright © 2021-2023 Mnemosyne LLC.
2022-08-08 18:05:39 +00:00
// It may be used under GPLv2 (SPDX: GPL-2.0-only), GPLv3 (SPDX: GPL-3.0-only),
// or any future license endorsed by Mnemosyne LLC.
// License text can be found in the licenses/ folder.
#pragma once
#include <cstddef> // size_t
#include <optional>
#include <string>
#include <string_view>
#include <vector>
2023-07-08 15:24:03 +00:00
#include "libtransmission/transmission.h"
2023-07-08 15:24:03 +00:00
#include "libtransmission/quark.h"
#include "libtransmission/interned-string.h"
#include "libtransmission/tr-macros.h"
struct tr_error;
struct tr_url_parsed_t;
class tr_announce_list
{
public:
struct tracker_info
{
tr_interned_string announce;
tr_interned_string scrape;
tr_interned_string host_and_port; // 'example.org:80'
tr_interned_string sitename; // 'example'
tr_interned_string query; // 'name=ferret'
tr_tracker_tier_t tier = 0;
tr_tracker_id_t id = 0;
[[nodiscard]] constexpr int compare(tracker_info const& that) const noexcept // <=>
{
if (this->tier != that.tier)
{
return this->tier < that.tier ? -1 : 1;
}
if (int const i{ this->announce.compare(that.announce) }; i != 0)
{
return i;
}
return 0;
}
[[nodiscard]] constexpr bool operator<(tracker_info const& that) const noexcept
{
return compare(that) < 0;
}
[[nodiscard]] constexpr bool operator==(tracker_info const& that) const noexcept
{
return compare(that) == 0;
}
};
private:
using trackers_t = std::vector<tracker_info>;
public:
[[nodiscard]] TR_CONSTEXPR20 auto begin() const noexcept
{
return std::begin(trackers_);
}
[[nodiscard]] TR_CONSTEXPR20 auto end() const noexcept
{
return std::end(trackers_);
}
[[nodiscard]] TR_CONSTEXPR20 bool empty() const noexcept
{
return std::empty(trackers_);
}
[[nodiscard]] TR_CONSTEXPR20 size_t size() const noexcept
{
return std::size(trackers_);
}
[[nodiscard]] TR_CONSTEXPR20 tracker_info const& at(size_t i) const
{
return trackers_.at(i);
}
[[nodiscard]] tr_tracker_tier_t nextTier() const;
[[nodiscard]] TR_CONSTEXPR20 bool operator==(tr_announce_list const& that) const
{
return trackers_ == that.trackers_;
}
[[nodiscard]] bool operator!=(tr_announce_list const& that) const
{
return trackers_ != that.trackers_;
}
bool add(std::string_view announce_url_sv)
{
return add(announce_url_sv, this->nextTier());
}
bool add(std::string_view announce_url_sv, tr_tracker_tier_t tier);
void add(tr_announce_list const& src);
bool remove(std::string_view announce_url);
bool remove(tr_tracker_id_t id);
bool replace(tr_tracker_id_t id, std::string_view announce_url_sv);
size_t set(char const* const* announce_urls, tr_tracker_tier_t const* tiers, size_t n);
2023-01-02 17:34:36 +00:00
TR_CONSTEXPR20 void clear()
{
return trackers_.clear();
}
/**
* Populate the announce list from a text string.
* - One announce URL per line
* - Blank line denotes a new tier
*/
bool parse(std::string_view text);
[[nodiscard]] std::string to_string() const;
bool save(std::string_view torrent_file, tr_error** error = nullptr) const;
[[nodiscard]] static std::optional<std::string> announce_to_scrape(std::string_view announce);
[[nodiscard]] static tr_quark announce_to_scrape(tr_quark announce);
private:
[[nodiscard]] tr_tracker_tier_t get_tier(tr_tracker_tier_t tier, tr_url_parsed_t const& announce) const;
[[nodiscard]] bool can_add(tr_url_parsed_t const& announce) const noexcept;
static tr_tracker_id_t next_unique_id();
trackers_t::iterator find(std::string_view announce);
trackers_t::iterator find(tr_tracker_id_t id);
trackers_t trackers_;
};