Skip to content

Zacban/building_maintainable_software

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Building Maintainable Software

This is the example code that accompanies Building Maintainable Software: Ten Guidelines for Future-Proof Code by Joost Visser.

There are currently two editions of Building Maintainable Software:

  • The Java edition (ISBN print: 978-1-4919-5352-5, ISBN eBook: 978-1-4919-5348-8), available at the O'Reilly webshop and at Amazon.
  • The C# edition, currently submitted as a manuscript to O'Reilly Media.

Training videos are also available via O'Reilly Media.

Both editions are the same except for the language of the code snippets and a bit of language-specific terminology (e.g., 'Eclipse' in the Java edition is 'Visual Studio' in the C# edition).

Click the Download Zip button to the right to download example code.

See an error? Report it here for the Java edition, or simply fork and send us a pull request.

About The Example Code

The example code of the Java edition lives in src/java and src/test/java. The example code of the C# edition lives in src/csharp and src/test/csharp. Every .java file in src/java has a .cs file with the same name in src/csharp and the other way around. The same is true for the contents of the src/test directories.

For the Java code, there is a pom.xml file in the root of this repository. This allows compiling the Java source files and running the unit tests using Maven by executing mvn test.

For the C# code, there is a Visual Studio Solution file in the root of this repository, which references two projects (see the .csproj files in src/csharp and src/test/csharp). We compile the C# code and run the unit tests regularly using Mono on MacOS and occasionally using Visual Studio.

Both the Java and the C# editions have been written using O'Reilly's Atlas platform in the AsciiDoc markup language. All code snippets displayed in the books are taken directly from this example code. The parts included in the books are between Java and C# comments of the form // tag::NameOfTag[] and // end::NameOfTag[]. All code not between such comments is just there to make everything compile and pass unit tests.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 51.2%
  • Java 48.8%