You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
67 lines
2.4 KiB
Markdown
67 lines
2.4 KiB
Markdown
# hma-proxy-parse
|
|
|
|
Good game, HideMyAss, but I win :)
|
|
|
|
This module extracts (parses) proxy details including the IP address from [http://proxylist.hidemyass.com/](http://proxylist.hidemyass.com/) and anything else using the same system, despite their (rather heavy) CSS-based obfuscation.
|
|
|
|
Note that this module only does the parsing; you're responsible for fetching the source HTML yourself.
|
|
|
|
## License
|
|
|
|
[WTFPL](http://www.wtfpl.net/txt/copying/) or [CC0](https://creativecommons.org/publicdomain/zero/1.0/), whichever you prefer. A donation and/or attribution are appreciated, but not required.
|
|
|
|
## Donate
|
|
|
|
My income consists entirely of donations for my projects. If this module is useful to you, consider [making a donation](http://cryto.net/~joepie91/donate.html)!
|
|
|
|
You can donate using Bitcoin, PayPal, Gratipay, Flattr, cash-in-mail, SEPA transfers, and pretty much anything else.
|
|
|
|
Bitcoins can also be sent to `1KafMHn6YEDFkUSoHK6pKkqqmfJUF5Wd1C` directly :)
|
|
|
|
## Contributing
|
|
|
|
Pull requests welcome. Please make sure your modifications are in line with the overall code style, and ensure that you're editing the `.coffee` files, not the `.js` files.
|
|
|
|
Build tool of choice is `gulp`; simply run `gulp` while developing, and it will watch for changes.
|
|
|
|
Be aware that by making a pull request, you agree to release your modifications under the licenses stated above.
|
|
|
|
## Usage
|
|
|
|
You can input HTML from any source, but this example uses [`bhttp`](https://www.npmjs.com/package/bhttp) in Promises mode.
|
|
|
|
```javascript
|
|
var hmaProxyParse = require("hma-proxy-parse");
|
|
var bhttp = require("bhttp");
|
|
var Promise = require("bluebird");
|
|
|
|
Promise.try(function(){
|
|
return bhttp.get("http://proxylist.hidemyass.com/");
|
|
}).then(function(response){
|
|
console.log(hmaProxyParse(response.body.toString()));
|
|
});
|
|
```
|
|
|
|
## API
|
|
|
|
### hmaProxyParse(html)
|
|
|
|
Parses the specified `html`, and returns an array of objects with proxy information. The objects look something like this:
|
|
|
|
```javascript
|
|
{
|
|
updateTimestamp: '1422645602',
|
|
ip: '187.108.223.204',
|
|
port: '8080',
|
|
country: 'br',
|
|
speed: '2441',
|
|
connectionTime: '235',
|
|
protocol: 'HTTP',
|
|
anonymity: 'Low'
|
|
}
|
|
```
|
|
|
|
It doesn't attempt to parse the actual data provided - all data is directly as specified in the list, and you'll have to figure out what to do with it. I have no idea, for example, what the bounds on `speed` or `connectionTime` are, or what the possible options for `anonymity` are.
|
|
|
|
If this helped you, don't forget to donate ;)
|