README file for pyFreenet3

PyFreenet3 is a suite of command-line freenet applications, as well as a powerful Python library, for Freenet.

Contribute at https://github.com/freenet/pyFreenet

Install via::

$ pip3 install --upgrade --user pyFreenet3 (this requires python3 and python3-setuptools and python3-distutils installed)

To just upload a file into Freenet (currently only on GNU/Linux), install a Java JRE or JDK and then use::

$ fcpupload --spawn `

It starts a Freenet node, uploads the file and returns the key to access the file via Freenet.

If you need a library for Python 2, please use pyFreenet.

This pyFreenet3 release includes:

• command-line freenet client applications, which will get installed as executable commands in your PATH, including:

  • freesitemgr - a simple yet flexible freesite management utility
  • fcpnames - utility for managing the new 'name service' layer
  • fproxyproxy - an experimental http proxy that sits on top of fproxy, and translates human-friendly site names transparently
  • fcpget - a single key fetcher
  • fcpput - a single key inserter
  • fcpupload - fcpput with more convenient defaults
  • fcpgenkey - a keypair generator
  • fcpinvertkey - generate new SSK/USK keypairs
  • fcpredirect - insert a redirect from one 'key' to another 'key'.
  • copyweb - download a page from a website with all resources.

• python package 'fcp3' and 'freenet3', containing classes for interacting with freenet.

• an XML-RPC server for freenet access, which can be run standalone, or easily integrated into an existing website

To get good API documentation, run::

$ epydoc -n "pyFreenet API manual" -o html fcp

When you install this package (refer INSTALL), you should end up with a command 'freesitemgr' on your PATH.

'freesitemgr' is a console-based freesite insertion utility which keeps your freesite configs and status in a single config file (~/.freesitemgr, unless you specify otherwise).

Just use 'freesitemgr add FOLDER' to upload a website into Freenet.

Invoke 'freesitemgr -h' (or if on windows, 'freesitemgr.py -h') and read the options.

release a new version::

python3 setup.py sdist; python3 -m twine upload dist/pyFreenet3-0.5.5.tar.gz