support for line numbers in github & html report format

AreYouOK?

A minimal, fast & easy to use URL health checker

Who is `AreYouOk` made for ?

OSS Package Maintainers 📦️:
With packages comes documentation which needs to be constantly updated & checked for dead/non-functioning URLs.
Tech Bloggers ✍️ :
If you are someone who writes countless tutorials & owns the source for your website, Use areyouok to make sure your blogs don't contain any non-functioning URLs.
Literally anyone who wants to check a bunch of URLs for being dead ☠️ or not, SEO experts?

With time AreYouOk can evolve to analyze URLs over a remote resource as well, send your ideas ✨️ through Discussions

Installation

Linux

curl -LJO https://github.com/Bhupesh-V/areyouok/releases/latest/download/areyouok-linux-amd64

MacOS

curl -LJO https://github.com/Bhupesh-V/areyouok/releases/latest/download/areyouok-darwin-amd64

Windows

curl -LJO https://github.com/Bhupesh-V/areyouok/releases/latest/download/areyouok-windows-amd64.exe

Check installation by running areyouok -v

$ mv areyouok-darwin-amd64 areyouok
$ areyouok -v
v1.0.0

Download builds for other architectures from releases

Usage

AreYouOk provides 3 optional arguments followed by a directory path (default: current directory)

-t type of files to scan for links
-i list of files or directories to ignore for links (node_modules, .git)
-r type of report to generate

Some example usages:

Analyze all HTML files for hyperlinks. The default directory path is set to current directory.
```
areyouok -t=html Documents/my-directory
```
There is not limitation on file type, to analyze json files use -t=json. The default type is set to md (markdown)
To ignore certain directories or file-types use the ignore -i flag.
```
areyouok -i=_layouts,.git,_site,README.md,build.py,USAGE.md
```

By default AreYouOk outputs analyzed data directly into console. To generate a report, use the -r flag

areyouok -i=_layouts,.git,_site,README.md,build.py,USAGE.md -r=html ~/Documents/til/

Currently supported report formats are: json, txt, html & github.

Different report types provide different levels of information which is briefly summarized below:

JSON (report.json)
The JSON report can be used for other computational tasks as required (E.g emailing dead urls to yourself)

{
   "http://127.0.0.1:8000/": {
           "code": "",
           "message": "Get \"http://127.0.0.1:8000/\": dial tcp 127.0.0.1:8000: connect: connection refused",
           "response_time": ""
   },
   "http://freecodecamp.org": {
           "code": "200",
           "message": "OK",
           "response_time": "5.44s"
   },
   "http://ogp.me/": {
           "code": "200",
           "message": "OK",
           "response_time": "3.60s"
   },
   "http://prnbs.github.io/projects/regular-expression-parser/": {
           "code": "200",
           "message": "OK",
           "response_time": "0.25s"
   },
   "https://bhupeshv.me/30-Seconds-of-C++/": {
           "code": "404",
           "message": "Not Found",
           "response_time": "3.84s"
   },
   ...
}

Text (report.txt)
The text format just lists the URLs which were not successfully fetched. Useful if you just want dead urls. Text report also puts the no.of hyperlinks analyzed along with total files & total reponse time.

74 URLs were analyzed across 31 files in 21.69s

Following URLs are not OK:

http://freecodecamp.org`
http://127.0.0.1:8000/
https://drive.google.com/uc?export=view&id=<INSERT-ID>`
https://drive.google.com/file/d/
https://drive.google.com/uc?export=view&id=$get_last
https://github.com/codeclassroom/PlagCheck/blob/master/docs/docs.md
https://bhupeshv.me/30-Seconds-of-C++/

Note that the total time would vary according to your internet speed & website latency.

HTML (report.html)
The html report is the most superior formats of all & can be used to have a visual representaion of analyzed links.
Below is demo of how this HTML report looks like, you can see it live
GitHub (report.github)
The github report format is well suited if you are utilizing Github Actions. The format generated is largely HTML, compatible with github's commonmark markdown renderer.
Below is a demo of a Github Action which reports the analyzed URLs through github issues. Here is a demo link

Development

Prerequisites

Go 1.16

Clone the repository.

git https://github.com/Bhupesh-V/areyouok.git

Run tests.
```
go test -v
```

Format & Lint the project.

gofmt -w areyouok.go && golint areyouok.go

Projects Using `AreYouOk`

📝 Changelog

See the CHANGELOG.md file for details.

☺️ Show your support

Support me by giving a ⭐️ if this project helped you! or just

📝 License

👋 Contributing

Please read the CONTRIBUTING file for the process of submitting pull requests to us.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_MaDDogx
🐛

This project follows the all-contributors specification. Contributions of any kind welcome!

	- name: Set up Go
	uses: actions/setup-go@v2
	with:
	stable: 'false'
	go-version: '1.16-beta1'

bhupesh-v / areyouok Goto Github PK

areyouok's Introduction

AreYouOK?

Who is AreYouOk made for ?

Installation

Usage

Development

Prerequisites

Projects Using AreYouOk

📝 Changelog

☺️ Show your support

📝 License

👋 Contributing

Contributors ✨

areyouok's People

Contributors

Stargazers

Watchers

Forkers

areyouok's Issues

Recommend Projects

Recommend Topics

Recommend Org

Who is `AreYouOk` made for ?

Projects Using `AreYouOk`