https://github.com/msigut/FreeProxySharp
.NET Core Proxy library based on HttpClient works with FreeProxyList.net
https://github.com/msigut/FreeProxySharp
free-proxy-list httpclient ihttpclientfactory netstandard20 proxy
Last synced: 5 months ago
JSON representation
.NET Core Proxy library based on HttpClient works with FreeProxyList.net
- Host: GitHub
- URL: https://github.com/msigut/FreeProxySharp
- Owner: msigut
- License: apache-2.0
- Created: 2019-03-07T06:41:36.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T05:26:52.000Z (almost 3 years ago)
- Last Synced: 2025-04-18T13:07:48.659Z (6 months ago)
- Topics: free-proxy-list, httpclient, ihttpclientfactory, netstandard20, proxy
- Language: C#
- Homepage:
- Size: 58.6 KB
- Stars: 19
- Watchers: 4
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
## FreeProxySharp
HttpClient *(IHttpClientFactory)* + Proxy implementation with Dependency injection support and https://free-proxy-list.net/ as proxy-list source for .NET Standard 2.0 (netstandard2.0).
Library **Checks**:
- transparency (with reverse-IP check at: http://www.whatismyip.cz/)
- HTTPS (with access to: http://www.google.com/)
- measure **elapsed** time in miliseconds
For proxy **Parse** & **Check** use (test: [BasicTest.cs](/src/FreeProxySharp.Test/BasicTest.cs)):
```c#
// get proxy list
var proxies = await FreeProxyListNet.Parse();
// check all proxies
var checkedProxies = await FreeProxyListNet.Check(proxies, codeFilter: new[] { "DE", "PL" },
required: 1, maxMiliseconds: 1200);
```
Or use it all together by **Dependency injection** init procedure (example at: [TestFixture.cs](/src/FreeProxySharp.Test/TestFixture.cs)).
```c#
// parse & check proxies ; save it into configuration
Options.CheckAndAssignToConfig(codeFilter: new[] { "SE", "DE", "ES", "PL" }, required: 2);
// proxy client, with all proxies gets by CheckAndAssignToConfig
services.AddHttpClientProxy("PROXY", Options);
```
And then use **build-in client** [HttpProxyClient.cs](/src/FreeProxySharp/HttpProxyClient.cs) (test: [BasicTest.cs](/src/FreeProxySharp.Test/BasicTest.cs))
```c#
var factory = _test.Services.GetRequiredService();
var client = factory.GetClientProxy("PROXY");
var html = await client.GetStringSafeAsync("https://httpstat.us");
```
For common work with *IHttpClientFactory* clients, configure it by **Dependency injection** init procedure (example at: [TestFixture.cs](/src/FreeProxySharp.Test/TestFixture.cs)).
```c#
// common client, with all settings from Configuration
services.AddHttpClient("COMMON", Options);
// common client, with retry = 5
services.AddHttpClient("5RETRY", retry: 5);
// common client, with configured for retry when 404 status found (example)
services.AddHttpClient("404TEST", Options, whenRetry: res => res.StatusCode == HttpStatusCode.NotFound);
```
Configuration example [TestOptions.cs](/src/FreeProxySharp.Test/TestOptions.cs):
```c#
public class TestOptions : IHttpProxyConfiguration
{
public int Retry => 2;
public int RetryFirstDelay => 1;
public bool GzipEnabled => true;
public string UserAgent => HttpExtensions.DEFAULT_AGENT;
public IHttpProxyServer[] Proxies { get; set; }
}
```
### Update notice
For update from version 1.0.x -> 1.1.x:
- ADD: `AddHttpClient` and `AddHttpClientProxy` parameter `whenRetry` for `HttpClient` retry settings
- ADD: `CheckAndAssignToConfig` switch: `throwWhenLessThanRequired` for exc. when less than requied proxy found
- ADD: `CheckAndAssignToConfig` parameter: `Timeout` for timeout for checking all proxies
- DEL: `IHttpProxyConfiguration.ProxyEnabled` removed (use `AddHttpClient` of `AddHttpClientProxy` instead manually)
- DEL: `HttpProxyClient` removed ; now use `HttpExtensions` (for common configuration and tasks) & `HttpProxyFactory` (for work with proxy)