ProduceTool

This producetool is used for four items:

1. git extensions
2. produce(work item-->pull request-->review-->checkin)
3. simple web crawler
4. azure analysis
5. baget extensions
6. tool cp

Getting started

1. Click Code-Download ZIP or Open cmd.exe and run commands:

git clone https://github.com/AlbertZhaohongyong/producetool.git

2. Open ProduceTools-Albert.sln by visual studio2019/2022.Rebuild solution(If some nuget is missing, you must restore nuget package).Tools-Nuget Package Manager-Package Manager Console

msbuild -t:restore

3. If you run Albert.sln successfully, you need to enter the bin\Debug\net5.0 folder of the project.Then, you must set the environment variables like this:

environment variables Path E:\Gitee\producetool\ProduceTools\bin\Debug\net5.0

4. Run cmd.exe to perform some supported operations like:

albert help
albert git "submit your comments"
albert crawl
albert produce(Not support currently)
albert azure(Not support currently)
albert baget
albert tool cp -s SourcePath -t DestinationPath
albert tool cptxt
albert tool md

5. Others config:you need to modify bin\Debug\net5.0\Configs\ProduceTool.json
6. Use exceptionless to record logs, you must modify bin\Debug\net5.0\Configs\ProduceTool.json SerilogConfig-Except of your api key.

"SerilogConfig": {
    "ExceptionlessClientDefaultStartUpKey": "YOUR_API_KEY"
  }

Git Extensions

Inputing albert git info is equivalent to execute combined command.

1.cd ..
2.git add .
3.git commit -m info
4.git push

Process

• Get the DLL name from WorkItem
• Use Tool to Analyze the source path of dll.
• Start windows terminal
• cd source path
• cd ..
• dir-->Check if there is a folder with dotNetcore Version
• cd source path(If there is no existence, enter the source code directory)
• produce netcore
• msbuild -t:restore-->NoError-->bcc-->NoError-->update DotNetCoreMigration/DotNetCoreMigrationAlignment.md
• root-->git status-->git add .-->git commit -m "Produce xxx.dll"-->git push
• Go to PR, Create a pull request.
• Wait for review & Focus
• Solve some question and comments
• Update OneNote state
• Update Tool state
• Done

Simple web crawler

Inputing albert -crawl can crawl all information of the website configured by Producetool.json(PersonalCrawlingSite)

Baget Extensions

1. First you need modify ProduceTool.json-BagetRule:NugetWebUrl, the NugetWebUrl is your webservice address. And modify ProduceTool.json-BagetRule:NugetKey in your remote services.
2. Second-Run cmd.exe to perform some supported operations like:

baget list:list all NugetPackage from remote service.
baget del -n PackageName -v PackageVersion:delete the NugetPackage from remote service.
baget push "Your local *.nupkg path":push all NugetPackage in local directory to remote service.

Tool Extensions

albert tool cp -s SourcePath -t DestinationPath :Copy SourceDir to DestinationDir
albert tool cptxt :Copy SourceDir to DestinationDir from Configs/ListCopyPath
albert tool md :Automatically generates a markdown file to record the packages used by the project (config file:Configs/ProjectDir)  

PackageReference

https://github.com/AlbertZhaoz/producetool/blob/master/ProduceTools/Configs/NugetPackageDescription.md

Other Instructions

    Exceptionless Readme

Exceptionless provides real-time error reporting for your apps. It organizes the gathered information into simple actionable data that will help your app become exceptionless!

Learn more at http://exceptionless.io.

    How to get an api key

The Exceptionless client requires an api key to use the Exceptionless service. You can get your Exceptionless api key by logging into http://exceptionless.io and viewing your project configuration page.

General Data Protection Regulation

By default the Exceptionless Client will report all available metadata including potential PII data. You can fine tune the collection of information via Data Exclusions or turning off collection completely.

Please visit the documentation https://exceptionless.com/docs/clients/dotnet/private-information/ for detailed information on how to configure the client to meet your requirements.

  ASP.NET Core Integration

You must import the "Exceptionless" namespace and add the following code to register and configure the ExceptionlessClient inside of the ConfigureServices method:

services.AddExceptionless("API_KEY_HERE");

In order to start gathering unhandled exceptions, you will need to register the Exceptionless middleware in the Configure method like this:

app.UseExceptionless();

Alternatively, you can also use the different overloads of the AddExceptionless method for different configuration options.

Please visit the documentation https://exceptionless.com/docs/clients/dotnet/sending-events/ for examples on sending events to Exceptionless.

Manually reporting an exception

By default the Exceptionless Client will report all unhandled exceptions. You can also manually send an exception by importing the Exceptionless namespace and calling the following method.

exception.ToExceptionless().Submit()

Please note that ASP.NET Core doesn't have a static http context. We recommend registering the http context accessor. Doing so will allow the request and user information to be populated. You can do this by calling the AddHttpContextAccessor while configure services.

services.AddHttpContextAccessor()

  Documentation and Support

Please visit http://exceptionless.io for documentation and support.