format fixes

privacy/bolton/losses.py

@@ -212,12 +212,12 @@ class StrongConvexBinaryCrossentropy(
   """Strongly Convex BinaryCrossentropy loss using l2 weight regularization."""
 
   def __init__(self,
-               reg_lambda: float,
+               reg_lambda,
-               C: float,
+               C,
-               radius_constant: float,
+               radius_constant,
-               from_logits: bool = True,
+               from_logits=True,
-               label_smoothing: float = 0,
+               label_smoothing=0,
-               reduction: str = losses_utils.ReductionV2.SUM_OVER_BATCH_SIZE,
+               reduction=losses_utils.ReductionV2.SUM_OVER_BATCH_SIZE,
                dtype=tf.float32):
     """
     Args:

privacy/bolton/losses_test.py

@@ -367,12 +367,13 @@ class HuberTests(keras_parameterized.TestCase):
       },
   ])
   def test_calculation(self, logits, y_true, delta, result):
-    """Test the call method to ensure it returns the correct value
+    """Test the call method to ensure it returns the correct value.
 
-    Args:
+      Args:
-      logits: unscaled output of model
+        logits: unscaled output of model
-      y_true: label
+        y_true: label
-      result: correct loss calculation value
+        delta:
+        result: correct loss calculation value
     """
     logits = tf.Variable(logits, False, dtype=tf.float32)
     y_true = tf.Variable(y_true, False, dtype=tf.float32)

privacy/bolton/models.py

@@ -86,8 +86,16 @@ class BoltonModel(Model):  # pylint: disable=abstract-method
               **kwargs):  # pylint: disable=arguments-differ
     """See super class. Default optimizer used in Bolton method is SGD.
 
-      Missing args.
+      Args:
-
+        optimizer:
+        loss:
+        metrics:
+        loss_weights:
+        sample_weight_mode:
+        weighted_metrics:
+        target_tensors:
+        distribute:
+        kernel_initializer:
     """
     if not isinstance(loss, StrongConvexMixin):
       raise ValueError('loss function must be a Strongly Convex and therefore '
@@ -126,15 +134,15 @@ class BoltonModel(Model):  # pylint: disable=abstract-method
           **kwargs):  # pylint: disable=arguments-differ
     """Reroutes to super fit with  Bolton delta-epsilon privacy requirements.
 
-    Note, inputs must be normalized s.t. ||x|| < 1.
+      Note, inputs must be normalized s.t. ||x|| < 1.
-    Requirements are as follows:
+      Requirements are as follows:
         1. Adds noise to weights after training (output perturbation).
         2. Projects weights to R after each batch
         3. Limits learning rate
         4. Use a strongly convex loss function (see compile)
-    See super implementation for more details.
+      See super implementation for more details.
 
-    Args:
+      Args:
         n_samples: the number of individual samples in x.
         epsilon: privacy parameter, which trades off between utility an privacy.
                   See the bolton paper for more description.
@@ -189,20 +197,20 @@ class BoltonModel(Model):  # pylint: disable=abstract-method
                     n_samples=None,
                     steps_per_epoch=None,
                     **kwargs):  # pylint: disable=arguments-differ
-    """Fit with a generator..
+    """Fit with a generator.
 
       This method is the same as fit except for when the passed dataset
       is a generator. See super method and fit for more details.
  
       Args:
-        n_samples: number of individual samples in x
+        generator:
+        class_weight: the class weights to be used. Can be a scalar or 1D tensor
+                      whose dim == n_classes.
         noise_distribution: the distribution to get noise from.
         epsilon: privacy parameter, which trades off utility and privacy. See
                   Bolton paper for more description.
-        class_weight: the class weights to be used. Can be a scalar or 1D tensor
+        n_samples: number of individual samples in x
-                      whose dim == n_classes.
+        steps_per_epoch:
-
-        See the super method for descriptions on the rest of the arguments.
     """
     if class_weight is None:
       class_weight = self.calculate_class_weights(class_weight)

privacy/bolton/models_test.py

@@ -32,10 +32,10 @@ from privacy.bolton.optimizers import Bolton
 class TestLoss(losses.Loss, StrongConvexMixin):
   """Test loss function for testing Bolton model."""
 
-  def __init__(self, reg_lambda, C, radius_constant, name='test'):
+  def __init__(self, reg_lambda, C_arg, radius_constant, name='test'):
     super(TestLoss, self).__init__(name=name)
     self.reg_lambda = reg_lambda
-    self.C = C  # pylint: disable=invalid-name
+    self.C = C_arg  # pylint: disable=invalid-name
     self.radius_constant = radius_constant
 
   def radius(self):
@@ -207,7 +207,7 @@ class InitTests(keras_parameterized.TestCase):
         n_outputs: number of output neurons
         loss: instantiated TestLoss instance
         optimizer: instanced TestOptimizer instance
-      """
+    """
     # test compilaton of invalid tf.optimizer and non instantiated loss.
     with self.cached_session():
       with self.assertRaises((ValueError, AttributeError)):
@@ -228,9 +228,10 @@ def _cat_dataset(n_samples, input_dim, n_classes, generator=False):
       input_dim: input dimensionality
       n_classes: output dimensionality
       generator: False for array, True for generator
+
     Returns:
       X as (n_samples, input_dim), Y as (n_samples, n_outputs)
-    """
+  """
   x_stack = []
   y_stack = []
   for i_class in range(n_classes):
@@ -520,7 +521,7 @@ class FitTests(keras_parameterized.TestCase):
         class_counts: count of number of samples for each class
         num_classes: number of outputs neurons
         err_msg:
-      """
+    """
     clf = models.BoltonModel(1, 1)
     with self.assertRaisesRegexp(ValueError, err_msg):  # pylint: disable=deprecated-method
       clf.calculate_class_weights(class_weights,

privacy/bolton/optimizers.py

@@ -298,9 +298,9 @@ class Bolton(optimizer_v2.OptimizerV2):
     return self
 
   def __call__(self,
-               noise_distribution: str,
+               noise_distribution,
-               epsilon: float,
+               epsilon,
-               layers: list,
+               layers,
                class_weights,
                n_samples,
                batch_size

privacy/bolton/optimizers_test.py

@@ -51,11 +51,8 @@ class TestModel(Model):  # pylint: disable=abstract-method
 
     Args:
       n_outputs: number of output neurons
-      epsilon: level of privacy guarantee
+      input_shape:
-      noise_distribution: distribution to pull weight perturbations from
+      init_value:
-      weights_initializer: initializer for weights
-      seed: random seed to use
-      dtype: data type to use for tensors
     """
     super(TestModel, self).__init__(name='bolton', dynamic=False)
     self.n_outputs = n_outputs
@@ -71,18 +68,19 @@ class TestModel(Model):  # pylint: disable=abstract-method
 class TestLoss(losses.Loss, StrongConvexMixin):
   """Test loss function for testing Bolton model."""
 
-  def __init__(self, reg_lambda, C, radius_constant, name='test'):
+  def __init__(self, reg_lambda, C_arg, radius_constant, name='test'):
     super(TestLoss, self).__init__(name=name)
     self.reg_lambda = reg_lambda
-    self.C = C  # pylint: disable=invalid-name
+    self.C = C_arg  # pylint: disable=invalid-name
     self.radius_constant = radius_constant
 
   def radius(self):
     """Radius, R, of the hypothesis space W.
 
-    W is a convex set that forms the hypothesis space.
+      W is a convex set that forms the hypothesis space.
 
-    Returns: radius
+      Returns:
+        radius
     """
     return _ops.convert_to_tensor_v2(self.radius_constant, dtype=tf.float32)
 
@@ -105,10 +103,11 @@ class TestLoss(losses.Loss, StrongConvexMixin):
   def lipchitz_constant(self, class_weight):  # pylint: disable=unused-argument
     """Lipchitz constant, L.
 
-    Args:
+      Args:
-      class_weight: class weights used
+        class_weight: class weights used
 
-    Returns: L
+      Returns:
+        L
     """
     return _ops.convert_to_tensor_v2(1, dtype=tf.float32)
 
@@ -143,7 +142,7 @@ class TestLoss(losses.Loss, StrongConvexMixin):
 
 
 class TestOptimizer(OptimizerV2):
-  """Optimizer used for testing the Bolton optimizer"""
+  """Optimizer used for testing the Bolton optimizer."""
 
   def __init__(self):
     super(TestOptimizer, self).__init__('test')
@@ -263,8 +262,12 @@ class BoltonOptimizerTest(keras_parameterized.TestCase):
   def test_project(self, r, shape, n_out, init_value, result):
     """test that a fn of Bolton optimizer is working as expected.
 
-      Missing args:
+      Args:
-
+        r:
+        shape:
+        n_out:
+        init_value:
+        result:
     """
     tf.random.set_seed(1)
     @tf.function
@@ -524,7 +527,7 @@ class BoltonOptimizerTest(keras_parameterized.TestCase):
 
 
 class SchedulerTest(keras_parameterized.TestCase):
-  """GammaBeta Scheduler tests"""
+  """GammaBeta Scheduler tests."""
 
   @parameterized.named_parameters([
       {'testcase_name': 'not in context',
@@ -533,10 +536,10 @@ class SchedulerTest(keras_parameterized.TestCase):
       }
   ])
   def test_bad_call(self, err_msg):
-    """ test that attribute of internal optimizer is correctly rerouted to
+    """Test attribute of internal opt correctly rerouted to the internal opt.
-    the internal optimizer
 
-    Missing args
+      Args:
+        err_msg:
     """
     scheduler = opt.GammaBetaDecreasingStep()
     with self.assertRaisesRegexp(Exception, err_msg):  # pylint: disable=deprecated-method
@@ -559,7 +562,9 @@ class SchedulerTest(keras_parameterized.TestCase):
       Test that attribute of internal optimizer is correctly rerouted to the
       internal optimizer
 
-      Missing Args:
+      Args:
+        step:
+        res:
     """
     beta = _ops.convert_to_tensor_v2(2, dtype=tf.float32)
     gamma = _ops.convert_to_tensor_v2(1, dtype=tf.float32)