{"id":16741531,"url":"https://github.com/duaraghav8/dignet","last_synced_at":"2025-06-14T14:38:59.757Z","repository":{"id":64305157,"uuid":"182247309","full_name":"duaraghav8/dignet","owner":"duaraghav8","description":"Go library and CLI tool to find available subnets in Amazon VPC","archived":false,"fork":false,"pushed_at":"2019-05-03T17:13:26.000Z","size":546,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-15T23:42:07.274Z","etag":null,"topics":["aws","devops","golang-library","networking"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/duaraghav8.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-19T10:22:56.000Z","updated_at":"2025-02-14T06:01:02.000Z","dependencies_parsed_at":"2023-01-15T10:30:41.540Z","dependency_job_id":null,"html_url":"https://github.com/duaraghav8/dignet","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/duaraghav8/dignet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duaraghav8%2Fdignet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duaraghav8%2Fdignet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duaraghav8%2Fdignet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duaraghav8%2Fdignet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/duaraghav8","download_url":"https://codeload.github.com/duaraghav8/dignet/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duaraghav8%2Fdignet/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259833442,"owners_count":22918918,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","devops","golang-library","networking"],"created_at":"2024-10-13T01:03:12.415Z","updated_at":"2025-06-14T14:38:59.698Z","avatar_url":"https://github.com/duaraghav8.png","language":"Go","readme":"# Dignet\nDignet is a Go library and a CLI tool to find available IPv4 subnets in Amazon [Virtual Private Clouds](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html).\n\nIt is useful when you want to determine one or more subnet CIDRs available for use inside a VPC. Specify the size of the subnet(s) required and `dignet` outputs all available subnet CIDRs that do not overlap with any of the existing ones in the target VPC.\n\n## CLI usage\nTo use a pre-compiled binary, download the package appropriate for your platform from [Releases](https://github.com/duaraghav8/dignet/releases). Unzip the binary into any directory. The recommended approach is to put it in `/usr/local/bin` or any directory in your `PATH`.\n\nUse the `help` command to see the complete list of commands and options available.\n```bash\n$ dignet help\nNAME:\n   Dignet - Find available Subnets in Amazon VPC\n\nUSAGE:\n   dignet [global options] command [command options] [arguments...]\n\nVERSION:\n   0.1.0\n\nCOMMANDS:\n     list-available-subnets  List CIDRs of available IPv4 subnets of given size in target VPC\n     help, h                 Shows a list of commands or help for one command\n\nGLOBAL OPTIONS:\n   --profile value            The profile to use from AWS credentials file [$AWS_PROFILE]\n   --region value             AWS Region [$AWS_REGION]\n   --access-key-id value      AWS Access Key ID [$AWS_ACCESS_KEY_ID]\n   --secret-access-key value  AWS Secret Access Key [$AWS_SECRET_ACCESS_KEY]\n   --help, -h                 show help\n   --version, -v              print the version\n```\n\nIf you've configured a [Named Profile](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html) for your AWS account, you can use it with dignet. Alternatively, you can provide the region and API credentials.\n\nNote that the region specified via the commandline overrides the region specified in profile.\n\nUse `help \u003ccommand\u003e` to get help on a particular command.\n```bash\n$ dignet help list-available-subnets\nNAME:\n   dignet list-available-subnets - List CIDRs of available IPv4 subnets of given size in target VPC\n\nUSAGE:\n   dignet list-available-subnets [command options] [arguments...]\n\nOPTIONS:\n   --vpc-id value       ID of the target VPC\n   --subnet-size value  Desired subnet size (default: 128)\n```\n\nTo get the list of Subnets available, use the `list-available-subnets` command.\n```bash\n# Below command shows the list of subnets available that comprise of 4000 IPv4 addresses.\n# Since the smallest subnet with at least 4K IPs is /20, dignet looks for all /20 subnets.\n\n$ dignet -profile production list-available-subnets -vpc-id vpc-07h38a995398gg203 -subnet-size 4000\n\nRegion:   us-east-1\nVPC ID:   vpc-02h68a099382ff017\nVPC CIDR: 10.108.0.0/16\n===================================\n7 Available Subnet(s) of size 4096\n===================================\n10.108.64.0/20\n10.108.80.0/20\n10.108.96.0/20\n10.108.112.0/20\n10.108.128.0/20\n...\n```\n\n## Library usage\nDownload dignet using `go get github.com/duaraghav8/dignet`.\n\nSee [examples/](https://github.com/duaraghav8/dignet/tree/master/examples) on how to use the library in your application.\n\n## Credentials\nThe AWS credentials you supply must have the appropriate IAM permissions to [read VPC and subnet information](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_IAM.html#readonlyvpciam).\n\n## License\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fduaraghav8%2Fdignet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fduaraghav8%2Fdignet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fduaraghav8%2Fdignet/lists"}