Add course test cases

Devecor · Devecor · commit a32e07bd3f94 · 2021-01-02T15:15:22.000+08:00
diff --git a/test/README.md b/test/README.md
@@ -1,53 +1,52 @@
-# Codebang Test Cases
-Here are robot test cases to verify the main functions of `codebang`, each test case has one `.robot` file. These test cases also could be as a guide for end users to understand how to use codebang.
+# Codebang Tests
+This folder contains the various test runners for **codebang**.
 
-## Let's start!
-In order to run them automatically, first install RobotFramework and SeleniumLibrary by `pip`
+## Requirements
 
+### 1. Install the dependencis
+Before running the test, install the dependencies:
 ```sh
 python3 -m pip install robotframework robotframework-SeleniumLibrary
 ```
 
-then, please complete the following preparations step by step
+### 2. Install webDirvers
+The general approach to install a browser driver is downloading a right driver, such as chromedriver for Chrome, and placing it into a directory that is in **PATH**. Drivers for different browsers can be found as follows
 
-### 1. install webDirvers
-The general approach to install a browser driver is downloading a right driver, such as chromedriver for Chrome, and **placing it into a directory that is in** `path`. here are two fast links about chrome and firefox drivers in `npm.taobao.org` for chinese users.
+* [ChromeDriver for google Chrome](https://npm.taobao.org/mirrors/chromedriver/)
 
-[chrome webdriver](https://npm.taobao.org/mirrors/chromedriver/)
+* [Geckodriver for firefox](https://npm.taobao.org/mirrors/geckodriver/)
 
-[firefox geckodriver](https://npm.taobao.org/mirrors/geckodriver/)
+### 3. Start server
 
-### 2. start codebang and future-server
-
-you have to start future-server at port `9092`. change directory to `future-server` in a terminal,
+You have to start future-server at port `9092`. Change directory to `future-server` in a terminal,
 then
 ```sh
 python3 manage.py runserver 9092
 ```
 
-change directory to `codebang` in a terminal and start codebang at any port you want(default: `8080`), then
+Change directory to `codebang` in a terminal and start codebang at any port you expected(default: `8080`), then
 ```sh
 npm run serve
 ```
 
-or you may want to use a shell script named `autostart.sh` for starting codebang and future-server automaticaly(just for bash with gnome)
+You may want to use a shell script named `autostart.sh` for starting codebang and future-server automaticaly.
 ```sh
 ./autostart.sh
 ``` 
 
-### 3. run tests
-create a directory for testing log
+## Run tests
+Create a directory for test log files
 ```sh
 mkdir test-results
 ```
 
-run any of one test suite which contains some test cases. for ecample
+Run any of one test suite which contains some test cases. for ecample
 ```sh
 cd codebang/test
-robot -X -d ./test-results login
+robot -X -d test-results --suite login_suite code_manager_test
 ```
 
-or run the whole test suite
+Or run the whole test suite
 ```sh
 robot -X -d test-results .
 ```
@@ -59,8 +58,3 @@ robot -X -d test-results .
 * Login With Invalid Username
 * Login With Invalid Password
 * Login With Invalid Username And Password
-
-## Reference
-
-* [robotframework](https://robotframework.org/#examples)
-* [SeleniumLibrary](https://robotframework.org/SeleniumLibrary/)
diff --git a/test/code_manager_test/__init__.robot b/test/code_manager_test/__init__.robot
@@ -1,9 +1,7 @@
 *** Settings ***
-Documentation     the login test suite
+Documentation     the code manager test suite
 Metadata          Version    0.1
 Library           SeleniumLibrary
 Resource          ../common.robot
-Resource          login_action.robot
 Suite Setup       Open Codebang To Home Page
 Suite Teardown    Close Browser
-Test Teardown     Logout
diff --git a/test/code_manager_test/course_action.robot b/test/code_manager_test/course_action.robot
@@ -0,0 +1,99 @@
+*** Settings ***
+Documentation    the common keywords for login defined here
+Resource         ../common.robot
+
+*** Variables ***
+${Add Course Button}                  xpath: //div/button[@title="新增课程"]
+${Confirm To Add Course Button}       xpath: //div[@class="el-message-box"]/descendant::button[contains(./span/text(), "确定")]
+${Delete Course Button}               xpath: //div[@class="cb-navbar"]/descendant::button[@title="删除当前课程和相关的课程文件"]
+${Rename Course Button}               xpath: //div[@class="cb-navbar"]/descendant::button[@title="修改课程标题"]
+${Confirm To Delete Course Button}    xpath: //div[@class="el-message-box"]/descendant::button[contains(span, "确定")]
+${Confirm To Rename Course Button}    xpath: //div[@class="el-message-box"]/descendant::button[contains(span, "确定")]
+
+${Course Input}                       xpath: //div[@class="el-message-box"]/descendant::div[@class="el-input"]/input
+${Select Course Input}                xpath: //div[@class="cb-card"]/descendant::input[@class="el-input__inner"]
+
+${Can Not Add Course Alert}           xpath: //div[@role="alert"]/descendant::p[contains(text(), "未登陆用户不能创建课程")]
+
+*** Keywords ***
+Click Add Course Button
+    Click Button    ${Add Course Button}
+
+Input Course Name
+    [Arguments]    ${Course Name}
+    Input Text    ${Course Input}    ${Course Name}
+
+Input New Course Name
+    [Arguments]    ${Course Name}
+    Input Text    ${Course Input}    ${Course Name}
+
+Confirm To Add Course
+    Click Button    ${Confirm To Add Course Button}
+
+Current Course Should Be
+    [Arguments]    ${Course Name}
+    Sleep    0.2s
+    Element Attribute Value Should Be    ${Select Course Input}    value    ${Course Name}
+
+Verify Course Can Not Be Added
+    Wait Until Element Is Visible    ${Can Not Add Course Alert}    0.5s
+
+Verify Course Can Not Be Renamed
+    Element Should Be Disabled    ${Rename Course Button}
+
+Verify Course Can Not Be Deleted
+    Element Should Be Disabled    ${Delete Course Button}
+
+Click Button To Delete Course
+    Click Button    ${Delete Course Button}
+
+Click Button To Rename Course
+    Click Button    ${Rename Course Button}
+
+Confirm To Delete Course
+    Click Button    ${Confirm To Delete Course Button}
+
+Confirm To Rename Course
+    Click Button    ${Confirm To Rename Course Button}
+
+Course Should Be Deleted
+    [Arguments]    ${Course Name}
+    Click Element    ${Select Course Input}
+    Page Should Not Contain Element    xpath: //div[@class="el-scrollbar"]/descendant::li[span="${Course Name}"]
+    Click Element    ${Select Course Input}
+
+# 会使页面停在课程列表处
+Course Should Exist
+    [Arguments]    ${Course Name}
+    Click Element    ${Select Course Input}
+    ${Course Li} =    Get WebElement    xpath: //div[@class="el-scrollbar"]/descendant::li[span="${Course Name}"]
+    Wait Until Page Contains Element    ${Course Li}    1s
+    [Return]    ${Course Li}
+
+Course Should Not Exist
+    [Arguments]    ${Course Name}
+    Click Element    ${Select Course Input}
+
+Select Course
+    [Arguments]    ${Course Name}
+    ${Course Element} =    Course Should Exist    ${Course Name}
+    Sleep    0.5s
+    Click Element    ${Course Element}
+    Current Course Should Be    ${Course Name}
+
+Add Course
+    [Arguments]    ${Course Name}
+    Click Button    ${Add Course Button}
+    Input Text    ${Course Input}    ${Course Name}
+    Click Button    ${Confirm To Add Course Button}
+    Current Course Should Be    ${Course Name}
+
+Delete Course
+    [Arguments]    ${Course Name}
+    Select Course    ${Course Name}
+    Click Button    ${Delete Course Button}
+    Click Button    ${Confirm To Delete Course Button}
+    Sleep    0.5s
+    Click Element    ${Select Course Input}
+    Page Should Not Contain Element    xpath: //div[@class="el-scrollbar"]/descendant::li[span="${Course Name}"]
+    Click Element    ${Select Course Input}
diff --git a/test/code_manager_test/course_suite.robot b/test/code_manager_test/course_suite.robot
@@ -0,0 +1,62 @@
+*** Settings ***
+Documentation    the test cases for course
+Resource         course_action.robot
+Resource         login_action.robot
+Test Setup       Login    devecor    t
+Test Teardown    Logout
+
+*** Variables ***
+${Course Name}            glibc
+${New Course Name}        glibc-new
+${Another Course Name}    linux-core
+
+
+*** Test Cases ***
+Add Course After Login
+    [Tags]    normal
+    Click Add Course Button
+    Input Course Name    ${Course Name}
+    Confirm To Add Course
+    Current Course Should Be    ${Course Name}
+    [Teardown]    Run Keywords    Delete Course    ${Course Name}    AND    Logout
+
+Add Course Before Login
+    [Tags]    abnormal
+    [Setup]
+    Click Add Course Button
+    Verify Course Can Not Be Added
+    [Teardown]
+
+Delete Course After Login
+    [Tags]    normal
+    Add Course    ${Course Name}
+    Select Course    ${Course Name}
+    Click Button To Delete Course
+    Confirm To Delete Course
+    Wait Until Animation Is Finished
+    Course Should Be Deleted    ${Course Name}
+
+Rename Course After Login
+    [Tags]    normal
+    Add Course    ${Course Name}
+    Select Course    ${Course Name}
+    Click Button To Rename Course
+    Input New Course Name    ${New Course Name}
+    Confirm To Rename Course
+    Current Course Should Be    ${New Course Name}
+    Delete Course    ${New Course Name}
+
+Course Renaming Or Deletion Before Login
+    [Tags]    abnormal
+    [Setup]
+    Verify Course Can Not Be Deleted
+    Verify Course Can Not Be Renamed
+    [Teardown]
+
+Switch Another Course After Login
+    [Tags]    normal   fail
+    Add Course    ${Course Name}
+    Add Course    ${Another Course Name}
+    Select Course    ${Course Name}
+    Delete Course    ${Course Name}
+    Delete Course    ${Another Course Name}
diff --git a/test/code_manager_test/login_action.robot b/test/code_manager_test/login_action.robot
@@ -59,6 +59,14 @@ Is Login
     Click Button    ${Me Dropdown Button}
     [Return]    ${Return Value}
 
+Login
+    [Arguments]    ${User Name}    ${Password}
+    Open Login Dialog
+    Input User Name    ${User Name}
+    Input User Password    ${Password}
+    Confirm To Login
+    Login Should Succeed
+
 Logout
     ${Is Login} =    Is Login
     Return From Keyword If    not ${Is Login}    ${None}
diff --git a/test/code_manager_test/login_suite.robot b/test/code_manager_test/login_suite.robot
@@ -1,7 +1,7 @@
 *** Settings ***
 Documentation    the test cases for login
-Library          SeleniumLibrary
 Resource         login_action.robot
+Test Teardown    Logout
 
 
 *** Variables ***
@@ -13,27 +13,31 @@ ${Invalid User Password}    wrong password
 
 *** Test Cases ***
 Login With Valid User
+    [Tags]    normal
     Open Login Dialog
     Input User Name    ${Valid User Name}
     Input User Password    ${Valid Password}
     Confirm To Login
     Login Should Succeed
 
 Login With Invalid Username
+    [Tags]    abnormal
     Open Login Dialog
     Input User Name    ${Invalid User Name}
     Input User Password    ${Valid Password}
     Confirm To Login
     Login Should Fail
 
 Login With Invalid Password
+    [Tags]    abnormal
     Open Login Dialog
     Input User Name    ${Valid User Name}
     Input User Password    ${Invalid User Password}
     Confirm To Login
     Login Should Fail
 
 Login With Invalid Username And Password
+    [Tags]    abnormal
     Open Login Dialog
     Input User Name    ${Invalid User Name}
     Input User Password    ${Invalid User Password}
diff --git a/test/codebang_test_user_guide.md b/test/codebang_test_user_guide.md
@@ -0,0 +1,67 @@
+# Codebang test guide
+
+## Getting started
+This is a tutorial for developer to prefect test cases of codebang. There is a [specification](#Specification) that we must follow
+
+### Prerequisites
+[See README](README)
+
+### Specification
+
+#### File encoding
+* utf-8
+
+#### Separated format
+* Space: 4 in genaral or more in special, for example
+  ```Robot Framework
+  *** Settings ***
+  Documentation     Example using the space separated format.
+  Library           OperatingSystem
+  
+  *** Variables ***
+  ${MESSAGE}        Hello, world!
+  
+  *** Test Cases ***
+  My Test
+      [Documentation]    Example test.
+      Log    ${MESSAGE}
+      My Keyword    ${CURDIR}
+  
+  Another Test
+      Should Be Equal    ${MESSAGE}    Hello, world!
+  
+  *** Keywords ***
+  My Keyword
+      [Arguments]    ${path}
+      Directory Should Exist    ${path}
+  ```
+
+#### File name
+* File names must be all lowercase and may include underscores: `_`
+* No additional punctuation.
+* Filenames’ extension must be `.robot`.
+
+  For example: `login_action.robot`
+
+#### Structure
+* a test suite of codebang with fandamental capability created from only **two** files: 
+  * Resource file: `anction.robot`
+  * Test case file: `suite.robot`
+
+  Any costomized `keyword` about the current suite should be defined in Resource file `anction.robot`. All cases for the current suite within test case file `suite.robot` are expected.
+* A high level suite of codebang created from a directory with a initialization file. An initialization file name must always be of the format `__init__.ext`, where the extension must be one of the supported file formats (typically `__init__.robot`).The main usage for initialization files is specifying test suite related settings in global. For example
+  ```
+  *** Settings ***
+  Documentation     the code manager test suite
+  Metadata          Version    0.1
+  Library           SeleniumLibrary
+  Resource          ../common.robot
+  Suite Setup       Open Codebang To Home Page
+  Suite Teardown    Close Browser
+  ```
+### Tags
+
+## Reference
+
+* [Robot Framework User Guide](http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html)
+* [The home page of SeleniumLibrary](https://robotframework.org/SeleniumLibrary/)
diff --git a/test/common.robot b/test/common.robot
diff --git a/test/rmlog.sh b/test/rmlog.sh
