package atd

  1. Overview
  2. Docs
Parser for the ATD data format description language

Install

Dune Dependency

Authors

  1. M
    Martin Jambon <martin@mjambon.com>
  2. R
    Rudi Grinberg <rudi.grinberg@gmail.com>
  3. M
    Martin Jambon <martin@r2c.dev>
  4. M
    Martin Jambon <github@mjambon.com>
  5. I
    Ivan Jager <aij+git@mrph.org>
  6. O
    oleksiy <oleksiy.golovko@ahrefs.com>
  7. D
    David Sheets <sheets@alum.mit.edu>
  8. R
    Rudi Grinberg <me@rgrinberg.com>
  9. M
    Martin Jambon <martin@esper.com>
  10. J
    Jeff Meister <nanaki@gmail.com>
  11. C
    Caio Wakamatsu <caio.wakamatsu@ahrefs.com>
  12. C
    Carmelo Piccione <carmelo.piccione@gmail.com>
  13. D
    Daniel Weil <danweil68@gmail.com>
  14. E
    Egor Chemokhonenko <egor.chemohonenko@ahrefs.com>
  15. Gabriel Scherer
  16. R
    Raman Varabets <roman.vorobets@gmail.com>
  17. T
    tzm <frank@boldsolutions.de>
  18. M
    Mathieu Baudet <mathieubaudet@fb.com>
  19. O
    Oleksiy Golovko <alexei.golovko@gmail.com>
  20. R
    Rauan Mayemir <rauan@mayemir.io>
  21. C
    Carmelo Piccione <cep1@solvuu.com>
  22. J
    John Billings <john@monkeynut.org>
  23. L
    Louis Roché <louis@louisroche.net>
  24. B
    Brendan Long <self@brendanlong.com>
  25. C
    Chris Yocum <cyocum@gmail.com>
  26. L
    Louis Roché (Ahrefs) <louis.roche@ahrefs.com>
  27. L
    Louis Roché <louis.roche@ahrefs.com>
  28. P
    Pavel Antoshkin <pavel.antoshkin@ahrefs.com>
  29. P
    Pierre Boutillier <pierre.boutillier@laposte.net>
  30. S
    Shon Feder <shon.feder@key.me>
  31. A
    Anurag Soni <anuragsoni.13@gmail.com>
  32. A
    Arjun Ravi Narayan <arjunravinarayan@gmail.com>
  33. A
    Asya-kawai <kawai-toshiki@aintek.xyz>
  34. C
    Christophe Troestler <christophe.Troestler@umons.ac.be>
  35. Damien Doligez
  36. D
    Daniel M <dan.mntg@gmail.com>
  37. D
    Ding Xiang Fei <dingxiangfei2009@protonmail.ch>
  38. F
    François Pottier <francois.pottier@inria.fr>
  39. J
    Javier Chavarri <javier.chavarri@gmail.com>
  40. K
    Kate <kit.ty.kate@disroot.org>
  41. L
    Louis <louis.roche@ahrefs.com>
  42. L
    Louis Roché <louis@cryptosense.com>
  43. R
    Raman Varabets <raman+git@ahrefs.com>
  44. S
    Stephane Legrand <slegrand45@gmail.com>
  45. V
    Vincent Bernardoff <vb@luminar.eu.org>
  46. H
    haoyang <haoyang@esper.co>
  47. P
    pmundkur <prashanth.mundkur@gmail.com>
  48. Y
    ygrek <ygrek@autistici.org>

Maintainers

Sources

atd-2.15.0.tbz
sha256=ba4279bed54d13dcf3f6703a4b31744db815df22c0502d9965d6c674ce083933
sha512=33b7943ae6afd14e5a0709d9131d288e663d3f2b962caa065f1b11db8f6adfe081becba7968c8596b3ff2420577295ac248d521858cb0748e95971390eb29829

Description

ATD is the OCaml library providing a parser for the ATD language and various utilities. ATD stands for Adjustable Type Definitions in reference to its main property of supporting annotations that allow a good fit with a variety of data formats. This package also provides the 'atdcat' and 'atddiff' command-line utilities.

Published: 30 Oct 2023

README

ATD project - Static Types for Json APIs

ATD stands for Adaptable Type Definitions. It is a syntax for defining cross-language data types. It is used as input to generate efficient and type-safe serializers, deserializers and validators.

Target programming languages currently supported:

Export to other interface description languages (IDLs):

Tools to work with ATD files:

  • atdcat: check syntax, reformat, expand inherited definitions, export to JSON Schema, ...

  • atddiff: compare two revisions of a given ATD interface and report incompatibilities.

All can installed with opam e.g.

$ opam install atdgen

Documentation

here

Contributing

The ATD suite of tools is developed and maintained by volunteers—users like you. Various issues are in need of attention. If you'd like to contribute, please leave a comment on the issue you're interested in, or create a new issue. Experienced contributors will guide you as needed.

There are many simple ways of making a positive impact. For example, you can...

  • Use the software in your project.

  • Give a demo to your colleagues.

  • Share the passion on your blog.

  • Tweet about what you're doing with atd.

  • Report difficulties by creating new issues. We'll triage them.

  • Ask questions on StackOverflow.

  • Answer questions on StackOverflow.

  • Discuss usage on the OCaml forums.

  • Pick a task that's easy for you.

Check out in particular good first time issues and other issues with which we could use some help.

For guidelines on how to contribute code, consult CONTRIBUTING.md.

Authors

The ATD project started in 2010. Contributors include:

  • Martin Jambon

  • Rudi Grinberg

  • Alexandre Bourquelot

  • Ivan Jager

  • oleksiy

  • Gregoire Lionnet

  • David Sheets

  • Rytis Jonynas

  • Jeff Meister

  • Carmelo Piccione

  • Louis

  • Louis Roché

  • Raman Varabets

  • Daniel Weil

  • Egor Chemokhonenko

  • Gabriel Scherer

  • Louis Roché (Ahrefs)

  • Matthew McQuaid

  • koonwen

  • tzm

  • Mathieu Baudet

  • Oleksiy Golovko

  • Rauan Mayemir

  • Hyeseong Kim

  • John Billings

  • Marek Kubica

  • Zach Yannes

  • Antonin Décimo

  • Brendan Long

  • Caio Wakamatsu

  • Chris Yocum

  • Pierre Boutillier

  • Shon Feder

  • metanivek

  • sebastiantoh

  • Anurag Soni

  • Arjun Ravi Narayan

  • Asya-kawai

  • Christophe Troestler

  • Damien Doligez

  • Daniel M

  • Enrico Tassi

  • François Pottier

  • Javier Chavarri

  • Jonas Bergler

  • Kate

  • Stephane Legrand

  • Vincent Bernardoff

  • Zach

  • haoyang

  • pmundkur

  • ygrek

We distribute the source code under the terms of a BSD license.

Dependencies (7)

  1. cmdliner >= "1.1.0"
  2. yojson >= "1.6.0"
  3. re >= "1.9.0"
  4. easy-format
  5. menhir >= "20180523" & != "20211230"
  6. ocaml >= "4.08"
  7. dune >= "2.8"

Dev Dependencies (2)

  1. odoc with-doc
  2. alcotest with-test

Used by (12)

  1. atdd
  2. atdgen >= "2.14.0"
  3. atdj >= "2.10.0" & < "20151001.01"
  4. atdpy >= "2.10.0"
  5. atds >= "2.10.0"
  6. atdts >= "2.10.0"
  7. esgg
  8. melange-atdgen-codec-runtime
  9. monorobot
  10. openai-gym
  11. vecosek
  12. wcs-lib >= "2017-05-26.02"

Conflicts

None