Skip to content

atlanhq/atlan-go

Repository files navigation

Atlan Go SDK Logo

Atlan Go SDK

This repository houses the code for a Go SDK to interact with Atlan.

Installing for Development

Initial Setup

To get started developing or using the SDK, follow the steps below. For a more detailed overview, check out our Getting Started Guide:

  1. Clone the repository:

    git clone https://github.com/atlanhq/atlan-go.git
  2. Ensure you have Go 1.19 or later installed. You can verify your Go version with:

    go version
  3. Install dependencies:

    go mod tidy

Code Formatting

Ensure your code adheres to the repository's formatting guidelines before committing. You can use the following command to format the code:

go fmt ./...

Environment Setup

To run integration tests or interact with the Atlan API, you'll need to configure your environment:

  1. Copy the example environment file:

    cp .env.example .env
  2. Update the .env file with your Atlan API key and base URL.

  3. Load the environment variables:

    • For macOS/Linux:
      export $(cat .env | xargs)
    • For Windows (PowerShell):
      Get-Content .env | ForEach-Object {
          if ($_ -match '^(.*?)=(.*)$') {
              $env:($matches[1]) = $matches[2]
          }
      }

Testing the SDK

You can run all tests in local development with the following command:

go test -v ./...

License: CC BY 4.0, Copyright 2022 Atlan Pte. Ltd.