Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/connorjclark/as3unit
A unit testing framework for ActionScript 3
https://github.com/connorjclark/as3unit
Last synced: 6 days ago
JSON representation
A unit testing framework for ActionScript 3
- Host: GitHub
- URL: https://github.com/connorjclark/as3unit
- Owner: connorjclark
- Created: 2015-02-02T11:08:06.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2015-02-09T05:49:00.000Z (over 9 years ago)
- Last Synced: 2024-10-19T00:01:33.640Z (21 days ago)
- Language: ActionScript
- Homepage:
- Size: 281 KB
- Stars: 4
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-actionscript-sorted - as3unit - A unit testing framework for ActionScript 3 (Frameworks / Unit Testing)
README
# AS3Unit
AS3Unit is a unit testing framework for ActionScript / Flash.
- Automate your unit testing
- Minimal set up
### Installation
In order to use AS3Unit, you need the following installed on your system and in your ENV variable:
- [Ruby](https://www.ruby-lang.org/en/downloads/)
- [Adobe Flex](http://www.adobe.com/devnet/flex/flex-sdk-download.html)*
##### *extra step
If you have a 64-bit Java installation as your system's default, you need to do an [extra step](http://tipila.com/tips/79/cannot-find-jvm-error-in-mxmlc-windows-64bit). Simply install a 32-bit version, and add the following line to flex_home/jvm.config:
```
java.home=location of your 32-bit java installation
```
### Integrating with your project
Now, pull the latest version of AS3Unit's .git repo, and type this in the command line:
```
ruby build.rb
```
This will create a folder called flash-unit-release. You can place this folder in the root directory of your Flash project. In the same folder as flash-unit-release is where you should keep your test directory. To run your tests, enter the command line from your project's directory (if viewing the folder in Windows, a nice shortcut is Alt+D, type 'cmd', enter), and type:
```
ruby flash-unit-release/test.rb
```
Voila! Your browser will launch and the test results will be on display.
If you wish to keep the tool packaged in your project's repo, add these items to add to your .gitignore:
```
as3unit.swf
as3unit.js
```
Otherwise, add this:
```
as3unit-release/
```
### Writing tests
Check out the [tests](test/) for AS3Unit to get an idea of how to make a unit test in AS3Unit. A quick rundown:
* Put all of your tests in a directory called tests/ in the SAME FOLDER as the directory as3unit-release/
* Every class in tests/ will be run as test cases. For your test case, extend TestCase.
* Only methods starting with 'test' will be run
* The available assert methods are like those in any other unit testing framework.
* ex: assert, assertFalse, assertEquals, assertSame, assertNotEquals, assertNotSame, fail
* helper methods: setUp, tearDown, setUpClass, tearDownClass. Simply define them in your test case, or don't. AS3Unit doesn't care.
### Development
Want to contribute? Cool! I highly encourage a TDD approach for the development of this tool. If you wish to contribute by adding *new features*, do so in a TDD manner! :)
### Todo's
- Make build / test scripts platform agnostic
- Mocking
### License
Apache License, Version 2.0