{"id":13765934,"url":"https://github.com/fedora-infra/fedocal","last_synced_at":"2025-07-28T05:08:42.535Z","repository":{"id":7601910,"uuid":"8959394","full_name":"fedora-infra/fedocal","owner":"fedora-infra","description":"A web based calendar application for Fedora","archived":false,"fork":false,"pushed_at":"2025-07-07T08:47:44.000Z","size":2680,"stargazers_count":26,"open_issues_count":1,"forks_count":20,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-07-07T09:37:14.338Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fedora-infra.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"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":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-03-22T19:35:10.000Z","updated_at":"2025-07-07T08:47:34.000Z","dependencies_parsed_at":"2025-05-10T21:32:31.796Z","dependency_job_id":"cf7c816f-083d-4ff2-8317-7db64b6527b8","html_url":"https://github.com/fedora-infra/fedocal","commit_stats":null,"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"purl":"pkg:github/fedora-infra/fedocal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedora-infra%2Ffedocal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedora-infra%2Ffedocal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedora-infra%2Ffedocal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedora-infra%2Ffedocal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fedora-infra","download_url":"https://codeload.github.com/fedora-infra/fedocal/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedora-infra%2Ffedocal/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267464522,"owners_count":24091505,"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-07-28T02:00:09.689Z","response_time":68,"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":[],"created_at":"2024-08-03T16:00:49.241Z","updated_at":"2025-07-28T05:08:42.508Z","avatar_url":"https://github.com/fedora-infra.png","language":"Python","funding_links":[],"categories":["Linux"],"sub_categories":["Red Hat/Fedora"],"readme":"fedocal\n=======\n\n:Author: Pierre-Yves Chibon \u003cpingou@pingoured.fr\u003e\n\n\nfedocal is a web based calendar application.\n\n\nGet this project:\n-----------------\nSource:  https://pagure.io/fedocal.git/\nMirror on github: https://github.com/fedora-infra/fedocal\n(Please use Pagure as the main repository and make sure\nyou run your patch against it)\n\nDocumentation: http://fedocal.rtfd.org\n\n\nDependencies:\n-------------\n.. _Flask: http://flask.pocoo.org/\n.. _SQLAlchemy: http://www.sqlalchemy.org/\n.. _alembic: https://bitbucket.org/zzzeek/alembic\n.. _iCal: http://en.wikipedia.org/wiki/ICalendar\n.. _python-vobject: http://vobject.skyhouseconsulting.com/\n.. _pytz: http://pytz.sourceforge.net/\n.. _dateutil: http://labix.org/python-dateutil\n\nThis project is a `Flask`_ application. The calendars and meetings are\nstored into a relational database using `SQLAlchemy`_ as Object Relational\nMapper (ORM) and `alembic`_ to handle database scheme changes.\nfedocal provides an `iCal`_ feed for each calendar and relies on\n`python-vobject`_ for this. Finally, `pytz`_ is used to handle the timezone\nchanges and `dateutil`_ to allow date manipulation over months/years.\n\nThe full list of dependencies can be found ine the ``requirements.txt`` file.\n\n\nRunning a development instance:\n-------------------------------\n\nClone the source::\n\n git clone https://github.com/fedora-infra/fedocal.git\n\n\nCopy the configuration files::\n\n cp fedocal.cfg.sample fedocal.cfg\n cp alembic.ini.sample alembic.ini\n\nAdjust the configuration file (secret key, database URL, admin group...)\n\n\nCreate the database scheme::\n\n FEDOCAL_CONFIG=fedocal.cfg sh createdb\n\n\nRegister the application to iddev for development::\n\n  oidc-register https://iddev.fedorainfracloud.org/ http://localhost:5000/oidc_callback\n\n\nAdd the following line in your configuration file `fedocal.cfg`::\n\n  OIDC_ID_TOKEN_COOKIE_SECURE = False\n\n\nRun the server::\n\n python runserver.py --config fedocal.cfg\n\nYou should be able to access the server at http://localhost:5000 (do not use\n``127.0.0.1`` as it will no work)\n\n\n/!\\ If login in does not work and gives you an ``invalid return_uri`` check\n  the ``redirect_uris`` in the ``client_secrets.json`` file and make sure it\n  matches **exactly** (check http vs https, trailing slash vs no trailing slash...).\n  You may have to re-register as editing directly the ``client_secrets.json``\n  file will not work.\n\n\nGit Branches:\n-------------\n\nThis project has three principal git branches:\n\n* ``master``: this is the default branch in which development is done. It is the\n  branch from which releases are made. It is the branch feature branches are\n  branched from and get merged into.\n* ``staging``: fedocal is deployed in the Fedora infrastructure in openshift\n  using s2i, the staging environment is built from this branch. This branch has\n  one extra commit that is not in ``master`` which adds all the files and changes\n  necessary to deploy fedocal in openshift using s2i. This branch is therefore\n  rebased and force-pushed when the staging fedocal instance is updated.\n  Pull-Request should not target this branch.\n* ``production``: this branch is used for the same situation as the ``staging``\n  branch but for the production fedocal instance. It also contains an additional\n  commit that is not in the ``master`` branch and is therefore force-pushed\n  after a rebase when the production fedocal instance is updated.\n  Pull-Request should not target this branch.\n\n\nTesting:\n--------\n\nThis project contains unit-tests allowing you to check if your server\nhas all the dependencies correctly set.\n\nTo run them simply call::\n\n tox\n\n.. note:: To stop the test at the first error or failure you can try:\n\n   ::\n\n    tox -- -x\n\n.. note:: To run a single file you can try:\n\n   ::\n\n    tox -- tests/test_flask.py -x\n\n\nReporting issues:\n-----------------\n\nFor any issue you may encounter please file a ticket and submit it to:\n\nFedocal Pagure: https://pagure.io/fedocal/issues\n\nContributors can use the same tracker to find existing bugs to work on.\nYou need to login with your FAS account to submit or modify a ticket.\n\n\n\nLicense:\n--------\n\nThis project is licensed GPLv3+.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffedora-infra%2Ffedocal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffedora-infra%2Ffedocal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffedora-infra%2Ffedocal/lists"}