@@ -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