Skip to content

Commit 4c42e1d

Browse files
committed
Base config
1 parent 7d783b7 commit 4c42e1d

File tree

3 files changed

+23
-8
lines changed

3 files changed

+23
-8
lines changed

README.md

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,16 @@ A professional Python project template designed for modern development. It uses
1010
## 🚀 Getting Started
1111

1212
### 1. Prerequisites
13+
1314
You will need `uv` installed. It replaces tools like `pip`, `poetry`, and `virtualenv`.
15+
1416
```powershell
1517
# Windows (PowerShell)
1618
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
1719
```
1820

1921
### 2. Installation
22+
2023
Clone the repo and sync dependencies:
2124

2225
```bash
@@ -25,6 +28,7 @@ uv sync
2528
```
2629

2730
### 3. Running the App
31+
2832
```bash
2933
# Run the command-line entry point
3034
uv run defaultpython
@@ -38,6 +42,7 @@ uv run uvicorn defaultpython.api:app --reload
3842
## 🛠️ Development Workflow
3943

4044
### Managing Dependencies
45+
4146
Instead of `pip install`, use `uv` to add packages. This keeps `pyproject.toml` and `uv.lock` in sync.
4247

4348
```bash
@@ -49,6 +54,7 @@ uv add --dev pytest
4954
```
5055

5156
### Code Quality & Testing
57+
5258
We use strict tools to maintain high code quality. You should run these before pushing code.
5359

5460
| Tool | Purpose | Command |
@@ -59,6 +65,7 @@ We use strict tools to maintain high code quality. You should run these before p
5965
| **Pytest** | Runs your test suite. | `task test` |
6066

6167
### Using the Task Runner
68+
6269
This project uses [Task](https://taskfile.dev/) to simplify commands. It's like a modern `Make`.
6370

6471
```bash
@@ -90,14 +97,19 @@ task check
9097
```
9198

9299
## 🔌 API Documentation
100+
93101
When the server is running (`task run-api`), you can view the interactive documentation:
94-
* **Swagger UI**: [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)
95-
* **ReDoc**: [http://127.0.0.1:8000/redoc](http://127.0.0.1:8000/redoc)
102+
103+
- **Swagger UI**: [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)
104+
- **ReDoc**: [http://127.0.0.1:8000/redoc](http://127.0.0.1:8000/redoc)
96105

97106
## 🤝 Contributing
98-
1. **Environment Variables**: Copy `.env.example` to `.env` if you need to set secrets.
99-
2. **Pre-commit Hooks**: We use `pre-commit` to catch errors automatically.
100-
```bash
101-
uv run pre-commit install
102-
```
103-
3. **Commit Messages**: We use [Conventional Commits](https://www.conventionalcommits.org/) (e.g., `feat: add login`, `fix: crash on modules`). This allows us to generate changelogs automatically.
107+
108+
1. **Environment Variables**: Copy `.env.example` to `.env` if you need to set secrets.
109+
2. **Pre-commit Hooks**: We use `pre-commit` to catch errors automatically.
110+
111+
```bash
112+
uv run pre-commit install
113+
```
114+
115+
3. **Commit Messages**: We use [Conventional Commits](https://www.conventionalcommits.org/) (e.g., `feat: add login`, `fix: crash on modules`). This allows us to generate changelogs automatically.

pyproject.toml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,9 @@ defaultpython = "defaultpython.main:main"
2020
[tool.hatch.build.targets.wheel]
2121
packages = ["src/defaultpython"]
2222

23+
[tool.hatch.build.targets.wheel.force-include]
24+
"src/defaultpython/py.typed" = "defaultpython/py.typed"
25+
2326
[tool.hatch.build.targets.sdist]
2427
include = ["src/defaultpython"]
2528

src/defaultpython/py.typed

Whitespace-only changes.

0 commit comments

Comments
 (0)