Skip to content

Commit

Permalink
Merge pull request #3 from ClydeDz/dev/0.2.0
Browse files Browse the repository at this point in the history
Update readme with badges, branding and usage information. Generate documentation files.
  • Loading branch information
ClydeDz committed Dec 22, 2020
2 parents 94773e7 + 4c8c1db commit 6b3d36c
Show file tree
Hide file tree
Showing 5 changed files with 20 additions and 16 deletions.
1 change: 1 addition & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@
- [ ] My change requires a change to the documentation in the `README` file.
- [ ] I have updated the documentation in the `README` file accordingly.
- [ ] I have updated the version number in the [`GiveMeAnAvatar.csproj`](https://github.com/ClydeDz/give-me-an-avatar-nuget/blob/main/src/GiveMeAnAvatar/GiveMeAnAvatar.csproj) file using the [SemVer](https://semver.org/) format.
- [ ] If I've added a class/method/any other object for public consumption, it is in the GiveMeAnAvatar namespace , i.e. `namespace GiveMeAnAvatar`.
- [ ] I have added tests to cover my changes.
- [ ] All new and existing tests passed.

2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -348,3 +348,5 @@ MigrationBackup/

# Ionide (cross platform F# VS Code tools) working folder
.ionide/

ignore/
24 changes: 12 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,27 @@
<div align="center">
<br>
<img width="172" src="https://raw.githubusercontent.com/ClydeDz/give-me-an-avatar-npm/main/icon.jpg" alt="Give me an avatar npm package icon">
<img width="172" src="https://raw.githubusercontent.com/ClydeDz/give-me-an-avatar-nuget/main/Icon.jpg" alt="Give me an avatar NuGet package icon">
<br>
<br>
</div>

# Give Me an Avatar
Gets a random avatar URL from a collection of different avatar generation services.

[![Azure DevOps builds](https://img.shields.io/azure-devops/build/clydedsouza-nuget/03b052e2-ef54-44b2-82b3-3c3a1e09d864/10?logo=Azure%20DevOps)](https://dev.azure.com/clydedsouza-nuget/Give%20Me%20an%20Avatar%20NuGet/_build)
[![Azure DevOps tests](https://img.shields.io/azure-devops/tests/clydedsouza-nuget/Give%2520Me%2520an%2520Avatar%2520NuGet/10?logo=Azure%20DevOps)](https://dev.azure.com/clydedsouza-nuget/Give%20Me%20an%20Avatar%20NuGet/_build)
[![Nuget](https://img.shields.io/nuget/v/GiveMeAnAvatar?color=brightgreen&logo=NuGet)](https://www.nuget.org/packages/GiveMeAnAvatar)
[![Nuget](https://img.shields.io/nuget/dt/GiveMeAnAvatar?color=brightgreen&logo=NuGet)](https://www.nuget.org/packages/GiveMeAnAvatar)

## Installation and usage
Library can either be directly downloaded from [Nuget.org](https://www.nuget.org/packages/give-me-an-avatar/), OR installed via the [NuGet Package Manager UI](https://docs.microsoft.com/en-us/nuget/tools/package-manager-ui#finding-and-installing-a-package) or via the [Package Manager Console](https://docs.microsoft.com/en-us/nuget/tools/package-manager-console) if you're using Visual Studio.
Library can either be directly downloaded from [Nuget.org](https://www.nuget.org/packages/GiveMeAnAvatar), OR installed via the [NuGet Package Manager UI](https://docs.microsoft.com/en-us/nuget/tools/package-manager-ui#finding-and-installing-a-package) or via the [Package Manager Console](https://docs.microsoft.com/en-us/nuget/tools/package-manager-console) if you're using Visual Studio.

Command to install Give Me an Avatar NuGet via the Package Manager Console UI in Visual Studio shown below.
```PowerShell
PM> Install-Package give-me-an-avatar
```

Include the namespace in your program.
```C#
using GiveMeAnAvatar;
PM> Install-Package GiveMeAnAvatar
```

Then go ahead and consume it.
Go ahead and consume it directly.
```C#
var avatarURL= GiveMeAnAvatar.GetAvatarURL();
```
Expand All @@ -40,7 +40,7 @@ var avatarURL= GiveMeAnAvatar.GetAvatarURL(settings);
|--------------------------------------------|------------------------------------------------------|
| [placeholder.com](https://placeholder.com) | ![image](https://via.placeholder.com/128?Text=J%20S) |
| [placeimg.com](https://placeimg.com) | ![image](https://placeimg.com/128/128/people) |
| [placekitten.com](https://placekitten.com) | ![image](https://placekitten.com/g/128/128?cache=invalidate) |
| [placekitten.com](https://placekitten.com) | ![image](https://placekitten.com/g/128/128?cache=nuget) |
| [dummyimage.com](https://dummyimage.com/) | ![image](https://dummyimage.com/128x128&text=J%20S) |
| [loremflickr.com](https://loremflickr.com) | ![image](https://loremflickr.com/128/128/human) |
| [baconmockup.com](https://baconmockup.com) | ![image](https://baconmockup.com/128/128/) |
Expand All @@ -63,6 +63,6 @@ var avatarURL= GiveMeAnAvatar.GetAvatarURL(settings);
* Placekitten image might appear broken at times in the table above, however, the image service itself runs fine.

## Credits
- All the avatar services used in this npm package are outlined in the table above.
- All the avatar services used in this NuGet package are outlined in the table above.
- Package logo created using [AutoDraw](https://www.autodraw.com/).
- This NPM package is developed by [Clyde D'Souza](https://twitter.com/clydedz).
- This NuGet package is developed by [Clyde D'Souza](https://twitter.com/clydedz).
2 changes: 1 addition & 1 deletion src/GiveMeAnAvatar/GiveMeAnAvatar.cs
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ namespace GiveMeAnAvatar
/// <summary>
/// Service to return a random avatar URL from a collection of different avatar generation services.
/// </summary>
public class GiveMeAnAvatar
public static class GiveMeAnAvatar
{
/// <summary>
/// Returns the URL of an avatar that is picked at random.
Expand Down
7 changes: 4 additions & 3 deletions src/GiveMeAnAvatar/GiveMeAnAvatar.csproj
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
<PropertyGroup>
<TargetFrameworks>netstandard2.0;net5.0</TargetFrameworks>
<GeneratePackageOnBuild>true</GeneratePackageOnBuild>
<Version>0.1.0</Version>
<Version>0.2.0</Version>
<Description>Gets a random avatar URL from a collection of different avatar generation services.</Description>
<Authors>Clyde D'Souza</Authors>
<Product>Give Me an Avatar</Product>
Expand All @@ -12,8 +12,9 @@
<PackageProjectUrl>https://github.com/ClydeDz/give-me-an-avatar-nuget</PackageProjectUrl>
<RepositoryUrl>https://github.com/ClydeDz/give-me-an-avatar-nuget</RepositoryUrl>
<PackageIcon>Icon.jpg</PackageIcon>
<PackageReleaseNotes>Development release</PackageReleaseNotes>
<PackageTags>avatar avatar-generator avatar-library random-avatar</PackageTags>
<PackageReleaseNotes>Development release.</PackageReleaseNotes>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
<PackageTags>avatar avatar-generator avatar-library random-avatar mock-avatars gravatar placeholder-image identicon robohash thispersondoesnotexist human-avatars pixel-art-avatar ui-avatar picsum dummyimage avataaar uimaterial-avatars jdenticon</PackageTags>
</PropertyGroup>

<ItemGroup>
Expand Down

0 comments on commit 6b3d36c

Please sign in to comment.