Re: Thoughts on PyFCP
Michael Pearce <michaelgpearce-/[email protected]> Fri, 15 Nov 2013 02:38:02 -0800 (PST)
| Newsgroups | gmane.network.freenet.technical |
|---|---|
| Message-ID | <[email protected]> |
--===============0732414644== Content-Type: multipart/alternative; boundary="-2135704657-87118247-1384511882=:62810" ---2135704657-87118247-1384511882=:62810 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Having just started playing with developing with Freenet, i had similar con= fusions. =A0Being a Rubyist, i started to look for a ruby library - unfortu= nately, there was no Gem. =A0Then when i grabbed the lib-rubyFreenet code o= ff github, it didn't work... it needed a ruby version many years old and se= emed to not quite do what it was supposed to. =A0It appears to be a sign of= no real developer community and possibly a lack of interest, which is kind= of sad.=0A=0A=0A=0AOn Thursday, November 14, 2013 10:43 AM, James Pearson = <[email protected]> wrote:=0A =0AI was browsing around Freenet's githu= b profile this morning and ran across PyFCP (lib-pyFreenet). =A0There 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.=0A=0AFirst, I'd like to convert the documentation from epydoc to s= phinx. =A0Sphinx is much prettier by default, has a number of great themes,= is not dead (Epydoc's last release was almost six years ago!), lends itsel= f to user-documentation (not just API docs), and is supported by Read the D= ocs, a fantastic documentation project that has become the standard for Pyt= hon projects.=0A=0ASecondly, the package is in actuality many different thi= ngs, tied together merely by subject (Freenet) and implementation language = (Python); a good half of the readme is a description of the various project= s. =A0Why should someone wanting to work with the Freenet protocol in Pytho= n need to install an IRC bot, or an XML-RPC server? =A0A split should, of c= ourse, consist of a number of forks from the current HEAD, so as to maintai= n revision history for each project.=0A=0A(BTW, the 'requires' argument is = misspelled 'requries' in the setup.py; I imagine setuptools would complain = about this any time you attempt to build the package.)=0A(BTW #2, what is t= he point of having separate -official and -staging repositories? =A0Is this= not the point of branches?)=0A=0AMy apologies if this is stepping on any t= oes; I'm not at all familiar with the development history of Freenet or PyF= CP, so I am relying upon you to point out any reasons things should stay as= they are.=0A=0AHappy anonymity,=0A=A0- James=0A___________________________= ____________________=0ATech mailing [email protected]=0Ahttps:= //emu.freenetproject.org/cgi-bin/mailman/listinfo/tech ---2135704657-87118247-1384511882=:62810 Content-Type: text/html; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable <html><body><div style=3D"color:#000; background-color:#fff; font-family:He= lveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif;fo= nt-size:10pt"><div><span>Having just started playing with developing with F= reenet, i had similar confusions. Being a Rubyist, i started to look = for a ruby library - unfortunately, there was no Gem. Then when i gra= bbed the lib-rubyFreenet code off github, it didn't work... it needed a rub= y version many years old and seemed to not quite do what it was supposed to= . It appears to be a sign of no real developer community and possibly= a lack of interest, which is kind of sad.</span></div><div class=3D"yahoo_= quoted" style=3D"display: block;"> <br> <br> <div style=3D"font-family: Hel= veticaNeue, 'Helvetica Neue', Helvetica, Arial, 'Lucida Grande', sans-serif= ; font-size: 10pt;"> <div style=3D"font-family: HelveticaNeue, 'Helvetica N= eue', Helvetica, Arial, 'Lucida Grande', sans-serif; font-size: 12pt;"> <di= v dir=3D"ltr"> <font size=3D"2" face=3D"Arial"> On Thursday, November 14, 20= 13 10:43 AM, James Pearson <[email protected]> wrote:<br> </font= > </div> <div class=3D"y_msg_container"><div id=3D"yiv8541731753"><div dir= =3D"ltr">I was browsing around Freenet's github profile this morning and ra= n across PyFCP (lib-pyFreenet). There were a few things that immediat= ely jumped out to me as projects I could work on, but given their scope I f= igured I'd get some feedback before investing the effort.<div>=0A=0A<br></d= iv><div>First, I'd like to convert the documentation from epydoc to sphinx.= Sphinx 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 t= o user-documentation (not just API docs), and is supported by Read the Docs= , a fantastic documentation project that has become the standard for Python= projects.</div>=0A=0A<div><br></div><div>Secondly, the package is in actua= lity many different things, tied together merely by subject (Freenet) and i= mplementation language (Python); a good half of the readme is a description= of the various projects. Why should someone wanting to work with the= Freenet protocol in Python need to install an IRC bot, or an XML-RPC serve= r? A split should, of course, consist of a number of forks from the c= urrent HEAD, so as to maintain revision history for each project.</div>=0A= =0A<div><br></div><div>(BTW, the 'requires' argument is misspelled 'requrie= s' in the setup.py; I imagine setuptools would complain about this any time= you attempt to build the package.)</div><div>(BTW #2, what is the point of= having separate -official and -staging repositories? Is this not the= point of branches?)</div>=0A=0A<div><br></div><div>My apologies if this is= stepping on any toes; I'm not at all familiar with the development history= of Freenet or PyFCP, so I am relying upon you to point out any reasons thi= ngs should stay as they are.</div>=0A=0A<div><br></div><div>Happy anonymity= ,</div><div> - James</div></div></div><br>____________________________= ___________________<br>Tech mailing list<br><a ymailto=3D"mailto:Tech@freen= etproject.org" href=3D"mailto:[email protected]">Tech@freenetproject.= org</a><br><a href=3D"https://emu.freenetproject.org/cgi-bin/mailman/listin= fo/tech" target=3D"_blank">https://emu.freenetproject.org/cgi-bin/mailman/l= istinfo/tech</a><br><br></div> </div> </div> </div> </div></body></html> ---2135704657-87118247-1384511882=:62810-- --===============0732414644== 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 --===============0732414644==--