correct pushing of initial ryu files

parent 47c863b9

Too many changes to show.

To preserve performance only 1000 of 1000+ files are displayed.

[Messages Control]
# PyLint Messages
# C0111: Don't require docstrings on every method
# W0511: TODOs in code comments are fine.
# W0142: *args and **kwargs are fine.
# E0602: Undefined variable %r
# C0103: Invalid name "%s" (should match %s)
# E1101: %s %r has no %r member
# R0903: Too few public methods (%s/%s)
# W0614: Unused import %s from wildcard import
# R0801: Similar lines in %s files
language: python
- "2.6"
- "2.7"
- "pip install -r tools/pip-requires -r tools/test-requires --use-mirrors"
- "./ -N"
This diff is collapsed.
include LICENSE
include *.rst
recursive-include ryu *.xsd
graft doc
graft etc
graft tools
recursive-exclude doc/build *
recursive-exclude ryu/tests/packet_data_generator *
global-exclude *~
global-exclude *.pyc
global-exclude .gitignore
What's Ryu
Ryu is a component-based software defined networking framework.
Ryu provides software components with well defined API that make it
easy for developers to create new network management and control
applications. Ryu supports various protocols for managing network
devices, such as OpenFlow, Netconf, OF-config, etc. About OpenFlow,
Ryu supports fully 1.0, 1.2, 1.3 and Nicira Extensions.
All of the code is freely available under the Apache 2.0 license. Ryu
is fully written in Python.
Quick Start
Installing Ryu is quite easy::
% pip install ryu
If you prefer to install Ryu from the source code::
% git clone git://
% cd ryu; python ./ install
If you want to use Ryu with `OpenStack <>`_,
please refer `detailed documents <>`_.
You can create tens of thousands of isolated virtual networks without
using VLAN. The Ryu application is included in OpenStack mainline as
of Essex release.
If you want to write your Ryu application, have a look at
`Writing ryu application <>`_ document.
After writing your application, just type::
% ryu-manager
Ryu Official site is `<>`_.
If you have any
questions, suggestions, and patches, the mailing list is available at
`ryu-devel ML
`The ML archive at Gmane <>`_
is also available.
How to Get Your Change Into Ryu
Submitting a change
Send patches to Please don't use 'pull
request' on github. We expect you to send a patch in Linux kernel
development style. If you are not familiar with it, please read the
following document:
Please check your changes with pep8 and run unittests to make sure
that they don't break the existing features. The following command
does both for you:
fujita@rose:~/git/ryu$ ./
Of course, you are encouraged to add unittests when you add new
features (it's not a must though).
Python version and libraries
* Python 2.6+
As RHEL 6 adopted python 2.6, features only for 2.7+ should be avoided.
* standard library + widely used library
Basically widely used == OpenStack adopted
As usual there are exceptions. gevents. Or python binding library for other
Coding style guide
* pep8
As python is used, PEP8 is would be hopefully mandatory for
* pylint
Although pylint is useful for finding bugs, but pylint score not very
important for now because we're still at early development stage.
* Google python style guide is very helpful
Guidelines derived from Guido's Recommendations
============================= ================= ========
Type Public Internal
============================= ================= ========
Packages lower_with_under
Modules lower_with_under _lower_with_under
Classes CapWords _CapWords
Exceptions CapWords
Functions lower_with_under() _lower_with_under()
Global/Class Variables lower_with_under _lower_with_under
Instance Variables lower_with_under _lower_with_under (protected) or __lower_with_under (private)
Method Names lower_with_under() _lower_with_under() (protected) or __lower_with_under() (private)
Function/Method Parameters lower_with_under
Local Variables lower_with_under
============================= ================= ========
* OpenStack Nova style guide
* JSON files
Ryu source tree has JSON files under ryu/tests/unit/ofproto/json.
They are used by unit tests. To make patches easier to read,
they are normalized using tools/ Please re-run
the script before committing changes to these JSON files.
* Python Essential Reference, 4th Edition [Amazon]
* Paperback: 717 pages
* Publisher: Addison-Wesley Professional; 4 edition (July 19, 2009)
* Language: English
* ISBN-10: 0672329786
* ISBN-13: 978-0672329784
* The Python Standard Library by Example (Developer's Library)
* Paperback: 1344 pages
* Publisher: Addison-Wesley Professional; 1 edition (June 11, 2011)
* Language: English
* ISBN-10: 0321767349
* ISBN-13: 978-0321767349
#!/usr/bin/env python
# Copyright (C) 2013 Nippon Telegraph and Telephone Corporation.
# Copyright (C) 2013 YAMAMOTO Takashi <yamamoto at valinux co jp>
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at