ipaddress 0.2.10 → 0.2.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/src/ipaddress.d.ts +2 -0
- package/dist/src/ipaddress.d.ts.map +1 -1
- package/dist/src/ipaddress.js +36 -0
- package/dist/test/test_ipv4.js +14 -0
- package/dist/test/test_ipv6.js +13 -0
- package/package.json +1 -1
- package/src/ipaddress.ts +37 -0
- package/test/test_ipv4.ts +14 -0
- package/test/test_ipv6.ts +13 -0
package/dist/src/ipaddress.d.ts
CHANGED
|
@@ -81,6 +81,8 @@ export declare class IPAddress {
|
|
|
81
81
|
broadcast(): IPAddress;
|
|
82
82
|
is_network(): boolean;
|
|
83
83
|
network(): IPAddress;
|
|
84
|
+
host(n: number | bigint): IPAddress | null;
|
|
85
|
+
host_number(): bigint;
|
|
84
86
|
static to_network(adr: Crunchy, host_prefix: number): Crunchy;
|
|
85
87
|
sub(other: IPAddress): Crunchy;
|
|
86
88
|
add(other: IPAddress): IPAddress[];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ipaddress.d.ts","sourceRoot":"","sources":["../../src/ipaddress.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"ipaddress.d.ts","sourceRoot":"","sources":["../../src/ipaddress.ts"],"names":[],"mappings":"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"}
|
package/dist/src/ipaddress.js
CHANGED
|
@@ -836,6 +836,42 @@ export class IPAddress {
|
|
|
836
836
|
network() {
|
|
837
837
|
return this.from(IPAddress.to_network(this.host_address, this.prefix.host_prefix()), this.prefix);
|
|
838
838
|
}
|
|
839
|
+
// Returns the address at host number +n+ relative to this address's
|
|
840
|
+
// network, keeping the prefix. The address does not need to be a
|
|
841
|
+
// network itself.
|
|
842
|
+
//
|
|
843
|
+
// IPAddress.parse("192.168.128.7/24").host(93).to_string()
|
|
844
|
+
// // => "192.168.128.93/24"
|
|
845
|
+
//
|
|
846
|
+
// Host 0 is the network itself. Returns null when +n+ falls outside
|
|
847
|
+
// the network (including negative numbers).
|
|
848
|
+
host(n) {
|
|
849
|
+
let offset;
|
|
850
|
+
if (typeof n === "bigint") {
|
|
851
|
+
if (n < 0n) {
|
|
852
|
+
return null;
|
|
853
|
+
}
|
|
854
|
+
offset = Crunchy.parse(n.toString());
|
|
855
|
+
}
|
|
856
|
+
else {
|
|
857
|
+
if (n < 0 || !Number.isInteger(n)) {
|
|
858
|
+
return null;
|
|
859
|
+
}
|
|
860
|
+
offset = Crunchy.from_number(n);
|
|
861
|
+
}
|
|
862
|
+
if (offset.gte(this.size())) {
|
|
863
|
+
return null;
|
|
864
|
+
}
|
|
865
|
+
return this.from(this.network().host_address.add(offset), this.prefix);
|
|
866
|
+
}
|
|
867
|
+
// Returns the host number of this address within its network, i.e.
|
|
868
|
+
// this address minus its network base. The inverse of host().
|
|
869
|
+
//
|
|
870
|
+
// IPAddress.parse("192.168.128.93/24").host_number()
|
|
871
|
+
// // => 93n
|
|
872
|
+
host_number() {
|
|
873
|
+
return BigInt(this.host_address.sub(this.network().host_address).toString());
|
|
874
|
+
}
|
|
839
875
|
static to_network(adr, host_prefix) {
|
|
840
876
|
return adr.shr(host_prefix).shl(host_prefix);
|
|
841
877
|
}
|
package/dist/test/test_ipv4.js
CHANGED
|
@@ -204,6 +204,20 @@ describe("Ipv4Test", () => {
|
|
|
204
204
|
const ip = IPAddress.parse("127.0.0.1");
|
|
205
205
|
assert.equal("01111111000000000000000000000001", ip.bits());
|
|
206
206
|
});
|
|
207
|
+
it("test_method_host", () => {
|
|
208
|
+
const ip = IPAddress.parse("192.168.128.7/22");
|
|
209
|
+
assert.equal("192.168.129.44/22", ip.host(300).to_string());
|
|
210
|
+
assert.equal("192.168.128.7/22", ip.host(7).to_string());
|
|
211
|
+
assert.equal("192.168.128.0/22", ip.host(0).to_string());
|
|
212
|
+
assert.equal("192.168.131.255/22", ip.host(1023).to_string());
|
|
213
|
+
assert.isNull(ip.host(1024));
|
|
214
|
+
assert.isNull(ip.host(-1));
|
|
215
|
+
});
|
|
216
|
+
it("test_method_host_number", () => {
|
|
217
|
+
assert.equal(300n, IPAddress.parse("192.168.129.44/22").host_number());
|
|
218
|
+
assert.equal(0n, IPAddress.parse("192.168.128.0/22").host_number());
|
|
219
|
+
assert.equal(1023n, IPAddress.parse("192.168.131.255/22").host_number());
|
|
220
|
+
});
|
|
207
221
|
it("test_method_first", () => {
|
|
208
222
|
let ip = IPAddress.parse("192.168.100.0/24");
|
|
209
223
|
assert.equal("192.168.100.1", ip.first().to_s());
|
package/dist/test/test_ipv6.js
CHANGED
|
@@ -103,6 +103,19 @@ describe("ipv6", () => {
|
|
|
103
103
|
assert.equal(true, setup().network.is_network());
|
|
104
104
|
assert.equal(false, setup().ip.is_network());
|
|
105
105
|
});
|
|
106
|
+
it("test_method_host", () => {
|
|
107
|
+
const ip = IPAddress.parse("fd00::10:12:80:1/64");
|
|
108
|
+
assert.equal("fd00::1000:0:0/64", ip.host(2n ** 44n).to_string());
|
|
109
|
+
assert.equal("fd00::/64", ip.host(0).to_string());
|
|
110
|
+
assert.equal("fd00::ffff:ffff:ffff:ffff/64", ip.host(2n ** 64n - 1n).to_string());
|
|
111
|
+
assert.isNull(ip.host(2n ** 64n));
|
|
112
|
+
assert.isNull(ip.host(-1));
|
|
113
|
+
});
|
|
114
|
+
it("test_method_host_number", () => {
|
|
115
|
+
assert.equal(2n ** 44n, IPAddress.parse("fd00::1000:0:0/64").host_number());
|
|
116
|
+
assert.equal(0n, IPAddress.parse("fd00::/64").host_number());
|
|
117
|
+
assert.equal(2n ** 64n - 1n, IPAddress.parse("fd00::ffff:ffff:ffff:ffff/64").host_number());
|
|
118
|
+
});
|
|
106
119
|
it("test_method_first", () => {
|
|
107
120
|
// the zero host is the subnet-router anycast, NOT a usable unicast —
|
|
108
121
|
// first()/last() are the first/last USABLE hosts (:1/:f), 2026-08-19
|
package/package.json
CHANGED
package/src/ipaddress.ts
CHANGED
|
@@ -915,6 +915,43 @@ export class IPAddress {
|
|
|
915
915
|
return this.from(IPAddress.to_network(this.host_address, this.prefix.host_prefix()), this.prefix);
|
|
916
916
|
}
|
|
917
917
|
|
|
918
|
+
// Returns the address at host number +n+ relative to this address's
|
|
919
|
+
// network, keeping the prefix. The address does not need to be a
|
|
920
|
+
// network itself.
|
|
921
|
+
//
|
|
922
|
+
// IPAddress.parse("192.168.128.7/24").host(93).to_string()
|
|
923
|
+
// // => "192.168.128.93/24"
|
|
924
|
+
//
|
|
925
|
+
// Host 0 is the network itself. Returns null when +n+ falls outside
|
|
926
|
+
// the network (including negative numbers).
|
|
927
|
+
public host(n: number | bigint): IPAddress | null {
|
|
928
|
+
let offset: Crunchy;
|
|
929
|
+
if (typeof n === "bigint") {
|
|
930
|
+
if (n < 0n) {
|
|
931
|
+
return null;
|
|
932
|
+
}
|
|
933
|
+
offset = Crunchy.parse(n.toString());
|
|
934
|
+
} else {
|
|
935
|
+
if (n < 0 || !Number.isInteger(n)) {
|
|
936
|
+
return null;
|
|
937
|
+
}
|
|
938
|
+
offset = Crunchy.from_number(n);
|
|
939
|
+
}
|
|
940
|
+
if (offset.gte(this.size())) {
|
|
941
|
+
return null;
|
|
942
|
+
}
|
|
943
|
+
return this.from(this.network().host_address.add(offset), this.prefix);
|
|
944
|
+
}
|
|
945
|
+
|
|
946
|
+
// Returns the host number of this address within its network, i.e.
|
|
947
|
+
// this address minus its network base. The inverse of host().
|
|
948
|
+
//
|
|
949
|
+
// IPAddress.parse("192.168.128.93/24").host_number()
|
|
950
|
+
// // => 93n
|
|
951
|
+
public host_number(): bigint {
|
|
952
|
+
return BigInt(this.host_address.sub(this.network().host_address).toString());
|
|
953
|
+
}
|
|
954
|
+
|
|
918
955
|
public static to_network(adr: Crunchy, host_prefix: number): Crunchy {
|
|
919
956
|
return adr.shr(host_prefix).shl(host_prefix);
|
|
920
957
|
}
|
package/test/test_ipv4.ts
CHANGED
|
@@ -219,6 +219,20 @@ describe("Ipv4Test", () => {
|
|
|
219
219
|
const ip = IPAddress.parse("127.0.0.1");
|
|
220
220
|
assert.equal("01111111000000000000000000000001", ip!.bits());
|
|
221
221
|
});
|
|
222
|
+
it("test_method_host", () => {
|
|
223
|
+
const ip = IPAddress.parse("192.168.128.7/22");
|
|
224
|
+
assert.equal("192.168.129.44/22", ip!.host(300)!.to_string());
|
|
225
|
+
assert.equal("192.168.128.7/22", ip!.host(7)!.to_string());
|
|
226
|
+
assert.equal("192.168.128.0/22", ip!.host(0)!.to_string());
|
|
227
|
+
assert.equal("192.168.131.255/22", ip!.host(1023)!.to_string());
|
|
228
|
+
assert.isNull(ip!.host(1024));
|
|
229
|
+
assert.isNull(ip!.host(-1));
|
|
230
|
+
});
|
|
231
|
+
it("test_method_host_number", () => {
|
|
232
|
+
assert.equal(300n, IPAddress.parse("192.168.129.44/22")!.host_number());
|
|
233
|
+
assert.equal(0n, IPAddress.parse("192.168.128.0/22")!.host_number());
|
|
234
|
+
assert.equal(1023n, IPAddress.parse("192.168.131.255/22")!.host_number());
|
|
235
|
+
});
|
|
222
236
|
it("test_method_first", () => {
|
|
223
237
|
let ip = IPAddress.parse("192.168.100.0/24");
|
|
224
238
|
assert.equal("192.168.100.1", ip!.first().to_s());
|
package/test/test_ipv6.ts
CHANGED
|
@@ -112,6 +112,19 @@ describe("ipv6", () => {
|
|
|
112
112
|
assert.equal(true, setup().network.is_network());
|
|
113
113
|
assert.equal(false, setup().ip.is_network());
|
|
114
114
|
});
|
|
115
|
+
it("test_method_host", () => {
|
|
116
|
+
const ip = IPAddress.parse("fd00::10:12:80:1/64");
|
|
117
|
+
assert.equal("fd00::1000:0:0/64", ip!.host(2n ** 44n)!.to_string());
|
|
118
|
+
assert.equal("fd00::/64", ip!.host(0)!.to_string());
|
|
119
|
+
assert.equal("fd00::ffff:ffff:ffff:ffff/64", ip!.host(2n ** 64n - 1n)!.to_string());
|
|
120
|
+
assert.isNull(ip!.host(2n ** 64n));
|
|
121
|
+
assert.isNull(ip!.host(-1));
|
|
122
|
+
});
|
|
123
|
+
it("test_method_host_number", () => {
|
|
124
|
+
assert.equal(2n ** 44n, IPAddress.parse("fd00::1000:0:0/64")!.host_number());
|
|
125
|
+
assert.equal(0n, IPAddress.parse("fd00::/64")!.host_number());
|
|
126
|
+
assert.equal(2n ** 64n - 1n, IPAddress.parse("fd00::ffff:ffff:ffff:ffff/64")!.host_number());
|
|
127
|
+
});
|
|
115
128
|
it("test_method_first", () => {
|
|
116
129
|
// the zero host is the subnet-router anycast, NOT a usable unicast —
|
|
117
130
|
// first()/last() are the first/last USABLE hosts (:1/:f), 2026-08-19
|