Skip to content

Latest commit

 

History

History
71 lines (52 loc) · 4.44 KB

Getting-involved-in-OpenSC-development.textile

File metadata and controls

71 lines (52 loc) · 4.44 KB

Getting involved in OpenSC development

Contributions to OpenSC are welcome! This page explains how to contribute to OpenSC.

Development process

  • OpenSC development is coordinated via the list [email protected]. See [[Mailing lists|Mailing-lists]]. Start helping the community by reviewing Github issues . Patches fixing new or existing issues may be submitted as Github Pull Requests or sent to the [[opensc-devel mailing list|Mailing-lists]].
  • Contribution should comply with coding guidelines. A minimal [[Development Policy|Development-Policy]] exists.
  • [[DRAFT Howto add/support a new card|Adding-a-new-card-driver]]
  • New features need to be tested. At worst transcript of `pkcs11-tool —test` with your card should be attached to Pull Requests. Even better would be implementation of unit tests systematically testing introduced code.

Test Tools

github process

GitHub is a web-based hosting service for software development projects using the Git revision control system.

  • OpenSC source code is hosted on GitHub :
  • The OpenSC master branch is available using:
    git clone git://github.com/OpenSC/OpenSC.git
cd OpenSC
./bootstrap
  • Read latest commits.
  • To start coding, create a Github account. Creating an account with one project is free. Upload your public ssh keys.
  • Visit OpenSC Github project and click on Fork to create your own OpenSC repository. Majors features should have their own branch. Bug fixes should go to the Staging branch.
  • To propose a commit, make a pull request to the main OpenSC master repository.
  • Advertise your pull request. Pull requests are discussed and applied by github core developers.

Pull Requests

The github pull requests (PR) to OpenSC/OpenSC are/can-be checked automatically for building on Ubuntu Windows and OSX. At the moment this feature is installed to help the contributors to reveal the compilation errors on the platforms that they do not used to manage (mostly Windows).

The Travis CI runs basic tests on few emulated cards (PIV, IsoApplet, OpenPGP, GIDS, OsEID) to make sure your changes did not break basic functionality of them. Adding more tests is always welcomed.

The Team

Current developers/maintainers with recent activity in Github, in alphabetical order:

Developers/maintainers with established GIT write access can be found in [[OpenSC organization page|https://github.com/orgs/OpenSC/people]].

The Emeritus of the OpenSC developer team as well as project chronology is listed on [[History-of-the-OpenSC-Project"|History-of-the-OpenSC-Project]]. List of all people who have sent patches to OpenSC is available on [[Github|https://github.com/OpenSC/OpenSC/graphs/contributors]].

All links