Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
cidr-tools
Advanced tools
Readme
Tools to work with IPv4 and IPv6 CIDR
import {mergeCidr, excludeCidr, expandCidr, overlapCidr, containsCidr, normalizeCidr, parseCidr} from "cidr-tools";
mergeCidr(["1.0.0.0/24", "1.0.1.0/24"]); //=> ["1.0.0.0/23"]
excludeCidr(["::1/127"], "::1/128") //=> ["::/128"]
expandCidr(["2001:db8::/126"]) //=> ["2001:db8::", "2001:db8::1", "2001:db8::2", "2001:db8::3"]
overlapCidr("1.0.0.0/24", "1.0.0.128/25") //=> true
containsCidr(["1.0.0.0/24", "2.0.0.0/24"], "1.0.0.1") //=> true
normalizeCidr("::ffff/64") //=> "::/64"
parseCidr("::/64"); // => {cidr: "::/64", version: 6, prefix: "64", start: 0n, end: 18446744073709551615n}
All functions take CIDR addresses or single IP addresses. On single addresses, a prefix of /32
or /128
is assumed. Function that return networks will return a merged and sorted set of networks with IPv4 sorted before IPv6.
It is expected that the passed CIDRs and IPs are validated as the module's own input validation is rudimentary. You are encouraged to use modules like is-cidr and is-ip to validate before passing to this module.
This module requires BigInt support in your environment.
networks
String or Array: One or more CIDR or IP addresses.Returns an array of merged networks.
baseNetworks
String or Array: One or more CIDR or IP addresses.excludeNetworks
String or Array: One or more CIDR or IP addresses to exclude from baseNetworks
.Returns an array of merged remaining networks.
networks
String or Array: One or more CIDR or IP addresses.Returns an array of individual IPs contained in the networks.
networksA
String or Array: One or more CIDR or IP address.networksB
String or Array: One or more CIDR or IP address.Returns a boolean that indicates if networksA
overlap (intersect) with networksB
.
networksA
String or Array: One or more CIDR or IP address.networksB
String or Array: One or more CIDR or IP address.Returns a boolean that indicates whether networksA
fully contain all networksB
.
networks
String or Array: One or more CIDR or IP address.Returns a string or array (depending on input) with a normalized representation. Will not include a prefix on single IPs. Will set network address to the start of the network.
opts
: Object
compress
: Whether to compress the IP. For IPv6, this means the "best representation" all-lowercase shortest possible form. Default: true
.hexify
: Whether to convert IPv4-Mapped IPv6 addresses to hex. Default: false
.network
String: A CIDR or IP address.Returns a parsed
Object which is used internally by this module. It can be used to test whether the passed network is IPv4 or IPv6 or to work with the BigInts directly.
parsed
: Object
cidr
String: The CIDR of the network.ip
String: The IP address inside the CIDR, including any %scopeid
if present.version
Number: IP protocol version. Either 4
or 6
.prefix
String: The network prefix, e.g. 64
.start
BigInt: Start number of the network.end
BigInt: End number of the network.© silverwind, distributed under BSD licence.
FAQs
Tools to work with IPv4 and IPv6 CIDR
The npm package cidr-tools receives a total of 23,216 weekly downloads. As such, cidr-tools popularity was classified as popular.
We found that cidr-tools demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.