chore: initialize and modernize NetLicensing Python client library

Author: r-brown

.github/workflows/netlicensing-publish-pypi.yml

@@ -0,0 +1,31 @@
+# This workflows will upload a Python Package using Twine when a release is created
+# For more information see: https://help.github.com/en/actions/language-and-framework-guides/using-python-with-github-actions#publishing-to-package-registries
+
+name: Python Client - Publish to PyPI
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel twine
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: |
+        python setup.py sdist bdist_wheel
+        twine upload dist/*

.github/workflows/netlicensing-publish-testpypi.yml

@@ -0,0 +1,31 @@
+# This workflows will upload a Python Package using Twine when a release is created
+# For more information see: https://help.github.com/en/actions/language-and-framework-guides/using-python-with-github-actions#publishing-to-package-registries
+
+name: Python Client - Publish to TestPyPI
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  deploy:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel twine
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: ${{ secrets.TESTPYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.TESTPYPI_PASSWORD }}
+      run: |
+        python setup.py sdist bdist_wheel
+        twine upload -r testpypi dist/*

.github/workflows/netlicensing-python-ci.yml

@@ -0,0 +1,42 @@
+# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
+
+name: Python Client - CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [3.6, 3.7, 3.8]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install flake8 pytest
+        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+    - name: Lint with flake8
+      run: |
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - name: Test with pytest
+      run: |
+        pytest
+    - name: Upload Codecov
+      run: |
+        bash <(curl -s https://codecov.io/bash)

.github/workflows/netlicensing-python-dependency.yml

@@ -0,0 +1,23 @@
+name: Python Client - Dependency Test
+
+on:
+  schedule:
+    - cron: '*/59 * * * *'
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [3.6, 3.7, 3.8]
+
+    steps:
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install netlicensing-client

.gitignore

@@ -0,0 +1,39 @@
+# ── Python ────────────────────────────────────────────────────────────────────
+__pycache__/
+*.py[cod]
+*.pyo
+*$py.class
+*.so
+
+# ── Build & packaging ─────────────────────────────────────────────────────────
+build/
+dist/
+*.egg-info/
+*.egg
+
+# ── Virtual environments ──────────────────────────────────────────────────────
+.env
+.venv/
+venv/
+
+# ── Testing & coverage ────────────────────────────────────────────────────────
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+.pytest_cache/
+.tox/
+.nox/
+
+# ── Type checkers ─────────────────────────────────────────────────────────────
+.mypy_cache/
+.dmypy.json
+.pyre/
+
+# ── IDE / editor ──────────────────────────────────────────────────────────────
+.idea/
+.vscode/
+
+# ── OS artefacts ──────────────────────────────────────────────────────────────
+.DS_Store
+Thumbs.db

CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.1.0
+
+- Rebuilt the package around a `src/` layout and `pyproject.toml` packaging.
+- Added `httpx`-based `NetLicensingClient` with API-key and username/password authentication.
+- Added typed Pydantic models for core NetLicensing entities.
+- Added services for products, product modules, licensees, license templates, licenses, tokens, transactions, payment methods, bundles, notifications, utility data, and validation.
+- Added deterministic pytest coverage using `httpx.MockTransport`.
+- Added demo CLI for validation and shop-token flows.

CONTRIBUTING.md

@@ -0,0 +1,66 @@
+# Contributing
+
+## Add features or fix bugs
+
+* Fork the repo
+* Check out a feature or bug branch
+* Add your changes
+* Update README when needed
+* Submit a pull request to upstream repo
+* Add description of your changes
+* Ensure tests are passing
+* Ensure branch is mergeable
+
+## Setup
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Test
+
+Testing is set up using [pytest](http://pytest.org) and coverage is handled with the pytest-cov plugin.
+
+Run your tests with:
+
+```bash
+pytest
+```
+
+Coverage is reported in the terminal after each run.
+To view a detailed HTML report open `htmlcov/index.html` after running the tests.
+
+To run the optional live integration tests against the NetLicensing demo account:
+
+```bash
+NETLICENSING_LIVE_DEMO=1 pytest tests/test_live_demo.py -q
+```
+
+## Type checking
+
+```bash
+mypy src/netlicensing
+```
+
+## Release
+
+Create a source distribution and wheel:
+
+```bash
+python -m build
+```
+
+Verify the distribution before uploading:
+
+```bash
+twine check dist/*
+```
+
+Upload to TestPyPI first, then PyPI:
+
+```bash
+# Test PyPI
+twine upload -r testpypi dist/*
+# PyPI
+twine upload dist/*
+```