https://github.com/certik/python-theora
https://github.com/certik/python-theora
Last synced: 11 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/certik/python-theora
- Owner: certik
- License: other
- Created: 2009-06-12T19:15:02.000Z (about 17 years ago)
- Default Branch: master
- Last Pushed: 2009-10-12T17:57:47.000Z (over 16 years ago)
- Last Synced: 2025-07-28T07:36:48.352Z (12 months ago)
- Language: Python
- Homepage:
- Size: 186 KB
- Stars: 3
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README
- License: LICENSE
Awesome Lists containing this project
README
python-theora
-------------
Python wrappers for libtheora.
webpage: http://certik.github.com/python-theora
Installation
------------
Download libtheora-1.0 from: http://www.theora.org/downloads/, install into
$PREFIX and set PKG_CONFIG_PATH to point to $PREFIX/lib/pkgconfig.
E.g. assuming you'll install to ~/usr, do:
wget http://downloads.xiph.org/releases/theora/libtheora-1.0.tar.bz2
tar xjf libtheora-1.0.tar.bz2
cd libtheora-1.0
./configure --prefix=$HOME/usr
make
make install
and then cd to the python-theora directory and just do:
export PKG_CONFIG_PATH=~/usr/lib/pkgconfig
./setup.py install --home=~/usr
Documentation
-------------
To build the documentation, use:
$ ./setup.py build_ext --inplace
$ cd doc
$ make html
To upload to github, use:
$ cd _build/html
$ sphinx-to-github
Processing matches for: _sources
Processing matches for: _static
$ cd ../../..
$ git co -b gh-pages
$ cp -r doc/_build/html/* .
$ git co -a -m "docs updated"
Usage
-----
In [1]: import theora
In [2]: help(theora)
And read the help for the Theora class.
Development
-----------
Rule: every single method, property and class exposed to the user (e.g. the
"def" ones in Cython, not the "cdef" ones) *must* have a docstring and at least
one doctest showing the usage to the user. More thorough regression testing is
then done using regular tests in the tests directory. Of course all tests and
all doctests must pass all the time, see below how to run tests:
Download test video files:
$ tests/download_test_vidos.sh
Compile inplace:
$ ./setup.py build_ext --inplace
Run tests:
$ ./setup.py test
This runs all regular tests in the test directory and all doctests.