{"id":21517579,"url":"https://github.com/tek/incipit","last_synced_at":"2025-03-17T16:28:54.934Z","repository":{"id":62436239,"uuid":"462457627","full_name":"tek/incipit","owner":"tek","description":"A Prelude for Polysemy","archived":false,"fork":false,"pushed_at":"2023-09-23T17:08:53.000Z","size":113,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-26T00:30:56.381Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Nix","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/tek.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-02-22T20:09:43.000Z","updated_at":"2024-05-30T14:00:05.378Z","dependencies_parsed_at":"2024-05-30T14:10:27.089Z","dependency_job_id":null,"html_url":"https://github.com/tek/incipit","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tek%2Fincipit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tek%2Fincipit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tek%2Fincipit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tek%2Fincipit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tek","download_url":"https://codeload.github.com/tek/incipit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243782450,"owners_count":20347271,"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-11-24T00:43:02.812Z","updated_at":"2025-03-17T16:28:54.898Z","avatar_url":"https://github.com/tek.png","language":"Nix","funding_links":[],"categories":[],"sub_categories":[],"readme":"# About\n\nThis Haskell library provides a `Prelude` for [Polysemy] libraries, building upon [incipit-base] and exporting most of\nPolysemy's core modules as well as a number of basic libraries:\n\n* [polysemy-conc](https://hackage.haskell.org/package/polysemy-conc)\n* [polysemy-time](https://hackage.haskell.org/package/polysemy-log)\n* [polysemy-log](https://hackage.haskell.org/package/polysemy-time)\n* [polysemy-resume](https://hackage.haskell.org/package/polysemy-resume)\n\nFor a minimal variant that only exports Polysemy, consider [incipit-core].\nThe two repositories are separated due to Cabal dependency cycles.\n\n# Usage\n\nUsing a custom `Prelude` requires the use of Cabal mixins to hide the module from `base` and replace it with\n`Incipit`:\n\nFor `hpack`:\n```yaml\ndependencies:\n  - name: base\n    version: '\u003e= 4 \u0026\u0026 \u003c 5'\n    mixin:\n      - hiding (Prelude)\n  - name: incipit\n    version: '\u003e= 0.3'\n    mixin:\n      - (Incipit as Prelude)\n      - hiding (Incipit)\n```\n\nFor `cabal`:\n```cabal\nbuild-depends:\n    base \u003e=4 \u0026\u0026 \u003c5, incipit \u003e= 0.3\nmixins:\n    base hiding (Prelude), incipit (Incipit as Prelude), incipit hiding (Incipit)\n```\n\n`incipit` used to export `Prelude`, but\n[stack can't deal with that](https://github.com/commercialhaskell/stack/issues/5414).\n\n# Custom Prelude\n\nIn order to extend `incipit` with a local `Prelude`, the module `Incipit` has to be reexported:\n\n```yaml\ndependencies:\n  - name: base\n    version: '\u003e= 4 \u0026\u0026 \u003c 5'\n    mixin:\n      - hiding (Prelude)\n  - name: incipit\n    version: \u003e= 0.3\n    mixin:\n      - hiding (Prelude)\n```\n\n```haskell\nmodule Prelude (\n  module Prelude,\n  module Incipit,\n) where\n\nimport Incipit\n\nprojectName :: Text\nprojectName =\n  \"spaceship\"\n```\n\n[incipit-base]: https://hackage.haskell.org/package/incipit-base\n[incipit-core]: https://hackage.haskell.org/package/incipit-core\n[Polysemy]: https://hackage.haskell.org/package/polysemy\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftek%2Fincipit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftek%2Fincipit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftek%2Fincipit/lists"}