Changes

Jump to: navigation, search

Testing Gramps

672 bytes added, 00:56, 29 March 2022
m
add-on > addon ( stick with one spelling )
=Test Automation=
Since 2022 we have test automation on [https://github.com/gramps-project/gramps/actions/workflows/gramps-ci.yml?query=branch%3Amaster GitHub Actions]. Status of all branches is [https://github.com/gramps-project/gramps/actions/workflows/gramps-ci.yml here].
 
GitHub Actions configuration is in [https://github.com/gramps-project/gramps/blob/master/.github/workflows/gramps-ci.yml .gramps-ci.yml].
 
What tests does GitHub Actions run? This is determined by the script line in [https://github.com/gramps-project/gramps/blob/master/.github/workflows/gramps-ci.yml .gramps-ci.yml].
nosetest3 runs all modules or folders named *[Tt]est.
 
* [https://docs.github.com/en/actions GitHub Actions Documentation]
 
=Test status=
As of Jan 2015 we don't have a record of tests executed, the platforms and environments they were run upon, and what code they covered. The only indirect evidence is available in open bugs, when people care to fill in these details. :-(
=Tests and frameworks used=
== Manual test plan ==
See [httphttps://sourceforgegithub.netcom/pgramps-project/gramps/source/ciblob/master/tree/TestPlan.txt TestPlan.txt] in gramps toplevel. (I believe this is only done at a major release (like Gramps version 4.0.0)).
== Specialized scripts for testing ==
See more specialized scripts in [httphttps://sourceforgegithub.netcom/pgramps-project/gramps/source/citree/master/tree/test/ test/], status unknown.
Contents of [httphttps://sourceforgegithub.netcom/pgramps-project/gramps/source/citree/master/tree/test/ test/] :
* GrampsLogger/
** ErrorReportAssistant_Test.py
==== test/runtest.sh ====
'''[httphttps://sourceforgegithub.netcom/pgramps-project/gramps/source/ciblob/master/tree/test/runtest.sh test/runtest.sh]''' - Report test for Gramps: Generate every report in every format. Runs all possible reports using the report cli interface, based on the [[example.gramps]] database. This test is not fully self-contained, in that it depends on various environment settings, such as your locale, your preferred name display formats, and your report options. Last, but not the least, the verification of the resulting reports is entirely manual.
Bugs tagged as [http://www.gramps-project.org/bugs/search.php?tag_string=found-by-runtest.sh found-by-runtest.sh]
===test/impex.sh===
'''[httphttps://sourceforgegithub.netcom/pgramps-project/gramps/source/ciblob/master/tree/test/impex.sh test/impex.sh]''' - Import/export test for Gramps.
From the file header:
== Unit testing ==
=== test/RunAllTests.py ===
'''[httphttps://sourceforgegithub.netcom/pgramps-project/gramps/source/ciblob/master/tree/test/RunAllTests.py test/RunAllTests.py]''' - Testing framework for performing a variety of unittests for Gramps. Runs out-of-tree (not in gramps/) testing code, by looking for any test/*_Test.py files and executing the test suites therein. See the current code in test/*_Test.py for example and python standard unittest docs.
{{man note|Starting with gramps4.x branch|these tests include non-automated unit tests only. The automated unit tests are all under gramps/.}}
|}
{{man note|Note from Nick Hall|Some of the merge tests are slow because they actually run Gramps from the command line to import and export files.<br><br>Extra packages and add-ons addons are required to run some of the tests. From memory, you will need the * Gramps addons** CliMerge and ** ExportRaw add-ons, *and the python packages.** libxml2, ** libxslt and ** mocking python packages. Some of these may not be available for python3 yet.}}
==== semi-interactive ====
! Comments
|-
|[httphttps://sourceforgegithub.netcom/pgramps-project/gramps/source/citree/master/tree/gramps/gen/relationship.py#l1889 gramps/gen/relationship.py]
|bgcolor="#ff8080"| To Do
|Relationship calculator
* [[Test_date_handlers#TO_CHECK]]
* [[Gramps_Performance#The_Test_Results]]
* [[Test Imports module]]
[[Category:Developers/Reference]]
[[Category:Developers/Quality Assurance]]

Navigation menu