Metadata-Version: 1.1
Name: bts-tools
Version: 0.3.1
Summary: BitShares delegate tools
Home-page: https://github.com/wackou/bts_tools
Author: Nicolas Wack
Author-email: wackou@gmail.com
License: UNKNOWN
Description: BitShares delegate tools
        ========================
        
        There are 2 tools currently provided:
        
        - command line util allowing to quickly build and run the BitShares client
        - web app allowing to monitor a running instance of the client and send
          an email or push notification on failure
        
        If you like these tools, please vote for `my
        delegate <http://digitalgaia.io/btstools.html>`_ to support further
        development, and feel free to visit my page for other delegate proposals
        at `digitalgaia.io <http://digitalgaia.io>`_. Thanks!
        
        Documentation
        -------------
        
        The main documentation for the tools, as well as a tutorial, can be found
        on `ReadTheDocs <http://bts-tools.readthedocs.org/>`_.
        
        Command-line client
        -------------------
        
        just run the ``bts`` script with the command you want to execute:
        
        ::
        
            $ bts -h
            usage: bts [-h] [-r]
                       {version,clean_homedir,clean,build,build_gui,run,run_gui,list,monitor,publish_slate}
                       [environment] [args [args ...]]
        
            following commands are available:
              - version          : show version of the tools
              - clean_homedir    : clean home directory. WARNING: this will delete your wallet!
              - clean            : clean build directory
              - build            : update and build bts client
              - build_gui        : update and build bts gui client
              - run              : run latest compiled bts client, or the one with the given hash or tag
              - run_gui          : run latest compiled bts gui client
              - list             : list installed bts client binaries
              - monitor          : run the monitoring web app
              - publish_slate    : publish the slate as described in the given file
        
            Examples:
              $ bts build          # build the latest bts client by default
              $ bts build v0.4.27  # build specific version
              $ bts run
              $ bts run debug  # run the client inside gdb
        
              $ bts build pts-dev v2.0.1  # build a specific client/version
              $ bts run seed-test         # run environments are defined in the config.yaml file
        
              $ bts build_gui
              $ bts run_gui
        
              $ bts publish_slate                      # will show a sample slate
              $ bts publish_slate /path/to/slate.yaml  # publish the given slate
        
        
            positional arguments:
              {version,clean_homedir,clean,build,build_gui,run,run_gui,list,monitor,publish_slate}
                                    the command to run
              environment           the build/run environment (bts, pts, ...)
              args                  additional arguments to be passed to the given command
        
            optional arguments:
              -h, --help            show this help message and exit
              -r, --norpc           run binary with RPC server deactivated
        
            You should also look into ~/.bts_tools/config.yaml to tune it to your liking.
        
        Monitoring web app
        ------------------
        
        To run the debug/development monitoring web app, just do the following:
        
        ::
        
            $ bts monitor
        
        and it will launch on ``localhost:5000``.
        
        For production deployments, it is recommended to put it behind a WSGI
        server, in which case the entry point is
        ``bts_tools.wsgi:application``.
        
        Do not forget to edit the ``~/.bts_tools/config.yaml`` file to configure
        it to suit your needs.
        
        Screenshots
        ~~~~~~~~~~~
        
        Monitoring the status of your running bts client binary
        
        .. figure:: https://github.com/wackou/bts_tools/raw/master/bts_tools_screenshot.png
           :width: 800
           :alt: Status screenshot
        
        You can host multiple delegates accounts in the same wallet, and check feed info
        
        .. figure:: https://github.com/wackou/bts_tools/raw/master/bts_tools_screenshot2.png
           :width: 800
           :alt: Info screenshot
        
        Monitoring multiple instances (ie: running on different hosts) at the same time,
        to have an overview while running backup nodes and re-compiling your main node.
        
        .. figure:: https://github.com/wackou/bts_tools/raw/master/bts_tools_screenshot3.png
           :width: 800
           :alt: Info screenshot
        
        
        
        .. This is your project NEWS file which will contain the release notes.
        .. Example: http://www.python.org/download/releases/2.6/NEWS.txt
        .. The content of this file, along with README.rst, will appear in your
        .. project's PyPI page.
        
        History
        =======
        
        0.3.1 (2015-11-01)
        ------------------
        
        * support for Muse clients
        * better feeds script. Process is now the following:
          - get the BTS/BTC valuation from Poloniex, CCEDK, Bter, Btc38 (configurable)
          - get the BTC/USD valuation from BitcoinAverage, with fallback on Bitfinex and Bitstamp
          - get the BTS valuation in other fiat currencies using Yahoo forex rates
          - get market indices using Yahoo, Google, Bloomberg (configurable)
        * can specify 'boost_root' option in build environment in config.yaml
        * minor bugfixes everywhere
        
        
        0.3 (2015-10-27)
        ----------------
        
        * first release with support for BitShares 2 clients (and graphene-based in general)
          use: bts2 build, bts2 run, bts2 run_cli, bts2 monitor, etc...
        * a lot of functionality still missing... Here be dragons!!
        
        
        0.2.11 (2015-09-26)
        -------------------
        
        * fix issue with BitShares 0.9.3 client
        * build environments can now specify the "debug" flag to produce debug builds
        * extremely preliminary support for graphene clients, only for the brave
        
        
        0.2.10 (2015-09-03)
        -------------------
        
        * added support for managing backbone nodes
        * new view in menu "network > backbone status" that shows the configured backbone nodes and
          whether we are connected to them or not
        * added monitoring plugins:
          - 'voted_in': monitors when a delegate is voted in or out
          - 'wallet_state': monitors when a wallet is opened/closed and locked/unlocked
          - 'fork': tries to detect when the client is being on a fork and/or out-of-sync
        * simplified config yaml file: there are now wildcards monitoring plugins you can use for most
          common tasks:
        
          - for delegate:
        
            + 'delegate': used to monitor an active delegate. This will activate the 'missed',
              'network_connections', 'voted_in', 'wallet_state', 'fork', 'version' and 'feeds'
              monitoring plugins
            + 'watcher_delegate': used to monitor a watcher delegate, i.e. without publishing
              any info (version, feeds) to the blockchain. This will activate the 'missed',
              'network_connections', 'voted_in', 'wallet_state' and 'fork' monitoring plugins
        
          - for seed nodes and delegate nodes, you don't have to specify required command-line args or
            monitoring plugins any longer, it is added automatically in function of the node type
        
        * added "bts deploy" command to copy built binary to specified ssh host(s)
        
        
        0.2.9 (2015-06-19)
        ------------------
        
        * feeds for composite indices are now priced in BTS
        * active feed providers can be configured in the config.yaml file
        
        
        0.2.8 (2015-06-10)
        ------------------
        
        * more robust feed monitoring
        
        
        0.2.7 (2015-06-09)
        ------------------
        
        * feeds for market indices are now fetched from Yahoo, Google and Bloomberg
        * added Poloniex feed provider for BTS/BTC
        * fixed monitoring of DACPLAY instances on linux
        
        
        0.2.6 (2015-06-05)
        ------------------
        
        * workaround for 0.2.5 not being installable from pypi
        
        
        0.2.5 (2015-06-05)
        ------------------
        
        * added feed for SHANGHAI market-pegged asset
        
        
        0.2.4 (2015-06-03)
        ------------------
        
        * added feed for NASDAQC, NIKKEI, HANGSENG market-pegged assets
        * list of visible feeds can be configured in config.yaml file
        
        
        0.2.3 (2015-06-02)
        ------------------
        
        * added feed for SHENZHEN market-pegged asset
        * fixed payroll plugin (contributed by @ThomasFreedman)
        
        
        0.2.2 (2015-05-04)
        ------------------
        
        * fixed slate publishing for BTS >= 0.9.0
        
        
        0.2.1 (2015-04-22)
        ------------------
        
        * fixed feeds publishing for BTS >= 0.9.0
        
        
        0.2 (2015-04-14)
        ----------------
        
        * now requires python3.4
        * API CHANGE: format of the config.yaml file has changed, and you will need to update it.
          Run "bts list" and it should tell you what to fix in your config file. For more details,
          see: http://bts-tools.readthedocs.org/en/latest/config_format.html#nodes-list
        * added support for building DVS and BTS client >= 0.9.0
        * added support for building PLAY client (pls)
        * internal refactoring and modularization of the monitoring plugins
        
        
        0.1.10 (2015-03-23)
        -------------------
        
        * modularized monitoring to make it easier to write monitoring plugins
        * more robust feed checking
        * added payroll distribution system, contributed by user Thom
        * general fixes and enhancements
        
        
        0.1.9 (2015-02-19)
        ------------------
        
        * allow to pass additional args to "bts run", eg: "bts run --rebuild-index"
        * fixed feeds due to bter being down
        * completed (for now) documentation and tutorial
        * tools display their version in footer of web pages, or using "bts version"
        
        
        0.1.8 (2015-02-11)
        ------------------
        
        * fixed minor quirks and annoyances
        * enhanced documentation and tutorial
        
        
        0.1.7 (2015-02-05)
        ------------------
        
        * fixed bugs
        * more documentation
        
        
        0.1.6 (2015-01-26)
        ------------------
        
        * started writing reference doc and tutorial
        * full support for DevShares
        * fixed issue with new naming of tags (bts/X.X.X and dvs/X.X.X)
        * include slate for btstools.digitalgaia as an example slate
        * send notifications grouped by clients (for multiple delegates in same wallet)
        * fixed tools for new API in 0.6.0 (blockchain_get_delegate_slot_records)
        
        
        0.1.5 (2015-01-06)
        ------------------
        
        * smarter caching of some RPC calls (improves CPU usage of the client a lot!)
        * automatically publish version of the client if not up-to-date
        * added ``pts`` command-line tool that defaults to building/running PTS binaries
        * new ``publish_slate`` command for the command-line tool
        * bugfixes / small enhancements
        
        
        0.1.4 (2014-12-21)
        ------------------
        
        * now publishes feeds for BitBTC, BitGold, BitSilver + all fiat BitAssets
        * full support for building and monitoring PTS-DPOS clients
        * preliminary support for building Sparkle clients
        * the usual bugfixes
        
        
        0.1.3 (2014-11-16)
        ------------------
        
        * renamed project from bitshares_delegate_tools to bts_tools
        * some fixes, up-to-date as of release date (bts: 0.4.24)
        
        
        0.1.2 (2014-11-09)
        ------------------
        
        * updated for building following rebranding BitSharesX -> BitShares
          (0.4.24 and above)
        
        
        0.1.1 (2014-11-03)
        ------------------
        
        * added view for connected peers and potential peers
        
        
        0.1 (2014-10-28)
        ----------------
        
        * first public release
        
Keywords: BitShares delegate tools
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
