Hello,
thank you.
My code is written in pure perl, mainly with Moose: I like object oriented
language because code is cleaner. So, no compilation is necessary and the
output is predictable.
Documentation is written at the end of each module with POD. One test is
dedicated to verify if all functions have their description.
I don't write malware :) and I try to have full code coverage with
automatic tests. I can't be sure that all is working fine, but I think that
it's a first step.
I will ask for an account and in the next day I will prepare the modules.
Working locally, normally I don't need a Makefile.PL to automate
installation and this is new for me to prepare.
Best regards,
Andrea
Il giorno mer 27 ott 2021 alle ore 17:02 Shlomi Fish <shlo...@shlomifish.org>
ha scritto:
> Hi Andrea!
>
> On Wed, 27 Oct 2021 09:06:07 +0200
> Andrea Tosoni <ludoteca.vesu...@gmail.com> wrote:
>
> > Hello,
> >
> > sorry : I'm asking if these modules can be a candidate to be posted on
> CPAN.
> >
>
> AFAIK, one is allowed to upload any FOSS and non-malware code to CPAN.
> That put
> aside, I have collected some resources about sw quality guidelines:
>
> https://github.com/shlomif/Freenode-programming-channel-FAQ/blob/master/FAQ_with_ToC__generated.md#what-are-some-best-practices-in-programming-that-i-should-adopt
>
> ; I also wrote about the overwhelming state of doc formats here:
> https://www.shlomifish.org/philosophy/computers/web/choice-of-docs-formats/
> .
>
> HTH.
>
> > Best regards,
> >
> > Andrea
> >
> >
> > Il giorno mer 27 ott 2021 alle ore 08:53 Shlomi Fish <
> shlo...@shlomifish.org>
> > ha scritto:
> >
> > > Hi Andrea!
> > >
> > > On Mon, 25 Oct 2021 21:41:21 +0200
> > > Andrea Tosoni <ludoteca.vesu...@gmail.com> wrote:
> > >
> > > > Hello,
> > > >
> > > > I'm Andrea Tosoni.
> > > >
> > > > Some years ago I started to write some perl scripts because I don't
> like
> > > to
> > > > re-made the same thing many times, especially when I have to write
> > > > documentation (I'm a hardware designer).
> > > >
> > > > In these years, scripts have become perl modules that work almost
> fine.
> > > >
> > >
> > > I read your message, but I don't understand what you wish to ask. What
> is
> > > the
> > > dilemma?
> > >
> > > > I started from POD idea: merge code and documentation. I added the
> > > > possibility to load parameters from an external file or by constants
> > > > defined in my code (VHDL or Verilog or some other language). I can
> also
> > > > calculate fields and iterate on lists or similar basic programming
> > > > operations.The markup is very easy. Documentation can be split in
> many
> > > > source files without order and it's merged at the end.
> > > >
> > > > I also added the possibility to load images (vectorial images for the
> > > > moment) and create tables.
> > > >
> > > > Today my output is a Framemaker file (in my company it is the tool
> for
> > > > official documentation) but I think to add the possibility to export
> in
> > > > Latex (because I like) and Word (because I have to support it).
> > > >
> > > > I don't know if these modules can help somebody else.
> > > >
> > > > Today I have to rework to remove deprecated modules, increase test
> > > coverage
> > > > and add some missing functionalities and this can be the moment to
> > > > organize in official modules, if you think that can be useful.
> > > >
> > > > Thank you for reading my mail.
> > > >
> > > > Best regards,
> > > >
> > > > Andrea Tosoni
> > >
> > >
> > >
> > > --
> > >
> > > Shlomi Fish https://www.shlomifish.org/
> > > https://shlomifishswiki.branchable.com/Self-Sufficiency/
> > >
> > > Chuck Norris killed all the members of the Spanish Inquisition, so they
> > > won’t
> > > come unexpectedly.
> > > — http://www.shlomifish.org/humour/bits/facts/Chuck-Norris/
> > >
> > > Please reply to list if it's a mailing list post -
> https://shlom.in/reply
> > > .
> > >
>
>
>
> --
>
> Shlomi Fish https://www.shlomifish.org/
> https://youtu.be/KxGRhd_iWuE - Never Give Up!!
>
> Unix was not designed to stop you from doing stupid things, because that
> would
> also stop you from doing clever things.
> — Doug Gwyn ( https://en.wikiquote.org/wiki/Unix )
>
> Please reply to list if it's a mailing list post - https://shlom.in/reply
> .
>
