semvec/pypi-packages huggingface dataset:
dns-singer 1.1.0
Embedding sentences in DNS records
License: MIT
Requires Python: >=3.9,<4.0

# DNS Singer

 > 我仍然在　无人问津的阴雨霉湿之地<br>
 > 和着雨音　唱着卖不出去的歌曲<br>
 > 浮游之人　也挣扎不已执着存在下去<br>
 > 追逐着　梦想着　继续
 >
 > _COP, 世末歌者_

DNS Singer can generate a DNS zone file with a sequence of records which include the lyrics/poems/sentences you provided. Multiple languages (English/Chinese/Japanese/Korean/German/French/Spanish/Italian/Russian) are supported through [IDN](https://en.wikipedia.org/wiki/Internationalized_domain_name).
## Installation

```bash
pip3 install dns-singer
```

## Usage
### Step 1: Install the package

```bash
pip3 install dns-singer
```

### Step 2: Generate a zone file
```bash
dns-singer -f example.txt -n poem.example.com -s 赴戍登程口占示家人 | tee poem.example.com.zone
```

The command above will generate a zone file as below:

```zone
; Generated by dns-singer v1.0.0
; Copyright (c) 2023 Joseph Chris <joseph@josephcz.xyz> MIT License
; Domain: poem.example.com

xn--gmq16ihlp2x19hu25ax9dyxbx53g.e2ac5807    IN CNAME xn--3iq1qy3gswsh4zeve7z3c.0769a433.poem.example.com.         ; 力微任重久神疲
xn--3iq1qy3gswsh4zeve7z3c.0769a433           IN CNAME xn--ihq18ftwlg9cr0kc47a20t.96b75b0f.poem.example.com.        ; 再竭衰庸定不支
xn--ihq18ftwlg9cr0kc47a20t.96b75b0f          IN CNAME xn--onq72f7ufgxfzyxchn5vw.1714a724.poem.example.com.         ; 苟利国家生死以
xn--onq72f7ufgxfzyxchn5vw.1714a724           IN CNAME xn--9iqz2suxem58akdao84kgle.b084404c.poem.example.com.       ; 岂因祸福避趋之
xn--9iqz2suxem58akdao84kgle.b084404c         IN CNAME xn--3mrpl32sgned1ilmif03d.7f0c25fa.poem.example.com.         ; 谪居正是君恩厚
xn--3mrpl32sgned1ilmif03d.7f0c25fa           IN CNAME xn--6kq14ewn72bf4vwvjzlb.313cc388.poem.example.com.          ; 养拙刚于戍卒宜
xn--6kq14ewn72bf4vwvjzlb.313cc388            IN CNAME xn--jhqtlh01akvcnzj96euq6f.b6e05ab3.poem.example.com.        ; 戏与山妻谈故事
xn--jhqtlh01akvcnzj96euq6f.b6e05ab3          IN CNAME xn--wqr21jxvms7q7uk9irx1g.41d9aabb.poem.example.com.         ; 试吟断送老头皮
```

### Step 3: Serve the zone file

Import the zone file to a DNS provider, like [Route 53](https://aws.amazon.com/route53/) or [Cloudflare](https://www.cloudflare.com/).

 > **Notice**: Turn off _CNAME Flattening_ if you are using Cloudflare.

You can verify the records by `dig` command:

```bash
dig +short +idnout xn--gmq16ihlp2x19hu25ax9dyxbx53g.e2ac5807.poem.example.com
力微任重久神疲.0769a433.poem.example.com.
再竭衰庸定不支.96b75b0f.poem.example.com.
苟利国家生死以.1714a724.poem.example.com.
岂因祸福避趋之.b084404c.poem.example.com.
谪居正是君恩厚.7f0c25fa.poem.example.com.
养拙刚于戍卒宜.313cc388.poem.example.com.
戏与山妻谈故事.b6e05ab3.poem.example.com.
试吟断送老头皮.41d9aabb.poem.example.com.
```

## Syntax
The empty lines or lines with only whitespaces in **input file** will be ignored by DNS Singer.

Lines starting with `#` will be treated as comments and ignored by DNS Singer.

## License
This porject is licensed under the MIT license. The example poem is in the public domain.