"occupancy",

"uoft_phpipam.ansible_lookup",

"uoft_phpipam",

"uoft_librenms.cli",

"uoft_ssh.pexpect_utils",

"uoft_ssh.util",

"uoft_snipeit.print",

"uoft_snipeit.cli",

"uoft_snipeit.create",

"uoft_snipeit.mkinventorylabel",

"uoft_snipeit.checkout",

"uoft_snipeit.serial_lookup",

"uoft_snipeit.batch",

"uoft_snipeit",

"uoft_snipeit.generate",

"uoft_snipeit.api",

"uoft_snipeit.location_lookup",

"uoft_occupancy.cli",

"uoft_occupancy",

"uoft_scripts",

"uoft_scripts._jinja",

"uoft_scripts.stg_ipam_dev.cli",

"uoft_scripts.stg_ipam_dev.lib",

"uoft_scripts.stg_ipam_dev",

"uoft_scripts.sib_turnup",

"uoft_scripts.librenms",

"uoft_scripts.ldap",

"uoft_scripts.nautobot.cli",

"uoft_scripts.nautobot.lib",

"uoft_scripts.nautobot",

"uoft_scripts.arista",

"uoft_nautobot.datasources",

"uoft_nautobot.urls",

"uoft_nautobot.secrets",

"uoft_nautobot.excel",

"uoft_nautobot",

"uoft_nautobot.golden_config",

"uoft_nautobot.jinja_filters",

"uoft_nautobot.template_content",

"uoft_nautobot.auth",

"uoft_nautobot.api.views",

"uoft_nautobot.api.urls",

"uoft_nautobot.api",

"uoft_aruba.cli",

"uoft_aruba.batch",

"uoft_aruba",

"uoft_aruba.api",

"uoft_aruba.cli_commands.station_blocklist",

"uoft_aruba.cli_commands.cpsec_allowlist",

"uoft_aruba.cli_commands",

"uoft_aruba.cli_commands.list_aps",

"uoft_switchconfig.deploy",

"uoft_switchconfig.util",

"uoft_switchconfig.__main__",

"uoft_core.console",

"uoft_core.logging",

"uoft_core.nested_data",

"uoft_core.__main__",

"uoft_core.toml",

"uoft_core.toml._parser",

"uoft_core.yaml.representer",

"uoft_core.yaml.util",

"uoft_core.yaml.comments",

"uoft_core.yaml.main",

"uoft_core.yaml.serializer",

"uoft_core.yaml.io",

"uoft_core.yaml.scalarint",

"uoft_core.yaml.constructor",

"uoft_core.yaml.error",

"uoft_core.yaml.emitter",

"uoft_core.yaml.anchor",

"uoft_core.yaml.compat",

"uoft_core.yaml",

"uoft_core.yaml.events",

"uoft_core.yaml.scalarbool",

"uoft_core.yaml.tokens",

"uoft_core.yaml.parser",

"uoft_grist.cli",

"uoft_grist",

"uoft_bluecat.cli",

"uoft_bluecat",

"uoft_bluecat.api",

_src_path: tasks/_new_project/template

author_email: kyle.fozo@utoronto.ca

author_name: Kyle-Fozo

description: Occupancy tracking

name: occupancy

Occupancy tracking

This software requires Python3.10 or higher.

We recommend you install this software with [pipx](https://pypa.github.io/pipx/):

$ python3.10 -m pip install --user pipx

$ pipx install uoft_occupancy

If you don't have or cannot easily get python3.10, you can run the following commands to download a standalone python3.10 binary and use it to install pipx:

$ curl -L https://github.com/uoft-networking/tools/releases/download/1.1.0/ensure-python.py

$ python ensure-python.py pipx

# You can use python2 or python3 to run this script

Install [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) and the [Windows Terminal](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701?hl=en-ca&gl=ca) and then follow the instructions for MacOS / Linux above.

Configuration for this application is loaded from multiple sources. All configuration from all sources is merged together. In the event of configuration conflicts, the configuration from the last source will take precedence.

Configuration is loaded from the following sources in order:

1. Configuration files in the following locations:

Linux:

- `/etc/xdg/uoft-tools/shared.ini`

- `/etc/xdg/uoft-tools/shared.yaml`

- `/etc/xdg/uoft-tools/shared.json`

- `/etc/xdg/uoft-tools/shared.toml`

- `/etc/xdg/uoft-tools/occupancy.ini`

- `/etc/xdg/uoft-tools/occupancy.yaml`

- `/etc/xdg/uoft-tools/occupancy.json`

- `/etc/xdg/uoft-tools/occupancy.toml`

- `~/.config/uoft-tools/shared.ini`

- `~/.config/uoft-tools/shared.yaml`

- `~/.config/uoft-tools/shared.json`

- `~/.config/uoft-tools/shared.toml`

- `~/.config/uoft-tools/occupancy.ini`

- `~/.config/uoft-tools/occupancy.yaml`

- `~/.config/uoft-tools/occupancy.json`

- `~/.config/uoft-tools/occupancy.toml`

MacOS:

- `/Library/Preferences/uoft-tools/shared.ini`

- `/Library/Preferences/uoft-tools/shared.yaml`

- `/Library/Preferences/uoft-tools/shared.json`

- `/Library/Preferences/uoft-tools/shared.toml`

- `/Library/Preferences/uoft-tools/occupancy.ini`

- `/Library/Preferences/uoft-tools/occupancy.yaml`

- `/Library/Preferences/uoft-tools/occupancy.json`

- `/Library/Preferences/uoft-tools/occupancy.toml`

- `~/.config/uoft-tools/shared.ini`

- `~/.config/uoft-tools/shared.yaml`

- `~/.config/uoft-tools/shared.json`

- `~/.config/uoft-tools/shared.toml`

- `~/.config/uoft-tools/occupancy.ini`

- `~/.config/uoft-tools/occupancy.yaml`

- `~/.config/uoft-tools/occupancy.json`

- `~/.config/uoft-tools/occupancy.toml`

- `~/Library/Preferences/uoft-tools/shared.ini`

- `~/Library/Preferences/uoft-tools/shared.yaml`

- `~/Library/Preferences/uoft-tools/shared.json`

- `~/Library/Preferences/uoft-tools/shared.toml`

- `~/Library/Preferences/uoft-tools/occupancy.ini`

- `~/Library/Preferences/uoft-tools/occupancy.yaml`

- `~/Library/Preferences/uoft-tools/occupancy.json`

- `~/Library/Preferences/uoft-tools/occupancy.toml`

The site-wide config directory (`/etc/xdg/uoft-tools` or `/Library/Preferences` in the above example) can be overridden by setting the `OCCUPANCY_SITE_CONFIG` environment variable.

The user config directory (`~/.config/uoft-tools` or `~/Library/Preferences` in the above example) can be overridden by setting the `OCCUPANCY_USER_CONFIG` environment variable.

2. [Pass](https://www.passwordstore.org/) secret named `uoft-occupancy` (if available). Configuration stored in pass must be written in [TOML](https://toml.io/en/) format.

3. Environment variables. Environment variables are loaded from the `OCCUPANCY_` namespace. For example, the `foo` configuration option can be set by setting the `OCCUPANCY_FOO` environment variable.

Configuration Options:

| Option | Type | Title | Description | Default |

| ------ | ---- | ----- | ----------- | ------- |

| psql_database | str | | | annotation=NoneType required=True title='PSQL Database name' description='The username used to manage the PSQL database.' |

| psql_host | str | | | annotation=NoneType required=True title='PSQL hostname' description='The hostname of the PSQL database.' |

| psql_user | str | | | annotation=NoneType required=True title='PSQL username' description='The username used to manage the PSQL database.' |

| psql_password | SecretStr | | | annotation=NoneType required=True title='PSQL database password' description='The password used to manage the PSQL database.' |

| psql_port | str | | | annotation=NoneType required=True title='PSQL database port' description='The port for the database on the host' |

| aruba_svc_account | str | | | annotation=NoneType required=True title='Aruba API Authentication Account' description="Account used to log into the API of Aruba 'Managed Devices'." |

| aruba_svc_password | SecretStr | | | annotation=NoneType required=True title='Aruba API Authentication Password' description="Password used to log into the API of Aruba 'Managed Devices'." |

| aruba_md_hostnames | str | | | annotation=NoneType required=True title='Aruba Controller (Managed Device) IP Adresses / Hostnames' description='A list of Aruba MD names to query.' |

| aruba_default_config_path | str | | | annotation=NoneType required=True title='Aruba API Default Config Path' description="Default config path used for API requests of Aruba 'Managed Devices'." |

| global_ranges | str | | | annotation=NoneType required=True title='Global column ranges' description='List used in conjunction with unique users.' |

| filter_ranges | str | | | annotation=NoneType required=True title='Global filter ranges' description='Used to count unique users.' |

| departments | Department | | | annotation=NoneType required=True title='Departmental Models' description='Any number of departmental models can be created as long as they follow the class format defined.' |

MIT

def pdm_build_initialize(context):

if "dependencies" in context.config_settings:

target = context.config_settings["dependencies"]

import re

from pathlib import Path

import subprocess

monorepo_root = Path(__file__).parent.parent.parent

# TODO: find out if python build frontends like pip ALWAYS initialize submodules

# if so, this call won't be necessary

subprocess.run(["git", "submodule", "init"], cwd=monorepo_root)

forks_dir = monorepo_root / "custom-forks"

forks = {fork.name: fork for fork in forks_dir.iterdir() if fork.is_dir() and not fork.name.startswith("_")}

if target == "local":

def local_dependency(name: str):

if name.startswith("uoft_"):

proj_name = name.partition(" ")[0].partition("uoft_")[2]

proj_dir = monorepo_root / "projects" / proj_name

if proj_dir.exists():

return f"{name} @ file://{proj_dir}"

base_name = re.split(r" |<|>|!|=|~|@|\[", name)[0]

if base_name in forks:

extras = re.search(r"\[.*\]", name)

if extras:

base_name = f"{base_name}{extras.group()}"

return f"{base_name} @ file://{forks[base_name]}"

return name

metadata = context.config.metadata

metadata["dependencies"] = [local_dependency(dep) for dep in metadata["dependencies"]]

print("Local dependencies selected")