Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update changelog with latest changes #241

Merged
merged 1 commit into from
Apr 13, 2023
Merged

update changelog with latest changes #241

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
282 changes: 275 additions & 7 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,282 @@
# Changelog

All notable changes to this project will be documented in this file.
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

This project follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format for changes and adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

<a name="v1.0.1"></a>
## [v1.0.1] - 2023-04-06
## Pull Requests

## [Unreleased]
* Merge pull request [#232](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/232) from amirkaws/amirkaws-release-v1.0.1
* Merge pull request [#227](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/227) from hjgraca/chore_fix_changelog_build
* Merge pull request [#225](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/225) from srcsakthivel/develop
* Merge pull request [#223](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/223) from hjgraca/fix_tracing_on_exception_thrown
* Merge pull request [#218](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/218) from amirkaws/amirkaws-update-examples-nuget-references-release

## [1.0.0] - 2023-02-24
## [0.0.2-preview] - 2023-01-18
## [0.0.1-preview.1] - 2022-08-01
### Added
- Public preview release

<a name="v1.0.0"></a>
## [v1.0.0] - 2023-02-24
## Bug Fixes

* removing manual trigger on docs wf

## Documentation

* **home:** update powertools definition

## Maintenance

* **ci:** api docs build update ([#188](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/188))
* **ci:** changing trigger to run manually
* **ci:** updated api docs implementation
* **ci:** updated bug report template
* **deps:** updates sample deps
* **docs:** incorrect crefs

## Pull Requests

* Merge pull request [#215](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/215) from amirkaws/amirkaws-release-v1.0.0
* Merge pull request [#208](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/208) from amirkaws/amirkaws-cold-start-capture-warning-bug-fix
* Merge pull request [#210](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/210) from awslabs/powertools-definition-update
* Merge pull request [#209](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/209) from amirkaws/amirkaws-metrics-timestamp-fix
* Merge pull request [#199](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/199) from awslabs/sliedig-ci-reviewers
* Merge pull request [#193](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/193) from hjgraca/maintenance-new-issue-template
* Merge pull request [#202](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/202) from hjgraca/fix-test-json-escaping
* Merge pull request [#195](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/195) from hjgraca/update-dotnet-sdk-6.0.405
* Merge pull request [#194](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/194) from hjgraca/patch-1
* Merge pull request [#192](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/192) from hjgraca/fix-incorrect-crefs
* Merge pull request [#189](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/189) from sliedig/develop
* Merge pull request [#185](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/185) from amirkaws/amirkaws-update-examples-nuget-references
* Merge pull request [#183](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/183) from awslabs/develop
* Merge pull request [#150](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/150) from awslabs/develop
* Merge pull request [#140](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/140) from awslabs/develop


<a name="v0.0.2-preview"></a>
## [v0.0.2-preview] - 2023-01-18
## Bug Fixes

* removed duplicate template issue
* updated logger casing env vars in samples

## Documentation

* typo in metrics README

## Features

* **ci:** codeql static code analysis ([#148](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/148))

## Maintenance

* updated setup-dotnet[@v1](https://github.com/v1) to [@v3](https://github.com/v3)
* updated packages ([#172](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/172))
* **ci:** bumped version
* **ci:** minor updates, licensing
* **deps:** bump gitpython from 3.1.29 to 3.1.30
* **docs:** updated documentation ([#175](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/175))
* **docs:** add discord invitation link

## Pull Requests

* Merge pull request [#182](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/182) from sliedig/develop
* Merge pull request [#181](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/181) from awslabs/dependabot/pip/gitpython-3.1.30
* Merge pull request [#179](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/179) from sliedig/sliedig-ci
* Merge pull request [#174](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/174) from sliedig/sliedig-ci
* Merge pull request [#173](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/173) from sliedig/sliedig-samples
* Merge pull request [#157](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/157) from kenfdev/fix-readme-title-typo
* Merge pull request [#170](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/170) from nCubed/develop
* Merge pull request [#152](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/152) from amirkaws/amirkaws-custom-exception-json-converter
* Merge pull request [#155](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/155) from sthuber90/add-discord-link-154
* Merge pull request [#147](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/147) from amirkaws/amirkaws-fix-doc-links


<a name="v0.0.1-preview.1"></a>
## v0.0.1-preview.1 - 2022-08-01
## Bug Fixes

* force directy rename
* making test function compile.
* updating issue templates with correct extention
* updated auto assign
* skip duplicate nuget packages publish
* added missing runtimes
* updated Logging template description
* updated documentation and doc generation ([#96](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/96))
* removed optional doc file paths
* explicitly adding doc files for build configurations
* resolving dependecy alert CVE-2020-8116
* added missing codecov packages for test projects
* fixed build
* forcing rename
* fixed powertolls spelling in docs
* replaced PackageIconUrl which is being depreciated with PackageIcon
* added missing include to pack README files
* fixing node vulnerabilites for docs
* resolving merge conflict
* update packages to resolve vulnerabilities. Switched to yarn package manager
* intermin fix to resolve vulnerability issues.
* proj references
* fixed spelling in libraries folder name
* **ci:** lockdown gh-pages workflow to sha

## Documentation

* fixed nav for roadmap
* updated link to feature request; added roadmap
* library readme updates and minor updates ([#117](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/117))
* spell check with US-English dictionary ([#115](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/115))
* docs review ([#112](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/112))
* Reviewing documentation ([#68](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/68))
* adding auto-generated API Reference to docs ([#87](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/87))
* alternative brew installation ([#86](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/86))
* homebrew installation ([#85](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/85))
* merging api generation tasks ([#84](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/84))
* fixing docfx path ([#83](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/83))
* fix docfx path ([#82](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/82))
* fix api docs generator installation ([#81](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/81))
* update github actions to publish api docs ([#80](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/80))
* API docs generation ([#79](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/79))

## Features

* added security.md
* updated record_pr action
* PR Labeler GitHub actions ([#119](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/119))
* Logger output case attributes docs and unit testing ([#100](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/100))
* add extra fields to the logger methods ([#98](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/98))
* updated examples to include managed runtime configuration as well as docker. Made updates to Tracing implementation
* added Tracing example
* added init Metrics sample
* added Logging example
* added serialisation options to force dictionary keys to camel case
* added build tools to generate nuget packages
* updated project packaging properties
* added package README files for core utilities
* update make and doc dep to build docs
* added docs template

## Maintenance

* set global .net version
* temporarily removing docs while content is being developed
* added example project
* refctored PowerTools to Powertools
* added github files and templates
* initial folder structure
* interim resolution of docs package vulnerabilities
* migrated AWS.Lambda.PowerTools to AWS.Lambda.PowerTools.Common namespace. fix: resolved incorrect namespace for Tracing fix: resolved dependencies in example project
* refactored to new namespace
* updated readme
* updated github templates
* added customer 404 page
* removing unecessary buildtools
* update pr template
* updating type documentation and file headers ([#56](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/56))
* moved solution file into libraries. Need a separate solution for examples
* added docs
* added gitignore and updated licence
* updating doc build workflow
* updated issue templates
* updated Label PR based on title action
* deleted unnecessay publishing action
* updated stale action
* removed unnecessary pr labeling
* updated PR labeling path
* updated list of assignees
* updated docker builds to use Amazon.Lambda.Tools ([#118](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/118))
* bumped .net version in global to 6.0.301 ([#120](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/120))
* bumped .net version in global to 6.0.301
* adding missed copyright info
* added copyright to examples
* removed SimpleLambda from examples
* cleaned up logging and metrics functions
* **ci:** add on_merge_pr workflow to notify releases
* **ci:** lockdown untrusted workflows to sha
* **ci:** add missing scripts
* **ci:** updated bug report template ([#144](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/144))
* **ci:** add workflow to detect missing related issue
* **ci:** enable concurrency group for docs workflow
* **ci:** upudated wording in PR template checklist
* **ci:** added codeowners
* **ci:** added Maintainers doc
* **ci:** updated PR workflows and scripts
* **ci:** upgrade setup-python to v4
* **ci:** upgrade checkout action to v3
* **ci:** use untrusted workflows with sha
* **ci:** add reusable export pr workflow dependency
* **deps:** bump hosted-git-info from 2.8.8 to 2.8.9 in /docs
* **deps:** bump object-path from 0.11.4 to 0.11.5 in /docs
* **deps:** bump ssri from 6.0.1 to 6.0.2 in /docs
* **deps:** bump elliptic from 6.5.3 to 6.5.4 in /docs
* **deps:** bump socket.io from 2.3.0 to 2.4.1 in /docs
* **deps:** bump ini from 1.3.5 to 1.3.8 in /docs
* **deps:** bump ua-parser-js from 0.7.23 to 0.7.28 in /docs
* **deps:** bump underscore from 1.12.0 to 1.13.1 in /docs
* **deps:** bump url-parse from 1.4.7 to 1.5.1 in /docs
* **deps:** bump prismjs from 1.20.0 to 1.21.0 in /docs
* **deps:** updates sample deps ([#142](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/142))
* **deps:** bump mkdocs from 1.2.2 to 1.2.3 ([#29](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/29))
* **governance:** render debug logs with csharp syntax
* **governance:** typo in pending release label name

## Pull Requests

* Merge pull request [#139](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/139) from awslabs/amirkaws-resolve-conflicts-2
* Merge pull request [#135](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/135) from awslabs/amirkaws-update-versions
* Merge pull request [#134](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/134) from heitorlessa/chore/lockdown-gh-pages-workflow
* Merge pull request [#132](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/132) from heitorlessa/chore/github-concurrency-docs
* Merge pull request [#130](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/130) from heitorlessa/chore/enforce-github-actions-sha
* Merge pull request [#128](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/128) from sliedig/sliedig-ci
* Merge pull request [#127](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/127) from sliedig/sliedig-ci
* Merge pull request [#126](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/126) from sliedig/develop
* Merge pull request [#123](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/123) from sliedig/develop
* Merge pull request [#1](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/1) from sliedig/sliedig/develop
* Merge pull request [#121](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/121) from awslabs/amirkaws-update-versions
* Merge pull request [#116](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/116) from awslabs/amirkaws/add-di-support-for-logging
* Merge pull request [#113](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/113) from awslabs/amirkaws/update-doc-1
* Merge pull request [#111](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/111) from awslabs/amirkaws/add-env-vars-docs
* Merge pull request [#102](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/102) from sliedig/sliedig/examples
* Merge pull request [#103](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/103) from awslabs/amirkaws/fix-example-issues
* Merge pull request [#97](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/97) from sliedig/sliedig/examples
* Merge pull request [#95](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/95) from awslabs/pr/91
* Merge pull request [#90](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/90) from sliedig/develop
* Merge pull request [#89](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/89) from awslabs/api-docs-template
* Merge pull request [#74](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/74) from awslabs/amirkaws/disable-tracing-outside-lambda-env
* Merge pull request [#66](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/66) from sliedig/develop
* Merge pull request [#59](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/59) from sliedig/develop
* Merge pull request [#58](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/58) from sliedig/sliedig/nuget
* Merge pull request [#32](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/32) from awslabs/amirkaws/metrics-1
* Merge pull request [#31](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/31) from t1agob/develop
* Merge pull request [#2](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/2) from awslabs/develop
* Merge pull request [#25](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/25) from t1agob/develop
* Merge pull request [#1](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/1) from t1agob/sourcegenerators
* Merge pull request [#24](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/24) from sliedig/develop
* Merge pull request [#23](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/23) from sliedig/develop
* Merge pull request [#22](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/22) from sliedig/develop
* Merge pull request [#21](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/21) from t1agob/develop
* Merge pull request [#19](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/19) from awslabs/dependabot/npm_and_yarn/docs/url-parse-1.5.1
* Merge pull request [#18](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/18) from awslabs/dependabot/npm_and_yarn/docs/hosted-git-info-2.8.9
* Merge pull request [#17](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/17) from awslabs/dependabot/npm_and_yarn/docs/ua-parser-js-0.7.28
* Merge pull request [#16](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/16) from awslabs/dependabot/npm_and_yarn/docs/underscore-1.13.1
* Merge pull request [#15](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/15) from awslabs/dependabot/npm_and_yarn/docs/ssri-6.0.2
* Merge pull request [#14](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/14) from awslabs/dependabot/npm_and_yarn/docs/elliptic-6.5.4
* Merge pull request [#13](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/13) from sliedig/develop
* Merge pull request [#12](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/12) from sliedig/develop
* Merge pull request [#11](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/11) from awslabs/dependabot/npm_and_yarn/docs/socket.io-2.4.1
* Merge pull request [#10](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/10) from awslabs/dependabot/npm_and_yarn/docs/ini-1.3.8
* Merge pull request [#9](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/9) from awslabs/dependabot/npm_and_yarn/docs/object-path-0.11.5
* Merge pull request [#7](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/7) from t1agob/develop
* Merge pull request [#8](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/8) from sliedig/develop
* Merge pull request [#5](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/5) from sliedig/develop
* Merge pull request [#4](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/4) from sliedig/develop
* Merge pull request [#3](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/3) from sliedig/develop
* Merge pull request [#2](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/2) from awslabs/dependabot/npm_and_yarn/docs/prismjs-1.21.0
* Merge pull request [#1](https://github.com/awslabs/aws-lambda-powertools-dotnet/issues/1) from sliedig/develop


[Unreleased]: https://github.com/awslabs/aws-lambda-powertools-dotnet/compare/v1.0.1...HEAD
[v1.0.1]: https://github.com/awslabs/aws-lambda-powertools-dotnet/compare/v1.0.0...v1.0.1
[v1.0.0]: https://github.com/awslabs/aws-lambda-powertools-dotnet/compare/v0.0.2-preview...v1.0.0
[v0.0.2-preview]: https://github.com/awslabs/aws-lambda-powertools-dotnet/compare/v0.0.1-preview.1...v0.0.2-preview