{"id":14988036,"url":"https://github.com/apache/flagon-distill","last_synced_at":"2025-10-19T12:30:40.050Z","repository":{"id":59262300,"uuid":"65358491","full_name":"apache/flagon-distill","owner":"apache","description":"Apache Flagon Distill is a python package to support and analyze Flagon UserAle.js logs","archived":false,"fork":false,"pushed_at":"2024-08-20T20:21:42.000Z","size":16569,"stargazers_count":10,"open_issues_count":7,"forks_count":14,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-10-01T01:09:06.859Z","etag":null,"topics":["apache","behavioral-analytics","behavioral-sciences","business-analytics","flagon","jupyter","pypi","python","usability","usage","user-monitoring"],"latest_commit_sha":null,"homepage":"https://flagon.apache.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apache.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.rst","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-08-10T07:00:06.000Z","updated_at":"2024-08-20T20:21:46.000Z","dependencies_parsed_at":"2023-01-31T04:45:45.385Z","dependency_job_id":"3a0b2e58-3ed3-4b92-aa9b-572e28d98612","html_url":"https://github.com/apache/flagon-distill","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fflagon-distill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fflagon-distill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fflagon-distill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apache%2Fflagon-distill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apache","download_url":"https://codeload.github.com/apache/flagon-distill/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219869248,"owners_count":16555572,"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":["apache","behavioral-analytics","behavioral-sciences","business-analytics","flagon","jupyter","pypi","python","usability","usage","user-monitoring"],"created_at":"2024-09-24T14:15:59.376Z","updated_at":"2025-10-19T12:30:40.045Z","avatar_url":"https://github.com/apache.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. ..\n\n\t\u003c!---\n    Licensed to the Apache Software Foundation (ASF) under one or more\n\tcontributor license agreements.  See the NOTICE file distributed with\n\tthis work for additional information regarding copyright ownership.\n\tThe ASF licenses this file to You under the Apache License, Version 2.0\n\t(the \"License\"); you may not use this file except in compliance with\n\tthe License.  You may obtain a copy of the License at\n\n\t  http://www.apache.org/licenses/LICENSE-2.0\n\n\tUnless required by applicable law or agreed to in writing, software\n\tdistributed under the License is distributed on an \"AS IS\" BASIS,\n\tWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\tSee the License for the specific language governing permissions and\n\tlimitations under the License. \n\t---\u003e\n\n\nApache Flagon Distill\n=====================\n\n🚨 This repository has been archived and it's contents have moved to https://github.com/apache/flagon\n-----------------------------------------------------------------------------------------------------\n\n.. image:: https://readthedocs.org/projects/incubator-flagon-distill/badge/?version=distill_toolkit_refactor\n\t:target: https://incubator-flagon-distill.readthedocs.io/en/distill_toolkit_refactor/?badge=stable\n\t:alt: Documentation Status\n\nThis project is a work in progress, prior to an official Apache Software Foundation release. Check back soon for important updates.\n\nPlease see our `readthedocs.org pages \u003chttps://incubator-flagon-distill.readthedocs.io/en/distill_toolkit_refactor/\u003e`_ for documentation.\n\nA contribution guide has been provided `here \u003chttp://flagon.incubator.apache.org/docs/contributing/\u003e`_.\n\nInstallation\n------------\n\nTo install and set up the Python project, Distill uses `Poetry \u003chttps://python-poetry.org/\u003e`_, a dependency and package management tool. Poetry simplifies the management of project dependencies and virtual environments, ensuring consistent and reproducible builds.\n\nPrerequisites\n~~~~~~~~~~~~~\n\nBefore you begin, make sure you have the following prerequisites installed on your system:\n\n- Python (\u003e= 3.8)\n- Poetry (\u003e= 1.0)\n\nYou can check your Python version by running:\n\n.. code-block:: bash\n\n    python --version\n\nThis will return the version of Python installed on your system. If you do not have Python installed, you can download it from the `official website \u003chttps://www.python.org/downloads/\u003e`_. However, we recommend using a Python version manager such as `pyenv`. You can refer to this guide for setting it up: `pyenv guide \u003chttps://realpython.com/intro-to-pyenv/\u003e`_.\n\nYou can install Poetry a number of ways (see the `Poetry docs \u003chttps://python-poetry.org/docs/\u003e`_ for all methods). We recommend installing one of the following two ways:\n\n**Official Installer**:\n\n*Linux, macOS, Windows (WSL)*\n\n.. code-block:: bash\n\n    curl -sSL https://install.python-poetry.org | python3 -\n\n*Windows (Powershell)*\n\n.. code-block:: bash\n\n    (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -\n\n**pipx**:\n\n.. code-block:: bash\n\n    pipx install poetry\n\nThe above two methods should minimize the chances of dependency conflicts with your system Python (global) installation. Some users have reported issues with Poetry using an incorrect Python environment instead of the project's local virtual environment when using regular pip method. If you run into issues, please refer to the official Poetry docs or Github for more in-depth installation instructions.\n\n\nInstallation Steps\n~~~~~~~~~~~~~~~~~~\n\nFollow these steps to set up and install the project:\n\n1. Clone the repository:\n\n    .. code-block:: bash\n\n        git clone https://github.com/apache/flagon-distill.git\n\n\n2. Navigate to the project directory:\n\n    .. code-block:: bash\n\n        cd flagon-distill\n\n3. Use Poetry to install project dependencies and create a virtual environment:\n\n    .. code-block:: bash\n\n        poetry install\n   \n   This command reads the ``pyproject.toml`` file and installs all required packages into a dedicated virtual environment.\n\n\n4. If you would like to run tests or make changes, install optional dependency groups.\n\n    .. code-block:: bash\n        poetry install --all-groups\n\n5. Run the tests:\n   \n   You can now run the tests to make sure everything installed properly. For example:\n\n    .. code-block:: bash\n        make test\n   \n   Remember that you need to activate the virtual environment (step 4) each time you work on the project.\n\nUpdating Dependencies\n~~~~~~~~~~~~~~~~~~~~~\n\nTo update project dependencies, you can use the following command:\n\n.. code-block:: bash\n\n   poetry update\n\nThis command updates the ``pyproject.toml`` file with the latest compatible versions of the packages.\n\nUninstalling\n~~~~~~~~~~~~\n\nTo uninstall the project and its dependencies, simply deactivate the virtual environment (if activated) by typing:\n\n.. code-block:: bash\n\n   exit\n\nThis will exit the virtual environment. You can then safely delete the project directory.\n\nBy following these installation steps, you can easily set up and manage the Python project using Poetry. Enjoy coding!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fflagon-distill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapache%2Fflagon-distill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapache%2Fflagon-distill/lists"}