In the software development process, a reference implementation (or, less frequently, sample implementation or model implementation) is a program that implements all requirements from a corresponding specification. The reference implementation often accompanies a technical standard, and demonstrates what should be considered the "correct" behavior of any other implementation of it.
Characteristics and examples
Reference implementations of algorithms, for instance cryptographic algorithms, are often the result or the input of standardization processes. In this function they are often dedicated to the public domain with their source code as public domain software. Examples are the first CERN's httpd, Serpent cipher, base64 variants, and SHA-3. The Openwall Project maintains a list of several algorithms with their reference source code in the public domain.
A reference implementation may or may not be production quality. For example, the Fraunhofer reference implementation of the MP3 standard usually does not compare favorably to other common implementations, such as LAME, in listening tests that determine sound quality. In contrast, CPython, the reference implementation of the Python programming language, is also the implementation most widely used in production.
Testing the implementation-vs-specification relationship further enhances the production's inter-process efficiencies:
A reference implementation is, in general, an implementation of a specification to be used as a definitive interpretation for that specification (This definition is a bit grandiloquent but works). During the development of the ... conformance test suite, at least one relatively trusted implementation of each interface is necessary to (1) discover errors or ambiguities in the specification, and (2) validate the correct functioning of the test suite.
Characteristics of a Reference Implementation:
- Developed concurrently with the specification and test suite;
- Verifies that specification is implementable;
- Enables the test suite to be tested;
- Serves as a Gold Standard against which other implementations can be measured;
- Helps to clarify the intent of the specification in situations where conformance tests are inadequate
- ^ The birth of the web Licensing the web on cern.ch (2014)
- ^ libb64 on sourceforge
- ^ KeccakReferenceAndOptimized-3.2.zip mainReference.c "The Keccak sponge function, designed by Guido Bertoni, Joan Daemen, Michaël Peeters and Gilles Van Assche. For more information, feedback or questions, please refer to our website: http://keccak.noekeon.org/Implementation[permanent dead link] by the designers, hereby denoted as "the implementer". To the extent possible under law, the implementer has waived all copyright and related or neighboring rights to the source code in this file. https://creativecommons.org/publicdomain/zero/1.0/"
- ^ Source code snippets and frameworks placed in the public domain on openwall.info
- ^ Snow, Eric (26 January 2012). "PEP 421 -- Adding sys.implementation". Python.org. Python Software Foundation. Archived from the original on 7 January 2017. Retrieved 6 January 2017.
For a number of years now, the distinction between Python-the-language and CPython (the reference implementation) has been growing.
- ^ Dalci, Eric; Fong, Elizabeth; Goldfine, Alan (2003). Requirements for GSC-IS Reference Implementations. National Institute of Standards and Technology, Information Technology Laboratory. [https://web.archive.org/web/20060928231404/http://xw2k.sdct.itl.nist.gov/smartcard/document/ref-imp51.pdf Requirements for GSC-IS Reference Implementations]
- ^ Curran, Patrick (2003). Conformance Testing: An Industry Perspective. Sun Microsystems.