The Tahoe-LAFS decentralized secure filesystem.
c56a0a4ba9
YAML, like JSON, is all-unicode. StorageFarmBroker.set_static_servers() is defined to take an all-unicode dictionary (the "storage:" key from private/servers.yaml), so the server_id keys it gets will be unicode. NativeStorageServer is defined to accept server_ids which are bytes (at least it is now). The tests were only passing bytes into set_static_servers(), whereas a real launch passed unicode in, causing a problem when NativeStorageServer tried to base32.a2b() the pubkey and choked on the unicode it received. This fixes set_static_servers() to convert the server_id to bytes, and changes NativeStorageServer to assert that it gets bytes. It also fixes the test to match real usage more closely. |
||
|---|---|---|
| docs | ||
| misc | ||
| src/allmydata | ||
| static | ||
| topfiles | ||
| .appveyor.yml | ||
| .coveragerc | ||
| .gitignore | ||
| .travis.yml | ||
| COPYING.GPL | ||
| COPYING.TGPPL.rst | ||
| CREDITS | ||
| Dockerfile | ||
| Makefile | ||
| MANIFEST.in | ||
| NEWS.rst | ||
| README.rst | ||
| relnotes.txt | ||
| setup.cfg | ||
| setup.py | ||
| Tahoe.home | ||
| tox.ini | ||
==========
Tahoe-LAFS
==========
Tahoe-LAFS is a Free and Open decentralized cloud storage system. It
distributes your data across multiple servers. Even if some of the servers
fail or are taken over by an attacker, the entire file store continues to
function correctly, preserving your privacy and security.
For full documentation, please see
http://tahoe-lafs.readthedocs.io/en/latest/ .
|readthedocs| |travis| |coveralls|
INSTALLING
==========
Pre-packaged versions are available for several operating systems:
* Debian and Ubuntu users can ``apt-get install tahoe-lafs``
* NixOS, NetBSD (pkgsrc), ArchLinux, Slackware, and Gentoo have packages
available, see `OSPackages`_ for details
* `Mac`_ and Windows installers are in development.
If you don't use an OS package, you'll need Python 2.7 and `pip`_. You may
also need a C compiler, and the development headers for python, libffi, and
OpenSSL. On a Debian-like system, use ``apt-get install build-essential
python-dev libffi-dev libssl-dev python-virtualenv``. On Windows, see
`<docs/windows.rst>`_.
Then, to install the most recent release, just run:
* ``pip install tahoe-lafs``
To install from source (either so you can hack on it, or just to run
pre-release code), you should create a virtualenv and install into that:
* ``git clone https://github.com/tahoe-lafs/tahoe-lafs.git``
* ``cd tahoe-lafs``
* ``virtualenv venv``
* ``venv/bin/pip install --editable .``
* ``venv/bin/tahoe --version``
To run the unit test suite:
* ``tox``
For more detailed instructions, read `<docs/INSTALL.rst>`_ .
Once ``tahoe --version`` works, see `<docs/running.rst>`_ to learn how to set
up your first Tahoe-LAFS node.
LICENCE
=======
Copyright 2006-2016 The Tahoe-LAFS Software Foundation
You may use this package under the GNU General Public License, version 2 or,
at your option, any later version. You may use this package under the
Transitive Grace Period Public Licence, version 1.0, or at your option, any
later version. (You may choose to use this package under the terms of either
licence, at your option.) See the file `COPYING.GPL`_ for the terms of the
GNU General Public License, version 2. See the file `COPYING.TGPPL`_ for
the terms of the Transitive Grace Period Public Licence, version 1.0.
See `TGPPL.PDF`_ for why the TGPPL exists, graphically illustrated on three
slides.
.. _OSPackages: https://tahoe-lafs.org/trac/tahoe-lafs/wiki/OSPackages
.. _Mac: docs/OS-X.rst
.. _pip: https://pip.pypa.io/en/stable/installing/
.. _COPYING.GPL: https://github.com/tahoe-lafs/tahoe-lafs/blob/master/COPYING.GPL
.. _COPYING.TGPPL: https://github.com/tahoe-lafs/tahoe-lafs/blob/master/COPYING.TGPPL.rst
.. _TGPPL.PDF: https://tahoe-lafs.org/~zooko/tgppl.pdf
----
.. |readthedocs| image:: http://readthedocs.org/projects/tahoe-lafs/badge/?version=latest
:alt: documentation status
:target: http://tahoe-lafs.readthedocs.io/en/latest/?badge=latest
.. |travis| image:: https://travis-ci.org/tahoe-lafs/tahoe-lafs.png?branch=master
:alt: build status
:target: https://travis-ci.org/tahoe-lafs/tahoe-lafs
.. |coveralls| image:: https://coveralls.io/repos/tahoe-lafs/tahoe-lafs/badge.png?branch=master
:alt: test coverage percentage
:target: https://coveralls.io/r/tahoe-lafs/tahoe-lafs?branch=master