Representation of IP addresses and subnets.
Find a file
James Harton 2b01e70ae1
All checks were successful
continuous-integration/drone/push Build is passing
chore: migrate to local. (#27)
Reviewed-on: #27
Co-authored-by: James Harton <james@harton.nz>
Co-committed-by: James Harton <james@harton.nz>
2024-02-19 10:33:16 +13:00
config chore: migrate to local. (#27) 2024-02-19 10:33:16 +13:00
lib chore: migrate to local. (#27) 2024-02-19 10:33:16 +13:00
test chore: migrate to local. (#27) 2024-02-19 10:33:16 +13:00
.drone.yml chore: migrate to local. (#27) 2024-02-19 10:33:16 +13:00
.formatter.exs Update deps 2018-09-04 03:25:04 +00:00
.gitignore Initial parsing of various formats for IP addresses. 2017-10-08 19:07:51 +13:00
.tool-versions chore: migrate to local. (#27) 2024-02-19 10:33:16 +13:00
CHANGELOG.md chore: migrate to local. (#27) 2024-02-19 10:33:16 +13:00
LICENSE.md chore!: Relicense to HL3-FULL. 2023-01-17 11:00:21 +13:00
mix.exs chore: migrate to local. (#27) 2024-02-19 10:33:16 +13:00
mix.lock chore: migrate to local. (#27) 2024-02-19 10:33:16 +13:00
README.md chore: migrate to local. (#27) 2024-02-19 10:33:16 +13:00
renovate.json chore: Configure Renovate (#25) 2024-02-14 17:43:20 +13:00

IP

Build Status Hex.pm Hippocratic License HL3-FULL

IP, IP, Ooray! Simple IP Address representations.

Installation

If available in Hex, the package can be installed by adding ip to your list of dependencies in mix.exs:

def deps do
  [
    {:ip, "~> 2.0.1"}
  ]
end

Usage

ip provides representations for IP addresses and subnets for Elixir with a bunch of helpful stuff tacked on the side.

iex> ~i(192.0.2.1)
#IP.Address<192.0.2.1 DOCUMENTATION>

iex> ~i(2001:db8::)
#IP.Address<2001:db8:: DOCUMENTATION>

iex> outside = ~i(2001:db8::/64)
...> inside  = IP.Prefix.eui_64!(outside, "60:f8:1d:ad:d8:90")
...> IP.Prefix.contains_address?(outside, inside)
true

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/ip.

Github Mirror

This repository is mirrored on Github from it's primary location on my Forejo instance. Feel free to raise issues and open PRs on Github.

License

This software is licensed under the terms of the HL3-FULL, see the LICENSE.md file included with this package for the terms.

This license actively proscribes this software being used by and for some industries, countries and activities. If your usage of this software doesn't comply with the terms of this license, then contact me with the details of your use-case to organise the purchase of a license - the cost of which may include a donation to a suitable charity or NGO.