├── .gitignore
├── .travis.yml
├── README.md
├── build.gradle
├── doc
└── libdoc
│ ├── de.codecentric.robot.mongodblibrary.keywords.MongodbLibrary.html
│ └── de.codecentric.robot.mongodblibrary.keywords.MongodbLibrary.xml
├── generateDocs.cmd
├── generateDocs.launch
├── robot-bin
├── commons-io-1.3.2.jar
├── junit-4.10.jar
├── mongo-java-driver-2.10.0.jar
└── robotframework-2.7.5.jar
├── runSample.cmd
├── runSampleTests.launch
├── runServer.cmd
├── sample
├── data.json
├── dataMultipleRows.json
├── mongodblibrarySample.txt
└── remoteMongodblibrarySample.txt
├── settings.gradle
└── src
├── main
├── java
│ └── de
│ │ └── codecentric
│ │ └── robot
│ │ └── mongodblibrary
│ │ ├── MongodbLibraryException.java
│ │ ├── keywords
│ │ └── MongodbLibrary.java
│ │ └── server
│ │ └── MongodbLibraryRemoteServer.java
└── resources
│ └── de
│ └── codecentric
│ └── robot
│ └── mongodblibrary
│ └── keywords
│ └── MongodbLibrary.properties
└── test
├── data
├── testArray.json
├── testRowSeperated.json
└── testSingleObject.json
└── java
└── de
└── codecentric
└── robot
└── mongodblibrary
└── keywords
└── MongodbLibraryTest.java
/.gitignore:
--------------------------------------------------------------------------------
1 | /.settings
2 | /target
3 | /.classpath
4 | /.project
5 | /.gradle
6 | /build
7 | /bin
8 |
--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | language: java
2 | jdk:
3 | - openjdk6
4 |
5 | after_script: gradle 'run sample tests'
6 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | Robotframework-Mongodblibrary
2 | =============================
3 |
4 | The **Robot Framework MongoDB Library** is a library for testing MongoDB applications with the Robotframework.
5 | Please see the [Keyword-Documentation](http://mahartma.github.com/robotframework-mongodblibrary/de.codecentric.robot.mongodblibrary.keywords.MongodbLibrary.html) for more information about the provided keywords.
6 |
7 | The library is written in Java using the MongoDB Java Driver.
8 |
9 | Sample test:
10 |
11 | ```
12 | *** Settings ***
13 | Library de.codecentric.robot.mongodblibrary.keywords.MongodbLibrary
14 | Suite Setup Startup Embedded 2.4.4
15 | Suite TearDown Shutdown Embedded
16 | Test Setup Setup MongoDB
17 |
18 | *** Test Cases ***
19 | should insert given document
20 | Insert Document myCollection {say : 'Hello MongoDb!'}
21 | Collection Should Exist myCollection
22 | Document Should Exist myCollection {say : 'Hello MongoDb!'}
23 | should insert data from file
24 | Import Documents myCollection sample/data.json
25 | Collection Should Exist myCollection
26 | Document Should Exist myCollection {name : 'Mike'}
27 | should insert data from file (row-seperated)
28 | Import Documents Row Seperated myCollection sample/dataMultipleRows.json
29 | Collection Should Exist myCollection
30 | Document Should Exist myCollection {name : 'Mike'}
31 | Document Should Exist myCollection {name : 'Tom'}
32 | Document Should Exist myCollection {name : 'Eric'}
33 |
34 | *** Keywords ***
35 | Setup MongoDB
36 | Connect To Server localhost 27017 robotdb1
37 | Drop Database robotdb1
38 | ```
39 |
40 | Dependencies
41 | ------------
42 | - [Robotframework >= 2.7.5 (with Jython)](http://code.google.com/p/robotframework/downloads/list)
43 | - [MongoDB Java Driver >= 2.10.0](http://central.maven.org/maven2/org/mongodb/mongo-java-driver)
44 | - [apache-commons-io 1.3.2](http://search.maven.org/remotecontent?filepath=org/apache/commons/commons-io/1.3.2/commons-io-1.3.2.jar)
45 | - [junit 4.10](http://search.maven.org/remotecontent?filepath=junit/junit/4.10/junit-4.10.jar)
46 | - [MongoDB Server >= 2.2.1](http://www.mongodb.org/downloads)
47 | - [Embedded MongoDB >= 1.31](https://github.com/flapdoodle-oss/embedmongo.flapdoodle.de)
48 |
49 | Install
50 | -------
51 | - download [robotframework-mongodblibrary-0.2.1-with-dependencies.jar](http://mahartma.github.com/robotframework-mongodblibrary/robotframework-mongodblibrary-0.2-with-dependencies.jar)
52 | - start the mongoDB daemon or use the embedded keywords ( _Startup Embedded_, _Shutdown Embedded_ )
53 | - add **robotframework-mongodblibrary-0.2.1-with-dependencies.jar** to the CLASSPATH (see runSample.cmd)
54 | - start the Robot-Tests
55 | - this can also be done by a gradle task:
56 | ```groovy
57 | configurations {
58 | robot
59 | }
60 |
61 | dependencies {
62 | robot files("libs/robotframework-mongodblibrary-0.2.1-with-dependencies.jar")
63 | }
64 |
65 | task(type : JavaExec, 'run tests') {
66 | classpath = configurations.robot
67 | main = 'org.robotframework.RobotFramework'
68 | args = [
69 | '-d',
70 | 'build',
71 | 'sample/mongodblibrarySample.txt'
72 | ]
73 | }
74 | ```
75 |
76 | Remote-Library
77 | --------------
78 | - the library also contains the Remote-Server from the Robotframework for executing the keywords on a dedicated JVM (see [Robot-Remote-Library](http://code.google.com/p/robotframework/wiki/RemoteLibrary))
79 | - it's very useful when you want to use python in the main suite instead of jython
80 | - the server can be started with **java -jar build/libs/robotframework-mongodblibrary-0.2.1-with-dependencies.jar**
81 | - see the example below:
82 |
83 | ```
84 | *** Settings ***
85 | Library Remote http://localhost:8270
86 | Suite Setup Startup Embedded 2.4.4
87 | Suite TearDown Shutdown Embedded
88 | Test Setup Setup MongoDB
89 |
90 | *** Test Cases ***
91 | should insert given document
92 | Insert Document myCollection {say : 'Hello MongoDb!'}
93 | Collection Should Exist myCollection
94 | Document Should Exist myCollection {say : 'Hello MongoDb!'}
95 | should insert data from file
96 | Import Documents myCollection sample/data.json
97 | Collection Should Exist myCollection
98 | Document Should Exist myCollection {name : 'Mike'}
99 | should insert data from file (row-seperated)
100 | Import Documents Row Seperated myCollection sample/dataMultipleRows.json
101 | Collection Should Exist myCollection
102 | Document Should Exist myCollection {name : 'Mike'}
103 | Document Should Exist myCollection {name : 'Tom'}
104 | Document Should Exist myCollection {name : 'Eric'}
105 |
106 | *** Keywords ***
107 | Setup MongoDB
108 | Connect To Server localhost 27017 robotdb1
109 | Drop Database robotdb1
110 | ```
111 |
--------------------------------------------------------------------------------
/build.gradle:
--------------------------------------------------------------------------------
1 | project.version = '0.2.1'
2 |
3 | repositories { mavenCentral() }
4 |
5 | apply plugin: 'java'
6 | apply plugin: 'eclipse'
7 |
8 | configurations {
9 | robot
10 | docs
11 | }
12 |
13 | dependencies {
14 | compile group: 'junit', name: 'junit', version: "4.10"
15 | compile group: 'de.flapdoodle.embed', name: 'de.flapdoodle.embed.mongo', version: "1.31"
16 | compile group: 'org.apache.commons', name: 'commons-io', version: "1.3.2"
17 | compile group: 'com.github.ombre42', name: 'jrobotremoteserver', version: "2.0"
18 | compile group: 'org.mongodb', name: 'mongo-java-driver', version: "2.10.0"
19 | robot group: 'org.robotframework', name: 'robotframework', version: "2.7.5"
20 | robot group: 'org.robotframework', name: 'javalib-core', version: "1.0.3"
21 | docs files("${System.getProperty('java.home')}/../lib/tools.jar")
22 | }
23 |
24 | task(type : Jar, 'jarWithDependencies') {
25 | classifier = 'with-dependencies'
26 | exclude('META-INF/*.RSA')
27 | exclude('META-INF/*.SF')
28 | from { configurations.compile.collect {
29 | if (!it.isDirectory()) {
30 | zipTree(it)
31 | }
32 | }
33 | }
34 | from { sourceSets.main.output }
35 | manifest { attributes 'Main-Class': 'de.codecentric.robot.mongodblibrary.server.MongodbLibraryRemoteServer' }
36 | }
37 |
38 | processResources {
39 | filter(org.apache.tools.ant.filters.ReplaceTokens,
40 | tokens: [version: project.version])
41 | }
42 |
43 | assemble.dependsOn 'jarWithDependencies'
44 |
45 | task(type : JavaExec, 'runSampleTests') {
46 | classpath = configurations.robot + configurations.compile + sourceSets.main.runtimeClasspath
47 | main = 'org.robotframework.RobotFramework'
48 | args = [
49 | '-d',
50 | 'build',
51 | 'sample/mongodblibrarySample.txt'
52 | ]
53 | }
54 |
55 | task 'generateDocs' << {
56 | tasks['generateHtmlDoc'].exec()
57 | tasks['generateXmlDoc'].exec()
58 | }
59 |
60 | task(type : JavaExec, 'generateHtmldoc') {
61 | classpath = configurations.docs + configurations.robot + configurations.compile + sourceSets.main.runtimeClasspath
62 | main = 'org.python.util.jython'
63 | args = [
64 | '-m',
65 | 'robot.libdoc',
66 | 'src/main/java/de/codecentric/robot/mongodblibrary/keywords/MongodbLibrary.java',
67 | 'doc/libdoc/de.codecentric.robot.mongodblibrary.keywords.MongodbLibrary.html'
68 | ]
69 | }
70 |
71 | task(type : JavaExec, 'generateXmlDoc') {
72 | classpath = configurations.docs + configurations.robot + configurations.compile + sourceSets.main.runtimeClasspath
73 | main = 'org.python.util.jython'
74 | args = [
75 | '-m',
76 | 'robot.libdoc',
77 | '--format',
78 | 'XML',
79 | 'src/main/java/de/codecentric/robot/mongodblibrary/keywords/MongodbLibrary.java',
80 | 'doc/libdoc/de.codecentric.robot.mongodblibrary.keywords.MongodbLibrary.xml'
81 | ]
82 | }
--------------------------------------------------------------------------------
/doc/libdoc/de.codecentric.robot.mongodblibrary.keywords.MongodbLibrary.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
82 |
92 |
114 |
154 |
174 |
186 |
189 |
190 |
191 |
192 |
193 |
194 |
Opening library documentation failed
195 |
196 | - Verify that you have JavaScript enabled in your browser.
197 | - Make sure you are using a modern enough browser. Firefox 3.5, IE 8, or equivalent is required, newer browsers are recommended.
198 | - Check are there messages in your browser's JavaScript error log. Please report the problem if you suspect you have encountered a bug.
199 |
200 |