ascension

Migrate DNS zones to the GNU Name System
Log | Files | Refs | README | LICENSE

PKG-INFO (3073B)

      1 Metadata-Version: 1.1
      2 Name: ascension
      3 Version: 0.11.5
      4 Summary: Tool to migrate DNS Zones to the GNU Name System
      5 Home-page: https://gnunet.org/git/ascension.git/
      6 Author: rexxnor
      7 Author-email: rexxnor+gnunet@brief.li
      8 License: UNKNOWN
      9 Description: # Ascension
     10         
     11         Tool to easily migrate existing DNS Zones into the GNU Name System using
     12         incremental zone transfers (AXFR/IXFR).
     13         
     14         ## How to install
     15         To install the ascension simply execute one of the following commands in the
     16         freshly cloned directory:
     17         
     18         ```bash
     19         # System wide installation
     20         sudo python3 setup.py install
     21         
     22         # Local installation through virtualenv
     23         python3 -m venv .venv
     24         source .venv/bin/activate
     25         python3 setup.py install
     26         ```
     27         
     28         ## How to install (Developer)
     29         A developer installation is very handy when you are making changes to the source
     30         code as this way you don't need to re-run the installation procedure every time
     31         you make a change.
     32         
     33         ```bash
     34         # installation through virtualenv
     35         python3 -m venv .venv
     36         source .venv/bin/activate
     37         python3 setup.py develop
     38         ```
     39         
     40         ## How to use
     41         If you have installed it, simply execute ascension with one of several options.
     42         You can also just run the file ascension.py itself directly.
     43         
     44         Taken from the docstring of the ascension.py file:
     45         ```
     46         Ascension
     47         
     48         Usage:
     49             ascension <domain> [-d] [-p] [-s] [--minimum-ttl=<ttl>] [--dry-run]
     50             ascension <domain> <port> [-d] [-p] [-s] [--minimum-ttl=<ttl>] [--dry-run]
     51             ascension <domain> -n <transferns> [-d] [-p] [-s] [--minimum-ttl=<ttl>] [--dry-run]
     52             ascension <domain> -n <transferns> <port> [-d] [-p] [-s] [--minimum-ttl=<ttl>] [--dry-run]
     53             ascension -p | --public
     54             ascension -s | --debug
     55             ascension -s | --standalone
     56             ascension -h | --help
     57             ascension -v | --version
     58         
     59         Options:
     60             <domain>              Domain to migrate
     61             <port>                Port for zone transfer
     62             <transferns>          DNS Server that does the zone transfer
     63             --minimum-ttl=<ttl>   Minimum TTL for records to migrate [default: 3600]
     64             --dry-run             Only try if a zone transfer is allowed
     65             -p --public           Make records public on the DHT
     66             -s --standalone       Run ascension once
     67             -d --debug            Enable debugging
     68             -h --help         Show this screen.
     69             -v --version      Show version.
     70         ```
     71         
     72         Example use:
     73         ```
     74         # Transfers the sy TLD from ns1.tld.sy.
     75         ascension sy -n ns1.tld.sy.
     76         # Transfers the nu TLD from zonedata.iis.se with debug options enabled
     77         ascension nu -n zonedata.iis.se. -d
     78         ```
     79         
     80 Platform: UNKNOWN
     81 Classifier: Programming Language :: Python :: 3