updated references and changelog for 1.0-RC1 (#829)

Author: mhowlett

CHANGELOG.md

@@ -1,15 +1,31 @@
-# 1.0.x (unreleased)
+# 1.0.0-RC1
 
 ## New Features
 
 - Added GET subject versions to the cached schema registry client.
+- References librdkafka.redist [1.0.0-RC8](https://github.com/edenhill/librdkafka/releases/tag/v1.0.0-RC8)
+  - supports apline linux out-of-the-box.
+  - fallback support (that excludes security features) for most linux distributions previously unsuppored out-of-the-box.
+  - fixed a dependency issue on MacOS
+
+## Changes
+
+- A new rebalance API.
+  - `SetRebalanceHandler` has been split into `SetPartitionsAssignedHandler` and `SetPartitionsRevokedHandler`.
+  - Calling of `Assign`/`Unassign` in these handlers is prohibited.
+  - Partitions to read from / start offsets can be optionally specified manually via the return value from these handlers.
+- The `Message.PersistenceStatus` property name has changed to `Message.Status`.
+- Moved the `GetWatermarkOffsets` and `QueryWatermarkOffsets` methods from admin client to consumer.
+- Context is now provided to serdes via a `SerializationContext` class instance.
 
 ## Fixes
 
 - Corrected an error in the `rd_kafka_event_type` method signature which was causing incompatibility with mono.
 - Audited exception use across the library and made changes in various places where appropriate.
-- Removed unused CancellationToken parameters (we will add them back when implemented).
+- Removed unused `CancellationToken` parameters (we will add them back when implemented).
 - Builder classes now return interfaces, not concrete classes.
+- Removed the dependency on `CompilerServices.Unsafe` which was causing `ProduceAsync` to hang in some scenarios.
+- Fixed a deadlock-on-dispose issue in `AdminClient`.
 
 
 # 1.0.0-beta3

README.md

@@ -42,20 +42,17 @@ confluent-kafka-dotnet is distributed via NuGet. We provide three packages:
 To install Confluent.Kafka from within Visual Studio, search for Confluent.Kafka in the NuGet Package Manager UI, or run the following command in the Package Manager Console:
 
 ```
-Install-Package Confluent.Kafka -Version 1.0.0-beta3
+Install-Package Confluent.Kafka -Version 1.0.0-RC1
 ```
 
 To add a reference to a dotnet core project, execute the following at the command line:
 
 ```
-dotnet add package -v 1.0.0-beta3 Confluent.Kafka
+dotnet add package -v 1.0.0-RC1 Confluent.Kafka
 ```
 
-**Note:** We recommend using the `1.0.0-beta3` version of Confluent.Kafka for new projects in preference to the most recent stable release (0.11.6).
-The 1.0 API provides more features, is considerably improved and is more performant than 0.11.x releases. In choosing the label 'beta',
-we are signaling that we do not anticipate making any high impact changes to the API before the 1.0 release, however be warned that some 
-breaking changes are still planned. You can track progress and provide feedback on the new 1.0 API
-[here](https://github.com/confluentinc/confluent-kafka-dotnet/issues/614).
+**Note:** We recommend using the `1.0.0-RC1` version of Confluent.Kafka for new projects in preference to the most recent stable release (0.11.6).
+The 1.0 API provides more features, is considerably improved and is more performant than 0.11.x releases.
 
 ### Branch builds
 

examples/AdminClient/AdminClient.csproj

@@ -9,7 +9,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <!-- nuget package reference: <PackageReference Include="Confluent.Kafka" Version="1.0.0-beta3" /> -->
+    <!-- nuget package reference: <PackageReference Include="Confluent.Kafka" Version="1.0.0-RC1" /> -->
     <ProjectReference Include="../../src/Confluent.Kafka/Confluent.Kafka.csproj" />
   </ItemGroup>
 

examples/AvroBlogExamples/AvroBlogExamples.csproj

@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <!-- nuget package reference: <PackageReference Include="Confluent.SchemaRegistry.Serdes" Version="1.0.0-beta3" /> -->
+    <!-- nuget package reference: <PackageReference Include="Confluent.SchemaRegistry.Serdes" Version="1.0.0-RC1" /> -->
     <ProjectReference Include="../../src/Confluent.SchemaRegistry.Serdes/Confluent.SchemaRegistry.Serdes.csproj" />
   </ItemGroup>
 

examples/AvroGeneric/AvroGeneric.csproj

@@ -9,7 +9,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <!-- nuget package reference: <PackageReference Include="Confluent.SchemaRegistry.Serdes" Version="1.0.0-beta3" /> -->
+    <!-- nuget package reference: <PackageReference Include="Confluent.SchemaRegistry.Serdes" Version="1.0.0-RC1" /> -->
     <ProjectReference Include="../../src/Confluent.SchemaRegistry.Serdes/Confluent.SchemaRegistry.Serdes.csproj" />
   </ItemGroup>
 

examples/AvroSpecific/AvroSpecific.csproj

@@ -9,7 +9,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <!-- nuget package reference: <PackageReference Include="Confluent.SchemaRegistry.Serdes" Version="1.0.0-beta3" /> -->
+    <!-- nuget package reference: <PackageReference Include="Confluent.SchemaRegistry.Serdes" Version="1.0.0-RC1" /> -->
     <ProjectReference Include="../../src/Confluent.SchemaRegistry.Serdes/Confluent.SchemaRegistry.Serdes.csproj" />
   </ItemGroup>
 

examples/ConfluentCloud/ConfluentCloud.csproj

@@ -7,7 +7,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <!-- nuget package reference: <PackageReference Include="Confluent.Kafka" Version="1.0.0-beta3" /> -->
+    <!-- nuget package reference: <PackageReference Include="Confluent.Kafka" Version="1.0.0-RC1" /> -->
     <ProjectReference Include="../../src/Confluent.Kafka/Confluent.Kafka.csproj" />
   </ItemGroup>
 

examples/Consumer/Consumer.csproj

@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <!-- nuget package reference: <PackageReference Include="Confluent.Kafka" Version="1.0.0-beta3" /> -->
+    <!-- nuget package reference: <PackageReference Include="Confluent.Kafka" Version="1.0.0-RC1" /> -->
     <ProjectReference Include="../../src/Confluent.Kafka/Confluent.Kafka.csproj" />
   </ItemGroup>
 

examples/MultiProducer/MultiProducer.csproj

@@ -8,7 +8,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <!-- nuget package reference: <PackageReference Include="Confluent.Kafka" Version="1.0.0-beta3" /> -->
+    <!-- nuget package reference: <PackageReference Include="Confluent.Kafka" Version="1.0.0-RC1" /> -->
     <ProjectReference Include="../../src/Confluent.Kafka/Confluent.Kafka.csproj" />
   </ItemGroup>
 

examples/Producer/Producer.csproj

@@ -9,7 +9,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <!-- nuget package reference: <PackageReference Include="Confluent.Kafka" Version="1.0.0-beta3" /> -->
+    <!-- nuget package reference: <PackageReference Include="Confluent.Kafka" Version="1.0.0-RC1" /> -->
     <ProjectReference Include="../../src/Confluent.Kafka/Confluent.Kafka.csproj" />
   </ItemGroup>