# CZDS
[][pypi status]
[][pypi status]
[][pypi status]
[][license]
[][read the docs]
[](https://github.com/MSAdministrator/czds/actions/workflows/tests.yml)
[][codecov]
[][pre-commit]
[][black]
[pypi status]: https://pypi.org/project/czds/
[read the docs]: https://czds.readthedocs.io/
[tests]: https://github.com/MSAdministrator/czds/actions?workflow=Tests
[codecov]: https://app.codecov.io/gh/MSAdministrator/czds
[pre-commit]: https://github.com/pre-commit/pre-commit
[black]: https://github.com/psf/black
## What is CZDS?
Each Top Level Domain (TLD) is maintained by a registry operator, who also manages a publicly available list of Second Level Domains (SLDs) and the details needed to resolve those domain names to Internet Protocol (IP) addresses.
The registry operator’s zone data contains the mapping of domain names, associated name server names, and IP addresses for those name servers. These details are updated by the registry operator for its respective TLDs whenever information changes or a domain name is added or removed.
Each registry operator keeps its zone data in a text file called the Zone File which is updated once every 24 hours.
## Features
- Retrieve Centralized Zone Transfer Files from root DNS servers hosted by ICAAN and other agencies
- Download one or all of the zone files and return data in multiple formats; text, json or a file (default)
- You can now retrieve zone files using multi-threading
## Roadmap
The following are some of the features I am planning on adding but would love to hear everyones thoughts as well.
- Add ability to search based on domain and/or TLD
- This may include using algorithms like Levenshtein distance, confusables/idna characters, etc.
- Add ability to derive differences between zone files over time
- Add ability to retrieve other contextual external information like WHOIS
- Add ability to save/store data into a database
## Requirements
- You need a CZDS account with ICAAN. You can sign-up [here](https://czds.icann.org)
- Internet access
## Installation
You can install _CZDS_ via [pip] from [PyPI]:
```console
$ pip install czds
```
If you are using `poetry` (recommended) you can add it to your package using
```console
poetry add czds
```
## Usage
Below is the command line reference but you can also use the current version of czds to retrieve the help by typing ```czds --help```.
```console
NAME
czds - Main class for ICAAN CZDS.
SYNOPSIS
czds GROUP | VALUE | --username=USERNAME --password=PASSWORD --save_directory=SAVE_DIRECTORY
DESCRIPTION
Main class for ICAAN CZDS.
ARGUMENTS
USERNAME
Type: ~AnyStr
PASSWORD
Type: ~AnyStr
SAVE_DIRECTORY
Type: ~AnyStr
GROUPS
GROUP is one of the following:
BASE_HEADERS
links
VALUES
VALUE is one of the following:
AUTH_URL
BASE_URL
OUTPUT_FORMAT
PASSWORD
SAVE_PATH
THREAD_COUNT
USERNAME
connection
```
## Contributing
Contributions are very welcome.
To learn more, see the [Contributor Guide](CONTRIBUTING.md).
## Developmemt
You can clone the repositry and begin development using
```bash
git clone https://github.com/MSAdministrator/czds.git
cd czds
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:
```bash
poetry config virtualenvs.prefer-active-python true
poetry install
```
## License
Distributed under the terms of the [MIT license][LICENSE.md],
_CZDS_ is free and open source software.
## Security
Security concerns are a top priority for us, please review our [Security Policy](SECURITY.md).
## Issues
If you encounter any problems,
please [file an issue](https://github.com/MSAdministrator/czds/issues/new) along with a detailed description.
## Credits
This project was generated from [@MSAdministrator]'s [Hypermodern Python Cookiecutter] template.
[@MSAdministrator]: https://github.com/MSAdministrator
[pypi]: https://pypi.org/
[hypermodern python cookiecutter]: https://github.com/cjolowicz/cookiecutter-hypermodern-python
[file an issue]: https://github.com/MSAdministrator/czds/issues
[pip]: https://pip.pypa.io/
<!-- github-only -->
[license]: https://github.com/MSAdministrator/czds/blob/main/LICENSE
[contributor guide]: https://github.com/MSAdministrator/czds/blob/main/CONTRIBUTING.md
[command-line reference]: https://czds.readthedocs.io/en/latest/usage.html