معرفی شرکت ها
flake8-error-link-1.2.4
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A linter that ensures all raised Exceptions include an error with a link to more information
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | flake8-error-link-1.2.4 |
| نام | flake8-error-link |
| نسخه کتابخانه | 1.2.4 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | David Andersson |
| ایمیل نویسنده | david@jdkandersson.com |
| آدرس صفحه اصلی | - |
| آدرس اینترنتی | https://pypi.org/project/flake8-error-link/ |
| مجوز | Apache 2.0 |
# flake8-error-link
Have you ever encountered an error when using a package and then gone to Google
to find out how to solve the error? Wouldn't your users prefer to go directly
to your documentation that tells them exactly what went wrong and how to
resolve that error? `flake8-error-link` checks the way exceptions are raised in
your code base to ensure that a link with more information is provided.
## Getting Started
```shell
python -m venv venv
source ./venv/bin/activate
pip install flake8 flake8-error-link
flake8 source.py
```
On the following code:
```Python
# source.py
raise Exception
```
This will produce warnings such as:
```shell
source.py:1:0: ELI001 builtin exceptions should be raised with a link to more information: https://github.com/jdkandersson/flake8-error-link#fix-eli001
```
This can be resolved by changing the code to:
```Python
# source.py
raise Exception("more information: https://github.com/jdkandersson/flake8-error-link#fix-eli001")
```
## Configuration
The plugin adds the following configurations to `flake8`:
* `--error-link-regex`: The regular expression to use to verify the way
exceptions are reased, defaults to
`more information: (mailto\:|(news|(ht|f)tp(s?))\:\/\/){1}\S+`
## Rules
A few rules have been defined to allow for selective suppression:
* `ELI001`: checks that any builtin exceptions that are raised with constant
arguments include a link to more information.
* `ELI002`: checks that any custom exceptions that are raised with constant
arguments include a link to more information.
* `ELI003`: checks that any exceptions that are raised with variable arguments
include a constant argument with a link to more information.
* `ELI004`: checks that any exceptions that are re-raised include a constant
argument with a link to more information.
### Fix ELI001
This linting rule is trigger by raising an inbuilt exception without providing
a constant that includes a link to more information as one of the arguments to
the constructor. For example:
```Python
raise Exception
raise ValueError
raise Exception()
raise Exception("oh no! :(")
```
These examples can be fixed by using something like:
```Python
raise Exception(
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli001"
)
raise ValueError(
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli001"
)
raise Exception(
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli001"
)
raise Exception(
"oh no! :(",
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli001",
)
```
### Fix ELI002
This linting rule is trigger by raising a custom exception without providing
a constant that include a link to more information as one of the arguments to
the constructor. For example:
```Python
class CustomError(Exception):
pass
raise CustomError
raise CustomError()
raise CustomError("bummer...")
```
These examples can be fixed by using something like:
```Python
class CustomError(Exception):
pass
raise CustomError(
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli002"
)
raise CustomError(
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli002"
)
raise CustomError(
"bummer...",
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli002",
)
```
### Fix ELI003
This linting rule is trigger by raising an exception and passing at least one
argument without providing a constant that include a link to more information
as one of the arguments to the constructor. For example:
```Python
message = "gotcha"
def get_message():
return message
raise Exception(get_message())
raise Exception(f"{message} quite badly")
```
These examples can be fixed by using something like:
```Python
message = "gotcha"
def get_message():
return message
raise Exception(
get_message(),
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli003",
)
raise Exception(
f"{message} quite badly, more information: https://github.com/jdkandersson/flake8-error-link#fix-eli003"
)
```
### Fix ELI004
This linting rule is trigger by re-raising an exception. For example:
```Python
try:
raise Exception(
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli004"
)
except Exception:
raise
```
This example can be fixed by using something like:
```Python
try:
raise Exception(
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli004"
)
except Exception as exc:
raise Exception(
"more information: https://github.com/jdkandersson/flake8-error-link#fix-eli004"
) from exc
```
This rule can be spurious at times if an exception is re-raisesd that already
has a more information link. Regardless, it is usually a good idea to include a
specific link for a problem. The context is usually different when an exception
is re-raised so it could be useful to include documentation for that context
rather then relying on any link provided by the original exception.
نیازمندی
| مقدار | نام |
|---|---|
| >=5 | flake8 |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.8.1,<4.0.0 | Python |
نحوه نصب
نصب پکیج whl flake8-error-link-1.2.4:
pip install flake8-error-link-1.2.4.whl
نصب پکیج tar.gz flake8-error-link-1.2.4:
pip install flake8-error-link-1.2.4.tar.gz