Rangekeeper 0.8.24__py3-none-any.whl → 0.8.26__py3-none-any.whl

rangekeeper/extrapolation.py

@@ -8,10 +8,12 @@ from abc import abstractmethod
 
 
 class Type(enum.Enum):
-    STRAIGHT_LINE = 'StraightLine'  # A constant-change (linearly growing (or decaying)) projection form, originating from an initial value.
-    COMPOUNDING = 'Compounding'  # An exponentially growing (compounding) or decaying projection at a specified rate per period.
-    RECURRING = 'Recurring'  # A projection form that repeats a specified sequence of values.
-    DYNAMIC = 'Dynamic'  # A projection form generated by a stochastic process.
+    STRAIGHT_LINE = "StraightLine"  # A constant-change (linearly growing (or decaying)) projection form, originating from an initial value.
+    COMPOUNDING = "Compounding"  # An exponentially growing (compounding) or decaying projection at a specified rate per period.
+    RECURRING = (
+        "Recurring"  # A projection form that repeats a specified sequence of values.
+    )
+    DYNAMIC = "Dynamic"  # A projection form generated by a stochastic process.
 
 
 class Form:
@@ -21,9 +23,7 @@ class Form:
     """
 
     @abstractmethod
-    def terms(
-            self,
-            sequence: pd.RangeIndex) -> [float]:
+    def terms(self, sequence: pd.RangeIndex) -> [float]:
         """
         Returns the set of terms that define the projection's form at each value in the sequence.
         """
@@ -37,15 +37,11 @@ class StraightLine(Form):
     To calculate the factor, the projection is modelled as a linear function of (slope * period) + 1
     """
 
-    def __init__(
-            self,
-            slope: float):
+    def __init__(self, slope: float):
         self.type = Type.STRAIGHT_LINE
         self.slope = slope
 
-    def terms(
-            self,
-            sequence: pd.RangeIndex) -> [float]:
+    def terms(self, sequence: pd.RangeIndex) -> [float]:
         """
         Returns the additive terms to the projection at each value in the sequence.
         """
@@ -65,15 +61,11 @@ class Compounding(Form):
     To calculate the factor, the projection is modelled as an exponential function of (1 + rate) ** period
     """
 
-    def __init__(
-            self,
-            rate: float):
+    def __init__(self, rate: float):
         self.type = Type.COMPOUNDING
         self.rate = rate
 
-    def terms(
-            self,
-            sequence: pd.RangeIndex) -> [float]:
+    def terms(self, sequence: pd.RangeIndex) -> [float]:
         """
         Returns the multiplicative factors of the projection's form at each value in the sequence.
         """
@@ -83,15 +75,11 @@ class Compounding(Form):
 class Dynamic(Form):
     series: pd.Series
 
-    def __init__(
-            self,
-            series: pd.Series):
+    def __init__(self, series: pd.Series):
         self.type = Type.DYNAMIC
         self.series = series
 
-    def terms(
-            self,
-            sequence: pd.RangeIndex) -> [float]:
+    def terms(self, sequence: pd.RangeIndex) -> [float]:
         """
         Returns the multiplicative factors of the projection's form at each value in the sequence.
         """

rangekeeper/flux.py

@@ -324,21 +324,35 @@ class Flow:
             movements=frame["Discounted Flow"], units=self.units, name=name
         )
 
-    def xirr(self) -> float:
-        return pyxirr.xirr(
+    def xirr(
+        self, registry: pint.UnitRegistry = rk.measure.Index.registry
+    ) -> pint.Quantity:
+        """
+        Returns the XIRR (Extended Internal Rate of Return) of the Flow's movements.
+        Formats the result as a percentage in the specified registry's units.
+        """
+        result = pyxirr.xirr(
             dates=list(self.movements.index.array),
             amounts=self.movements.to_list(),
         )
+        return result * 100 * registry.percent
 
     def xnpv(
         self,
-        rate: float,
-    ) -> float:
-        return pyxirr.xnpv(
+        rate: Union[float, pint.Quantity],
+    ) -> pint.Quantity:
+        """
+        Returns the XNPV (Extended Net Present Value) of the Flow's movements at a specified rate.
+        Formats the result as a quantity in the Flow's units.
+        """
+        if isinstance(rate, pint.Quantity):
+            rate = rate.to(rk.measure.Index.registry.dimensionless).magnitude
+        result = pyxirr.xnpv(
             rate=rate,
             dates=list(self.movements.index.array),
             amounts=self.movements.to_list(),
         )
+        return result * self.units
 
     def diff(
         self,

rangekeeper/measure.py

@@ -102,7 +102,7 @@ def register_currency(
     return Measure(
         name=currency.name,
         definition="Currency of {0}".format(currency.countries),
-        units=registry[currency.code].units,
+        units=registry.parse_units(currency.code),
     )
 
 

{rangekeeper-0.8.24.dist-info → rangekeeper-0.8.26.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Rangekeeper
-Version: 0.8.24
+Version: 0.8.26
 Summary: A Python library assisting financial modelling in real estate asset & development planning, decision-making, cashflow forecasting, and scenario analysis.
 Author-email: Daniel Fink <danfink@mit.edu>
 License-Expression: MPL-2.0

{rangekeeper-0.8.24.dist-info → rangekeeper-0.8.26.dist-info}/RECORD

@@ -2,11 +2,11 @@ rangekeeper/__init__.py,sha256=3ed6dqjrwb0_Z1le9oItyOFHFrAtP0XJIVhZG07iqZ0,1731
 rangekeeper/api.py,sha256=3nuG7C2IQjpumcn79MvYDTa7ADWPAos7VfVM-3pL4n4,4798
 rangekeeper/distribution.py,sha256=2C3jhi1rLJUs0seBztdQb196hNhc00sKJEGMkFiDpYs,8961
 rangekeeper/duration.py,sha256=9GU6dcZTL_OAOgEHLGkCVxjG16_Po1IMEU29K5g4iRM,20433
-rangekeeper/extrapolation.py,sha256=PLiQsMXujHOaodBoFoLcV7A1a2YG6WLIGFZIIg2I7hA,2973
-rangekeeper/flux.py,sha256=X1m4bkGQqRG5DswYWh46nwcbgIfKqj2sk6xLhaFYzYE,31227
+rangekeeper/extrapolation.py,sha256=Zfsz2KwkImxEMMCNZaF8RpiQxlIgemS1dQkSnjliYU4,2814
+rangekeeper/flux.py,sha256=R7W8GwiVcgRSw8Y1GgucrcQpWDFYS510EP2uRslRc5s,31916
 rangekeeper/format.py,sha256=DOfF4-LCXqWyCtE1OomwE80sJLe6LjL4gqEOAP454LQ,10796
 rangekeeper/graph.py,sha256=6oWRv-qzGsM5Z19UyJ1v3hwtWaQp_F4qQKxizvkQ_gg,28043
-rangekeeper/measure.py,sha256=gVhmq4JLZFzvwmPAlAwZ8M5GfTDNDzuwm0zD1t2e1r8,4119
+rangekeeper/measure.py,sha256=eCdoTAocq1loNZBnOp3nPiPV7yIi0QTwpVHvjba1hkY,4125
 rangekeeper/policy.py,sha256=8p-sl7SpcE_FTwpwR6wR8COotNISzD4bcqZqPHoJCQI,567
 rangekeeper/projection.py,sha256=r5fHDeobCMvQkFqohCIR4SfH1fmkV4aQUlzxmF429mU,6231
 rangekeeper/segmentation.py,sha256=-qZkXQ7JbSKp_psORog3TIP8yag6ooe9hGD9uuylcSk,6862
@@ -20,7 +20,7 @@ rangekeeper/dynamics/trend.py,sha256=-WqrRvmmTj2mE24Pz-Dl5lXEpLXnDUMngafU__em_ac
 rangekeeper/dynamics/volatility.py,sha256=MGDLzrI1uP_C6HL-pigJwWikHg1KNbfB_0m0Akh-L2A,5162
 rangekeeper/formula/__init__.py,sha256=4OXzdJAYDBxQeOMzLR5MZvIjxxIfFOTE9aNu9zFryAE,36
 rangekeeper/formula/financial.py,sha256=oNFdhygbtdEUFjpxYFuuDnpC_P8nOO538b21FzaMtTU,14045
-rangekeeper-0.8.24.dist-info/METADATA,sha256=D5oueno-TSNZ26V3OzefkIABhfOsWYWwxKyzCfm6ImI,2212
-rangekeeper-0.8.24.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rangekeeper-0.8.24.dist-info/top_level.txt,sha256=7ov6d70lppmzKc088MAmRWnCtCRGA2cd43G28QBSv-c,12
-rangekeeper-0.8.24.dist-info/RECORD,,
+rangekeeper-0.8.26.dist-info/METADATA,sha256=uvEDt-iGG-ofh01UcYM3srEUOUW9OxpHV-GOE5lL8PU,2212
+rangekeeper-0.8.26.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rangekeeper-0.8.26.dist-info/top_level.txt,sha256=7ov6d70lppmzKc088MAmRWnCtCRGA2cd43G28QBSv-c,12
+rangekeeper-0.8.26.dist-info/RECORD,,