Skip to content

Commit 4609521

Browse files
authored
1.0.0 release (#15)
* Added IX.Observable (#8) * Imported IX.Guaranteed into collections. * Documentation project stub. * Minor IX.Core changes. * IX.Undoable added * Added IX.Observable. * Updated TLDs. * Added unit test project stub. * #3 - IX.Math and unit tests brought into development (#9) * #3 - Some code in preparation for IX.Math * #3 - Added IX.Math * Data generation and stream extensions in core. * IStringFormatter try syntax in IX.Math * Unit tests. * Updated documentation in IX.Core (#11) * #10 - added some namespace documentation * Updated namespaces in serialization. * Charset detection changed namespace after one year of inactivity in source repo. * Added namespace documentation for all of IX.Core * #13: Major dependencies and namespace updates. * Updated IANA TLDs * Updated utility code * Proper readme and usage stuff. * Moved IX.Core to IX.Library. * Internal source generator added. * Namespaces updated. * Repaired some issues with namespaces and tests. * Removed some warnings. * More warning removal. * ForEachAsync * ForEachAsync with ValueTask * ForEach actions completely merged into generator. * Removed some warnings. * Last foreach method. * Formatting. * Fixed merge conflicts.
1 parent 14a9830 commit 4609521

File tree

748 files changed

+71869
-3904
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

748 files changed

+71869
-3904
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -348,3 +348,4 @@ MigrationBackup/
348348

349349
# Ionide (cross platform F# VS Code tools) working folder
350350
.ionide/
351+
/Documentation/Help

Directory.Build.targets

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -5,64 +5,66 @@
55
<IsPackable>false</IsPackable>
66
</PropertyGroup>
77

8-
<ItemGroup Condition="'$(IsTestProject)'!='true'">
8+
<ItemGroup Condition="'$(IsTestProject)'!='true' And '$(IsIxSourceGenerator)' != 'true'">
99
<SourceRoot Include="$(NuGetPackageRoot)" />
1010
</ItemGroup>
1111

12-
<PropertyGroup Condition="'$(IsTestProject)'!='true'">
12+
<PropertyGroup Condition="'$(IsTestProject)'!='true' And '$(IsIxSourceGenerator)' != 'true'">
1313
<DocumentationFile>bin\$(Configuration)\$(TargetFramework)\$(AssemblyName).xml</DocumentationFile>
1414
</PropertyGroup>
1515

1616
<!-- SourceLink -->
17-
<ItemGroup Condition="'$(Configuration)'!='Debug' And '$(IsTestProject)'!='true'">
17+
<ItemGroup Condition="'$(Configuration)'!='Debug' And '$(IsTestProject)'!='true' And '$(IsIxSourceGenerator)' != 'true'">
1818
<PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.1.1">
1919
<PrivateAssets>all</PrivateAssets>
2020
<IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
2121
</PackageReference>
2222
</ItemGroup>
2323

24-
<ItemGroup>
24+
<ItemGroup Condition="'$(IsIxSourceGenerator)' != 'true'">
2525
<None Include="..\Common\Resources\icon.png" Link="icon.png" Pack="true" PackagePath="\" />
2626
</ItemGroup>
2727

2828
<!-- Analyzer suppressions -->
29-
<ItemGroup>
29+
<ItemGroup Condition="'$(IsIxSourceGenerator)' != 'true'">
3030
<Compile Include="..\Common\Code\StandardSuppressions.cs" Link="Properties\StandardSuppressions.cs" />
3131
</ItemGroup>
3232

3333
<!-- Further analyzers - only in debug, as they tend to be rather heavy -->
34-
<PropertyGroup Condition="'$(Configuration)'=='Debug' And '$(IsTestProject)'!='true' And '$(TargetFrameworkIs5)'!='true'">
34+
<PropertyGroup Condition="'$(Configuration)'=='Debug' And '$(IsTestProject)'!='true' And '$(TargetFrameworkIs5)'!='true' And '$(IsIxSourceGenerator)' != 'true'">
3535
<EnableNETAnalyzers>true</EnableNETAnalyzers>
3636
</PropertyGroup>
3737

38-
<ItemGroup Condition="'$(Configuration)'=='Debug' And '$(IsTestProject)'!='true'">
38+
<ItemGroup Condition="'$(Configuration)'=='Debug' And '$(IsTestProject)'!='true' And '$(IsIxSourceGenerator)' != 'true'">
3939
<!-- CLR Heap Allocation Analyzer -->
4040
<PackageReference Include="ClrHeapAllocationAnalyzer" Version="3.0.0">
4141
<PrivateAssets>all</PrivateAssets>
4242
<IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
4343
</PackageReference>
4444

4545
<!-- IDisposable Analyzer -->
46-
<PackageReference Include="IDisposableAnalyzers" Version="4.0.2">
46+
<PackageReference Include="IDisposableAnalyzers" Version="4.0.7">
4747
<PrivateAssets>all</PrivateAssets>
4848
<IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
4949
</PackageReference>
5050
</ItemGroup>
5151

5252
<!-- JetBrains annotations -->
53-
<ItemGroup>
54-
<PackageReference Include="JetBrains.Annotations" Version="2022.3.1" />
53+
<ItemGroup Condition="'$(IsIxSourceGenerator)' != 'true'">
54+
<PackageReference Include="JetBrains.Annotations" Version="2023.2.0" />
5555
<Using Include="JetBrains.Annotations" />
5656
</ItemGroup>
5757

5858
<!-- Most common global usings -->
59-
<ItemGroup>
60-
<Using Include="IX.Core.Contracts" />
61-
<Using Include="IX.Core.Threading" />
59+
<ItemGroup Condition="'$(IsIxSourceGenerator)' != 'true'">
60+
<Using Include="IX.Library" />
61+
<Using Include="IX.Library.Contracts" />
62+
<Using Include="IX.Library.ComponentModel" />
63+
<Using Include="IX.Library.Threading" />
6264
</ItemGroup>
6365

6466
<!-- Do not include VS Code-specific files -->
65-
<ItemGroup>
67+
<ItemGroup Condition="'$(IsIxSourceGenerator)' != 'true'">
6668
<Compile Remove=".vscode\**" />
6769
<EmbeddedResource Remove=".vscode\**" />
6870
<None Remove=".vscode\**" />
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<topic id="6ba0616e-8c98-42ba-9c9f-2734fe0bc216" revisionNumber="1">
3+
<developerConceptualDocument xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<introduction>
5+
<para>The topics in this section describe the various changes made to the [TODO: Project Title] over the
6+
life of the project.</para>
7+
</introduction>
8+
9+
<section>
10+
<title>Version History</title>
11+
<content>
12+
<para>Select a version below to see a description of its changes.</para>
13+
14+
<list class="bullet">
15+
<listItem>
16+
<para><link xlink:href="46f9c534-8884-48aa-932b-8330de5b8df6" /></para>
17+
</listItem>
18+
19+
<listItem>
20+
<para>[TODO: Add links to each specific version page]</para>
21+
</listItem>
22+
23+
</list>
24+
25+
</content>
26+
</section>
27+
28+
<relatedTopics>
29+
<link xlink:href="2f1cd51e-8143-4348-b6b6-55000302a21c" />
30+
</relatedTopics>
31+
32+
</developerConceptualDocument>
33+
</topic>
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<topic id="46f9c534-8884-48aa-932b-8330de5b8df6" revisionNumber="1">
3+
<developerConceptualDocument xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<introduction>
5+
<para>Version [TODO: Version] was released on [TODO: Date].
6+
</para>
7+
</introduction>
8+
9+
<section>
10+
<title>Changes in This Release</title>
11+
<content>
12+
13+
<list class="bullet">
14+
<listItem>
15+
<para>[TODO: Add change items here]</para>
16+
</listItem>
17+
18+
</list>
19+
20+
</content>
21+
</section>
22+
23+
<relatedTopics>
24+
<link xlink:href="6ba0616e-8c98-42ba-9c9f-2734fe0bc216" />
25+
</relatedTopics>
26+
27+
</developerConceptualDocument>
28+
</topic>

Documentation/Content/Welcome.aml

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<topic id="2f1cd51e-8143-4348-b6b6-55000302a21c" revisionNumber="1">
3+
<developerConceptualDocument xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink">
4+
<introduction>
5+
<para>This is a sample conceptual topic. You can use this as a starting point for adding more conceptual
6+
content to your help project.</para>
7+
</introduction>
8+
9+
<section>
10+
<title>Getting Started</title>
11+
<content>
12+
<para>To get started, add a documentation source to the project (a Visual Studio solution, project, or
13+
assembly and XML comments file). See the <legacyBold>Getting Started</legacyBold> topics in the Sandcastle Help
14+
File Builder's help file for more information. The following default items are included in this project:</para>
15+
16+
<list class="bullet">
17+
<listItem>
18+
<para><localUri>ContentLayout.content</localUri> - Use the content layout file to manage the
19+
conceptual content in the project and define its layout in the table of contents.</para>
20+
</listItem>
21+
22+
<listItem>
23+
<para>The <localUri>.\media</localUri> folder - Place images in this folder that you will reference
24+
from conceptual content using <codeInline>medialLink</codeInline> or <codeInline>mediaLinkInline</codeInline>
25+
elements. If you will not have any images in the file, you may remove this folder.</para>
26+
</listItem>
27+
28+
<listItem>
29+
<para>The <localUri>.\icons</localUri> folder - This contains a default logo for the help file. You
30+
may replace it or remove it and the folder if not wanted. If removed or if you change the file name, update
31+
the <ui>Transform Args</ui> project properties page by removing or changing the filename in the
32+
<codeInline>logoFile</codeInline> transform argument. Note that unlike images referenced from conceptual topics,
33+
the logo file should have its <legacyBold>BuildAction</legacyBold> property set to <codeInline>Content</codeInline>.</para>
34+
</listItem>
35+
36+
<listItem>
37+
<para>The <localUri>.\Content</localUri> folder - Use this to store your conceptual topics. You may
38+
name the files and organize them however you like. One suggestion is to lay the files out on disk as you have
39+
them in the content layout file as shown in this project but the choice is yours. Files can be added via the
40+
Solution Explorer or from within the content layout file editor. Files must appear in the content layout file
41+
in order to be compiled into the help file.</para>
42+
</listItem>
43+
</list>
44+
45+
<para>See the <legacyBold>Conceptual Content</legacyBold> topics in the Sandcastle Help File Builder's
46+
help file for more information. See the <legacyBold> Sandcastle MAML Guide</legacyBold> for details on Microsoft
47+
Assistance Markup Language (MAML) which is used to create these topics.</para>
48+
</content>
49+
</section>
50+
51+
<relatedTopics>
52+
<link xlink:href="6ba0616e-8c98-42ba-9c9f-2734fe0bc216" />
53+
</relatedTopics>
54+
</developerConceptualDocument>
55+
</topic>
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<Topics>
3+
<Topic id="2f1cd51e-8143-4348-b6b6-55000302a21c" visible="True" isDefault="true" title="Welcome to the IX Libraries">
4+
<HelpKeywords>
5+
<HelpKeyword index="K" term="Welcome" />
6+
</HelpKeywords>
7+
</Topic>
8+
<Topic id="6ba0616e-8c98-42ba-9c9f-2734fe0bc216" visible="True" isSelected="true" title="Version History">
9+
<HelpKeywords>
10+
<HelpKeyword index="K" term="version, history" />
11+
</HelpKeywords>
12+
<Topic id="46f9c534-8884-48aa-932b-8330de5b8df6" visible="True" title="Version 1.0.0.0">
13+
<HelpKeywords>
14+
<HelpKeyword index="K" term="version, 1.0.0.0" />
15+
</HelpKeywords>
16+
</Topic>
17+
</Topic>
18+
</Topics>
Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<Project ToolsVersion="15.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
3+
<!-- Import the common properties to support NuGet restore -->
4+
<Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
5+
<PropertyGroup>
6+
<!-- A target framework version is required by Visual Studio. It can be any version with a targeting pack installed. -->
7+
<TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>
8+
<!-- The configuration and platform will be used to determine which assemblies to include from solution and
9+
project documentation sources -->
10+
<Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
11+
<Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
12+
<SchemaVersion>2.0</SchemaVersion>
13+
<ProjectGuid>3a21ceec-78a5-4791-8830-febf91a86d27</ProjectGuid>
14+
<SHFBSchemaVersion>2017.9.26.0</SHFBSchemaVersion>
15+
<!-- AssemblyName, Name, and RootNamespace are not used by SHFB but Visual Studio adds them anyway -->
16+
<AssemblyName>Documentation</AssemblyName>
17+
<RootNamespace>Documentation</RootNamespace>
18+
<Name>Documentation</Name>
19+
<!-- SHFB properties -->
20+
<FrameworkVersion>Cross-platform (.NET Core/.NET Standard)</FrameworkVersion>
21+
<OutputPath>.\Help\</OutputPath>
22+
<HtmlHelpName>Documentation</HtmlHelpName>
23+
<Language>en-US</Language>
24+
<TransformComponentArguments>
25+
<Argument Key="logoFile" Value="Help.png" xmlns="" />
26+
<Argument Key="logoHeight" Value="" xmlns="" />
27+
<Argument Key="logoWidth" Value="" xmlns="" />
28+
<Argument Key="logoAltText" Value="" xmlns="" />
29+
<Argument Key="logoPlacement" Value="left" xmlns="" />
30+
<Argument Key="logoAlignment" Value="left" xmlns="" />
31+
<Argument Key="maxVersionParts" Value="" xmlns="" />
32+
</TransformComponentArguments>
33+
<HelpFileFormat>Markdown</HelpFileFormat>
34+
<SyntaxFilters>C#, Visual Basic, Managed C++, F#, XAML Usage</SyntaxFilters>
35+
<PresentationStyle>Markdown</PresentationStyle>
36+
<CleanIntermediates>True</CleanIntermediates>
37+
<KeepLogFile>True</KeepLogFile>
38+
<DisableCodeBlockComponent>False</DisableCodeBlockComponent>
39+
<IndentHtml>False</IndentHtml>
40+
<BuildAssemblerVerbosity>OnlyWarningsAndErrors</BuildAssemblerVerbosity>
41+
<SaveComponentCacheCapacity>100</SaveComponentCacheCapacity>
42+
<DocumentationSources>
43+
<DocumentationSource sourceFile="..\IX.Core\IX.Core.csproj" />
44+
<DocumentationSource sourceFile="..\IX.Undoable\IX.Undoable.csproj" />
45+
<DocumentationSource sourceFile="..\IX.Math\IX.Math.csproj" />
46+
<DocumentationSource sourceFile="..\IX.Observable\IX.Observable.csproj" />
47+
</DocumentationSources>
48+
</PropertyGroup>
49+
<!-- There are no properties for these groups. AnyCPU needs to appear in order for Visual Studio to perform
50+
the build. The others are optional common platform types that may appear. -->
51+
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
52+
</PropertyGroup>
53+
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
54+
</PropertyGroup>
55+
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x86' ">
56+
</PropertyGroup>
57+
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x86' ">
58+
</PropertyGroup>
59+
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x64' ">
60+
</PropertyGroup>
61+
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x64' ">
62+
</PropertyGroup>
63+
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|Win32' ">
64+
</PropertyGroup>
65+
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|Win32' ">
66+
</PropertyGroup>
67+
<ItemGroup>
68+
<Folder Include="Content" />
69+
<Folder Include="Content\VersionHistory" />
70+
<Folder Include="icons" />
71+
<Folder Include="media" />
72+
</ItemGroup>
73+
<ItemGroup>
74+
<None Include="Content\VersionHistory\v1.0.0.0.aml" />
75+
<None Include="Content\VersionHistory\VersionHistory.aml" />
76+
<None Include="Content\Welcome.aml" />
77+
</ItemGroup>
78+
<ItemGroup>
79+
<ContentLayout Include="ContentLayout.content" />
80+
</ItemGroup>
81+
<ItemGroup>
82+
<Content Include="icons\Help.png" />
83+
</ItemGroup>
84+
<!-- Import the common build targets during NuGet restore because before the packages are being installed, $(SHFBROOT) is not set yet -->
85+
<Import Project="$(MSBuildToolsPath)\Microsoft.Common.targets" Condition="'$(MSBuildRestoreSessionId)' != ''" />
86+
<!-- Import the SHFB build targets during build -->
87+
<Import Project="$(SHFBROOT)\SandcastleHelpFileBuilder.targets" Condition="'$(MSBuildRestoreSessionId)' == ''" />
88+
<!-- The pre-build and post-build event properties must appear *after* the targets file import in order to be
89+
evaluated correctly. -->
90+
<PropertyGroup>
91+
<PreBuildEvent>
92+
</PreBuildEvent>
93+
<PostBuildEvent>
94+
</PostBuildEvent>
95+
<RunPostBuildEvent>OnBuildSuccess</RunPostBuildEvent>
96+
</PropertyGroup>
97+
</Project>

Documentation/icons/Help.png

4.83 KB
Loading

0 commit comments

Comments
 (0)