zt 0.1.1

data/.ruby-gemset

@@ -0,0 +1 @@
+zt

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.6.2

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.6.2
+before_install: gem install bundler -v 2.0.1

data/.versions.conf

@@ -0,0 +1,4 @@
+ruby=ruby-2.6.2
+ruby-gemset=zt
+#ruby-gem-install=bundler rake
+#ruby-bundle-install=true

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,75 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of
+experience, nationality, personal appearance, race, religion, or sexual
+identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team by any method listed on
+[https://keybase.io/dave](https://keybase.io/dave) . All complaints will be
+reviewed and investigated and will result in a response that is deemed necessary
+and appropriate to the circumstances. The project team is obligated to maintain
+confidentiality with regard to the reporter of an incident. Further details of
+ specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# see zt.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Dave Williams
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,103 @@
+# zt
+
+Utilities and glue to make working with ZeroTier networks a bit more
+friendly
+
+[![gem version][img-badge-gem]][link-badge-gem]
+
+This document assumes a UNIX-like operating system.
+
+For the vast majority of people, that means Linux, *BSD, and macOS.
+
+It might work with Windows, but Ruby on Windows is an adventure in
+itself so I'm afraid you're on your own. If you're stuck with Windows,
+try setting one of the [Windows Subsystem for Linux][link-wsl] sandboxes
+up - they work surprisingly well.
+
+## Installation
+
+At this point, `zt` is intended as a command-line tool first and a
+library second (if at all). As such, instructions for usage with Bundler
+or similar are not given.
+
+If `zt` becomes useful as a library, instructions will be provided, and
+if you want to try using it as a library anyway, then best of luck to
+you.
+
+`zt` can be installed with RubyGems, and is published to the default
+repository. Simply install it like any other gem.
+
+```bash
+gem install zt
+```
+
+Depending on how your Ruby installation is set up, you may need to
+install it as a superuser. If you're not sure, and if commands like
+`rvm`, `rbenv`, and/or `ruby-build` don't ring any bells, you probably
+need to install as a superuser using `sudo`.
+
+```bash
+sudo gem install zt
+```
+
+## Usage
+
+<!-- TODO: the bit we're all here to see in the first place -->
+
+## Development
+
+- Fork the repository on GitHub.
+  -  ![gem version][img-fork_button]
+-  Check out your fork.
+   -  `git clone https://github.com/yourusername/zt`
+-  Enter the checkout directory.
+   - `cd zt`
+- Install dependencies.
+  - `bin/setup`
+- Run the tests.
+  - `rake spec`
+- Make a new branch for your feature.
+  - `git branch your-amazing-new-feature`
+- Check out your new branch.
+  - `git checkout your-amazing-new-feature`
+- Hack away.
+  - `(you have to come up with this bit yourself)`
+- Make sure you add tests for your work.
+  - `(this bit is boring but REALLY IMPORTANT)`
+- Make sure all the tests pass, both old and new.
+  - `rake spec`
+- Commit and push your now-tested work to your fork.
+  - `git commit && git push origin your-amazing-new-feature`
+- Open a pull request and wait for a response.
+
+**PROTIP:** You can also run `bin/console` for an interactive prompt
+that will allow you to experiment.
+
+The [Bundler guide to gem development][link-bundler-guide] may be
+helpful if this is your first gem. It certainly helped me.
+
+## Contributing
+
+Bug reports and pull requests are welcome [on GitHub][link-repo]. This
+project is intended to be a safe, welcoming space for collaboration, and
+contributors are expected to adhere to the [code of conduct][link-coc].
+
+## License
+
+The gem is available as open source under the terms of the
+[MIT License][link-mitlic].
+
+## Code of Conduct
+
+Everyone interacting in the zt project’s codebases, issue trackers, chat
+rooms, and mailing lists, including the original author, is expected to
+follow the [code of conduct][link-coc].
+
+[link-repo]: https://github.com/daveio/zt
+[link-coc]: https://github.com/daveio/zt/blob/master/CODE_OF_CONDUCT.md
+[link-mitlic]: https://opensource.org/licenses/MIT
+[link-bundler-guide]: https://bundler.io/v2.0/guides/creating_gem.html
+[link-badge-gem]: https://badge.fury.io/rb/zt
+[link-wsl]: https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux
+[img-badge-gem]: https://badge.fury.io/rb/zt.svg
+[img-fork_button]: https://zt.dave.io/images/fork_button.png

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "zt"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "pry"
+Pry.start
+
+#require "irb"
+#IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/zt

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'zt/cli'
+Zt::CLI.start

data/lib/zt.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'zt/cli'
+require 'zt/conf'
+require 'zt/constants'
+require 'zt/errors'
+require 'zt/exporters'
+require 'zt/importers'
+require 'zt/remote_api'
+require 'zt/version'
+
+# Top-level zt module
+module Zt
+end

data/lib/zt/cli.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require 'thor'
+require 'zt'
+
+module Zt
+  # Base CLI class
+  class CLI < Thor
+    attr_accessor :conf
+
+    def initialize(thor_args = [], thor_options = {}, thor_config = {})
+      super(thor_args, thor_options, thor_config)
+      @conf = Conf.instance.conf
+    end
+
+    desc 'version', 'Show the zt version number'
+    def version
+      puts "zt version #{Zt::VERSION}"
+    end
+
+    desc 'pull',
+         'Fetch and save the current state of your networks'
+    def pull
+      puts '≫ pull started'
+      puts '  ≫ pulling'
+      rapi = Zt::RemoteAPI::ZeroTierAPI.new
+      print '    ≫ networks '
+      rnetworks = rapi.networks
+      column_width = rnetworks.map { |n| n['config']['name'].length }.max + 1
+      print ' ' * (column_width + 9)
+      puts '✅'
+      rnodes = {}
+      rnetworks.each do |net|
+        netid = net['id']
+        netname = net['config']['name']
+        print "    ≫ nodes for network #{netname}"
+        rnodes[netid] = rapi.network_members(netid)
+        print ' ' * (column_width - netname.length)
+        puts '✅'
+      end
+      puts '  ≫ processing'
+      importer_results = Zt::Importers::Importer.new(rnetworks, rnodes).import
+      lnetworks = {}
+      ldomains = {}
+      lnodes = {}
+      importer_results.each do |importer_result|
+        if importer_result.key?(:networks)
+          importer_result[:networks].each_key do |netid|
+            ldomains[netid] =
+              importer_result[:networks][netid][:local][:dns_zone]
+            lnetworks[netid] = importer_result[:networks][netid]
+          end
+        end
+
+        next unless importer_result.key?(:nodes)
+
+        importer_result[:nodes].each_key do |nodeid|
+          lnodes[nodeid] = importer_result[:nodes][nodeid]
+        end
+      end
+      puts '  ≫ saving'
+      Zt::Conf.instance.conf.domains = ldomains
+      Zt::Conf.instance.conf.networks = lnetworks
+      Zt::Conf.instance.conf.nodes = lnodes
+      Zt::Conf.instance.save!
+      puts '≫ pull completed'
+    end
+
+    desc 'export',
+         'export the on-disk database to STDOUT in /etc/hosts format'
+    def export(format = :hosts)
+      output = Zt::Exporters::Exporter.new.export_one_format :hosts
+      puts output
+    end
+
+    desc 'auth [TOKEN]',
+         'Store an authentication token (unencrypted) in the config'
+    def auth(token)
+      token_regex = Constants::AUTH_TOKEN_REGEX
+      if token.length != Constants::AUTH_TOKEN_LENGTH
+        abort('Authentication token must be exactly 32 characters')
+      elsif !token_regex.match?(token)
+        abort('Authentication token contains invalid characters, only ' \
+              'alphanumerics are permitted.')
+      else
+        conf.zt['token'] = token
+        Zt::Conf.instance.save! :zt
+      end
+    end
+  end
+end

data/lib/zt/conf.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require 'ostruct'
+require 'singleton'
+require 'yaml'
+require 'zt/constants'
+require 'zt/errors'
+
+module Zt
+  # Create initial config if it is not present already
+  class Conf
+    include Singleton
+    attr_accessor :conf
+
+    def initialize
+      raise Errors::ZtConfDiskError unless ensure_config_on_disk
+      raise Errors::ZtConfSyntaxError unless read_config
+    end
+
+    def save!(*sections)
+      sections = %i[domains networks nodes zt] if sections.empty?
+      sections.each do |section|
+        File.open(full_path_for_section(section), 'w') do |f|
+          YAML.dump(@conf[section], f)
+        end
+      end
+    end
+
+    private
+
+    def full_path_for_section(section)
+      raise Errors::ZtConfInvalidSectionError unless
+        Constants::CONF_SECTIONS.key? section
+
+      "#{Constants::CONF_DIR}/#{Constants::CONF_SECTIONS[section]}"
+    end
+
+    def read_config
+      @conf = OpenStruct.new
+      Constants::CONF_SECTIONS.each_key do |section|
+        @conf[section] =
+          YAML.load_file(
+            "#{Constants::CONF_DIR}/#{Constants::CONF_SECTIONS[section]}"
+          )
+      end
+      true
+    rescue StandardError
+      false
+    end
+
+    def ensure_config_on_disk
+      ensure_config_dir && ensure_config_files
+    end
+
+    def ensure_config_files
+      existing_files = []
+      created_files = []
+      Constants::INITIAL_CONF.keys.each do |config_file|
+        if File.exist?("#{Constants::CONF_DIR}/#{config_file}")
+          existing_files.append(config_file)
+        elsif create_config_file("#{Constants::CONF_DIR}/#{config_file}",
+                                 Constants::INITIAL_CONF[config_file])
+          created_files.append(config_file)
+        end
+      end
+      (existing_files + created_files).uniq.sort ==
+        Constants::INITIAL_CONF.keys.sort
+    end
+
+    def create_config_file(path, content)
+      File.open(path, 'w') do |f|
+        YAML.dump(content, f)
+      end
+      true
+    rescue StandardError
+      false
+    end
+
+    def ensure_config_dir
+      if Dir.exist? Constants::CONF_DIR
+        dir_exists = true
+        dir_created = false
+      else
+        dir_exists = false
+        dir_created = create_config_dir(Constants::CONF_DIR)
+      end
+      dir_created || dir_exists
+    end
+
+    def create_config_dir(path)
+      Dir.mkdir(path)
+      true
+    rescue StandardError
+      false
+    end
+  end
+end