rubyang

YANG parser and tree structure data store

Add this line to your application's Gemfile:

gem 'rubyang'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rubyang

You can use Rubyang as yang database or as server

To use rubyang as database, add this line to head of your code:

require 'rubyang'

You can specify YANG model as String:

yang_string_1 = <<-'EOB'
module rubyang-example-1 {
  namespace 'http://rubyang/example/1';
  prefix 'rubyang-example-1';
  container container1 {
    leaf leaf1 {
      type string;
    }
  }
}
EOB

yang_string_2 = <<-'EOB'
module rubyang-example-2 {
  namespace 'http://rubyang/example/2';
  prefix 'rubyang-example-2';
  container container2 {
    leaf leaf2 {
      type string;
    }
  }
}
EOB

And prepare DB for configurations:

db = Rubyang::Database.new

You can load YANG models to DB:

yang_string_list = [yang_string_1, yang_string_2]
db.load_models yang_string_list

The YANG models' dependencies are taken care automatically based on their import and include statements.

Then configurations can be set with YANG model:

db.configure.edit( "container1" ).edit( "leaf1" ).set( "hoge" )

And you can see configured data in XML format:

puts db.configure.to_xml( pretty: true )
# => <config xmlns='http://rubyang/config/0.1'>
#      <container1 xmlns='http://rubyang/example'>
#        <leaf1>hoge</leaf1>
#      </container1>
#    </config>

And also JSON format:

puts db.configure.to_json( pretty: true )
# => {
#      "config": {
#        "container1": {
#          "leaf1": "hoge"
#        }
#      }
#    }

And to use rubyang as server

require 'rubyang/server/base'

and create some class inheriting Rubyang::Server::Base class

class Example < Rubyang::Server::Base
end

now you can run server

example = Example.new
example.run

you can connect to this server with cli.rb

require 'rubyang/cli'

cli = Rubyang::Cli.new
cli.run

Rubyang provides component mechanism to develop some component for users. Users can develop some components and load those components. The components which is defined as "hook commit" in configuraion are called when commit is executed.

Example component is stored in "/path/to/rubyang/component/example.rb"

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/hirura/rubyang. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

The gem is available as open source under the terms of the Apache License 2.0.