You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iggy.apache.org by "marvin-hansen (via GitHub)" <gi...@apache.org> on 2025/04/19 09:11:38 UTC

[I] Split SDK crate into some smaller crates [iggy]

marvin-hansen opened a new issue, #1713:
URL: https://github.com/apache/iggy/issues/1713

   As discussed on [Discord](https://discord.com/channels/1144142576266530928/1161593488954114059/1363007323613822976),
   
   the idea is to slim down the SDK mega crate into a number of small crates. 
   
   The expected benefits:
   - Smaller SDK crate that is simpler to reason about
   - Consolidate and clean up shared code
   - Isolate and version the binary protocol in a dedicated crate to structure compatibility 
   
   The last point is rooted in the idea to make the Iggy binary protocol easily accessible to third parties so they can add new language bindings, clients, and tools. This is similar in spirit as the open Postgres protocol that lead to a vibrant ecosystem. 
   
   Preliminary proposed additional crates:
   - iggy_error
   - iggy_common (most likely contains code shared in server and SDK) 
   - iggy_protocol (The binary protocol and its default implementation) 
   
   As a result, the SDK crate should become a lot smaller, leaner and cleaner. 
   
   The wisdom of separating error from common is the observation that some error types tend to grow large (a.ka. mega-enum) and you really want to have structured testing to catch regressions before they hit CI. Furthermore, there might be cases where you need error types without common, so that keeps build dependencies slim. Speaking of build deps, having multiple smaller crates might speed up cached builds in case Cargo isn't bombing it with its broken cache.  
   
   All of this is a preliminary draft and may evovle over time based on learning, feedback and implementation progress. 


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@iggy.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [I] Split SDK crate into some smaller crates [iggy]

Posted by "marvin-hansen (via GitHub)" <gi...@apache.org>.
marvin-hansen closed issue #1713: Split SDK crate into some smaller crates
URL: https://github.com/apache/iggy/issues/1713


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@iggy.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org