{"id":16949157,"url":"https://github.com/jackc/booklog","last_synced_at":"2025-04-11T20:20:31.604Z","repository":{"id":136156023,"uuid":"179761373","full_name":"jackc/booklog","owner":"jackc","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-25T13:50:02.000Z","size":608,"stargazers_count":10,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-25T16:15:55.369Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/jackc.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":"2019-04-05T22:14:32.000Z","updated_at":"2024-12-25T13:50:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"7fba4ceb-af17-4ced-ac0b-17097ba1939a","html_url":"https://github.com/jackc/booklog","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackc%2Fbooklog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackc%2Fbooklog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackc%2Fbooklog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackc%2Fbooklog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jackc","download_url":"https://codeload.github.com/jackc/booklog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248473079,"owners_count":21109629,"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-13T21:53:16.270Z","updated_at":"2025-04-11T20:20:31.572Z","avatar_url":"https://github.com/jackc.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Booklog\n\nBooklog is a simple tool to track read books.\n\n## Development\n\nRequired Prerequisites:\n\nhttps://github.com/jackc/tern - for database migrations\nhttps://direnv.net/ - Manage environment variables\n\nHighly Recommended:\n\nhttps://github.com/asdf-vm/asdf - Version management for Ruby and Node\nhttps://github.com/watchexec/watchexec - Restart server when files change (needed for `rake rerun`)\n\nMake a copy of all files that end in `.example` but without the `.example` and edit the new files as needed to configure development environment.\n\nCreate database and user.\n\n```\ncreatedb --locale=en_US -T template0 booklog_dev\ncreateuser booklog\n```\n\n\n```\nnpm install\nbundle install\ntern migrate -m migration -c migration/development.conf\n```\n\nRun server with rake:\n\n```\nrake rerun\n```\n\nRun asset server:\n\n```\nnpx vite\n```\n\nSite will be available at: http://localhost:5173/\n\n## Iterm2 Script\n\n`bin/start-booklog-dev.py.example` contains an example script to start all needed programs for development. It does the following:\n\n* Start booklog server.\n* Split the window and run the asset server\n* Create a tab for a console.\n* Open booklog in VS Code.\n\nMake a copy of this file without the `.example`. Symlink the file into `~/Library/Application Support/iTerm2/Scripts`. e.g. `ln -s ~/dev/booklog/bin/start-isoamp-dev.py ~/Library/Application\\ Support/iTerm2/Scripts`.  This script will then be available in the iTerm2 Scripts menu as well as the cmd+shift+o \"Open Quickly\" window. You can now edit the file if needed.\n\n## Testing\n\nThe following environment variables must be set:\n\n* `TEST_DATABASE`: the test database name\n* `TEST_DATABASE_COUNT`: the number of test databases to use\n\nSet these variables in `.envrc`.\n\nRun tests with `rake`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackc%2Fbooklog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjackc%2Fbooklog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackc%2Fbooklog/lists"}