Skip to content

Commit bd139f5

Browse files
author
007
committed
update README.md
1 parent 3159009 commit bd139f5

1 file changed

Lines changed: 32 additions & 31 deletions

File tree

README.md

Lines changed: 32 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,49 @@
1-
# cf_speedtest
1+
# cf-speedtest
22

3-
## A simple internet speed test tool/library, which uses https://speed.cloudflare.com (provided by Cloudflare)
3+
A simple internet speed test CLI tool using [speed.cloudflare.com](https://speed.cloudflare.com)
44

55
[![PyPI version](https://img.shields.io/pypi/v/cf-speedtest.svg)](https://pypi.python.org/pypi/cf-speedtest)
66
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/cf-speedtest.svg)](https://pypi.python.org/pypi/cf-speedtest)
7-
[![PyPI status](https://img.shields.io/pypi/status/cf-speedtest.svg)](https://pypi.python.org/pypi/cf-speedtest)
7+
[![CI](https://github.com/12932/cf-speedtest/actions/workflows/main.yml/badge.svg)](https://github.com/12932/cf-speedtest/actions/workflows/main.yml)
88
[![PyPI downloads](https://img.shields.io/pypi/dm/cf-speedtest.svg)](https://pypi.python.org/pypi/cf-speedtest)
99

10-
## Installation:
10+
## Installation
11+
1112
```bash
12-
$ pip install -U cf-speedtest
13+
# Recommended
14+
uv tool install cf-speedtest
15+
16+
# Or with pip
17+
pip install -U cf-speedtest
1318
```
1419

15-
## Basic CLI usage:
20+
## Usage
1621

17-
- ### Running a normal speedtest:
18-
- `cf_speedtest`
22+
```bash
23+
# Run a speedtest
24+
cf-speedtest
1925

20-
- ### Without verifying SSL:
21-
- `cf_speedtest --verifyssl=false`
26+
# Without SSL verification
27+
cf-speedtest --verifyssl=false
2228

23-
- ### Specify a [percentile](https://en.wikipedia.org/wiki/Percentile) of measurements to be considered your speed (default 90):
24-
- `cf_speedtest --percentile 80`
29+
# Custom percentile (default 90)
30+
cf-speedtest --percentile 80
2531

26-
- ### Output measurements to a CSV file:
27-
- `cf_speedtest --output speed_data.csv`
32+
# Output to CSV
33+
cf-speedtest --output speed_data.csv
34+
35+
# With proxy
36+
cf-speedtest --proxy socks5://127.0.0.1:1080
37+
cf-speedtest --proxy http://127.0.0.1:8181
38+
```
2839

29-
- ### Specify a SOCKS/HTTP proxy to use (with or without authentication):
30-
- `cf_speedtest --proxy socks5://127.0.0.1:1080`
31-
- `cf_speedtest --proxy socks5://admin:admin@127.0.0.1:1080`
32-
- `cf_speedtest --proxy http://127.0.0.1:8181`
33-
- `cf_speedtest --proxy http://admin:admin@127.0.0.1:8181`
34-
- `cf_speedtest --proxy 127.0.0.1:8181`
40+
## Requirements
3541

36-
## Programmatic usage:
37-
- TODO
42+
- Python 3.10+
3843

39-
#### TODO:
40-
- Programmatic usage
41-
- Multi-threaded speedtest
42-
- Continuous mode
44+
## Disclaimers
4345

44-
#### Disclaimers:
45-
- This library is purely single-threaded
46-
- This library works entirely over HTTP(S), which has some overhead
47-
- Latency is measured with HTTP requests
48-
- Cloudflare has a global network, but you may be connected to a distant PoP due to ISP peering and other factors
46+
- Single-threaded
47+
- Works over HTTP(S), which has some overhead
48+
- Latency measured via HTTP requests
49+
- Cloudflare has a global network, but you may connect to a distant PoP due to ISP peering

0 commit comments

Comments
 (0)