Sharpenis a Visual Studio extension that intelligently modernizes your existing C# codebase. It makes your code more expressive, more readable, more robust, and more performant, in one word - sharper.
Sharpenidentifies places in your code that will benefit from introducing new C# language features.It helps you tolearn new C# features quickerandcritically refactor your existing codeto modern C#.
Sharpen helps you to:
- learn new C# features faster
- modernize and refactor your code
- always have high-quality documentation on C# language at your fingerprints
- learn to approach new C# features critically
- improve the design and architecture of your codebase
- use C# features consistently over your codebase
Learn new C# features faster by applying them to your existing codebase.
Sharpenpoints you to places in real-life production code - your production code! - where you can learn and apply modern C#. This is a far cry from simplified and artificial code samples often used to explain new C# features.Sharpenallows you to learn and understand modern C# in the context of your own code.
Sharpenprovides you with meaningful recommendations and considerations for modernizing your code. It relates those recommendations and considerations to particular C# versions and their language features. Recommendations and considerations supported at the moment are listed below, sorted by the language version. Each new version ofSharpenbrings additional recommendations and considerations.
Modernize your C# code by refactoring it via a single mouse click.
Sharpenwill have a preview window that shows how the code looks now and how it will look after the proposed change is applied. That way, you will clearly understand the difference and, at the same time, visually grasp what the language feature is about. You will have the option to accept the proposed change and automatically refactor that piece of code.
Preview is not implemented at the moment. Here is a rough mockup of that upcoming functionality.
Refactoring will not be limited to the preview window only. It will be possible on different scales. E.g. in a single place in code, or in a single file, or a whole project, or solution.Sharpenwill give you full control over the scope and nature of the refactorings. Also, it will automatically refactor only direct recommendations. Those are considered as always safe to apply.
This mockup shows applying suggested changes for a specific language feature within all files of a solution.
UntilSharpenbuilt-in refactorings are implemented, you can use the code fixes that come with Visual Studio for some of the recommendations. They are not available for allSharpenrecommendations, but for some, they are, so make sure to take a look if they might exist.
Learn C# without leaving Visual Studio by using built-in, high-quality documentation.
Sharpenwill bring high-quality C# documentation right at your fingerprints. It will provide its own extensive built-in documentation that explains C# language features in-depth. It will also link to the official MSDN documentation and curated high-quality online blog posts and videos that bring additional insights into particular topics.
Sharpenaims to become a one-stop-shop for everything you ever wanted to know about the design and evolution of C#.
In its current version,Sharpenlinks C# releases and language features to their official MSDN documentation. Extensive built-in documentation will be available in upcoming versions ofSharpen.(To open the documentation in an external browser, press the CTRL key while clicking on the link.)
Understand the potential drawbacks of new C# features before using them.
Sharpenimposes a critical view on C# features. It does that by distinguishing betweenrecommendationsandconsiderations.Recommendations are safe and recommended to apply. They will result in a more expressive, more readable, more robust, or more performant code. Recommendations always start with call-for-action verbs like "use," "apply," or "replace." Considerations, on the other hand, ask you to critically assess a particular language feature's usage in a given context. Considerations usually start with the verb "consider."
At the moment,Sharpen's considerations do not provide any explanations. In the upcoming versions, every consideration will come with an explanation. This explanation, together with additional examples, will provide you with enough information to decide if the language feature should be used in that particular case.
Recognize potential improvements and redesign and rearchitecture your code on a broader scope.
Sharpenis equipped with intelligent heuristics that recognizes potential code improvements on a broader scope. For example, the "Consider awaiting equivalent asynchronous method and yielding IAsyncEnumerable" recognizes places where asynchronous streams might be a better design choice than returning anIEnumerable<T>.Accepting such consideration impacts and improves the code on a broader scope. It means rearchitecting and redesigning a larger portion of the codebase rather than simply refactoring an isolated piece of code.
Other examples would be considering:
- to rearchitecture legacy asynchronous programming patterns like, e.g.
IAsyncResultpattern, to the Task-based Asynchronous Pattern and async and await. - to rearchitecture mutable Data Transfer Objects to C# 9.0 records.
Use new C# features consistently over your entire codebase.
Future versions ofSharpenwill allow you to configure which recommendations are relevant for you and refine the recommendations using recommendation-specific settings. Storing of such configurations will be possible on different levels, e.g., on a project, or on a solution, or on a machine level, to name just a few possibilities. It will be possible to shareSharpen's configuration among programmers working on the same project by checking it into the source code repository.
Note that defining and storing configurations is not implemented at the moment.
You caninstallSharpendirectly from Visual Studioby using Extensions dialog or you candownload itfrom the Visual Studio Marketplace.
To runSharpenanalysis on a whole solution, go to the "Tools -> Sharpen -> Analyze Solution".
To run an analysis on the currently edited file, use the "Analyze with Sharpen" context menu option on the file context menu.
To run an analysis on an arbitrary scope, use the "Analyze with Sharpen" context menu option after selecting nodes in the Solution Explorer.
Sharpenis a volunteer effort. Covering the whole C# evolution is a humongous task that cannot be carried out by a few people. So pitch in and join the development!:-) Before contributing, please make sure to read thecontribution guidelines.
All notable changes to theSharpenextension are documented in thechangelog.
Sharpenis licensed under theMIT license.