Skip to content

Commit da961eb

Browse files
Updated README, CHANGELOG, bump version
1 parent 2886098 commit da961eb

File tree

3 files changed

+24
-9
lines changed

3 files changed

+24
-9
lines changed

CHANGELOG

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,14 @@
1+
## 2.0.0 (2015-04-23)
2+
3+
* Rewritten Xvfb launch using Process.spawn and avoiding a shell
4+
* Do not manually remove X11 lock file when stopping Xvfb; this isn’t conventional. Should eliminate some errors with not being able to find Xvfb
5+
* More informative error messages
6+
* Detect situation when Xvfb can’t listen to any sockets and raise corresponding error.
7+
* If video recorder provider is libav, use avconv binary instead of ffmpeg
8+
* Fixes to video recorder launch options (from @gpavlidi, @abotalov, @ynagorny, @WeAreFarmGeek)
9+
* Customize launch timeout (from @ShockwaveNN)
10+
* Properly working integration tests
11+
112
## 1.0.2 (2014-06-03)
213

314
* pass options correctly to ffmpeg (from @abotalov)

README.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# Headless [![Travis CI status](https://secure.travis-ci.org/leonid-shevtsov/headless.png)](http://travis-ci.org/leonid-shevtsov/headless)
22

3-
Headless is *the* Ruby interface for Xvfb. It allows you to create a headless display straight from Ruby code, hiding some low-level action.
4-
It can also capture images and video from the virtual framebuffer.
3+
Headless is *the* Ruby interface for Xvfb. It allows you to create a headless display straight from Ruby code, hiding the low-level action.
4+
It can also capture images and video from the virtual framebuffer. For example, you can record screenshots and screencasts of your failing integration specs.
55

66
I created it so I can run Selenium tests in Cucumber without any shell scripting. Even more, you can go headless only when you run tests against Selenium.
77
Other possible uses include pdf generation with `wkhtmltopdf`, or screenshotting.
88

9-
Documentation is available at [rdoc.info](http://rdoc.info/projects/leonid-shevtsov/headless)
9+
Documentation is available at [rubydoc.info](http://www.rubydoc.info/gems/headless)
1010

1111
[Changelog](https://github.com/leonid-shevtsov/headless/blob/master/CHANGELOG)
1212

@@ -159,15 +159,19 @@ To install the necessary libraries on ubuntu:
159159
`import` - run `sudo apt-get install imagemagick`
160160
`xwd` - run `sudo apt-get install X11-apps` and if you are going to use netpbm utilities for image conversion - `sudo apt-get install netpbm`
161161

162-
## Contributors
162+
## Troubleshooting
163163

164-
* [Igor Afonov](http://iafonov.github.com) - video and screenshot capturing functionality.
164+
### Display socket is taken but lock file is missing
165165

166-
---
166+
This means that there is an X server that is taking up the chosen display number, but its lock file is missing. This is an exceptional situation. Please stop the server process manually (`pkill Xvfb`) and open an issue.
167+
168+
### Video not recording
167169

168-
© 2011 Leonid Shevtsov, released under the MIT license
170+
If video is not recording, and there are no visible exceptions, try passing the following option to Headless to figure out the reason: `Headless.new(video: {log_file_path: STDERR})`. In particular, there are some issues with the version of avconv packaged with Ubuntu 12.04 - an outdated release, but still in use on Travis.
169171

170172

173+
##[Contributors](https://github.com/leonid-shevtsov/headless/graphs/contributors)
171174

172-
[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/leonid-shevtsov/headless/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
175+
---
173176

177+
© 2011-2015 Leonid Shevtsov, released under the MIT license

headless.gemspec

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ spec = Gem::Specification.new do |s|
33
s.email = '[email protected]'
44

55
s.name = 'headless'
6-
s.version = '1.0.2'
6+
s.version = '2.0.0'
77
s.summary = 'Ruby headless display interface'
88

99
s.description = <<-EOF

0 commit comments

Comments
 (0)