Welcome to OpenUpgrade Library’s documentation!

Contents:

Build Status Coverage Status Code Climate Pypi Package

OpenUpgrade Library

A library with support functions to be called from Odoo migration scripts.

Features

  • TODO

Installation

At the command line:

$ easy_install openupgradelib

Or, if you have virtualenvwrapper installed:

$ mkvirtualenv openupgradelib
$ pip install openupgradelib

Usage

To use OpenUpgrade Library in a project:

import openupgradelib

Contributing

Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.

You can contribute in many ways:

Types of Contributions

Report Bugs

Report bugs at https://github.com/OCA/openupgradelib/issues.

If you are reporting a bug, please include:

  • Your operating system name and version.
  • Any details about your local setup that might be helpful in troubleshooting.
  • Detailed steps to reproduce the bug.

Fix Bugs

Look through the GitHub issues for bugs. Anything tagged with “bug” is open to whoever wants to implement it.

Implement Features

Look through the GitHub issues for features. Anything tagged with “feature” is open to whoever wants to implement it.

Write Documentation

OpenUpgrade Library could always use more documentation, whether as part of the official OpenUpgrade Library docs, in docstrings, or even on the web in blog posts, articles, and such.

Submit Feedback

The best way to send feedback is to file an issue at https://github.com/OCA/openupgradelib/issues

If you are proposing a feature:

  • Explain in detail how it would work.
  • Keep the scope as narrow as possible, to make it easier to implement.
  • Remember that this is a community-driven project, and that contributions are welcome :)

Get Started!

Ready to contribute? Here’s how to set up openupgradelib for local development.

  1. Fork the openupgradelib repo on GitHub.

  2. Clone your fork locally:

    $ git clone git@github.com:your_name_here/openupgradelib.git

  3. Install your local copy into a virtualenv. Assuming you have

virtualenvwrapper installed, this is how you set up your fork for local development:

$ mkvirtualenv openupgradelib
$ cd openupgradelib/
$ python setup.py develop

  1. Create a branch for local development:

    $ git checkout -b name-of-your-bugfix-or-feature

    Now you can make your changes locally.

  2. When you’re done making changes, check that your changes pass flake8 and the

tests, including testing other Python versions with tox:

 $ flake8 openupgradelib tests
 $ python setup.py test
 $ tox

To get flake8 and tox, just pip install them into your virtualenv.

  1. Commit your changes and push your branch to GitHub:

    $ git add .
$ git commit -m "Your detailed description of your changes."
$ git push origin name-of-your-bugfix-or-feature

  2. Submit a pull request through the GitHub website.

Pull Request Guidelines

Before you submit a pull request, check that it meets these guidelines:

  1. The pull request should include tests.
  2. If the pull request adds functionality, the docs should be updated. Put your
new functionality into a function with a docstring, and add the feature to the list in README.rst.
  1. The pull request should work for Python 2.6, 2.7, 3.3, and 3.4, and for
PyPy. Check https://travis-ci.org/OCA/openupgradelib/pull_requests and make sure that the tests pass for all supported Python versions.

Tips

To run a subset of tests:

$ python -m unittest tests.test_openupgradelib

Credits

Development Lead

Contributors

  • Stefan Rijnhart
  • David Béal
  • Sylvain LE GAL
  • Holger Brunn
  • Sandy Carter
  • Alexis de Lattre
  • Arthur Vuillard
  • Florent Xicluna
  • Benoit Guillot
  • Paulius Sladkevičius
  • Florian Dacosta
  • Alexandre Fayolle
  • Pedro M. Baeza
  • Manuel Vázquez Acosta
  • Miku Laitinen
  • Christoph Giesel
  • Jordi Riera

History

0.1.0 (2015-05-04)

  • First release on PyPI.

0.1.1 (2015-05-05)

  • Fixes to the tests
  • Add more badges
  • Fix pip install issue with required.txt

0.1.2 (2015-06-23)

  • Rewrite history with git filter-branch
  • Remove unneeded files from history * openupgrade_loading.py * deferred80.py * openupgrade_log.py * #openupgrade_loading.py#

1.0.0 (2015-08-10)

  • Rerelease to pypi with proper upload
  • Include requirements.txt
  • Mark as Beta

Indices and tables