bricco

Name	bricco JSON
Version	1.0.2 JSON
	download
home_page	None
Summary	A simple Tor bridges testing tool
upload_time	2024-08-13 11:55:06
maintainer	None
docs_url	None
author	None
requires_python	>=3.11
license	None
keywords	bridge censorship obfs4 tor
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # python3-bricco

## Description

Bricco is a simple Tor bridges testing tool.
It can find Tor bridges in some text data (for now **obfs4** and **vanilla**) and perform fast port scanning to check bridge availability.

## Installation

The script is pure Python and a part of [PyPI](https://pypi.org/project/bricco), so can be installed via *pip*:

```bash
python3 -m pip install bricco
```

## Usage

Bridges test:

```bash
bricco test -i ${untested_bridges_txt} -o ${available_bridges_txt}
```

Set smaller socket timeout to make things faster:

```bash
# 2 sec instead of 5
bricco test -i ${untested_bridges_txt} -o ${available_bridges_txt} -t 2
```

Also, it is possible to use external [Nmap](https://nmap.org/) executable.
Presumably, it is more accurate than using native Python3 `socket` module:

```bash
# Debian: sudo apt install nmap
bricco test -i ${untested_bridges_txt} -o ${available_bridges_txt} -n /usr/bin/nmap
# Windows:
bricco test -i ${untested_bridges_txt} -o ${available_bridges_txt} -n C:/downloads/nmap.exe
```

## Bugs

If you want to report a bug or propose a feature, feel free to [open an issue](https://codeberg.org/screwery/bricco/issues).

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "bricco",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "bridge, censorship, obfs4, tor",
    "author": null,
    "author_email": "Ellie Viesn\u00e1 <snowboard_refinery@proton.me>",
    "download_url": "https://files.pythonhosted.org/packages/be/42/6f167c23c4facb9a76858f781b8ab33a686114d03edf2d0acc1d21812ae4/bricco-1.0.2.tar.gz",
    "platform": null,
    "description": "# python3-bricco\n\n## Description\n\nBricco is a simple Tor bridges testing tool.\nIt can find Tor bridges in some text data (for now **obfs4** and **vanilla**) and perform fast port scanning to check bridge availability.\n\n## Installation\n\nThe script is pure Python and a part of [PyPI](https://pypi.org/project/bricco), so can be installed via *pip*:\n\n```bash\npython3 -m pip install bricco\n```\n\n## Usage\n\nBridges test:\n\n```bash\nbricco test -i ${untested_bridges_txt} -o ${available_bridges_txt}\n```\n\nSet smaller socket timeout to make things faster:\n\n```bash\n# 2 sec instead of 5\nbricco test -i ${untested_bridges_txt} -o ${available_bridges_txt} -t 2\n```\n\nAlso, it is possible to use external [Nmap](https://nmap.org/) executable.\nPresumably, it is more accurate than using native Python3 `socket` module:\n\n```bash\n# Debian: sudo apt install nmap\nbricco test -i ${untested_bridges_txt} -o ${available_bridges_txt} -n /usr/bin/nmap\n# Windows:\nbricco test -i ${untested_bridges_txt} -o ${available_bridges_txt} -n C:/downloads/nmap.exe\n```\n\n## Bugs\n\nIf you want to report a bug or propose a feature, feel free to [open an issue](https://codeberg.org/screwery/bricco/issues).\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A simple Tor bridges testing tool",
    "version": "1.0.2",
    "project_urls": {
        "Changelog": "https://codeberg.org/screwery/bricco/src/branch/main/CHANGELOG.md",
        "Issues": "https://codeberg.org/screwery/bricco/issues",
        "Repository": "https://codeberg.org/screwery/bricco"
    },
    "split_keywords": [
        "bridge",
        " censorship",
        " obfs4",
        " tor"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b54d427da124410d5005dfe219263d4b5dcf7bd838d40ceb5b48129025bb5882",
                "md5": "35c28bf3a8286aef7ad5d784c2bff08d",
                "sha256": "7e4bb70f9d88f3d0c6112d55d77c5dc36ca37df0cb618086a10fb42d593b6475"
            },
            "downloads": -1,
            "filename": "bricco-1.0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "35c28bf3a8286aef7ad5d784c2bff08d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 15782,
            "upload_time": "2024-08-13T11:55:04",
            "upload_time_iso_8601": "2024-08-13T11:55:04.043023Z",
            "url": "https://files.pythonhosted.org/packages/b5/4d/427da124410d5005dfe219263d4b5dcf7bd838d40ceb5b48129025bb5882/bricco-1.0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "be426f167c23c4facb9a76858f781b8ab33a686114d03edf2d0acc1d21812ae4",
                "md5": "bc1c613ff295baecdcf4de64974ae387",
                "sha256": "eb104a1346263d28e4bc7806902231df03c3d89a7e91e4fff65d47a98b86cb96"
            },
            "downloads": -1,
            "filename": "bricco-1.0.2.tar.gz",
            "has_sig": false,
            "md5_digest": "bc1c613ff295baecdcf4de64974ae387",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 16436,
            "upload_time": "2024-08-13T11:55:06",
            "upload_time_iso_8601": "2024-08-13T11:55:06.103862Z",
            "url": "https://files.pythonhosted.org/packages/be/42/6f167c23c4facb9a76858f781b8ab33a686114d03edf2d0acc1d21812ae4/bricco-1.0.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-13 11:55:06",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": true,
    "codeberg_user": "screwery",
    "codeberg_project": "bricco",
    "lcname": "bricco"
}