Tools

As any true open source project NReco supposes using only free and/or open source tools for development environment:

• Subversion version control for repository
• Visual Studio 2008 Express edition as primary editor for source code / domain specific models (XML-editor)
• Notepad++ as supporting editor for files of any kind
• TopCoder UML Tool as UML-models editor (Poseidon for UML is no longer free)
• NUnit for running unit tests.
• see also list of external libraries used by NReco

Configuration

How to build examples

First of all open tools/NReco.Tools.sln and build it.

How to enable intellisense for XML

NReco contains a set of XML-based domain specific models specifications; VS 2008 suits ideally for creating and maintaining them. It's very handy to register their XML Schemas in VS 2008 to enable intellisense mechanizm:

1. Find catalog.xml file in VS 2008 folder (usually it is located in "C:\Program Files\Microsoft Visual Studio 9.0\Xml\Schemas\" folder)
2. Add following nodes (replace %NRECO_REPO_ROOT% with your local path to NReco repository)

  <Schema href="%NRECO_REPO_ROOT%\shared\schemas\NRecoDalc.xsd" 
          targetNamespace="urn:schemas-nreco:nicnet:dalc:v1" />
  <Schema href="%NRECO_REPO_ROOT%\shared\schemas\NRecoCore.xsd" 
          targetNamespace="urn:schemas-nreco:nreco:core:v1" />
  <Schema href="%NRECO_REPO_ROOT%\shared\schemas\NRecoWeb.xsd" 
          targetNamespace="urn:schemas-nreco:nreco:web:v1" />
  <Schema href="%NRECO_REPO_ROOT%\shared\schemas\NRecoWebLayout.xsd" 
          targetNamespace="urn:schemas-nreco:nreco:web:layout:v1" />
  <Schema href="%NRECO_REPO_ROOT%\shared\schemas\NRecoEntity.xsd" 
          targetNamespace="urn:schemas-nreco:nreco:entity:v1" />
  <Schema href="%NRECO_REPO_ROOT%\shared\schemas\NRecoLucene.xsd" 
          targetNamespace="urn:schemas-nreco:nreco:lucene:v1" />

3. enjoy!

How to register NUnit as external tool

1. Open 'External Tools' dialogue
2. in 'Command' textbox specify path to nunit-gui.exe
3. in 'Arguments' specify: $(BinDir)/$(TargetName)$(TargetExt)
4. This will run NUnit for selected project.

Contribution

Every project member can contribute to the project with following conditions:

• the license of the whole project can be changed by project owner(s) in the future without asking for permission from all members.
• member can hold copyright only for atomic parts (separate files). By committing the code to the project repository author gives following exclusive rights to NReco project:
• copyrighted code cannot be recalled from the project in the future
• copyrighted code may be distributed under latest NReco license