Skip to content

Commit 4fa64fb

Browse files
authored
Merge pull request #480 from atlanhq/FT-585
FT-585: Added "Installation for development" section to README.md
2 parents 2219cf4 + 885649c commit 4fa64fb

File tree

2 files changed

+92
-0
lines changed

2 files changed

+92
-0
lines changed

.env.example

+2
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
ATLAN_BASE_URL=your_tenant_base_url
2+
ATLAN_API_KEY=your_api_key

README.md

+90
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,96 @@ This repository houses the code for a Python SDK to interact with [Atlan](https:
1111

1212
[https://developer.atlan.com/getting-started/python-sdk/](https://developer.atlan.com/getting-started/python-sdk/)
1313

14+
15+
16+
## Installing for Development
17+
18+
### Initial Setup
19+
To get started developing the SDK:
20+
21+
1. Clone the repository:
22+
```bash
23+
git clone <repository-url>
24+
```
25+
26+
2. Ensure you have Python 3.8 or later installed. You can verify your Python version with:
27+
```bash
28+
python --version
29+
```
30+
or
31+
```bash
32+
python3 --version
33+
```
34+
35+
3. Set up a virtual environment for development:
36+
```bash
37+
python -m venv venv
38+
source venv/bin/activate # On macOS/Linux
39+
venv\Scripts\activate # On Windows
40+
```
41+
42+
4. Install the required dependencies:
43+
```bash
44+
pip install -r requirements.txt
45+
```
46+
47+
### Code Formatting
48+
Before committing code, ensure it adheres to the repository's formatting guidelines. You can apply the required formatting using the below command:
49+
50+
```bash
51+
./pyatlan-formatter
52+
```
53+
54+
### Environment Setup
55+
For running integration tests, you'll need to configure your environment:
56+
57+
1. Copy the example environment file:
58+
```bash
59+
cp .env.example .env
60+
```
61+
2. Update the `.env` file with your Atlan API key and base URL.
62+
3. Load the environment variables:
63+
- For macOS/Linux:
64+
```bash
65+
export $(cat .env | xargs)
66+
```
67+
- For Windows (PowerShell):
68+
```powershell
69+
Get-Content .env | ForEach-Object {
70+
if ($_ -match '^(.*?)=(.*)$') {
71+
$env:($matches[1]) = $matches[2]
72+
}
73+
}
74+
```
75+
76+
## Testing the SDK
77+
78+
### Run all the QA checks
79+
You can run all the QA checks using the following command:
80+
81+
```bash
82+
./qa-checks
83+
```
84+
85+
### Running Unit Tests
86+
You can run the SDK's unit tests **without needing access to an Atlan environment**:
87+
88+
```bash
89+
pytest tests/unit
90+
```
91+
92+
### Running Integration Tests
93+
Once the environment is set up, you can run integration tests:
94+
95+
- All integration tests:
96+
```bash
97+
pytest tests/integration
98+
```
99+
- Specific integration tests:
100+
```bash
101+
pytest tests/integration/<test_specific_feature>.py
102+
```
103+
14104
## Attribution
15105
16106
Portions of the SDK are based on original work from https://github.com/apache/atlas. Those classes that derive from this original work have an extra heading comment as follows:

0 commit comments

Comments
 (0)