memorymanagement 1.1.0

Adds support for memory management

memorymanagement

Provides memory management support.

The only Python implementation currently supported is the one made by the CPython team. The rest remain untested.

Modules

cleaning

Provides the class Cleaner, which allows you to flag references stored in memory to eventually erase them. It is also possible to modify the list of flagged references through its methods.

pointers

Provides a safe implementation of pointers for Python.

Class Pointer

The pointer itself. Imitates the behaviour of C pointers. This pointer points to a reference, not to an object stored in memory.

Decorator pointerize

Allows functions to receive pointers instead of values.

Installation

You can install the memorymanagement package from PyPI as follows:

pip install memorymanagement

How to use

Class Cleaner

# Imports
# Make your imports here
from memorymanagement import Cleaner # Importing class Cleaner

Right after imports are done, I recommend to initialize an instance of class Cleaner, so no arguments are needed. This is the optimal use this class was designed for.

# Initialize cleaner object
cleaner=Cleaner()

Create, for example, these global variables:

value_1=10
value_2=50
value_3=100

Update the list of flagged references like one of the following:

• Including all new global variables:

  cleaner.update()
  print(cleaner.flagged)
  

  Output:

  ["value_1","value_2","value_3"]
  

• Excluding some variables:

  cleaner.update(exclude="value_2")
  print(cleaner.flagged)
  

  Output:

  ["value_1","value_3"]
  

  ---

  cleaner.update(exclude=["value_2","value_3"])
  print(cleaner.flagged)
  

  Output:

  ["value_1"]
  

• Include again some variables:

  After having excluded some variables

  cleaner.update(exclude=["value_2","value_3"])
  

  You can reintroduce them

  # Create a new variable and update
  value_4=150
  cleaner.update(exclude="value_4",include="value_2") # "include" can also be a list of strings
  print(cleaner.flagged)
  

  Output:

  ["value_1","value_2"]
  

You can also directly include or exclude references like so:

cleaner.exclude(<name_var_1>,<name_var_2>,...)

cleaner.include(<name_var_1>,<name_var_2>,...)

Class Pointer

Example:

from memorymanagement import Pointer
a=10
x=Pointer(a)
print(f"a:\n{a}\n\nPointer:\n{x.value}\n\n")
a=20
print(f"a:\n{a}\n\nPointer:\n{x.value}\n\n")
a=10
x.value=20
print(f"a:\n{a}\n\nPointer:\n{x.value}")

Output:

a:
10

Pointer:
10


a:
20

Pointer:
20


a:
20

Pointer:
20

Decorator pointerize

Example:

from memorymanagement import pointerize
@pointerize
def myFunction(value:int):
    value=20
    return
a=10
print(f"Value: {a}")
myFunction(Pointer(a))
print(f"Value: {a}")

Output:

Value: 10
Value: 20

Contribution

To contribute to this project, clone or fork this repository.

There are to branches:

• PyPI: the main branch, for releases.
• TestPyPI: for pre-releases or development versions.

Pull requests from TestPyPI to PyPI will be accepted when a new release is finished.