Skip to main content

The small Python library to read resources available for Linux OS container.

Project description

Python package


The simple library to gather CPU and memory resource limits from within OS Container bases on Linux.


pip install oscontainer

Usage in code

The library can be used to acquire current limits exposed to the container or process as following:

from oscontainer import OSContainer

# Get the container instance
container = OSContainer()

# Check if current process runs inside container
if container.is_containerized():
    # Get active processors
    cpus_count = container.active_processor_count()
    # Get the limit of available memory for this process.
    mem_limit = container.memory_limit_in_bytes()
    print("No Container support detected")

For extra metrics available see OSContainer.

Run in Docker from source code

To run library in the test container you need to build the docker image and run it as container.

Checkout the repository.

git clone

Build local image with oscontainer name.

cd oscontainer

docker build -f Dockerfile -t oscontainer . 

Run the image we built within container with specific CPU limits set. For details about setting container resources limits with Docker, see: Runtime options with Memory, CPUs, and GPUs.

The following command will start container and open interactive shell:

docker run -it --cpus=".5" oscontainer /bin/bash

Now, execute script within shell to see resource constraints that was detected:


This will produce the output like following:

   active processors: 1
      container type: cgroup2
memory limit (bytes): -1
memory usage (bytes): 9908224
 > CPU:
               quota: 50000
              period: 100000
              shares: -1
         cpuset cpus: 

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oscontainer-1.0.1.tar.gz (15.9 kB view hashes)

Uploaded source

Built Distribution

oscontainer-1.0.1-py3-none-any.whl (18.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page