{"id":22753710,"url":"https://github.com/slaclab/trace","last_synced_at":"2025-04-14T15:34:10.693Z","repository":{"id":147399147,"uuid":"549849739","full_name":"slaclab/trace","owner":"slaclab","description":"Live and Archived data plotting tool","archived":false,"fork":false,"pushed_at":"2025-03-27T22:54:58.000Z","size":4262,"stargazers_count":4,"open_issues_count":42,"forks_count":4,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-03-27T23:29:17.887Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://slaclab.github.io/trace/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slaclab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-11T20:48:47.000Z","updated_at":"2025-03-11T17:40:58.000Z","dependencies_parsed_at":"2024-08-09T22:45:17.355Z","dependency_job_id":"870251f0-c0b2-45e9-9dfb-496a5168c77c","html_url":"https://github.com/slaclab/trace","commit_stats":null,"previous_names":["slaclab/trace"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slaclab%2Ftrace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slaclab%2Ftrace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slaclab%2Ftrace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slaclab%2Ftrace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slaclab","download_url":"https://codeload.github.com/slaclab/trace/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248906436,"owners_count":21181177,"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-12-11T06:12:51.957Z","updated_at":"2025-04-14T15:34:10.673Z","avatar_url":"https://github.com/slaclab.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Trace\n\ntrace is an PyDM-based application developed at SLAC National Accelerator Laboratory. trace has been built to replace the antiquated StripTool and Java Archive Viewer applications used to plot EPICS data. trace is a flexible, modern application for plotting live data (Channel Access or PV Access), and historical data from the EPICS Archive Appliance. With built in conveniences like an archived PV search, and designed to be easily launched from PyDM widgets, files, or the command line, trace will provide an improved user experience for accelerator staff. Trace is an open-source project.\n\nFor more information and a how to guide on trace see [the project's website](https://slaclab.github.io/trace/)\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/slaclab/trace/issues/new?labels=bug\u0026projects=\u0026template=bug-report.yml\u0026title=%5BBUG%5D+-+\"\u003eReport bug\u003c/a\u003e\n  ·\n  \u003ca href=\"https://github.com/slaclab/trace/issues/new?labels=enhancement\u0026projects=\u0026template=feature-request.yml\u0026title=%5BFEATURE%5D+-+\"\u003eRequest feature\u003c/a\u003e\n\n\u003c/p\u003e\n\n## Contributing to Trace\n\nThank you for your interest in contributing to **Trace**! Your contributions help make the project better for everyone. Below are the guidelines to ensure a smooth and efficient collaboration.\n\n### How to Contribute\n\n1. **Fork and Clone the Repository**\n   - Fork the [Trace repository](https://github.com/slaclab/trace) on GitHub.\n   - Clone your fork to your local machine:\n     ```bash\n     git clone https://github.com/your-username/trace.git\n     cd trace\n     ```\n\n2. **Set Up Your Development Environment**\n   - Install the necessary dependencies:\n     ```bash\n     pip install -r requirements.txt\n     ```\n\n3. **Implement Your Changes**\n   - **Code Style:** Follow the [PEP8](https://peps.python.org/pep-0008/) style guide for Python code.\n   - **Documentation:** Add docstrings to all new methods and classes using the [NumPy style guide](https://numpydoc.readthedocs.io/en/latest/format.html).\n   - **Unit Tests:** Write unit tests for your changes using [Pytest](https://docs.pytest.org/).\n\n4. **Run Tests Locally**\n   - Ensure all tests pass before submitting:\n     ```bash\n     pytest\n     ```\n\n5. **Create a Pull Request (PR)**\n   - When you feel like your feature is ready to be merged into Trace make a PR and request feedback from the Maintainers.\n   - Provide a descriptive title and detailed description of your changes.\n\n### Pull Request Requirements\n\nTo ensure your PR is reviewed efficiently, please adhere to the following:\n\n- **Unit Tests:**\n  - Include tests for all new functionality.\n  - Ensure tests cover different scenarios and edge cases.\n\n- **Documentation:**\n  - All new methods and classes must have comprehensive docstrings.\n  - Follow the [NumPy style guide](https://numpydoc.readthedocs.io/en/latest/format.html) for consistency.\n\n- **Code Quality:**\n  - Adhere to the [PEP8](https://peps.python.org/pep-0008/) style guide.\n  - Ensure your code is clean, well-organized, and free of unnecessary complexity.\n\n### Additional Guidelines\n- **Communication:**\n  - For significant changes, consider opening an issue to discuss your approach before starting.\n\n### Resources\n\n- [NumPy Docstring Guide](https://numpydoc.readthedocs.io/en/latest/format.html)\n- [PEP8 Style Guide](https://peps.python.org/pep-0008/)\n- [Pytest Documentation](https://docs.pytest.org/)\n\n### Notes on Contributing to the Documentation\n\n1. **Set Up Your Development Environment**\n   - Ensure you are working on your development environment.\n\n2. **Navigate to the Project Directory**\n   - Go to the top-level `trace` project directory, which contains the `mkdocs.yml` file.\n\n3. **Make and Test Your Changes Locally**\n   - Edit the documentation files as needed.\n   - Test your changes locally using MkDocs before submitting a pull request.\n\n---\n\n#### Detailed Steps\n\n1. **Set Up Your Development Environment**\n   - Make sure you have all the necessary tools installed (e.g., Python, MkDocs).\n\n2. **Navigate to the Project Directory**\n   ```bash\n   cd path/to/trace\n\n3. **Install Dependencies**\n   ```bash\n    pip install -r requirements.txt\n\n4. **Serve the Documentation Locally**\n   ```bash\n    mkdocs serve\n\n-  Open your browser and go to http://localhost:8000 to preview your changes.\n\n5. **Submit Your Changes**\n\n- After verifying your changes, commit and push them to your forked repository.\n-  Create a pull request to submit your updates.\n\n---\n\nIf you have any questions or need further assistance, feel free to open an [issue](https://github.com/slaclab/trace/issues) or reach out to the maintainers.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslaclab%2Ftrace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslaclab%2Ftrace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslaclab%2Ftrace/lists"}