@@ -11,6 +11,96 @@ This repository houses the code for a Python SDK to interact with [Atlan](https:
11
11
12
12
[ https://developer.atlan.com/getting-started/python-sdk/ ] ( https://developer.atlan.com/getting-started/python-sdk/ )
13
13
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
+
14
104
## Attribution
15
105
16
106
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