@@ -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\S cripts\a ctivate     #  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
16106Portions 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