Python FCPv2 library and utilities
Clone or download
ArneBab Merge pull request #20 from ArneBab/communication_primitives
Communication primitives part 3: Real Implementation
Latest commit 70b0ea2 Oct 25, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.bugs babcom: polish Apr 14, 2016
artwork added the first version for an activelink. Nov 4, 2014
doc move confidential messages to later May 15, 2016
fcp fcpupload: implement spawn and teardown Aug 12, 2016
freenet use the local appdirs Aug 12, 2016
manpages manpages: warn user about outdated man pages Feb 27, 2015
.gitignore Ignore *.pyc May 7, 2009
.hgsigs Added signature for changeset 0a2ce55e46ac Jul 31, 2016
AUTHORS Standardize package name to pyFreenet in doc Feb 27, 2015
BUGS This check-in constitutes the release of version 0.2 Jun 16, 2006
CHANGELOG update version to 0.3.4 and update CHANGELOG Apr 10, 2016
COPYING Standardize package name to pyFreenet in doc Feb 27, 2015
CREDITS This check-in constitutes the release of version 0.2 Jun 16, 2006
INSTALL Standardize package name to pyFreenet in doc Feb 27, 2015
INSTALL.es pyFreenet: README and INSTALL files translated to spanish. Jul 7, 2006
LICENSE_appdirs.txt move spawning a Freenet node into freenet.spawn Aug 12, 2016
README.es Standardize package name to pyFreenet in doc Feb 27, 2015
README.freedisk Allow retrieve of CHK@blahblah.ext, the .ext gets stripped May 27, 2006
README.md readme as markdown Sep 29, 2018
Review.txt Remove unused historic files and code. Jan 12, 2015
appdirs.py Ran 2to3 on fcp and *.py. Jul 1, 2016
babcom.py setup: add classifiers to show that this is Python3 only right now. Aug 12, 2016
copyweb copyweb: Ran 2to3 and updated shebang. Jul 1, 2016
fcp_to_mrtg_bridge.py Ran 2to3 on fcp and *.py. Jul 1, 2016
fcp_to_rrdtool_bridge.py Ran 2to3 on fcp and *.py. Jul 1, 2016
fcpgenkey Updated the shebang of fcpgenkey. Jul 1, 2016
fcpget fcpget: Updated to Python 3. Jul 1, 2016
fcpinvertkey fcpinvertkey: Updated the shebang. Jul 1, 2016
fcpnames fcpnames: Updated to Python 3. Jul 1, 2016
fcpput fcpput: Updated to Python 3. Jul 1, 2016
fcpredirect fcpredirect: Updated the shebang. Jul 1, 2016
fcpupload fcpupload: Updated to Python 3. Jul 1, 2016
fcpxmlrpc.cgi Explicitly use Python 2 in executable scripts Jan 6, 2015
fproxyproxy fpproxyproxy: Updated to Python 3. Jul 1, 2016
freedisk Replace pyFCP references found in code with pyFreenet Feb 27, 2015
freedisk.conf Start of development for 'freedisk', the 'freenetfs' filesystem. May 26, 2006
freesitemgr Fix of DDA test, still one thing broken. Jul 1, 2016
newbase60.py add newbase60.py, because it makes the doctest reports nicer Jul 19, 2016
pyNodeConfig pyNodeConfig: Updated to Python 3. Jul 1, 2016
rrdtool_freenet.sh.example Added example of using fcp_to_rrdtool_bridge.py: rrdtool_freenet.sh.e… Jun 29, 2007
setup.py setup: it actually requires wheel Aug 12, 2016
test.py Ran 2to3 on fcp and *.py. Jul 1, 2016
testwatchglobal.py old file for py3 Jul 1, 2016
tutorial.py tutorial.py: Updated to Python 3. Jul 1, 2016

README.md

README file for pyFreenet

Currently outdated: Not yet reviewed changes can be found in https://github.com/ArneBab/lib-pyFreenet-staging/tree/py3.

fcpVersion = "0.3.4"

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

Install via

$ pip3 install --upgrade --user pyFreenet3

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

$ fcpupload --spawn <file>

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

This pyFreenet 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
    • 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 'fcp', 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.