Metadata-Version: 2.1
Name: ambient-package-update
Version: 23.5.4
Summary: Ambient package update tool for clean and swift maintenance
Author-email: Ambient Digital <hello@ambient.digital>
Description-Content-Type: text/markdown
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Utilities
Requires-Dist: typer~=0.7
Requires-Dist: Jinja2~=3.1
Requires-Dist: flit~=3.8
Requires-Dist: keyring~=23.13
Requires-Dist: pre-commit~=3.2
Requires-Dist: black~=23.3
Project-URL: Bugtracker, https://github.com/ambient-innovation/ambient-package-update/issues
Project-URL: Changelog, https://github.com/ambient-innovation/ambient-package-update/blob/master/CHANGES.md
Project-URL: Documentation, https://github.com/ambient-innovation/ambient-package-update/blob/master/README.md
Project-URL: Maintained by, https://ambient.digital/

[![pypi](https://img.shields.io/pypi/v/ambient-package-update.svg)](https://pypi.python.org/pypi/ambient-package-update/)
[![Downloads](https://pepy.tech/badge/ambient-package-update)](https://pepy.tech/project/ambient-package-update)

# Ambient Package Update

This repository will help keep all Python packages maintained by 
[Ambient Digital](https://ambient.digital) tidy and up-to-date.

## Installation

1. Ensure you have installed Python >=3.10 and the binary is in your system path
2. Navigate into the project directory
3. Execute scripts/setup_venv.ps1 (on Windows) or rename the file to "setup_venv.sh" and execute it for macOS and UNIX

## Versioning

This project follows the CalVer versioning pattern: `YY.MM.[RELEASE]`

## Usage

* python .\main.py render-templates [PACKAGE_NAME]

todo:
- write usage paragraph
- create template dirs if not existing (without .github/workflows it's failing)
- package-readme hat dopplungen zu docs und enthält zeug, das nicht da drinstehen muss
- ambient-toolbox branch löschen und nur rest von core da ablegen

## Contribution

### Publish to PyPi

- Update documentation about new/changed functionality

- Update the `Changelog`

- Increment version in main `__init__.py`

- Create pull request / merge to master

- This project uses the flit package to publish to PyPI. Thus publishing should be as easy as running:
  ```
  flit publish
  ```

  To publish to TestPyPI use the following ensure that you have set up your .pypirc as
  shown [here](https://flit.readthedocs.io/en/latest/upload.html#using-pypirc) and use the following command:

  ```
  flit publish --repository testpypi
  ```

## Changelog

Can be found at [GitHub](https://github.com/ambient-innovation/ambient-package-update/blob/master/CHANGES.md).
