{"id":15293305,"url":"https://github.com/jamesmoriarty/poto","last_synced_at":"2025-09-07T06:35:00.847Z","repository":{"id":33412117,"uuid":"37057352","full_name":"jamesmoriarty/poto","owner":"jamesmoriarty","description":"multi cloud storage to image gallery + image proxy + file api - 350 LOC.","archived":false,"fork":false,"pushed_at":"2018-12-07T04:09:30.000Z","size":2335,"stargazers_count":19,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-07T06:33:45.311Z","etag":null,"topics":["aws","cloud-storage","google-storage","image-gallery","ruby","ruby-application","s3"],"latest_commit_sha":null,"homepage":"https://jamesmoriarty-poto-aws-s3.herokuapp.com/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jamesmoriarty.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-08T09:17:56.000Z","updated_at":"2023-04-03T21:26:03.000Z","dependencies_parsed_at":"2022-08-20T16:00:44.857Z","dependency_job_id":null,"html_url":"https://github.com/jamesmoriarty/poto","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/jamesmoriarty/poto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesmoriarty%2Fpoto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesmoriarty%2Fpoto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesmoriarty%2Fpoto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesmoriarty%2Fpoto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jamesmoriarty","download_url":"https://codeload.github.com/jamesmoriarty/poto/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamesmoriarty%2Fpoto/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274005336,"owners_count":25205934,"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","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["aws","cloud-storage","google-storage","image-gallery","ruby","ruby-application","s3"],"created_at":"2024-09-30T16:46:09.625Z","updated_at":"2025-09-07T06:35:00.822Z","avatar_url":"https://github.com/jamesmoriarty.png","language":"Ruby","readme":"[![Code Climate](https://codeclimate.com/github/jamesmoriarty/poto/badges/gpa.svg)](https://codeclimate.com/github/jamesmoriarty/poto) [![Test Coverage](https://codeclimate.com/github/jamesmoriarty/poto/badges/coverage.svg)](https://codeclimate.com/github/jamesmoriarty/poto/coverage) [![Build Status](https://travis-ci.org/jamesmoriarty/poto.svg?branch=master)](https://travis-ci.org/jamesmoriarty/poto)\n\n# Poto\n\nTurn your AWS S3 bucket into an image gallery.\n\n![Demo GIF](/doc/Demo.gif \"Demo GIF\")\n\nExample: http://jamesmoriarty-poto-aws-s3.herokuapp.com/\n\n## Usage\n\n### S3\n\n    $ PORT=? AWS_ACCESS_KEY_ID=? AWS_SECRET_ACCESS_KEY=? AWS_REGION=? AWS_S3_BUCKET=? poto-aws-s3\n\n### Google Cloud Storage\n\n    $ PORT=? GOOGLE_CLOUD_PROJECT_ID=? GOOGLE_CLOUD_KEYFILE=? GOOGLE_CLOUD_STORAGE_BUCKET=? poto-google-cloud-storage\n\n## Poto::ImageProxy\n\nThe image resizing proxy is rack middleware and can be used standalone.\n\n```ruby\nrequire \"poto\"\n\n# width  - max width in pixels.\n# height - max height in pixels.\n# src    - source image url.\n#\n# Examples\n#\n# GET /image_proxy?width=500\u0026height=500\u0026src=https%3A%2F%2Faqueous-cliffs-6127.herokuapp.com%3A443%2Fapi%2Ffiles%2FRGVhdGggVmFsbGV5LmpwZw%3D%3D%250A\n\nmap(\"/image_proxy\") do\n  run Poto::ImageProxy\nend\n```\n\n## Poto::API\n\nAs well as the API - query and access the storage backend via hal+json.\n\n```ruby\nrequire \"poto\"\nrequire \"poto/file_repository/aws/s3\"\n\n# Examples\n#\n# GET /files\u0026per_page=9\n# {\n#     \"_embedded\": {\n#         \"files\": [{\n#             \"name\": \"Abstract.jpg\",\n#             \"size\": 15198281,\n#             \"_links\": {\n#                 \"file\": {\n#                     \"href\": \"https://aqueous-cliffs-6127.herokuapp.com:443/api/files/QWJzdHJhY3QuanBn%0A\"\n#                 }\n#             }\n#         }]\n#     },\n#     \"_links\": {\n#         \"self\": {\n#             \"href\": \"https://aqueous-cliffs-6127.herokuapp.com:443/api/files?page=\"\n#         },\n#         \"next\": {\n#             \"href\": \"https://aqueous-cliffs-6127.herokuapp.com:443/api/files?page=Death+Valley.jpg\u0026per_page=9\"\n#         }\n#     }\n# }\n\nrepository = Poto::FileRepository::AWS::S3.new(bucket: ENV[\"AWS_S3_BUCKET\"])\n\nmap(\"/api\") do\n  run Poto::API.configure(repository: repository)\nend\n```\n\n## Installation\n\n    $ gem install poto\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Contributing\n\n1. Fork it ( https://github.com/[my-github-username]/poto/fork )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamesmoriarty%2Fpoto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjamesmoriarty%2Fpoto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamesmoriarty%2Fpoto/lists"}