Skip to content

Commit f70f0c4

Browse files
authored
Update docs + Version Bump (#57)
* Update docs * Version bump to 0.8.0
1 parent 2013a81 commit f70f0c4

File tree

2 files changed

+38
-31
lines changed

2 files changed

+38
-31
lines changed

README.md

Lines changed: 37 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,6 @@
22

33
[![PyPI version](https://badge.fury.io/py/pyanchor.svg)](https://badge.fury.io/py/pyanchor)
44
![GitHub](https://img.shields.io/github/license/endlesstrax/pyanchor)
5-
![Black](https://img.shields.io/badge/code%20style-black-000000.svg)
6-
![CodeCov](https://codecov.io/gh/EndlessTrax/pyanchor/branch/master/graph/badge.svg)
7-
![Build](https://travis-ci.org/EndlessTrax/pyanchor.svg?branch=master)
85

96
Dead links are an annoyance for websites with an extensive amount of content. A side from the
107
negative impact on SEO, dead links are an annoyance for any user that clicks on one.
@@ -14,18 +11,27 @@ into your development workflow so that users never see a 404 in the first place.
1411

1512
## Install
1613

17-
PyAnchor requires Python 3.7 and above.
14+
> Requires Python 3.8 and above.
15+
16+
It is recommended that you install this package in a virtual or isoloated environment. The easiest way to do this
17+
is with pipx.
18+
19+
```shell
20+
pipx install pyanchor
21+
```
22+
23+
Alternatively, you can install it with pip into your virtual environment:
1824

1925
MacOS / Linux:
2026

2127
```shell
22-
$ python3 -m pip install pyanchor
28+
python3 -m pip install pyanchor
2329
```
2430

2531
Windows:
2632

27-
```cmd
28-
> python -m pip install pyanchor
33+
```pwsh
34+
python -m pip install pyanchor
2935
```
3036

3137
## Using the CLI
@@ -34,48 +40,54 @@ The CLI can be invoked with the `pyanchor` command. A URL **must** be provided u
3440

3541
To get the help page:
3642

37-
```shell script
38-
> pyanchor --help
43+
```shell
44+
pyanchor --help
3945
```
4046

4147
![Example Gif](/assets/example-help.gif)
4248

4349
Basic example for a single page:
50+
4451
> Note: all provided URLs must include a valid HTTP scheme.
4552
4653
```shell
47-
> pyanchor https://mysite.com/
54+
pyanchor https://mysite.com/
4855
```
4956

50-
5157
![Example Gif](/assets/example-single-page.gif)
5258

53-
54-
If you want to check all links on a website, and not just a single page, a `sitemap.xml` URL may be
55-
provided and flagged with `--sitemap`.
59+
If you want to check all links on a website, and not just a single page, a `sitemap.xml` URL may be provided and
60+
flagged with `--sitemap`.
5661

5762
Example:
5863

59-
```shell script
60-
> pyanchor https://mysite.com/sitemap.xml --sitemap
64+
```shell
65+
pyanchor https://mysite.com/sitemap.xml --sitemap
6166
```
6267

6368
![Example Gif](/assets/example-sitemap.gif)
6469

6570
By default, successful requests are not printed to the terminal. To see all urls with a `200`
6671
response add the `--verbose` flag.
6772

68-
```shell script
69-
> pyanchor https://mysite.com --verbose
73+
```shell
74+
pyanchor https://mysite.com --verbose
7075
```
7176
![Example Gif](/assets/example-single-page-verbose.gif)
7277

73-
```shell script
74-
> pyanchor https://mysite.com/sitemap.xml --sitemap --verbose
78+
```shell
79+
pyanchor https://mysite.com/sitemap.xml --sitemap --verbose
7580
```
7681

7782
![Example Gif](/assets/example-sitemap-verbose.gif)
7883

84+
If you wish the output the results to a csv file, instead of to the terminal (default), then you may wish to use
85+
the `--output-csv` flag:
86+
87+
```shell
88+
pyanchor https://mysite.com --output-csv output/path/to/file
89+
```
90+
7991
## But wait, there's more...
8092

8193
To integrate PyAnchor into your application, you can import the `LinkResults` class. `LinkResults`
@@ -126,29 +138,24 @@ and use the appropriate label.
126138

127139
## Support
128140

129-
If you would like to show your support for the project, I would be very grateful if you would donate
130-
to a charity close to my heart, [Walk AS One](https://walkasone.org/donate/).
131-
132-
And if you would prefer to donate to me personally instead,
141+
If you would like to show your support for the project,
133142
[you can sponsor me on Github](https://github.com/sponsors/EndlessTrax)? 🤓
134143

135-
136144
## How to Contribute
137145

138-
Please **raise an issue** before making a PR, so that the issue and implementation can be discussed before you write any code. **This will save you time**, and increase the chances of your PR being merged without significant changes.
146+
Please **raise an issue before making a PR**, so that the issue and implementation can be discussed before you write any code. This will save you time, and increase the chances of your PR being merged without significant changes.
139147

140-
Please make PR's on a **new branch**, and _not_ on main/master.
141-
142-
Please **format you code** with [Black](https://pypi.org/project/black/).
148+
Please **make PR's on a new branch**, and _not_ on main/master.
143149

144150
Please **include tests** for any PR's that include code (unless current tests cover your code contribution).
145151

146-
152+
Please **add documentation** for any new features or flags.
147153

148154
## Contributors
149155

150156
Thank you to:
151157

158+
- [Zingzy](https://github.com/Zingzy) for PR [#55](https://github.com/EndlessTrax/pyanchor/pull/55)
152159
- [mrbazzan](https://github.com/mrbazzan) for PR [#25](https://github.com/EndlessTrax/pyanchor/pull/25)
153160
- [Icelain](https://github.com/Icelain) for PR [#11](https://github.com/EndlessTrax/pyanchor/pull/11)
154161
- [wevnasc](https://github.com/wevnasc) for PR [#8](https://github.com/EndlessTrax/pyanchor/pull/8)

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
44

55
[project]
66
name = "pyanchor"
7-
version = "0.7.3"
7+
version = "0.8.0"
88
authors = [
99
{name="Ricky White", email="[email protected]"},
1010
]

0 commit comments

Comments
 (0)