8000 GitHub - MSAdministrator/blocker: blocker is a Python package that checks indicators against block lists
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

MSAdministrator/blocker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

blocker

PyPI Status Python Version License

Code Quality & Tests

Codecov

pre-commit Black

What is blocker?

blocker is a Python package to check if a indicator is in a blocklist.

There are two main data definitions at this time that drive the blocker package. These defined the different locations to check against.

Features

  • Retrieve blocklist data from multiple sources
  • Check if a IP address is on a DNSBL (DNS Block List)
  • Collects data using multi-threading

Installation

You can install blocker via pip from PyPI:

$ pip install blocker

If you are using poetry (recommended) you can add it to your package using

poetry add blocker

Usage

Below is the command line reference but you can also use the current version of blocker to retrieve the help by typing blocker --help.

NAME
    blocker - Lookup is the main method to check if a given value can be identified in block lists.

SYNOPSIS
    blocker VALUE <flags>

DESCRIPTION
    The consumer of this method can toggle the different checks as needed.

POSITIONAL ARGUMENTS
    VALUE
        Type: str
        A value to lookup. This is typically going to be a domain, ip address, etc.

FLAGS
    -t, --text_list=TEXT_LIST
        Type: bool
        Default: False
        Whether or not to check text based lists. Defaults to False.
    -d, --dns_list=DNS_LIST
        Type: bool
        Default: False
        Whether or not to check dns lists. Defaults to False.

NOTES
    You can also use flags syntax for POSITIONAL ARGUMENTS

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

Developmemt

You can clone the repositry and begin development using

git clone https://github.com/MSAdministrator/blocker.git
cd blocker
poetry install

If you are using pyenv to manage your enviroments you can set a config option in poetry to use the set pyenv version of python by running this:

poetry config virtualenvs.create true
poetry install

License

Distributed under the terms of the [MIT license] 6798 [LICENSE.md], blocker is free and open source software.

Security

Security concerns are a top priority for us, please review our Security Policy.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @MSAdministrator's Hypermodern Python Cookiecutter template.

About

blocker is a Python package that checks indicators against block lists

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

0