Skip to content

Commit 403e128

Browse files
committed
fix: fix some doc in README, adding some badges in README
1 parent f9e675c commit 403e128

3 files changed

Lines changed: 34 additions & 10 deletions

File tree

.github/workflows/test.yml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,3 +40,11 @@ jobs:
4040
run: |
4141
source venv/bin/activate
4242
pytest
43+
44+
- name: Upload coverage reports to Codecov
45+
uses: codecov/codecov-action@v5
46+
with:
47+
token: ${{ secrets.CODECOV_TOKEN }}
48+
files: coverage.xml
49+
name: ${{ matrix.python-version }}-coverage
50+
flags: python-${{ matrix.python-version }}

README.md

Lines changed: 25 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,24 @@
11
# Aztec tool 🛸
22
[![aztec tool on pypi](https://badge.fury.io/py/aztec-tool.svg)](https://pypi.org/project/aztec-tool/)
33
[![Test with PyTest](https://github.com/mdevolde/aztec_tool/workflows/Test%20with%20PyTest/badge.svg)](https://github.com/mdevolde/aztec_tool/actions)
4+
[![codecov](https://codecov.io/gh/mdevolde/aztec_tool/branch/master/graph/badge.svg)](https://codecov.io/gh/mdevolde/aztec_tool)
45
[![Python Versions](https://img.shields.io/pypi/pyversions/aztec-tool.svg)](https://devguide.python.org/versions/)
56
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
7+
[![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/mdevolde/aztec_tool/pulls)
68

79
*A fast, pure‑Python Aztec Code reader with auto‑orientation and Reed-Solomon correction.*
810

911
-------------
1012
## Table of content
1113
1. [Installation](#installation)
1214
2. [Usage](#usage)
13-
3. [Changelog](#changelog)
14-
4. [TODO](#todo)
15-
5. [License](#license)
15+
3. [Useful links](#useful-links)
16+
- [Contributing](#contributing)
17+
- [Security](#security)
18+
- [Changelog](#changelog)
19+
- [TODO](#todo)
20+
- [License](#license)
21+
- [Code of Conduct](#code-of-conduct)
1622
6. [Resources](#Resources)
1723

1824
## Installation
@@ -52,7 +58,7 @@ The most common way to use the library is to use the `AztecDecoder` class. You c
5258
If you need to access more specific data, you can use the `AztecDecoder` class directly:
5359

5460
```python
55-
>>> from aztec_decoder import AztecDecoder
61+
>>> from aztec_tool import AztecDecoder
5662
>>> decoder = AztecDecoder("welcome_lib.jpg")
5763
>>> decoder.aztec_type
5864
<AztecType.COMPACT: 0>
@@ -71,7 +77,7 @@ If you have some problems with the correction, it can be useful to set `auto_cor
7177

7278
If you need very specific data, you can access the `AztecDecoder` class attributes, or directly the various classes used in the library.
7379

74-
This library has his own exceptions. You can find them in the `exceptions.py` file. The most common exception is `AztecDecoderError`, which is the parent class of all the exceptions in the library.
80+
This library has its own exceptions. You can find them in the `exceptions.py` file. The most common exception is `AztecDecoderError`, which is the parent class of all the exceptions in the library.
7581

7682
The tool is also available as a command line interface (CLI). You can use it by running the following command in your terminal:
7783

@@ -90,17 +96,27 @@ Data words: 21
9096
ECC bits: 01010101010010101000
9197
```
9298

93-
To have all the options available, you can run `aztec-tool -h `.
99+
You can view all available options by running `aztec-tool -h`.
94100

95-
## Changelog
101+
## Useful links
102+
### Contributing
103+
Contributions are welcome! If you want to contribute to the project, please read the [CONTRIBUTING.md](CONTRIBUTING.md) file.
104+
105+
### Security
106+
If you discover any security vulnerabilities, please read the procedure in the [SECURITY.md](SECURITY.md) file.
107+
108+
### Changelog
96109
The full changelog is available in the [CHANGELOG.md](CHANGELOG.md) file.
97110

98-
## TODO
111+
### TODO
99112
The plan for the next releases is available in the [TODO.md](TODO.md) file.
100113

101-
## License
114+
### License
102115
The Aztec tool is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
103116

117+
### Code of Conduct
118+
The Aztec tool is committed to providing a friendly, safe, and welcoming environment for all. Please read the [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) file for more details.
119+
104120
## Resources
105121
These resources were very useful to understand the Aztec code and build this library:
106122
- [Wikipedia - Aztec code](https://en.wikipedia.org/wiki/Aztec_Code)

pytest.ini

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# pytest.ini
22
[pytest]
3-
addopts = --cov=aztec_tool --cov-report=term-missing
3+
addopts = --cov=aztec_tool --cov-report=xml
44

55
[coverage:run]
66
source = aztec_tool

0 commit comments

Comments
 (0)