Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/altai-man/asn-meta
Experimental ASN.1 spec "evaluator" for Raku
https://github.com/altai-man/asn-meta
asn1 metaprogramming perl6 perl6-module raku raku-module rakulang
Last synced: about 1 month ago
JSON representation
Experimental ASN.1 spec "evaluator" for Raku
- Host: GitHub
- URL: https://github.com/altai-man/asn-meta
- Owner: Altai-man
- License: artistic-2.0
- Created: 2019-01-14T16:26:57.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2021-04-01T21:14:34.000Z (almost 4 years ago)
- Last Synced: 2024-12-17T05:16:18.452Z (about 2 months ago)
- Topics: asn1, metaprogramming, perl6, perl6-module, raku, raku-module, rakulang
- Language: Raku
- Homepage:
- Size: 25.4 KB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
### ASN::META
Experimental Raku module that is able to compile [ASN.1](https://en.wikipedia.org/wiki/Abstract_Syntax_Notation_One) specification into set of Raku types.
#### What ASN::META does not?
* It does not generate Raku code (at least, textual form).
* The module knows nothing about ASN.1 encoding means, it purely generates Raku types.
For this purpose a separate module may be used. Currently, goal is to have full compatibility
with [ASN::BER](https://github.com/Altai-man/ASN-BER) module.
#### What ASN::META does?
Main workflow is as follows:
* A specification is passed to ASN::META on module `use`
* (internally, `ASN::Grammar` is used to parse the specification)
* ASN::META uses parsed specification to generate appropriate types with [MOP](https://docs.perl6.org/language/mop)
* Generated types for particular ASN.1 specification are precompiled and exported
#### What it does?
#### Synopsis
```perl6
# In file `schema.asn`:
WorldSchema
DEFINITIONS IMPLICIT TAGS ::= BEGIN
Rocket ::= SEQUENCE
{
name UTF8String,
message UTF8String DEFAULT "Hello World",
fuel ENUMERATED {
solid(0),
liquid(1),
gas(2)
},
speed CHOICE {
mph [0] INTEGER,
kmph [1] INTEGER
} OPTIONAL,
payload SEQUENCE OF UTF8String
}
END
# In file `User.pm6`:
# Note usage of BEGIN block to gather file's content at compile time
use ASN::META BEGIN [ 'file', slurp 'schema.asn' };
# In case of re-compilation on dependency change, package User may be
# re-built from the place where local paths are useless, in this case use %?RESOURCES:
# `use ASN::META BEGIN { 'file', slurp %?RESOURCES }`
# `Rocket` type is exported by ASN::META
my Rocket $rocket = Rocket.new(name => 'Rocker', :fuel(solid),
speed => Speed.new((mph => 9001)),
payload => Array[Str].new('A', 'B', 'C'));
# As well as inner types being promoted to top level:
say Fuel; # generated enum
say solid; # value of this enum, (solid ~~ Fuel) == true
say Speed; # Generated type based on ASNChoice from ASN::BER
```