Méretezés

This is an ancient page about Gnucash's code size.

Néha nagyon érdekes lehet egy szoftverprojekt mögött meghúzódó kód méretének vizsgálata. Nem meglepő az érdeklődés: végül is ez a könyvelés. A GnuCash az évek során egy kis, praktikus elektronikus csekkfüzetből egy meglehetősen nagy, és funkciókban bővelkedő asztali alkalmazássá nőtte ki magát.

A GnuCash jelenleg több mint egyharmadmillió kódsorból áll, amely több mint ezer fájlban oszlik meg. Huszonhárom nyelvre fordították le, és több mint 139 szerzőnek és közreműködőnek köszönhetjük.

If you've had trouble swimming through that mass of source code, think of it this way: printed out on paper, and bound into volumes, it would amount to several dozen copies of Tolstoy's "War and Peace", roughly a bookshelf-width's worth of source code.

Mind you, this is source code (and docs) crafted and debugged by actual humans, this is *not* autogenerated code. Tools (such as glade or swig) can generate gazillions of lines of code automatically; I'm not counting those. Every last line counted here was typed in, edited, indented, tweaked, multiple times, by human hands.

Given that we have about 400 outstanding bugs in bugzilla, that works out to about one bug per thousand lines of code, or one bug per 50 pages of printout. This bug count is actually not atypical for software projects; it is near the norm.

Az alábbi táblázat a GnuCash fejlesztési projekt néhány korábbi kódsor- és fájlszámát mutatja be. Vegye figyelembe, hogy nem számoltuk bele az összes kódot: például a Makefile állományok és a configure.in és autogen.sh nem számítanak bele. Ezenkívül az automatikusan generált fájlok sem számítanak bele és a más projektekből „kölcsönvett” fájlok sem. Nem számítanak bele a kísérleti fájlok, a különböző perl szkriptek, konverterek, kiegészítők és segédprogramok sem. Végül a glade fájlok sem számítanak bele, bár a teljes grafikus felhasználói felület nagy része a glade fájlokban van leírva.

Note also that KLOC's are not a good metric of programmer productivity, nor even that wc is a good way of counting KLOC's. Much better measures are complexity metrics, which, for example, count the number and size of if-then-else blocks, or the number and size of all blocks, or the number of math operators per statement. Maybe someday we'll run one of those tools on this code. For now, this is what we have. On the other hand, we've attempted to count only those files that contain human-edited code, that is, files that are directly edited by humans. The point of doing this is to avoid artificially inflating the KLOC counts by counting automatically generated code (which is why the glade files are not counted: they are large and automatically generated).

Minden cella a következőt mutatja:

number of *c and *.h and *.scm files (KLOCS in *.c + KLOCS in *.h + KLOCS in *.scm). If there are no *.scm files in the directory, then only (KLOCS in *.c + KLOCS in *.h) are displayed. If there is only one number in the parenthesis, it is the approriate KLOC count for that statistic.

where KLOC == kilo-lines-of-code, as reported by wc. As noted above, wc is not a terribly good code metric, but it is what we have handy.

engine

Contents of the src/engine and the include directories. The engine was split out from the motif code in version 1.1. The data storage backend (file-io, sql) was split out in the course of version 1.5.

backend

Contents of the src/backend directory (version 1.7 and later) or of src/engine/file, src/engine/sql (version 1.6 and earlier).

register

Contents of the src/register directory (version 1.6 and earlier) or src/register/register-core (version 1.7 and later). The register was split out as a separate component from the motif code in version 1.1. As can be seen from the stats, the register code has been fairly stable. At version 1.7 and later, this cell shows a second count: the number of lines of code in src/register/register-gnome (previously counted as part of gnome).

ledger

*.c, *.h files in the src directory only (version 1.6 and earlier) or src/register/ledger-core (version 1.7 and later).

motif

Contents of the src/motif directory (version 1.2 and earlier). The motif version of the code was discontinued after version 1.2, after most of the non-gui code was moved to either the engine, the register or the ledger.

gnome

Contents of src/gnome plus src/register/gnome (version 1.6 and earlier). For version 1.7 and later, this consists of src/gnome, src/gnome-search and src/gnome-util

misc app

Contents of miscellanous application-related directories (version 1.7 and later): src/app-file, src/app-utils, src/calculation, src/core-utils, src/gnc-module, src/network-utils, src/tax/us.

import-export

Code to import and export various file formats: contents of the src/import-export directory.

reports

Code to generate reports and graphs: contents of the src/reports directory.

scheme

scheme and guile code in directories src/scm plus src/guile (version 1.6 and earlier). In version 1.7 and later, much of this code went into reports, import/export, and into indiovidual modules; thus only miscellaneous code remains.

business

Code to add small-business features: contents of the src/business directory.

test

Code to peform automated regression tests: contents of the src/*/test directories.

docs

English-language-only user documentation, including on-line help and manual (html, sgml or xml). For version 1.8.4 and later, the number below the bar counts the translated, non-english docs (currently de, es, fr, pt_PT). Both of these numbers are somewhat hard to count, because of fairly large format churns, and multiple competing versions.

internal txt

The number of design documents and README files aimed at developers. This includes *.txt files, *.texinfo files and README.* files in all subdirectories. For version 1.7 and later, only those in the src subdirectory are counted (leaving out some half-dozen scattered elsewhere).

Nyelv

The number of languages that the application messages have been translated to (the number of po/*.po files). In parenthesis, the number of messages in the message files (grep msgstr po/*.po |wc), in thousands.

Author Credits

The number of people credited in the AUTHORS file (version 1.6 and later) or the README file (earlier versions). These include lead developers, patch submitters and national-language translators. This includes additional credits listed in the gnucash-docs/AUTHORS file that are not listed in the main gnucash/AUTHORS file.

Copyright © 2001–2023 The GnuCash Project

Szerver és e-mail kimaradási jelentés a következő címre: irc://irc.gimp.net/gnucash

Fordítási problémák? Kapcsolat: gnucash-devel@gnucash.org