Port

Libraries/Esiur/Esiur.csproj

@@ -5,7 +5,7 @@
 		<Copyright>Ahmed Kh. Zamil</Copyright>
 		<PackageProjectUrl>https://www.esiur.com</PackageProjectUrl>
 		<GeneratePackageOnBuild>true</GeneratePackageOnBuild>
-		<Version>3.0.0</Version>
+		<Version>3.0.1</Version>
 		<RepositoryUrl>https://github.com/esiur/esiur-dotnet</RepositoryUrl>
 		<Authors>Ahmed Kh. Zamil</Authors>
 		<AssemblyVersion></AssemblyVersion>

Libraries/Esiur/Protocol/EpConnection.cs

@@ -3143,10 +3143,16 @@ public partial class EpConnection : NetworkConnection, IStore
                 return new AsyncReply<bool>(true);
 
 
-            var host = Instance.Name.Split(':');
+            if (!Uri.TryCreate($"ep://{Instance.Name}", UriKind.Absolute, out var endpoint)
+                || string.IsNullOrWhiteSpace(endpoint.Host)
+                || endpoint.Port <= 0
+                || endpoint.Port > ushort.MaxValue)
+                throw new FormatException(
+                    "EP endpoints must include an explicit port (for example, ep://host:port)."
+                );
 
-            var address = host[0];
-            var port = host.Length > 1 ? ushort.Parse(host[1]) : (ushort)10518;
+            var address = endpoint.Host;
+            var port = checked((ushort)endpoint.Port);
 
             // assign domain from hostname if not provided
             if (context is EpConnectionContext epContext)

Libraries/Esiur/Protocol/EpServer.cs

@@ -131,12 +131,14 @@ public class EpServer : NetworkServer<EpConnection>, IResource
         set;
     }
 
-    //[Attribute]
+    /// <summary>
+    /// Application-supplied native TCP port. Zero requests an ephemeral port from the OS.
+    /// </summary>
     public ushort Port
     {
         get;
         set;
-    } = 10518;
+    }
 
     /// <summary>
     /// Controls whether warehouse initialization opens Esiur's native TCP listener.

Libraries/Esiur/README.md

@@ -93,8 +93,13 @@ Add an `EpServer` to expose the resource through the Esiur EP protocol. Anonymou
 
 
 ```C#
+var epPort = ushort.Parse(
+    Environment.GetEnvironmentVariable("ESIUR_PORT")
+    ?? throw new InvalidOperationException("Set ESIUR_PORT."));
+
 await warehouse.Put("sys/server", new EpServer
 {
+    Port = epPort,
     AllowUnauthorizedAccess = true, // Development only.
 });
 ```
@@ -113,11 +118,15 @@ To sum up
 >using Esiur.Resource;
 >using Esiur.Stores;
 >
+>var epPort = ushort.Parse(
+>    Environment.GetEnvironmentVariable("ESIUR_PORT")
+>    ?? throw new InvalidOperationException("Set ESIUR_PORT."));
 >var warehouse = new Warehouse();
 >await warehouse.Put("sys", new MemoryStore());
 >await warehouse.Put("sys/hello", new HelloResource());
 >await warehouse.Put("sys/server", new EpServer
 >{
+>    Port = epPort,
 >    AllowUnauthorizedAccess = true, // Development only.
 >});
 >await warehouse.Open();
@@ -129,7 +138,8 @@ To access our resource remotely, we need to use it's full path including the pro
 
 ```C#
 var warehouse = new Warehouse();
-dynamic res = await warehouse.Get<IResource>("ep://localhost/sys/hello");
+var epPort = ushort.Parse(Environment.GetEnvironmentVariable("ESIUR_PORT")!);
+dynamic res = await warehouse.Get<IResource>($"ep://localhost:{epPort}/sys/hello");
 ```
 
 Now we can invoke the exported functions and read/write properties;
@@ -147,7 +157,8 @@ Summing up
 >using Esiur.Resource;
 >
 >var warehouse = new Warehouse();
->dynamic res = await warehouse.Get<IResource>("ep://localhost/sys/hello");
+>var epPort = ushort.Parse(Environment.GetEnvironmentVariable("ESIUR_PORT")!);
+>dynamic res = await warehouse.Get<IResource>($"ep://localhost:{epPort}/sys/hello");
 >
 >var reply = await res.SayHi("Hi, I'm calling you from dotnet");
 >
@@ -165,7 +176,7 @@ Esiur has a self describing feature which comes with every language it supports,
 After installing the Esiur NuGet package, a new command named ***Get-Types*** is added to the Visual Studio Package Manager Console. It generates client-side classes for robust static typing.
 
 ```ps 
-Get-Types ep://localhost/sys/hello
+Get-Types "ep://localhost:$env:ESIUR_PORT/sys/hello"
 ```
 
 This will generate and add wrappers for all types needed by our resource.
@@ -173,7 +184,8 @@ This will generate and add wrappers for all types needed by our resource.
 Allowing us to use
 ```C#
 var warehouse = new Warehouse();
-var res = await warehouse.Get<MyResource>("ep://localhost/sys/hello");
+var epPort = ushort.Parse(Environment.GetEnvironmentVariable("ESIUR_PORT")!);
+var res = await warehouse.Get<MyResource>($"ep://localhost:{epPort}/sys/hello");
 var reply = await res.SayHi("Static typing is better");
 Console.WriteLine(reply);
 ```