FOSSology

{{toc}}

h1. Basic functional Test Cases based on the top menu items

Return to [[Manual Test Cases]].

Return to [[20-specific Test Suite]].

h2. Homepage

table{border:5px, color:black}.

|_.Purpose | To check that the basic user functionality of the home page works |

|_.Dependencies | A working server to test on |

table{border:1px solid black}.

|_. Step |_.Action |_.Expected Results|

|1. |  Open FOSSology UI (http://<server>/repo/)| FOSSology loads with a "Welcome" message; the text of the page makes sense and doesn't contain typos. |

|2. |  Select "Home" menu | The same FOSSology page re-loads successfully. There are still only a limited number of menu options. |

|3. |  Select "Help" menu | Several sub-menus appear and are selectable |

|4. |  Select "Help -> About" menu | Text explaining FOSSology is displayed, it makes sense, and there are no typos. |

|5. |  Select "Help -> Documentation" menu | The page for User Documentation is displayed, it makes sense, and there are no typos. |

|6. |  Select "Help -> Getting Started" menu | A page explaining the overview of FOSSology is displayed, it makes sense, and there are no typos. |

|7. |  Select "Help -> Debug" menu | Several sub-menus appear and are selectable |

|8. |  Select "Help -> Debug -> Debug Menus" menu | A page is displayed explaining the functionality, it makes sense, and there are no typos.  There is a button to Enable Full Debugging. |

|9. |  Select the "Enable" button | The page is re-displayed and full debugging enabled.  A button to Disable Full Debugging is now displayed. |

|10. |  Select the "Disable" button | The page is re-displayed and full debugging disabled.  A button to Enable Full Debugging is again displayed. |

|11. |  Select "Help -> Debug -> Global Variables" menu | A page is displayed with the global variables, it makes sense, and there are no typos. |

|12. | Select the login link.  Enter your username and password and select the login button. | The system logs you in and many more menu items now appear. |

h2. Upload 

table{border:5px, color:black}.

|_.Purpose | To test the upload functionality via various mechanisms   |

|_.Dependencies | A working server to test on |

table{border:1px solid black}.

|_. Step |_.Action |_.Expected Results|

|1. | Select "Upload -> Instructions" menu | A page is displayed with upload instructions, it makes sense, all the links work, and there are no typos. |

|2. | Select "Upload -> From File" menu and click upload button | The page does not do anything since there was nothing entered. |

|3. | Click on various checkboxes and click the upload button | The page does not do anything since there was nothing entered. |

|4. | Select the browse button and select a file; click the upload button | The page is re-loaded and a message indicating your file was uploaded is displayed.  Note the upload number. |

|5. | Select the browse button and select a different file; select various checkboxes and click the upload button | The page is re-loaded and a message indicating your file was uploaded is displayed.  Note the upload number. |

|6. | Select "Upload -> From Server" menu and click upload button | The page does not do anything since there was nothing entered. |

|7. | Click on various checkboxes and click the upload button | The page does not do anything since there was nothing entered. |

|8. | -TBD - how do we get something to the server- Select one directory or one file on the server, please make sure the user 'fossy' has the permission to read this directory  or this file; click the upload button | The page is re-loaded and a message indicating your file was uploaded is displayed.  Note the upload number. |

|9. | -TBD - do it again- In order to upload all the files which have the postfix, e.g. /home/xxx/*.dsc, enter /home/xxx/*.dsc; click the upload button | The page is re-loaded and a message indicating your file was uploaded is displayed.  Note the upload number. #1191|

|10.| -TBD - try different alphabetized options- *the function about alphabetized sub-folders for organization is removed in 2.0* | |

|11.| Select "Upload -> From URL" menu and click upload button | The page does not do anything since there was nothing entered. |

|12.| Enter a bogus url | A message is displayed indicating the bad url and the page does not do anything. |

|13.| Click on various checkboxes and click the upload button | The page does not do anything since there was nothing entered. |

|14.| Enter a valid url and click the upload button | The page is re-loaded and a message indicating your file was uploaded is displayed.  Note the upload number. |

|15.| Enter another valid url, enter various optional information, select various checkboxes and click the upload button | The page is re-loaded and a message indicating your file was uploaded is displayed.  Note the upload number. |

|16.| Select "Upload -> One-Shot License Analysis" menu and click analyze button | The page does not do anything since there was nothing entered. |

|17.| Select the browse button and select a file; click the analyze button | The page is re-loaded and a message indicating your file was analyzed is displayed. The license(s) found in the file is displayed. |

|18.| Select the browse button and select a different file; click the analyze button | The page is re-loaded and a message indicating your file was analyzed is displayed.  The license(s) found in the file is displayed. |

|19.| Select "Upload -> One-Shot Copyright ... Analysis" menu and click analyze button | The page does not do anything since there was nothing entered. |

|20.| Select the browse button and select a file; click the analyze button | The page is re-loaded and a message indicating your file was analyzed is displayed. The copyright(s), email(s), and URL(s) found in the file are displayed. |

|21.| Select the browse button and select a different file; click the analyze button | The page is re-loaded and a message indicating your file was analyzed is displayed.  The copyright(s), email(s), and URL(s) found in the file are displayed. |

h2. Jobs

table{border:5px, color:black}.

|_.Purpose | To test the basic functionality of jobs and scheduling |

|_.Dependencies |    |

table{border:1px solid black}.

|_. Step |_.Action |_.Expected Results|

|1. | Click on the upload link for one of your uploads | The UI should display "Show Jobs" page with your requested uploads and the right number of jobs: ununpack & adj2nest, agent 1, agent 2, etc.  | 

|2. | When all the jobs have been completed, click the job # in the far left to view the log files for each | Verify all the jobs ran without any fatal errors |

|3. | Return to the "Show Jobs" page and click on the upload name to browse | The UI should display your upload in the "Browse" page |

|4. | Click the link 'View' besides the uploaded file on the 'Browse' page | Get the file contents of the file you have already uploaded. |

|5. | Repeat Steps 1-4 for all your uploads | The system behaves expectedly. |

h2. Search

table{border:5px, color:black}.

|_.Purpose | To test the basic functionality of search |

|_.Dependencies |    |

table{border:1px solid black}.

|_. Step |_.Action |_.Expected Results|

|1. | Click on the menu [Search] and enter a file name search-file% | You get a list of files which have a prefix 'search-file' |

|3. | Click on the menu [Search] and enter a file name plugins | You get a list of directories which are plugins |

|4. | You can set other conditions yourself and search them | You should get what you expect |

h2. Browse

table{border:5px, color:black}.

|_.Purpose | To test the basic functionality of browsing uploads and folders |

|_.Dependencies |    |

table{border:1px solid black}.

|_. Step |_.Action |_.Expected Results|

|1. | On the 'Browse' page, click on the package name for one of the previous uploads | You can browse through this package recursively (if the upload is one file, you can not get through it) |

|2. | On the 'Browse' page, click on the link 'view' under one upload | You will get the text content of this upload |

|3. | On the 'Browse' page, click on the link 'info' under one upload | You will get the mimetype info/pfile id/Repository ID/etc of this upload |

|4. | On the 'Browse' page, click on the link 'Download' under one upload | A popup window will appear for you to download; check that the file downloads correctly to your local system. |

|5. | On the 'Browse' page, click on the link 'History' under one upload | The job view page of this upload will be displayed |

|6. | On the 'Browse' page, click on the link 'Compare' under one upload | You can compare this upload with others (for how to compare, see http://www.fossology.org/projects/fossology/wiki/Nomos_diff) |

h2. Organize

table{border:5px, color:black}.

|_.Purpose | To test the basic functionality of organizing files and folders |

|_.Dependencies | |

table{border:1px solid black}.

|_. Step |_.Action |_.Expected Results|

|1. | Click on [Organize]-->[Folders]-->[Create] menu to create a folder 'test1' under 'Software Repository' folder, set the folder description as 'test description'; click on 'Create!' link | You should now see the 'test1' folder under 'Software Repository' folder when you click on the [Browse] menu |

|2. | Click on [Organize]-->[Folders]-->[Create] menu to create one folder 'test1' under 'Software Repository' folder, set the folder description as 'test description #2'; click on 'Create!' link | You should get an error message indicating that the folder already exists; when clicking the [Browse] menu, you shoud not see two 'test1' folders under the 'Software Repository' folder. |

|3. | Click on [Upload]-->[From File] menu to the 'upload from file' page; select the target folder as 'test1', select one file locally, set the description for this upload as 'dup upload desc', set viewable name for this upload as 'dup_upload'; click on the link 'Upload'. | A notice indicating the file is being uploaded is displayed with the upload id. |

|4. | Click on the upload link for your job | The UI should display "Show Jobs" page |

|5. | When all the jobs are completed, click the job # in the far left to view the log files for each | Verify all the jobs ran without any fatal errors |

|6. | Return to the show jobs page and click on the upload name to browse | The UI should display your upload in the "Browse" page in the test folder |

|7. | Repeat step 3 (upload the same file with the same information) | A notice indicating the file is being uploaded is displayed with the upload id. |

|8. | Repeat steps 5-7 to check that all the jobs complete sucessfully | All the jobs are completed sucessfully |

|9. | Click on the [Browse] menu to the Browse page | You get 2 duplicate uploads under 'test1' folder |

|10.| Click on the top-level [Organize]-->[Folders]-->[Create], enter the folder name as "test2" under Software Repository | go to "Browse" page, will see the test2 folder under Software Repository |

|11.| Click on the top-level [Organize]-->[Folders]-->[Move] and move the folder test1 to test2 under Software Repository | go to "Browse" page, will see the test1 folder under folder test2 |

|12.| Click on the [Organize]-->[Folders]-->[Edit Properties] menu to go to the 'Edit Folder Properties' page; select the test folder; change both the folder name and folder description to something else (and remember what you specified); click on the 'Edit!' link on the bottom of the page | Click on the [Browse] menu, you will find that the test folder has been changed to the new name; click on the [Organize]-->[Folders]-->[Edit Properties] menu, and you will find that the description of the folder has been changed also |

|13.| Click on the [Organize]-->[Uploads]-->[Edit Properties] menu to go to the 'Edit Uploaded File Properties' page; change both the upload name and description of the upload you just uploaded (and remember what you specified); click on the link 'Edit!' | After clicking on the [Browse] menu to go to the 'Browse' page, you find the upload name and upload description of the recent upload are changed. |

|14.| Click on the [Organize]-->[Uploads]-->[Move] menu to go to the page 'Move upload to different folder' and move a upload file from the test folder to the high-level folder 'Software Repository'; click on the link 'Move!' | After clicking on the menu [Browse], you will find that the test file has been moved from the test folder to the higher-level folder |

|15.| Click on the [Organize]-->[Uploads]-->[Delete Upload File] menu to go to the 'Delete Uploaded File' page; select the uploaded test file to delete | After clicking on the menu [Browse], you will find the test file has been successfully deleted |

|16.| Click on the [Organize]-->[Folders]-->[Delete Folder] menu to delete a Folder, select a test folder and click on the link 'Delete!' | After clicking on the [Browse] menu to go to the 'Folder Navigation' page, you will find that the folder has been deleted successfully |

* Merge Cluster Basic tests here