DC "Give SNAP A Raise" program (#4226)

* DC "Give SNAP A Raise" program
Fixes #3609

* Fixes

* changes

* some changes

* value changes

* changes

* merge branch and make changes

* changes

* DC "Give SNAP A Raise" program
Fixes #3609

* changes

* changes

* Merge branch

Co-authored-by: Pavel Makarchuk <PavelMakarchuk@users.noreply.github.com>

* format

---------

Co-authored-by: Pavel Makarchuk <PavelMakarchuk@users.noreply.github.com>
Co-authored-by: PavelMakarchuk <pavel.ma99@gmail.com>

changelog_entry.yaml

@@ -0,0 +1,4 @@
+- bump: minor
+  changes:
+    added:
+    - DC "Give SNAP A Raise" program.

policyengine_us/parameters/gov/usda/snap/temporary_local_benefit/dc/rate.yaml

@@ -0,0 +1,22 @@
+description: DC provides a temporary local SNAP benefit of this percentage of the maximum allotment.
+values:
+  0000-01-01: 0
+  # The legal code set the effective date of 2023-10-01, with no end date,
+  # conditional on funding.
+  # DC DHS documentation indicates that it is funded only from 2024-01-01 to
+  # 2024-10-01.
+  2024-01-01: 0.1
+  2024-10-01: 0
+metadata:
+  period: year
+  unit: /1
+  label: DC temporary local SNAP benefit rate
+  reference:
+    - title: Supplemental Nutrition Assistance Program (SNAP) raise in District of Columbia in 2024.
+      href: https://dhs.dc.gov/page/give-snap-raise-heres-what-expect
+    - title: D.C. Law 24-301. Give SNAP a Raise Amendment Act of 2022. Sec 5084 amending (D.C. Official Code § 4-261.04 (b) ) 
+      href: https://code.dccouncil.gov/us/dc/council/laws/24-301
+    # D.C. Law 24-301 amends § 4–261.04 conditional on addition to an approved budget.
+    # As of 2024-04-16, this has now occurred (per DC DHS), but the legal code does not yet reflect it.
+    - title: Code of the District of Columbia § 4–261.04. Locally funded supplemental benefits.
+      href: https://code.dccouncil.gov/us/dc/council/code/sections/4-261.04

policyengine_us/tests/policy/baseline/gov/usda/snap/dc_snap_temporary_local_benefit.yaml

@@ -0,0 +1,48 @@
+- name: Household size 1, State DC
+  period: 2024-01
+  input:
+    spm_unit_size: 1
+    state_code: DC
+    snap_region_str: CONTIGUOUS_US
+  output:
+    # 291 * 0.1 = 29.1
+    dc_snap_temporary_local_benefit: 29.1
+
+- name: Household size 4, State DC
+  period: 2024-01
+  input:
+    spm_unit_size: 4
+    state_code: DC
+    snap_region_str: CONTIGUOUS_US
+  output:
+    # 973 * 0.1 = 97.3
+    dc_snap_temporary_local_benefit: 97.3
+
+- name: Household size 4, State DC, yearly
+  period: 2024
+  input:
+    spm_unit_size: 4
+    state_code: DC
+    snap_region_str: CONTIGUOUS_US
+  output:
+    # 973 * 0.1 = 97.3 * 9 = 875.7
+    dc_snap_temporary_local_benefit: 875.7
+
+- name: Household size 10, State DC, yearly
+  period: 2024
+  input:
+    spm_unit_size: 10
+    state_code: DC
+    snap_region_str: CONTIGUOUS_US
+  output:
+    # (1751 + 219 * 2) * 0.1 * 9 = 1_970.1
+    dc_snap_temporary_local_benefit: 1_970.1
+
+- name: Test using snap_max_allotment
+  period: 2024
+  input:
+    snap_max_allotment: 1_000
+    state_code: DC
+  output:
+    # (1000 * 0.1) / 12 * 9 = 75
+    dc_snap_temporary_local_benefit: 75

policyengine_us/tests/policy/baseline/gov/usda/snap/snap.yaml

@@ -17,3 +17,24 @@
       2022-12: 0
   output:
     snap: 3
+
+- name: Total SNAP sums normal and emergency allotments in 2024 with DC temporary local benefit.
+  period: 2024
+  input:
+    snap_normal_allotment: 1
+    snap_emergency_allotment: 
+      2024-01: 2
+      2024-02: 0
+      2024-03: 0
+      2024-04: 0
+      2024-05: 0
+      2024-06: 0
+      2024-07: 0
+      2024-08: 0
+      2024-09: 0
+      2024-10: 0
+      2024-11: 0
+      2024-12: 0
+    dc_snap_temporary_local_benefit: 3 
+  output:
+    snap: 6

policyengine_us/tests/policy/baseline/household/cliff_gap.yaml

@@ -41,6 +41,7 @@
     employment_income: 76_500
     rent: 24_000
     state_fips: 11  # DC
+    dc_snap_temporary_local_benefit: 0
   output:
     adjusted_gross_income: 76_500
     dc_ptc: 1_225
@@ -54,6 +55,7 @@
     employment_income: 76_500 + 1_000
     rent: 24_000
     state_fips: 11  # DC
+    dc_snap_temporary_local_benefit: 0
   output:
     adjusted_gross_income: 76_500 + 1_000
     dc_ptc: 0
@@ -88,6 +90,7 @@
     spm_units:
       spm_unit:
         members: [person1, person2]
+        dc_snap_temporary_local_benefit: 0
     households:
       household:
         members: [person1, person2]
@@ -114,6 +117,7 @@
     spm_units:
       spm_unit:
         members: [person1, person2]
+        dc_snap_temporary_local_benefit: 0
     households:
       household:
         members: [person1, person2]

policyengine_us/variables/gov/usda/snap/dc_snap_temporary_local_benefit.py

@@ -0,0 +1,22 @@
+from policyengine_us.model_api import *
+
+
+class dc_snap_temporary_local_benefit(Variable):
+    value_type = float
+    entity = SPMUnit
+    definition_period = MONTH
+    documentation = "DC temporary SNAP benefit amount"
+    label = "DC temporary local SNAP benefit amount"
+    reference = (
+        "https://dhs.dc.gov/page/give-snap-raise-heres-what-expect",
+        "https://code.dccouncil.gov/us/dc/council/laws/24-301",
+    )
+    unit = USD
+    defined_for = StateCode.DC
+
+    def formula(spm_unit, period, parameters):
+        p = parameters(period).gov.usda.snap.temporary_local_benefit.dc
+
+        max_allotments = spm_unit("snap_max_allotment", period)
+
+        return max_allotments * p.rate

policyengine_us/variables/gov/usda/snap/snap.py

@@ -19,5 +19,9 @@ def formula(spm_unit, period, parameters):
             return add(
                 spm_unit,
                 period,
-                ["snap_normal_allotment", "snap_emergency_allotment"],
+                [
+                    "snap_normal_allotment",
+                    "snap_emergency_allotment",
+                    "dc_snap_temporary_local_benefit",
+                ],
             )