Support tabs and CRLF line endings

[zdne]

No description provided.

[netmilk]

+1
Apiary users are often facing this issue:

message: Cannot parse blueprint code 
description: The use of tab(s) '\\t' in source data isn't currently 
supported, please contact makers 
code: 2

[zzen]

+1

[zdne]

To fix this issues a moderate modification to https://github.com/apiaryio/sundown is needed.

Consider using Hoedown contributing to hoedown/hoedown#22 and hoedown/hoedown#28 instead

[pksunkara]

Can we make a hack for this by expanding all \t before parsing?

[zdne]

This won't not help as then you would need to recalculate the source maps (in order to display any possible warning / errors). Doing so (recalculating) is the core problem here and solving it would bring the solution for this issue (and thus it wouldn't be a hack)

[vitawasalreadytaken]

+1 for tabs! Any ETA on this?

[zdne]

@ze-phyr-us so far there wasn't too much of push on this one (read no concrete plans yet). Introducing this will most likely mean migration to Hoedown or CommonMark parser.

[stephnr]

Pinging for update @zdne

[zdne]

Hey @Stephn-R,
you are the first one to ask for this in a long time. I am afraid the status hasn't changed since #29 (comment) we might migrate the parser but no ETA just yet.

[stephnr]

So lets rise this baby back from the dead 💀 ⚡

[jacquesfu]

So what's a workaround? I have codeblocks with tabs to show examples... will the codeblocks have to be converted to spaces I guess?

[vitawasalreadytaken]

@jacquesfu I'm just piping my blueprints through sed 's/ / /g' before feeding them to snowcrash.

Edit: GH screws up the formatting, but obviously that was s/<tab>/<4 spaces>/g

[zdne]

Hey guys, may I just ask you where you need the tabs? Is it the mock server or testing? I presume it is really about the content of payloads and not necessarily the blueprint itself, correct?

[stephnr]

Alright so the way I was able to resolve this was if I targeted the affected files and ran a python method for stripping out carriage returns >> \r

[vitawasalreadytaken]

@zdne Coding standards. When the entire project uses tabs rather than spaces, I want my documentation consistent with that.

[stephnr]

Agreed but this discussion is about the way line endings are formed by your IDE/System

[lippea]

This is not big problem, but quite annoying.
We also have problem that I removed all \t \r, committed to git, but others still have problem with \r after downloading the code again.

[BigBlueHat]

I just hit this issue because Windows. 😖 It's obviously possible to route around, but it's an unfortunate complication when trying to use API Blueprint docs with dredd, etc.

Remove pain. Win hearts and minds. 😄

👍 to fixing this soon.

[tobeorla]

I hope CRLF gets supported or converted when necessary

[jch254]

+1!!!

[honzajavorek]

This is an important pre-requisite for apiaryio/dredd#204.

[vnenkpet]

+1

[lippea]

It was annoying, but not blocking issue.
I ended up by replacing with notepad++ and check into github with .gitattributes:
*.apib text eol=lf

[abtris]

Migrated to apiaryio/drafter#652