Skip to content

Commit 320428d

Browse files
authored
Update README.md
1 parent 0f88301 commit 320428d

File tree

1 file changed

+34
-2
lines changed

1 file changed

+34
-2
lines changed

README.md

+34-2
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,34 @@
1-
# AsmComp
2-
.NET assembly comparer
1+
<center><h1>AsmComp</h1></center>
2+
When you have two .NET assemblies with the same size and most of the file metadata, it might be difficult to tell whether these two assemblies have differences, and what
3+
these differences are. If you load these assemblies into AsmComp, you can see the differences side-by-side.
4+
5+
For reference, if TestLibX.dll has this code:
6+
```cs
7+
namespace TestLibX;
8+
9+
public enum Level {
10+
High,
11+
Medium,
12+
Low
13+
}
14+
```
15+
and TestLibY.dll has this code:
16+
```cs
17+
namespace TestLibY;
18+
19+
public class Class1;
20+
21+
public enum Level {
22+
High,
23+
Medium,
24+
Low = 4 /*remember this one here*/
25+
}
26+
```
27+
If you then build these two assemblies, you'll end up with two assemblies whose size is 4.5KB. It can be hard to distinguish the difference between the two, if you don't know
28+
about its source code.
29+
30+
Open up AsmComp (`AsmComp.Desktop.Windows.exe`), select two files, click 'Compare Assemblies' and open the 'Comparison' tab. By doing so, you can see the entire hierarchy
31+
of differences between two assemblies.
32+
![Screenshot 2024-08-27 224900](https://github.com/user-attachments/assets/ba4de1df-96a5-455b-8a55-7bf352dd2434)
33+
34+
Remember, AsmComp can do this while being super lightweight - only ~5MB in size.

0 commit comments

Comments
 (0)