# speedtest-rs
*a tool like `speedtest-cli`, but in Rust*
[](https://crates.io/crates/speedtest-rs)
Status: This is usable for lower-end residential connections using ["HTTP Legacy Fallback"][http_legacy_fallback]
## [HTTP Legacy Fallback][http_legacy_fallback]
This tool currently only supports [HTTP Legacy Fallback][http_legacy_fallback] for testing.
High bandwidth connections higher than ~200Mbps may return incorrect results!
The testing operations are different from socket versions of tools connecting to speedtest.net infrastructure. In the many FOSS Go versions, tests are done to find an amount of data that can run for a default of 3 seconds over some TCP connection. In particular, `speedtest-cli` and `speedtest-rs` tests with what Ookla calls the ["HTTP Legacy Fallback"][http_legacy_fallback] for hosts that cannot establish a direct TCP connection.
### Ookla speedtest now has their own non-FOSS CLI tool that's native and available for many platforms.
* TCP-based
* Higher Bandwidth capable.
https://www.speedtest.net/apps/cli
Please look here. Unfortunately, it is not FOSS. Still, it is supported by them and can be used for non-commercial purposes.
## Purpose
This is a learning exercise for me to learn Rust and keeping up with its ecosystem.
The [HTTP Legacy Fallback][http_legacy_fallback] is currently based on the popular Python implementation:
https://github.com/sivel/speedtest-cli @ 2.1.2
There are also other speedtest.net using tools using different approaches to be stolen from in the future. For example:
https://github.com/traetox/speedtest
This example seems different as it appears to just use TCP connections and some protocol. It's probably more suitable to high-speed connections. TODO: Add a default TCP-mode.
## Use as a Library
The API is very much not stable. Use at your own risk. Semver adherence definitely not guaranteed. Please lock to exact versions if you must.
## License
Licensed under either of
* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any
additional terms or conditions.
[http_legacy_fallback]: http://www.ookla.com/support/a84541858