An open API service indexing awesome lists of open source software.

https://github.com/julia-vscode/documentformat.jl

Auto-formatter for Julia
https://github.com/julia-vscode/documentformat.jl

Last synced: 3 months ago
JSON representation

Auto-formatter for Julia

Awesome Lists containing this project

README

          

# DocumentFormat

### This package is deprecated. Please use [JuliaFormatter.jl](https://github.com/domluna/JuliaFormatter.jl) instead!
---
[![Dev](https://img.shields.io/badge/docs-dev-blue.svg)](https://www.julia-vscode.org/DocumentFormat.jl/dev)
[![Project Status: Active - The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)
![](https://github.com/julia-vscode/DocumentFormat.jl/workflows/Run%20CI%20on%20master/badge.svg)
[![codecov.io](http://codecov.io/github/julia-vscode/DocumentFormat.jl/coverage.svg?branch=master)](http://codecov.io/github/julia-vscode/DocumentFormat.jl?branch=master)

An auto formatter for Julia.

## Installation and Usage
```julia
using Pkg
Pkg.add("DocumentFormat")
```
```julia
using DocumentFormat
```
**Documentation**: [![Dev](https://img.shields.io/badge/docs-dev-blue.svg)](https://www.julia-vscode.org/DocumentFormat.jl/dev)

## Overview
The main function to format code is `format`. When called with a string argument, that string is assumed to be code and a new string in which the code is formatted is returned. When called with an `AbstractPath` that points to a file, that file is being formatted. If called with an `AbstractPath` that points to a folder, all `*.jl` files in that folder are formatted.

The function `isformatted` checks whether a piece of code is formatted. It can be called with a string (assumed to hold code) or an `AbstractPath`.