Metadata-Version: 2.4
Name: treqsext-gitlab
Version: 0.1.0
Summary: GitLab issue resolver extension for TReqs
Home-page: https://gitlab.com/treqs-on-git/treqs-ng
Author: Abdullatif AlShriaf
Author-email: latiif@mail.com
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# TReqs GitLab Extension

Resolves external elements from public GitLab issues.

## Installation

Included with treqs-ng:

```bash
pip install treqs-ng
```

## Usage

Reference GitLab issues in treqs links:

```xml
<treqs-element id="my-requirement" type="requirement">
My requirement text

<treqs-link type="relatesTo" target="gl:mygroup/myproject#96"/>
</treqs-element>
```

**Format**: `gl:project#IID` or `gl:#IID`

Examples:

- `gl:treqs-on-git/treqs-ng#96` - Issue #96 in specific project
- `gl:#96` - Issue #96 in default project (requires `GITLAB_PROJECT` env var)

## Configuration

```bash
# GitLab instance URL (default: https://gitlab.com)
export GITLAB_URL="https://gitlab.example.com"

# Default project for short references like gl:#96
export GITLAB_PROJECT="mygroup/myproject"
```

## Limitations

- Only works with public projects (no authentication support)
- GitLab API rate limit: 10 requests/minute for unauthenticated requests

## License

MIT
