<commit_before># transit-julia

Transit is a data format and a set of libraries for conveying values between applications written in different languages. This library provides support for marshalling Transit data to/from [Julia](http://julialang.org).

* [Rationale](http://blog.cognitect.com/blog/2014/7/22/transit)
* [Specification](http://github.com/cognitect/transit-format)

This implementation's major.minor version number corresponds to the version of the Transit specification it supports.

Currently on the JSON formats are implemented.
MessagePack is **not** implemented yet. 

_NOTE: Transit is a work in progress and may evolve based on feedback. As a result, while Transit is a great option for transferring data between applications, it should not yet be used for storing data durably over time. This recommendation will change when the specification is complete._

## Usage

Reading data with transit-julia involves...

```julia
TBD
```

Writing is similar:

```julia
TBD
```


## Default Type Mapping

Really this is all TBD at this point.

| Semantic Type | write accepts | read produces |
|:--------------|:--------------|:--------------|
| null| nil | nil |
| string| string | string |
| boolean | bool| bool |
| integer, signed 64 bit| any signed or unsiged int type | int64 |
| floating pt decimal| float32 or float64 | float64 |
| bytes| []byte | []byte |
| keyword | transit.Keyword | transit.Keyword |
| symbol | transit.Symbol | transit.Keyword
| arbitrary precision decimal| big.Float | big.Float |
| arbitrary precision integer| big.Int | big.Int |
| point in time | time.Time | time.Time |
| point in time RFC 33339 | - | time.Time |
| u| github.com/pborman/uuid UUID| github.com/pborman/uuid UUID|
| uri | net/url URL | net/url URL |
| char | rune | rune |
| special numbers | As defined by math NaN and math.Inf() | TBD
| array | arrays or slices | []interface{} |
| map | map[interface{}]interface{} | map[interface{}]interface{} | 
| set |  transit.Set | transit.Set |
| list | container/list List | container/list List |
| map w/ composite keys |  transit.CMap |  transit.CMap |
| link | TBD | TBD |


## Copyright and License
Copyright © 2016 <NAME>

This library is a Go port of the Java and Ruby versions created and maintained by Cognitect, therefore

Copyright © 2014 Cognitect

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

This README file is based on the README from transit-csharp, therefore:

Copyright © 2014 NForza.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

<commit_msg>First pass at matching Julia types to Transit spec<commit_after># transit-julia

Transit is a data format and a set of libraries for conveying values between applications written in different languages. This library provides support for marshalling Transit data to/from [Julia](http://julialang.org).

* [Rationale](http://blog.cognitect.com/blog/2014/7/22/transit)
* [Specification](http://github.com/cognitect/transit-format)

This implementation's major.minor version number corresponds to the version of the Transit specification it supports.

Currently only the JSON formats are implemented.
MessagePack is **not** implemented yet. 

_NOTE: Transit is a work in progress and may evolve based on feedback. As a result, while Transit is a great option for transferring data between applications, it should not yet be used for storing data durably over time. This recommendation will change when the specification is complete._

## Usage

Reading data with transit-julia involves...

```julia
TBD
```

Writing is similar:

```julia
TBD
```


## Default Type Mapping

Really this is all TBD at this point.

| Semantic Type | write accepts | read produces |
|:--------------|:--------------|:--------------|
| null| Nothing | Nothing |
| string| string | string |
| boolean | Bool | Bool |
| integer, signed 64 bit| any signed or unsiged int type | Int64 |
| floating pt decimal| Float32 or Float64 | Float64 |
| bytes| Array{Int8} | Array{Int8} |
| keyword | Symbol | Symbol |
| symbol | Transit.Symbol | Transit.Symbol
| arbitrary precision decimal| BigFloat | BigFloat |
| arbitrary precision integer| BigInt | BigInt |
| point in time | Instant, Time | Instant |
| point in time RFC 33339 | UTInstant, DateTime | UTInstant |
| uuid | Base.Random.UUID| Base.Random.UUID|
| uri | URIParser.URI | URIParser.URI |
| char | Char | Char |
| special numbers | Inf, Nan| Inf, Nan
| array | arrays or slices | []interface{} |
| map | Dict{Any,Any} | Dict{Any,Any} | 
| set |  Set{Any} | Set{Any} |
| list | Array{Any} | Array{Any} |
| map w/ composite keys |  Dict{Array,Any} |  Dict{Array,Any} |
| link | Transit.Link | Transit.Link |


## Copyright and License
Copyright © 2016 <NAME>

This library is a Julia port of the Java and Ruby versions created and maintained by Cognitect, therefore

Copyright © 2014 Cognitect

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

This README file is based on the README from transit-csharp, therefore:

Copyright © 2014 NForza.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
{'fraction_non_alphanumeric': 0.0943778002601532, 'fraction_numerical': 0.012429541841306548, 'mean_word_length': 4.084496693607641, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3031573', 'n_tokens_mistral': 1941, 'n_tokens_neox': 1805, 'n_words': 887}