Skip to content

Commit 66bef49

Browse files
author
evelynmitchell
authored
Merge branch 'kyegomez:main' into main
2 parents 2fb6808 + 3ebd8ae commit 66bef49

File tree

1 file changed

+12
-51
lines changed

1 file changed

+12
-51
lines changed

README.md

Lines changed: 12 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -11,27 +11,13 @@ You can install the package using pip
1111
```bash
1212
pip install -e .
1313
```
14-
## Structure
15-
```
16-
├── LICENSE
17-
├── Makefile
18-
├── README.md
19-
├── agorabanner.png
20-
├── example.py
21-
├── package
22-
│ ├── __init__.py
23-
│ ├── main.py
24-
│ └── subfolder
25-
│ ├── __init__.py
26-
│ └── main.py
27-
├── pyproject.toml
28-
└── requirements.txt
29-
30-
2 directories, 11 files
31-
```
14+
3215
# Usage
16+
```python
17+
print("hello world")
18+
19+
```
3320

34-
# Documentation
3521

3622

3723
### Code Quality 🧹
@@ -40,8 +26,8 @@ We provide two handy commands inside the `Makefile`, namely:
4026

4127
- `make style` to format the code
4228
- `make check_code_quality` to check code quality (PEP8 basically)
43-
44-
So far, **there is no types checking with mypy**. See [issue](https://github.com/roboflow-ai/template-python/issues/4).
29+
- `black .`
30+
- `ruff . --fix`
4531

4632
### Tests 🧪
4733

@@ -51,26 +37,11 @@ So far, **there is no types checking with mypy**. See [issue](https://github.com
5137

5238
**Important**: Before publishing, edit `__version__` in [src/__init__](/src/__init__.py) to match the wanted new version.
5339

54-
We use [`twine`](https://twine.readthedocs.io/en/stable/) to make our life easier. You can publish by using
55-
56-
```
57-
export PYPI_USERNAME="you_username"
58-
export PYPI_PASSWORD="your_password"
59-
export PYPI_TEST_PASSWORD="your_password_for_test_pypi"
60-
make publish -e PYPI_USERNAME=$PYPI_USERNAME -e PYPI_PASSWORD=$PYPI_PASSWORD -e PYPI_TEST_PASSWORD=$PYPI_TEST_PASSWORD
61-
```
62-
63-
You can also use token for auth, see [pypi doc](https://pypi.org/help/#apitoken). In that case,
64-
6540
```
66-
export PYPI_USERNAME="__token__"
67-
export PYPI_PASSWORD="your_token"
68-
export PYPI_TEST_PASSWORD="your_token_for_test_pypi"
69-
make publish -e PYPI_USERNAME=$PYPI_USERNAME -e PYPI_PASSWORD=$PYPI_PASSWORD -e PYPI_TEST_PASSWORD=$PYPI_TEST_PASSWORD
41+
poetry build
42+
poetry publish
7043
```
7144

72-
**Note**: We will try to push to [test pypi](https://test.pypi.org/) before pushing to pypi, to assert everything will work
73-
7445
### CI/CD 🤖
7546

7647
We use [GitHub actions](https://github.com/features/actions) to automatically run tests and check code quality when a new PR is done on `main`.
@@ -87,21 +58,11 @@ The **correct steps** to create a new realease are the following:
8758
The CI will run when you create the new release.
8859

8960
# Docs
90-
We use MK docs. This repo comes with the zeta docs. All the docs configurations are already here along with the readthedocs configs
91-
92-
# Q&A
93-
94-
## Why no cookiecutter?
95-
This is a template repo, it's meant to be used inside GitHub upon repo creation.
61+
We use MK docs. This repo comes with the zeta docs. All the docs configurations are already here along with the readthedocs configs.
9662

97-
## Why reinvent the wheel?
9863

99-
There are several very good templates on GitHub, I prefer to use code we wrote instead of blinding taking the most starred template and having features we don't need. From experience, it's better to keep it simple and general enough for our specific use cases.
100-
101-
# Architecture
64+
# Tests
65+
`pytest`
10266

10367
# License
10468
MIT
105-
106-
107-

0 commit comments

Comments
 (0)