Metadata-Version: 2.1
Name: dt-extensions-sdk
Version: 1.1.18
Project-URL: Documentation, https://github.com/dynatrace-extensions/dt-extensions-python-sdk#readme
Project-URL: Issues, https://github.com/dynatrace-extensions/dt-extensions-python-sdk/issues
Project-URL: Source, https://github.com/dynatrace-extensions/dt-extensions-python-sdk
Author-email: dlopes7 <davidribeirolopes@gmail.com>
License-Expression: MIT
License-File: LICENSE.txt
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.10
Provides-Extra: cli
Requires-Dist: dt-cli>=1.6.13; extra == 'cli'
Requires-Dist: pyyaml; extra == 'cli'
Requires-Dist: typer[all]; extra == 'cli'
Description-Content-Type: text/markdown

# Dynatrace Extensions Python SDK

[![PyPI - Version](https://img.shields.io/pypi/v/dt-extensions-sdk.svg)](https://pypi.org/project/dt-extensions-sdk)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/dt-extensions-sdk.svg)](https://pypi.org/project/dt-extensions-sdk)

-----

**Table of Contents**

- [Quick Start](#quick-start)
- [License](#license)
- [Developing](#developing)

## Documentation

The documentation can be found on [github pages](https://dynatrace-extensions.github.io/dt-extensions-python-sdk/) 

## Quick Start

### Requirements:

* Python 3.10+

### Install the SDK

```bash
pip install dt-extensions-sdk[cli]
# Note, on some shells like zsh you may need to escape the brackets - pip install dt-extensions-sdk\[cli\]
```

### Create signing certificates

```bash
dt-sdk gencerts
```

### Create a new extension

```bash
dt-sdk create my_first_extension
```

### Simulate

```bash
cd my_first_extension
dt-sdk run
```

### Build
    
```bash
dt-sdk build
```


### Upload
    
```bash
# Note, you need to either set environment variables DT_API_URL and DT_API_TOKEN or pass them as arguments
dt-sdk upload
```

## Developing

### Testing

```console
hatch run test
```

### Linting

```console
hatch run lint:all
```

### Building

```console
hatch build
```

### Building docs

```console
hatch run docs:build
```

## License

`dt-extensions-sdk` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.


## Publishing to PyPI

It's automatically published to PyPi on each pushed tag, and uses [gh-action-pypi-publish](https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/)
Version will be determined using __about__.py