Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rustedbones/taxonomy
Strongly typed DNS for scala. Based on the cats ecosystem with scodec and fs2
https://github.com/rustedbones/taxonomy
cats-effect dns fs2 scala scodec
Last synced: 3 months ago
JSON representation
Strongly typed DNS for scala. Based on the cats ecosystem with scodec and fs2
- Host: GitHub
- URL: https://github.com/rustedbones/taxonomy
- Owner: RustedBones
- License: apache-2.0
- Created: 2020-04-14T18:42:47.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-11-28T17:30:32.000Z (about 1 year ago)
- Last Synced: 2023-11-29T17:34:04.855Z (about 1 year ago)
- Topics: cats-effect, dns, fs2, scala, scodec
- Language: Scala
- Homepage:
- Size: 142 KB
- Stars: 5
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# taxonomy
[](https://github.com/RustedBones/taxonomy/actions/workflows/ci.yml)
[](https://maven-badges.herokuapp.com/maven-central/fr.davit/taxonomy-model_3)
[](LICENSE)
[](https://scala-steward.org)
Strongly typed DNS for scala based on the [cats ecosystem](https://github.com/typelevel/cats)
with [scodec](https://github.com/scodec/scodec)
and [fs2](https://github.com/typelevel/fs2)
## Versions
| Version | Release date | fs2 version | Scala versions |
|---------|--------------|-------------|---------------------|
| `1.2.1` | 2022-12-29 | `3.4.0` | `3.2.1` |
| `1.2.0` | 2022-12-24 | `3.4.0` | `3.2.1` |
| `1.1.0` | 2022-03-25 | `3.2.5` | `3.1.1` |
| `1.0.0` | 2021-05-09 | `3.0.2` | `2.13.5`, `2.12.13` |
| `0.3.0` | 2021-01-09 | `2.5.0` | `2.13.4`, `2.12.12` |
| `0.2.0` | 2020-12-20 | `2.4.6` | `2.13.4`, `2.12.12` |
| `0.1.0` | 2020-12-17 | `2.4.6` | `2.13.4`, `2.12.12` |
## Getting taxonomy
```sbt
// DNS with fs2
libraryDependencies += "fr.davit" %% "taxonomy-fs2" % ""
```
If you want to only part of the project with another IO implementation for instance,
you can import the following sub modules
```sbt
// for the scala model only
libraryDependencies += "fr.davit" %% "taxonomy-model" % ""
// for the binary protocol with scodec
libraryDependencies += "fr.davit" %% "taxonomy-scodec" % ""
```
## Dns
Here is a quick example of a DNS lookup to the `9.9.9.9` DNS server for the `davit.fr` domain name
```scala
import java.net.{Inet4Address, InetAddress, InetSocketAddress}
import cats.effect.*
import cats.effect.unsafe.implicits.*
import fr.davit.taxonomy.model.record.*
import fr.davit.taxonomy.model.*
import fr.davit.taxonomy.scodec.DnsCodec
import fs2.io.net.Network
import munit.CatsEffectSuite
import scodec.Codec
import scala.concurrent.duration.*
given Codec[DnsMessage] = DnsCodec.dnsMessage
val quad9DnsServer = new InetSocketAddress("9.9.9.9", 53)
val question = DnsQuestion("davit.fr", DnsRecordType.A, unicastResponse = false, DnsRecordClass.Internet)
val query = DnsMessage.query(id = 1, questions = Seq(question))
val socketResource = Network[IO].openDatagramSocket()
val response = socketResource.use(s => Dns.resolve(s, DnsPacket(quad9DnsServer, query))).unsafeRunSync()
```
## Based on taxonomy
- [`scout`](https://github.com/RustedBones/scout): zeroconf DNS-SD client and server
- [`shovel`](https://github.com/RustedBones/shovel): A JVM dig implementation