{"id":15493614,"url":"https://github.com/gridhead/fuas","last_synced_at":"2026-02-06T10:34:24.954Z","repository":{"id":94656519,"uuid":"607503767","full_name":"gridhead/fuas","owner":"gridhead","description":"AutoMAGICally gather and update the statistics of active users in Fedora Project over the course of last given period of time","archived":false,"fork":false,"pushed_at":"2025-01-15T03:08:38.000Z","size":7028,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-04T17:09:07.448Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gridhead.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-02-28T05:07:26.000Z","updated_at":"2023-07-03T17:16:08.000Z","dependencies_parsed_at":"2023-08-28T11:00:56.740Z","dependency_job_id":"685ebec6-c3f2-4dc5-8b34-d596549162a2","html_url":"https://github.com/gridhead/fuas","commit_stats":null,"previous_names":["gridhead/fuas"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gridhead/fuas","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridhead%2Ffuas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridhead%2Ffuas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridhead%2Ffuas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridhead%2Ffuas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gridhead","download_url":"https://codeload.github.com/gridhead/fuas/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridhead%2Ffuas/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265344863,"owners_count":23750567,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-02T08:08:24.527Z","updated_at":"2026-02-06T10:34:19.781Z","avatar_url":"https://github.com/gridhead.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fuas\n\nor Fedora User Activity Statistics\n\nAutoMAGICally gather and update the statistics of active users in Fedora Project over the course of last given period of time\n\n## Usage\n\n### Superficially\n\n\u003e This might not work sometimes due to the time limit for each job present for GitHub Actions.\n\u003e The task for fetching a list of available usernames from FASJSON takes around 2 hours of time while \n\u003e the task for fetching a list of active usernames from Datagrepper takes over 6 hours of time.\n\n1. Install `curl` on your Fedora Linux installation, if not installed already.\n   ```\n   sudo dnf install curl\n   ```\n2. Obtain a list of available usernames by executing the following command.\n   ```\n   curl https://raw.githubusercontent.com/t0xic0der/fuas/main/data/namefile -o /var/tmp/namefile\n   ```\n3. Obtain a list of active usernames by executing the following command.\n   ```\n   curl https://raw.githubusercontent.com/t0xic0der/fuas/main/data/actvfile -o /var/tmp/actvfile\n   ```\n4. Obtain the number of active usernames by executing the following command.\n   ```\n   echo \"$(curl https://raw.githubusercontent.com/t0xic0der/fuas/main/data/acqtfile) usernames active\"\n   ```\n\n### Actively\n\n1. Install `cronie` and `podman` on your Fedora Linux installation, if not installed already.\n   ```\n   $ sudo dnf install cronie podman\n   ```\n2. Clone the repository to your local storage and make it your present working directory.\n   ```\n   $ git clone https://github.com/t0xic0der/fuas.git\n   $ cd fuas\n   ```\n3. Navigate into the [`cron`](https://github.com/t0xic0der/fuas/blob/main/cron/actv-push.Dockerfile) subdirectory and find a set of dockerfiles and shell scripts.\n   ```\n   $ cd cron\n   ```\n   [`actv-push.Dockerfile`](https://github.com/t0xic0der/fuas/blob/main/cron/actv-push.Dockerfile) - For generating a record of active usernames and pushing them to a Git repository  \n   [`actv-only.Dockerfile`](https://github.com/t0xic0der/fuas/blob/main/cron/actv-only.Dockerfile) - For generating a record of active usernames only  \n   [`name-push.Dockerfile`](https://github.com/t0xic0der/fuas/blob/main/cron/name-push.Dockerfile) - For generating a record of available usernames and pushing them to a Git repository  \n   [`name-only.Dockerfile`](https://github.com/t0xic0der/fuas/blob/main/cron/name-only.Dockerfile) - For generating a record of available usernames only  \n4. Make necessary changes to the shell scripts with the same names as their dockerfiles of your choice.\n5. Schedule building of these container images by adding an entry to the cron.\n   ```\n   crontab -e\n   ```\n   Please note that we strongly recommend running these build processes no more than twice a day keeping in mind the \n   long-running and resource intensive nature of the requests made against the services like FASJSON and Datagrepper.\n\n## Development\n\n1. Install Python 3, Virtualenv, PIP and Poetry on your Fedora Linux installation.\n   ```\n   $ sudo dnf install python3 python3-virtualenv python3-pip poetry\n   ```\n2. Clone the repository to your local storage and make it your present working directory.\n   ```\n   $ git clone https://github.com/t0xic0der/fuas.git\n   $ cd fuas\n   ```\n3. Set up and activate a virtual environment within the directory of the cloned repository.\n   ```\n   $ virtualenv venv\n   $ source venv/bin/activate\n   ```\n4. Check the validity of the project configuration and install the project dependencies from the lockfile.\n   ```\n   $ (venv) poetry check\n   $ (venv) poetry install\n   ```\n5. Execute the following command to view the help message.\n   ```\n   $ (venv) fuas --help\n   ```\n   Output\n   ```\n   Usage: fuas [OPTIONS] COMMAND [ARGS]...\n\n   Options:\n     --version  Show the version and exit.\n     --help     Show this message and exit.\n\n   Commands:\n     activity  Fetch a list of active usernames from Datagrepper\n     namelist  Fetch a list of usernames on the Fedora Account System\n   ```\n6. Execute the following command to view the project version.\n   ```\n   $ (venv) fuas --version\n   ```\n   Output\n   ```\n   fuas, version 0.1.0\n   ```\n7. Make necessary changes to the variables located in the `fuas/conf.py` file, following the instructions.\n   ```\n   $ (venv) nano fuas/conf.py\n   ```\n8. Fetch and store the list of available usernames locally by executing the following command.\n   ```\n   $ (venv) fuas namelist\n   ```\n   As this command makes a long-running and resource intensive request to the FASJSON service, it is strongly \n   recommended to not run this command manually and instead rely on the automatically updated list in the project \n   repository.\n9. Fetch and store the list and count of active usernames by executing the following command.\n   ```\n   $ (venv) fuas activity\n   ```\n   As this command makes a long-running and resource intensive request to the Datagrepper service, it is strongly \n   recommended to not run this command manually and instead rely on the automatically updated list and count in the \n   project repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgridhead%2Ffuas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgridhead%2Ffuas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgridhead%2Ffuas/lists"}