Skip to content

Document ability to use wildcards for with-access-specifier #418

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

Merged
merged 4 commits into from
Feb 12, 2023
Merged

Document ability to use wildcards for with-access-specifier #418

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c26bcef
Document ability to use wildcards for with-access-specifier
kant2002 Feb 3, 2023
7f1d8c2
Change based on suggestions
kant2002 Feb 3, 2023
2614452
Update based on comments
kant2002 Feb 3, 2023
75af4db
Address PR feedback
kant2002 Feb 12, 2023
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
3 changes: 3 additions & 0 deletions sources/ClangSharpPInvokeGenerator/CustomHelpBuilder.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,9 @@ public void Write(params TwoColumnHelpRow[] helpItems)
var _ = new Command("unused");
WriteColumns(helpItems, new HelpContext(this, _, Console.Out.CreateTextWriter()));
WriteLine();
WriteLine("Wildcards:");
WriteLine();
WriteLine("You can use * as catch-all rule for remapping procedures. For example if you want make all of your generated code internal you can use --with-access-specifier *=Internal.");
}

public void WriteLine() => Console.Out.WriteLine();
Expand Down
28 changes: 14 additions & 14 deletions sources/ClangSharpPInvokeGenerator/Program.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1156,7 +1156,7 @@ private static Option<string[]> GetWithAccessSpecifierOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-access-specifier", "-was" },
description: "An access specifier to be used with the given qualified or remapped declaration name during binding generation. You can use wildcards like this --with-access-specifier *=Internal",
description: "An access specifier to be used with the given qualified or remapped declaration name during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1167,7 +1167,7 @@ private static Option<string[]> GetWithAttributeOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-attribute", "-wa" },
description: "An attribute to be added to the given remapped declaration name during binding generation.",
description: "An attribute to be added to the given remapped declaration name during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1178,7 +1178,7 @@ private static Option<string[]> GetWithCallConvOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-callconv", "-wcc" },
description: "A calling convention to be used for the given declaration during binding generation.",
description: "A calling convention to be used for the given declaration during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1189,7 +1189,7 @@ private static Option<string[]> GetWithClassOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-class", "-wc" },
description: "A class to be used for the given remapped constant or function declaration name during binding generation.",
description: "A class to be used for the given remapped constant or function declaration name during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1200,7 +1200,7 @@ private static Option<string[]> GetWithGuidOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-guid", "-wg" },
description: "A GUID to be used for the given declaration during binding generation.",
description: "A GUID to be used for the given declaration during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1211,7 +1211,7 @@ private static Option<string[]> GetWithLibraryPathOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-librarypath", "-wlb" },
description: "A library path to be used for the given declaration during binding generation.",
description: "A library path to be used for the given declaration during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1222,7 +1222,7 @@ private static Option<string[]> GetWithManualImportOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-manual-import", "-wmi" },
description: "A remapped function name to be treated as a manual import during binding generation.",
description: "A remapped function name to be treated as a manual import during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1233,7 +1233,7 @@ private static Option<string[]> GetWithNamespaceOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-namespace", "-wn" },
description: "A namespace to be used for the given remapped declaration name during binding generation.",
description: "A namespace to be used for the given remapped declaration name during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1244,7 +1244,7 @@ private static Option<string[]> GetWithSetLastErrorOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-setlasterror", "-wsle" },
description: "Add the SetLastError=true modifier or SetsSystemLastError attribute to a given DllImport or UnmanagedFunctionPointer.",
description: "Add the SetLastError=true modifier or SetsSystemLastError attribute to a given DllImport or UnmanagedFunctionPointer. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1255,7 +1255,7 @@ private static Option<string[]> GetWithSuppressGCTransitionOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-suppressgctransition", "-wsgct" },
description: "Add the SuppressGCTransition calling convention to a given DllImport or UnmanagedFunctionPointer.",
description: "Add the SuppressGCTransition calling convention to a given DllImport or UnmanagedFunctionPointer. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1266,7 +1266,7 @@ private static Option<string[]> GetWithTransparentStructOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-transparent-struct", "-wts" },
description: "A remapped type name to be treated as a transparent wrapper during binding generation.",
description: "A remapped type name to be treated as a transparent wrapper during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1277,7 +1277,7 @@ private static Option<string[]> GetWithTypeOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-type", "-wt" },
description: "A type to be used for the given enum declaration during binding generation.",
description: "A type to be used for the given enum declaration during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1288,7 +1288,7 @@ private static Option<string[]> GetWithUsingOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-using", "-wu" },
description: "A using directive to be included for the given remapped declaration name during binding generation.",
description: "A using directive to be included for the given remapped declaration name during binding generation. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand All @@ -1299,7 +1299,7 @@ private static Option<string[]> GetWithPackingOption()
{
return new Option<string[]>(
aliases: new string[] { "--with-packing", "-wp" },
description: "Overrides the StructLayoutAttribute.Pack property for the given type.",
description: "Overrides the StructLayoutAttribute.Pack property for the given type. Supports wildcards.",
getDefaultValue: Array.Empty<string>
) {
AllowMultipleArgumentsPerToken = true
Expand Down