Re: Thoughts on PyFCP

This is an OpenPGP/MIME signed message (RFC 4880 and 3156)
--===============1747319252==
Content-Type: multipart/signed; micalg=pgp-sha1;
 protocol="application/pgp-signature";
 boundary="TO6Fgo3U25c8mUrm6LNwMil4iFulAebdl"

This is an OpenPGP/MIME signed message (RFC 4880 and 3156)
--TO6Fgo3U25c8mUrm6LNwMil4iFulAebdl
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On 11/14/2013 01:43 PM, James Pearson wrote:
> I was browsing around Freenet's github profile this morning and ran acr=
oss
> PyFCP (lib-pyFreenet).  There were a few things that immediately jumped=
 out
> to me as projects I could work on, but given their scope I figured I'd =
get
> some feedback before investing the effort.
>=20
> First, I'd like to convert the documentation from epydoc to sphinx.  Sp=
hinx
> is much prettier by default, has a number of great themes, is not dead
> (Epydoc's last release was almost six years ago!), lends itself to
> user-documentation (not just API docs), and is supported by Read the Do=
cs,
> a fantastic documentation project that has become the standard for Pyth=
on
> projects.

Sounds good!

> Secondly, the package is in actuality many different things, tied toget=
her
> merely by subject (Freenet) and implementation language (Python); a goo=
d
> half of the readme is a description of the various projects.  Why shoul=
d
> someone wanting to work with the Freenet protocol in Python need to ins=
tall
> an IRC bot, or an XML-RPC server?  A split should, of course, consist o=
f a
> number of forks from the current HEAD, so as to maintain revision histo=
ry
> for each project.

Wow, that is incredibly crufty! An IRC bot for exchanging noderefs
should no longer even exist - automatically exchanging noderefs is
discouraged as it removes the need to socially engineer people to get
into a darknet. That sounds like a holdover from Freenet 0.5 days if
anything.

> (BTW, the 'requires' argument is misspelled 'requries' in the setup.py;=
 I
> imagine setuptools would complain about this any time you attempt to bu=
ild
> the package.)
> (BTW #2, what is the point of having separate -official and -staging
> repositories?  Is this not the point of branches?)

My understanding is that there are separate repositories because GitHub
does not support separate permissions for different branches within a
repository. I'm not sure if this is a legitimate reason. There's a fair
amount of momentum behind this setup, at least for fred, (it's in a
number of scripts) but I for one would be open to consolidation.

> My apologies if this is stepping on any toes; I'm not at all familiar w=
ith
> the development history of Freenet or PyFCP, so I am relying upon you t=
o
> point out any reasons things should stay as they are.

I am not aware of such toes or reasons. I know ArneBab reviewed the
library a few months ago, but if I recall correctly that may have been
focused on the FCP parts.


--TO6Fgo3U25c8mUrm6LNwMil4iFulAebdl
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)

iQIcBAEBAgAGBQJSiECsAAoJECLJP19KqmFuqnUQAIxBfOBZgPV4tyE3gyh+b+fx
6pLXgU44nV0+fU5IoW+FTXWbD8I2a1DxKOb8Cm4G4Ig5WnWrEz8suHTG512muJwX
xc+faE0KzoYMoWqMQjaAYF3qybaJBWsCI/Edw+Xi4JP/FAJ6uPJ4jKNzEcl5yiQA
ThVUTt72kDE6lNpajwJZzCuCoH9dRytyJYtBjh4wdK5CX172HbiEIYMWpGi5vDTJ
97AnzG6zZCD67kksA0utWpwEC6Q7K5voseuUAE/zQ2VlxDrjX9hDLw+OzOPzsV4z
cEuQWyXYlD3xTrqQ/naWpGaDaltMJEEFnWXPXgUUsS66niHLTs7ORoH49MA/y44+
JEevDRQZ+98iRCRGULXr/fIYFLvZsEBf/VaEul4YH9HThqm44vTMGCCNr1uNJqpu
PwdzA153Ilpn/bIodCjU9FyUeCw1O5v1EcoSAF/jzCCqpyO4Ra/Jdz3u9x7HrWGq
nMOqVjtz5huFvS47srItVHEsVA0cj/ItdoVA8I7pNwPxNvVeHPcu1vPqdSJs9uQ2
eRqb55F5Oagau8r5GRWpEy2IWxDdWGJU5MrdmfD+Zc7cWCNDvVI+zYvLOdsQrqS1
Ot/CsF7Xy3eSkVX+olodkF6clvFGHJmxVngu25o4KI8sgg+nVfvyyEAkMvWfgiRS
CSAkyzsvdZaSWuK54Tg1
=cMJr
-----END PGP SIGNATURE-----

--TO6Fgo3U25c8mUrm6LNwMil4iFulAebdl--

--===============1747319252==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
Tech mailing list
[email protected]
https://emu.freenetproject.org/cgi-bin/mailman/listinfo/tech
--===============1747319252==--