Skip to content

Commit 44f334d

Browse files
committed
[main]: update README
1 parent cf80c7c commit 44f334d

3 files changed

Lines changed: 298 additions & 328 deletions

File tree

README.md

Lines changed: 8 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
1-
# Sample-py
1+
# RZ-Sample
22

3-
A streamlit, fast api boilerplate for python development
3+
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/rz-sample)
4+
![pypi](https://badgen.net/pypi/v/rz-sample)
5+
![License](https://badgen.net/pypi/license/rz-sample)
6+
7+
poetry + streamlit + fast api boilerplate for python development.
48

59
## Installation Guide
610

@@ -65,7 +69,7 @@ setup `.env.development` and `.env.production` in project root
6569

6670
```bash
6771
make dev
68-
#or with custom port
72+
# OR with custom port
6973
poetry run sample dev --port 8051
7074

7175
```
@@ -82,7 +86,7 @@ poetry run sample dev --port 1234
8286

8387
```bash
8488
make api
85-
#OR with custom port
89+
# OR with custom port
8690
poetry run sample api --port 5000
8791
```
8892

@@ -105,39 +109,6 @@ poetry run mypy .
105109
poetry run ruff check .
106110
```
107111

108-
## Build & Packaging
109-
110-
## Build Package
111-
112-
```bash
113-
114-
poetry clean
115-
poetry build
116-
```
117-
118-
Artifacts in `dist/`
119-
120-
- sample-x.y.0-py3-none-any.whl
121-
- sample-x.y.0.tar.gz
122-
123-
## Test Locally
124-
125-
```bash
126-
python -m venv .venv-dist
127-
source .venv-dist/bin/activate
128-
# Windows
129-
.venv-dist\Scripts\activate
130-
```
131-
132-
### Install package
133-
134-
```bash
135-
pip install dist/*.whl
136-
pip install --upgrade dist/*.whl
137-
# Install extras:
138-
pip install sample
139-
```
140-
141112
## CLI Shortcuts
142113

143114
`make dev` → Launch Streamlit UI
@@ -146,21 +117,6 @@ pip install sample
146117

147118
current version will be printed on start of above commands.
148119

149-
## Install GIT hooks
150-
151-
these hooks will
152-
153-
- Check for lint and audit for security before commit
154-
- Append branch name in commit message
155-
- Generate requirements.txt on checkout on new branch
156-
157-
```bash
158-
# Install git hooks
159-
make hooks
160-
```
161-
162-
there is `.vscode/Python.code-profile` file; import this as a profile in vscode which include necessary extension for python development.
163-
164120
## Troubleshooting
165121

166122
sometimes there might be chances that virtual environment get corrupted then delete the old virtual environment and start afresh.

0 commit comments

Comments
 (0)