|
6 | 6 | [](https://opensource.org/licenses/Apache-2.0) |
7 | 7 | [](https://github.com/psf/black) |
8 | 8 | [](https://pycqa.github.io/isort/) |
| 9 | +[](https://github.com/dialogchain/python/actions/workflows/tests.yml) |
| 10 | +[](https://codecov.io/gh/dialogchain/python) |
9 | 11 |
|
10 | 12 | ## 📦 Installation |
11 | 13 |
|
|
17 | 19 |
|
18 | 20 | 1. Clone the repository: |
19 | 21 | ```bash |
20 | | - git clone https://github.com/taskinity/dialogchain.git |
21 | | - cd dialogchain |
| 22 | + git clone https://github.com/dialogchain/python.git |
| 23 | + cd python |
22 | 24 | ``` |
23 | 25 |
|
24 | 26 | 2. Install dependencies: |
|
33 | 35 |
|
34 | 36 | ### Development Setup |
35 | 37 |
|
36 | | -1. Install development dependencies: |
| 38 | +1. Install development and test dependencies: |
37 | 39 | ```bash |
38 | | - poetry install --with dev |
| 40 | + poetry install --with dev,test |
39 | 41 | ``` |
40 | 42 |
|
41 | 43 | 2. Set up pre-commit hooks: |
|
45 | 47 |
|
46 | 48 | 3. Run tests: |
47 | 49 | ```bash |
48 | | - poetry run pytest |
| 50 | + make test |
49 | 51 | ``` |
| 52 | + |
| 53 | + Or with coverage report: |
| 54 | + ```bash |
| 55 | + make coverage |
| 56 | + ``` |
| 57 | + |
| 58 | +## 🏗️ Project Structure |
| 59 | + |
| 60 | +``` |
| 61 | +dialogchain/ |
| 62 | +├── src/ |
| 63 | +│ └── dialogchain/ # Main package |
| 64 | +│ ├── __init__.py |
| 65 | +│ ├── cli.py # Command-line interface |
| 66 | +│ ├── config.py # Configuration handling |
| 67 | +│ ├── connectors/ # Connector implementations |
| 68 | +│ ├── engine.py # Core engine |
| 69 | +│ ├── exceptions.py # Custom exceptions |
| 70 | +│ ├── processors/ # Processor implementations |
| 71 | +│ └── utils.py # Utility functions |
| 72 | +├── tests/ # Test files |
| 73 | +│ ├── unit/ # Unit tests |
| 74 | +│ │ ├── core/ # Core functionality tests |
| 75 | +│ │ ├── connectors/ # Connector tests |
| 76 | +│ │ └── ... |
| 77 | +│ └── integration/ # Integration tests |
| 78 | +├── .github/ # GitHub workflows |
| 79 | +├── docs/ # Documentation |
| 80 | +├── .gitignore |
| 81 | +├── .pre-commit-config.yaml |
| 82 | +├── Makefile # Common development commands |
| 83 | +├── pyproject.toml # Project metadata and dependencies |
| 84 | +└── README.md |
| 85 | +``` |
| 86 | + |
| 87 | +## 🧪 Testing |
| 88 | + |
| 89 | +Run the full test suite: |
| 90 | +```bash |
| 91 | +make test |
| 92 | +``` |
| 93 | + |
| 94 | +Run specific test categories: |
| 95 | +```bash |
| 96 | +# Unit tests |
| 97 | +make test-unit |
| 98 | + |
| 99 | +# Integration tests |
| 100 | +make test-integration |
| 101 | + |
| 102 | +# With coverage report |
| 103 | +make coverage |
| 104 | +``` |
| 105 | + |
| 106 | +## 🧹 Code Quality |
| 107 | + |
| 108 | +Format and check code style: |
| 109 | +```bash |
| 110 | +make format # Auto-format code |
| 111 | +make lint # Run linters |
| 112 | +make typecheck # Run type checking |
| 113 | +make check-all # Run all checks |
| 114 | +``` |
50 | 115 |
|
51 | 116 | ## 🚀 Quick Start |
52 | 117 |
|
|
0 commit comments