cpp-header-template

// Copyright [year] [copyright holder]
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
 
#ifndef [PROJECT]_[PATH]_[FILENAME]_H_
#define [PROJECT]_[PATH]_[FILENAME]_H_
 
// C system headers (if needed)
// #include <sys/types.h>
 
// C++ standard library headers
#include <memory>
#include <string>
#include <vector>
 
// Other library headers
// #include "other/library.h"
 
// Project headers
// #include "project/base.h"
 
namespace [namespace] {
 
// Forward declarations (avoid when possible)
 
/// Brief description of the class.
///
/// Detailed description if needed. Include:
/// - Purpose and responsibilities
/// - Thread safety guarantees
/// - Example usage (for complex classes)
class [ClassName] {
 public:
  // Types and type aliases
  using ValueType = int;
 
  // Static constants
  static constexpr int kDefaultSize = 100;
 
  // Factory functions (if needed)
  static std::unique_ptr<[ClassName]> Create();
 
  // Constructors
  [ClassName]();
  explicit [ClassName](int value);
 
  // Rule of five - be explicit about copy/move
  [ClassName](const [ClassName]&) = default;
  [ClassName]& operator=([const ClassName]&) = default;
  [ClassName]([ClassName]&&) noexcept = default;
  [ClassName]& operator=([ClassName]&&) noexcept = default;
 
  // Destructor
  ~[ClassName]();
 
  // Public methods
  void Process();
 
  // Accessors and mutators
  int value() const { return value_; }
  void set_value(int value) { value_ = value; }
 
 protected:
  // Protected members (only if needed for inheritance)
 
 private:
  // Private methods
  void InternalHelper();
 
  // Data members (always private for classes)
  int value_ = 0;
  std::string name_;
};
 
}  // namespace [namespace]
 
#endif  // [PROJECT]_[PATH]_[FILENAME]_H_

namespace [namespace] {
 
/// Brief description.
struct [StructName] {
  int field_one;           // No trailing underscore for structs
  std::string field_two;
  float field_three = 0.0f;  // Default values OK
};
 
}  // namespace [namespace]