Metadata-Version: 2.4
Name: tmautils-bgp
Version: 0.2.0
Summary: BGP/ASN utilities for tmautils
License-Expression: MPL-2.0
License-File: LICENSE
Author: Sulyab Thottungal Valapu
Author-email: sulyabtv@gmail.com
Requires-Python: >=3.13,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Provides-Extra: dev
Requires-Dist: pandas (>=2.3.0,<3.0.0)
Requires-Dist: pyasn (>=1.6.2,<2.0.0)
Requires-Dist: pytest (>=9.0.0,<10.0.0) ; extra == "dev"
Requires-Dist: pytest-asyncio (>=1.0.0,<2.0.0) ; extra == "dev"
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: tmautils-core (>=0.2.0,<0.3.0)
Project-URL: Repository, https://github.com/sulyabtv/tmautils-bgp
Description-Content-Type: text/markdown

# tmautils-bgp
BGP/ASN utilities for Internet measurement research. Part of the [tmautils](https://github.com/sulyabtv/tmautils) package family.

Provides IP-to-ASN lookups, AS categorization (Stanford ASdb), and AS-to-organization mapping (CAIDA AS2Org).

Installation:
```bash
pip install tmautils-bgp
```

## API

| Utility / Function | What it does |
| --- | --- |
| `PyasnUtil` | IP to ASN lookups (wraps `pyasn`) |
| `ASdbCategoryUtil` | AS categorization using Stanford ASdb |
| `CaidaAsOrgInfoUtil` | AS to Organization mapping using CAIDA's AS2Org |

## License
This project is licensed under [MPL-2.0](LICENSE) (Mozilla Public License 2.0).

What this means in practice:
- If you modify an existing file, your modifications must remain MPL-2.0.
- You can license new files however you want. (But I won't merge them unless they are MPL-2.0.)
- You can use this code alongside code under other licenses.

## Contributing
Contributions are highly welcome! See the [tmautils README](https://github.com/sulyabtv/tmautils/blob/main/README.md) for philosophy and design choices.

AI Policy: I don't consider AI tool usage any different from IDE usage. This also means that *you* are responsible for the code you write and *you* should inspect every line of code written by an LLM.

