git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 0/2] gitweb: Add support for running gitweb as FastCGI script

From
Jakub Narebski <jnareb@gmail.com>
Date
May 14, 2010, 10:53 UTC
Message-ID
<201005141253.46956.jnareb@gmail.com>
In-Reply-To
<20100513131016.GA5250@screwed.box>
On Thu, 13 May 2010, Peter Vereshagin wrote:
> 2010/05/11 15:51:15 +0200 Jakub Narebski <jnareb@gmail.com> => To Peter Vereshagin :
>> On Tue, 11 May 2010, Peter Vereshagin wrote:
>>> 2010/05/11 12:58:50 +0200 Jakub Narebski <jnareb@gmail.com> => To Peter Vereshagin :
Show 17 quoted lines
>>>>>> I have changed this 'exit' to non-local goto to toplevel.  It could be
>>>>>> done instead by redefining 'exit' subroutine, like shown below, but I
>>>>>> feel that would be hacky if you can change gitweb code (it is not
>>>>>> black box you should not touch).
>>>>> 
>>>>> Right, one shouldn't ever redefine perl built-in functions. I did only because
>>>>> of no other way to 'get things working'
>>>> 
>>>> Why not?  For example CGI::Carp redefines 'die' to log errors.
>>> 
>>> Ouch, sorry, I meant 'last' or something like that.
>> 
>> "last" / "last LABEL" is a command, not a function, therefore you cannot
>> redefine it.
> 
> It's a flow control statement, thus it is a built-in thing; same way as any other
> functions are explained in a 'perldoc -f'.

`perldoc -f exit` says 'The exit() function ...', while `perldoc -f last` says 'The "last" command is like the "break" statement in C ...'.

> Therefore it is treated by monkeys crowd as function. It's obvious for me to
> stay out here (here != maillist) yet in such an environment.
Sidenote: The 'Monkey patch' article on Wikipedia says that the
technique of adding method dirctly to class instead of subclassing was
originally called "guerilla patching", then it mutated into "gorilla
patching", and finally into "monkey patching".
Show 5 quoted lines
> Anyway, I compare "last" here  with exit() and die() which look to user just
> like the same kind of: the flow control statements. I guess any Perl user who
> makes things like gitweb (at least as a CGI-only app) shouldn't care about
> such an internal difference of flow control statements those are
> hidden/incapsulated inside the implementation of those statements?

Perl hacker should know the difference between command such as "last" and "next", and functions such as exit() and die(). Just like C programmer should know the difference between "break" statement and exit() function.

> Needless to mention that the 'last LABEL' ( goto, gosub, ... named them )  is a
> bad and a very deprecated style which is every schoolboy is aware about
> nowadays to keep from using in the application [...]

Not true. The 'last LABEL;' command is very useful to exit nested loops. If used right it makes code much simpler (allowing to avoid extra flag variable and/or complicating loop conditional). If I remember correctly in O.-J. Dahl, Edsger W. Dijkstra, C. A. R. Hoare "Structured Programming" the programming language described includes "break <n>" statement, with similar purpose as "last LABEL" in Perl.

Note also that Dijkstra wrote in seminal article "Go To Statement Considered Harmful" that the problem with abused 'goto' is that it compilcates and muddles control flow of program. But there are legitimate uses of 'goto' that make the program simpler to understand, and not harder,... among those is handling exceptions.

Show 16 quoted lines
>>>> I know this from painful experience of trying to find bug in a
>>>> test... when the error was in parsing file in 'do $file;'.
>>> 
>>> I handle them just fine like in any other CGI program using
>>> CGI::Carp:fatalsToBrowser. Are you about to 'make test' via the http? ;-)
>> 
>> I don't think you understand what I wanted to say there.
>> 
>> If you don't check if there were parse errors from 'do $file;', you can
>> get later some error message which is totally unrelated to the parsing
>> error.  If you don't know or forget that you should check $@ after 
>> 'do $file;', and are unlucky, you can chase elusive error from there
>> to kingdom come...
> 
> Got it, it's about the inclusion failure via the do() which is the
> development, not a production, situation.

Yes, it is a problem mainly in developemtn, where changes to the file included via "do <file>" might introduce parsing errors.

> I think this should be an adjective noun to use the both strict and
> the warnings?

The problem is that "do <file>;" is similar to "eval `cat <file>`;" (except that it's more efficient and concise), it that it silences parsing errors. From `perldoc -f do`:

  If "do" cannot read the file, it returns undef and sets $! to the error.
  If "do" can read the file but cannot compile it, it returns undef and sets
  an error message in $@.   If the file is successfully compiled, "do"
  returns the value of the last expression evaluated.
> And yes, since it's about development but not production use, die is just fine
> in the inclusion code like this:
> 
> eval( 'use Module;' ); die $@ if $@;
Wrong!
 
Show 7 quoted lines
> as always, require() can do the trick, not to mention usual 
> 
> use Module;
> 
> This all will cause die() when it's necessary as only the application developer
> knows how strict is the dependence on the Module. In some cases, application
> can work without some Module but it's just better with it.

First, both "use Module;" and "require Module;" (and "require '<file>';") do automatic error checking and raise an exception if there is problem.

Second, "use Module <LIST>;" is equivalent to
  BEGIN { require Module; import Module <LIST>; }
and therefore it doesn't make sense to use it for conditional inclusion.

Therefore, to load Perl module / file, if you can 'die' you can simply use

  require "<file>";

If you don't want to die, but want to know if loading and parsing file succeeded or not, you should use the following syntax:

  if (eval { require "<file>"; 1 }) {
    ...
  } else {
    ...
  }

If you want to use 'do "<file>";' (it is preferred in some circumstances), you really should check for error conditins:

  unless (my $return = do "<file>") {
    if ($@) {
       # couldn't parse <file>
    } elsif (!defined $return) {
       # couldn't do <file> (e.g. couldn't find <file>)
    }
    ...
  }
[...]
Show 9 quoted lines
>> PSGI is interface, Plack is reference implementation.  You can run PSGI
>> app on any supported web server; this includes running PSGI apps on
>> FastCGI.
> 
> Existing problem FCGI::Spawn for is not the PSGI applications to be run as a
> FastCGI, but the bunch of existing CGI.pm applications (even gitorious) need
> to be more effective with the widest-spread protocol FastCGI. Best without any
> patching of the application, deployed the same simple way as with apache's cgi
> implementation.

Gitorious is in Ruby, therefore is not a CGI.pm application, as it is not even in Perl.

By using Plack::App::CGIBin you can load CGI scripts from a directory and convert them into a <persistent> PSGI application. You can use Plack::App::WrapCGI to convert single CGI script into PSGI application. You can use Plack::Buuilder's domain specific language to join (map) together a bunch of PSGI applications (in different paths) in a single app (via Plack::App::URLMap).

You can then run PSGI application (for example the PSGI app which loads CGI apps via Plack::App::CGIBin) on any supported web server, which includes FCGI (FastCGI).

-- 
Jakub Narebski
Poland
Previous: Peter VereshaginNext: Peter Vereshagin
Message 21 of 30 in “gitweb: Add support for running gitweb as FastCGI script”
  1. 0/2 gitweb: Add support for running gitweb as FastCGI scriptJakub Narebski, May 7, 2010
  2. 1/2 gitweb: Put all per-connection code in run() subroutineJakub Narebski, May 7, 2010
  3. 2/2 gitweb: Add support for FastCGI, using CGI::FastJakub Narebski, May 7, 2010
  4. 2/2 gitweb: Add support for FastCGI, using CGI::FastJakub Narebski, May 8, 2010
  5. Jakub NarebskiMay 8, 2010
  6. Eric WongMay 9, 2010
  7. Ævar Arnfjörð BjarmasonMay 9, 2010
  8. Jakub NarebskiMay 9, 2010
  9. Peter VereshaginMay 9, 2010
  10. Jakub NarebskiMay 9, 2010
  11. Peter VereshaginMay 10, 2010
  12. Jakub NarebskiMay 10, 2010
  13. Peter VereshaginMay 11, 2010
  14. Petr BaudisMay 11, 2010
  15. Jakub NarebskiMay 11, 2010
  16. Peter VereshaginMay 11, 2010
  17. Jakub NarebskiMay 11, 2010
  18. Peter VereshaginMay 13, 2010
  19. Ævar Arnfjörð BjarmasonMay 13, 2010
  20. Peter VereshaginMay 14, 2010
  21. Jakub NarebskiMay 14, 2010
  22. Peter VereshaginMay 14, 2010
  23. Jakub NarebskiMay 14, 2010
  24. Jakub NarebskiMay 14, 2010
  25. Peter VereshaginMay 15, 2010
  26. Jakub NarebskiMay 15, 2010
  27. Peter VereshaginMay 16, 2010
  28. Jakub NarebskiMay 18, 2010
  29. Petr BaudisMay 16, 2010
  30. Petr BaudisMay 15, 2010

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.