librats 0.7.1 → 0.8.0

package/native-src/CMakeLists.txt

@@ -129,6 +129,7 @@ set(LIBRARY_SOURCES
     src/krpc.cpp
     src/krpc.h
     src/librats.cpp
+    src/librats_discovery.cpp
     src/librats_reconnection.cpp
     src/librats_logging.cpp
     src/librats_encryption.cpp
@@ -136,6 +137,7 @@ set(LIBRARY_SOURCES
     src/librats_gossipsub.cpp
     src/librats_mdns.cpp
     src/librats_persistence.cpp
+    src/librats_statistic.cpp
     src/librats.h
     src/sha1.cpp
     src/sha1.h
@@ -157,13 +159,17 @@ set(LIBRARY_SOURCES
     src/rats_export.h
     ${PROJECT_BINARY_DIR}/src/version.h
 
-# Buffer utilities for bittorrent and file transfer
+# Buffer utilities for async I/O, file transfer, and bittorrent
     src/receive_buffer.h
     src/receive_buffer.cpp
     src/chained_send_buffer.h
     src/chained_send_buffer.cpp
 
-# Cypto algorithms including Noise Protocol needed
+# Platform-optimal I/O multiplexing (epoll/kqueue/IOCP)
+    src/io_poller.h
+    src/io_poller.cpp
+
+# Crypto algorithms including Noise Protocol
     src/crypto/curve25519.c
     src/crypto/curve25519.h
     src/crypto/chacha.c
@@ -430,6 +436,8 @@ if(RATS_BUILD_TESTS)
         tests/test_stun.cpp
         tests/test_turn.cpp
         tests/test_ice.cpp
+# I/O poller abstraction (epoll/kqueue/IOCP)
+        tests/test_io_poller.cpp
 # Buffer utilities for file transfer and bittorrent
         tests/test_receive_buffer.cpp
         tests/test_chained_send_buffer.cpp
@@ -501,3 +509,8 @@ if(RATS_BUILD_TESTS)
         RUNTIME_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/bin
     )
 endif()
+
+# Examples (basic examples always built; BT examples require RATS_SEARCH_FEATURES)
+if(RATS_BUILD_EXAMPLES)
+    add_subdirectory(examples)
+endif()

package/native-src/src/bt_client.cpp

@@ -326,7 +326,8 @@ Torrent::Ptr BtClient::add_torrent(const TorrentInfo& info,
 }
 
 Torrent::Ptr BtClient::add_magnet(const std::string& magnet_uri,
-                                   const std::string& save_path) {
+                                   const std::string& save_path,
+                                   bool skip_dht_search) {
     auto info = TorrentInfo::from_magnet(magnet_uri);
     if (!info) {
         if (on_alert_) {
@@ -345,7 +346,14 @@ Torrent::Ptr BtClient::add_magnet(const std::string& magnet_uri,
     
     // Create torrent without full metadata
     TorrentConfig torrent_config;
-    torrent_config.save_path = save_path.empty() ? config_.download_path : save_path;
+    // For metadata-only mode (skip_dht_search=true with empty save_path), keep save_path empty
+    // Otherwise use default download path if not specified
+    if (skip_dht_search && save_path.empty()) {
+        // Metadata-only mode - keep empty save_path for proper detection
+        torrent_config.save_path = "";
+    } else {
+        torrent_config.save_path = save_path.empty() ? config_.download_path : save_path;
+    }
     torrent_config.resume_data_path = config_.resume_data_path;
     torrent_config.max_connections = config_.max_connections_per_torrent;
     torrent_config.max_uploads = config_.max_uploads;
@@ -362,8 +370,8 @@ Torrent::Ptr BtClient::add_magnet(const std::string& magnet_uri,
     if (running_) {
         torrent->start();
         
-        // Find peers via DHT for metadata
-        if (dht_running_) {
+        // Find peers via DHT for metadata (skip if using direct peer connection)
+        if (dht_running_ && !skip_dht_search) {
             find_peers_dht(info->info_hash());
         }
     }
@@ -891,6 +899,9 @@ void BtClient::announce_torrents_to_trackers() {
     for (auto& [hash, torrent] : torrents_) {
         if (!torrent->is_active()) continue;
         
+        // Skip metadata-only torrents (empty save_path means only fetching metadata)
+        if (torrent->save_path().empty()) continue;
+        
         auto tracker_it = tracker_managers_.find(hash);
         if (tracker_it == tracker_managers_.end()) continue;
         
@@ -993,12 +1004,14 @@ void BtClient::tick_loop() {
         }
         
         // Periodic DHT announces (every 15 minutes)
+        // Skip metadata-only torrents (empty save_path) to avoid unnecessary network traffic
         auto dht_elapsed = std::chrono::duration_cast<std::chrono::minutes>(
             now - last_dht_announce_).count();
         if (dht_elapsed >= 15 && dht_running_) {
             std::lock_guard<std::mutex> lock(mutex_);
             for (auto& [hash, torrent] : torrents_) {
-                if (torrent->is_active()) {
+                // Skip metadata-only torrents (empty save_path means only fetching metadata)
+                if (torrent->is_active() && !torrent->save_path().empty()) {
                     announce_to_dht(hash);
                 }
             }

package/native-src/src/bt_client.h

@@ -170,10 +170,12 @@ public:
      * 
      * @param magnet_uri Magnet URI
      * @param save_path Directory to save files
+     * @param skip_dht_search If true, don't search DHT for peers (for metadata-only from specific peer)
      * @return Torrent pointer, or nullptr on failure
      */
     Torrent::Ptr add_magnet(const std::string& magnet_uri,
-                            const std::string& save_path = "");
+                            const std::string& save_path = "",
+                            bool skip_dht_search = false);
     
     /**
      * @brief Add a torrent with resume data for fast resume