Skip to content

Commit 2eb9589

Browse files
Improve Readme
1 parent eb3a65f commit 2eb9589

1 file changed

Lines changed: 82 additions & 6 deletions

File tree

README.md

Lines changed: 82 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22

33
**Architecture + Python – Perfect for Structured Design**
44

5-
ArchiPy is a Python project designed to provide a robust and structured architecture for building scalable and maintainable applications. It integrates modern Python tools and libraries to streamline development, testing, and deployment.
5+
ArchiPy is a Python project designed to provide a robust and structured architecture for building scalable and
6+
maintainable applications. It integrates modern Python tools and libraries to streamline development, testing, and
7+
deployment.
68

79
---
810

@@ -21,7 +23,8 @@ ArchiPy is a Python project designed to provide a robust and structured architec
2123

2224
## ✨ Features
2325

24-
- **Modern Python Stack**: Built with Python 3.13 and leveraging tools like `pydantic`, `fastapi`, `gRPC` and `sqlalchemy`.
26+
- **Modern Python Stack**: Built with Python 3.13 and leveraging tools like `pydantic`, `fastapi`, `gRPC` and
27+
`sqlalchemy`.
2528
- **Modular Design**: Optional dependencies for Redis, gRPC, PostgreSQL, Prometheus, and more.
2629
- **Type Safety**: Enforced by `mypy` and `pydantic` for robust code.
2730
- **Testing**: Integrated with `pytest` and `behave` for comprehensive testing.
@@ -35,11 +38,20 @@ ArchiPy is a Python project designed to provide a robust and structured architec
3538

3639
Before you begin, ensure you have the following installed:
3740

38-
- **Python 3.13.x**
41+
- **Python 3.13 or higher**
42+
`archipy` is compatible with Python 3.13 and above but does not support Python 4 or higher.
43+
To check your Python version, run:
44+
```bash
45+
python --version
46+
```
47+
If your Python version is lower than 3.13, [download and install the latest version of Python](https://www.python.org/downloads/).
48+
3949
- **Poetry** (for dependency management)
50+
Poetry is required to manage dependencies and install the project. If you don’t have Poetry installed, follow the [official installation guide](https://python-poetry.org/docs/).
4051

4152
---
4253

54+
4355
## 🚀 Installation
4456

4557
1. **Clone the Repository**
@@ -67,14 +79,78 @@ Before you begin, ensure you have the following installed:
6779

6880
## 🎯 Usage
6981

70-
### Running the Project
7182

72-
To run the project locally, use the following command:
83+
### Installing the Project
84+
85+
You can install the project and its dependencies using either `pip` or `poetry`. Below are the instructions for both.
86+
87+
#### Using `pip`
88+
89+
To install the core library:
90+
91+
```bash
92+
pip install archipy
93+
```
94+
95+
To install the library with optional dependencies (e.g., `redis`, `fastapi`, etc.):
96+
97+
```bash
98+
pip install archipy[redis,fastapi]
99+
```
100+
101+
#### Using `poetry`
102+
103+
To add the core library to your project:
104+
105+
```bash
106+
poetry add archipy
107+
```
108+
109+
To add the library with optional dependencies (e.g., `redis`, `fastapi`, etc.):
73110

74111
```bash
75-
poetry run python -m archipy
112+
poetry add archipy[redis,fastapi]
76113
```
77114

115+
---
116+
117+
### Optional Dependencies
118+
119+
The library provides optional dependencies for additional functionality. You can install them as needed:
120+
121+
| Feature | Installation Command |
122+
|----------------------|---------------------------------|
123+
| Redis | `archipy[redis]` |
124+
| Elastic APM | `archipy[elastic-apm]` |
125+
| FastAPI | `archipy[fastapi]` |
126+
| JWT | `archipy[jwt]` |
127+
| Kavenegar | `archipy[kavenegar]` |
128+
| Prometheus | `archipy[prometheus]` |
129+
| Sentry | `archipy[sentry]` |
130+
| Dependency Injection | `archipy[dependency-injection]` |
131+
| Scheduler | `archipy[scheduler]` |
132+
| gRPC | `archipy[grpc]` |
133+
| PostgreSQL | `archipy[postgres]` |
134+
| aiosqlite | `archipy[aiosqlite]` |
135+
136+
---
137+
138+
### Troubleshooting Installation Issues
139+
140+
If you encounter issues during installation, ensure that:
141+
142+
1. Your Python version is **3.13 or higher**.
143+
2. Your package manager (`pip` or `poetry`) is up to date.
144+
3. You have the necessary build tools installed (e.g., `setuptools`, `wheel`).
145+
146+
For example, to upgrade `pip`, run:
147+
148+
```bash
149+
pip install --upgrade pip
150+
```
151+
152+
---
153+
78154
### Available Commands
79155

80156
Run `make help` to see all available commands:

0 commit comments

Comments
 (0)