semvec/pypi-packages huggingface dataset:
FreeProxyScraper 0.1.9
A plugin driven package that scrapes sites for free proxies

# FreeProxyScraper
This is a plugin driven web scraper meant to retrieve and test free proxies for use. Note that this package may be unstable and should not be used in a production environment.

## Installation
Run the following to install:

```bash
pip install FreeProxyScraper
```

## Usage

```python
import FreeProxyScraper

pq = FreeProxyScraper.ProxyQuery()

# Returns any proxy's found
for proxy in pq.find_proxies(limit=20):
    print(proxy)

# Returns only proxies that are anonymous or "elite"
for proxy in pq.find_filter(limit=20, min_anon_level=1):
    print(proxy)
```

There are 3 anonymity levels, indicated as integers between 0-2.

- Level 0: Transparent. The end server can see your real ip even though it's being routed through a proxy
- Level 1: Anonymous. The end server knows you are using a proxy, but does not know your real ip
- Level 2: High Anonymity, also sometimes called "elite". The end server does not know you are using a proxy or know your real ip. The end server may have a database known proxies, so they still may know that you are using a proxy by matching your ip against such a database.

## List of sites implemented for scraping:
- https://www.sslproxies.org/
- http://free-proxy.cz/en/
- https://spys.one/en/
- https://hidemy.name/en/proxy-list/
- https://geonode.com/free-proxy-list

## FAQ
- Why implement so many websites for scraping?

Websites are always changing, or going down, or banning ip's very quickly. In order to make sure this package stays reliable it is essential that it implements many websites

- I want to make sure that I am truly not using transparent proxies, how do I know the websites being scraped from aren't lying abut the anonymity of the proxies?

By default, all proxies will be checked if they are transparent or not before ever giving them to you if you specified a higher anon_level then 0. There's no need to worry, your ip should be safe.

## Development
to install FreeProxyScraper, along with the tools you need to develop, run the following in the directory containing this repo:

```bash
pip install -e .[dev]
```

If you'd like to contribute to development, right now the most needed thing is writing more plugins. In order to help, you need basic knowledge of BeautifulSoup4 and a little of patience with websites purposely making it hard for you to scrape information. Check out `src/plugins/examplePlugin.py` to see an example layout of a plugin file.
mac-notifier 0.0.3
Display notifications, alerts and dialogs on mac from command line

# Mac Notifier
Mac_notifier is a command line utility to display notifications, alerts and dialogs on mac. It executes apple scripts underneath to achieve the purpose.

## Usage
```
dsp notify 'Hello wolrd'                                 # send notification
dsp notify -t 'Hurry up!' 'Time is precious'             # send notification with title

dsp alert WARNING                                        # display alert
dsp alert -b '["Sorry", "I will"]' 'Will you marry me?'  # display alert with customized buttons

dsp dialog 'Man is not made for defeat. A man can be destroyed but not defeated.'
```
For more detailed usage, refer to command help.

## Command Help
Use `dsp --help` to show help:
```
Usage: dsp [OPTIONS] COMMAND [ARGS]...

  Display notifications, alerts and dialogs on mac

Options:
  --help  Show this message and exit.

Commands:
  alert   Display an alert on mac
  dialog  Display a dialog on mac
  notify  Display a notification on mac
```

Use `dsp subcommand --help` to show help for subcommands, for example:
```
Usage: dsp alert [OPTIONS] CONTENT

  Display an alert on mac

Options:
  -m, --message TEXT     Explanatory message.
  -b, --buttons TEXT     List of button names in json format, e.g. ["Cancel",
                         "OK"].
  -d, --default INTEGER  Index of default buttons, 1 based.
  -l, --lasting INTEGER  Number of seconds before dismissing. Wait forever if
                         not specified.
  --help                 Show this message and exit.
```