# Welcome to the Court Seal Rookery
This is a collection of court seals that works in tandem with the Free Law Project court seals service. You can use this system to integrate picture of court seals directly into your applications.
Original files can be found in the `orig` directory and an index file can be found at `seals.json`.
## Using this Project
This system is exceedingly simple. To use this it, install the judge pics package from pypi:
pip install seal-rookery
And then use that package to get the URL of a court's seal:
>>> from seal_rookery.search import seal, ImageSizes
>>> seal("ca9", ImageSizes.SMALL)
'https://seals.free.law/v2/128/ca9.png'
Now that you have the URL of the court's seal in a useful size, just embed it in your application. Perhaps:
```html
<img src="https://seals.free.law/v2/128/ca9.png"
height=128 />
```
One thing we don't currently do is provide a consistent width for the photos. This is because our sources are not consistent, and we opted to set the height consistently instead of the width. You can work around this by using the `width` attribute of the `img` tag instead of the `height` (in which case the browser will scale it for you), or by just ignoring the `width` attribute and letting the photo have slightly varying widths on your page.
You can request images in one of the following heights:
```python
class ImageSizes(Enum):
SMALL = 128
MEDIUM = 256
LARGE = 512
XLARGE = 1024
ORIGINAL = "orig"
```
Selecting `ImageSizes.ORIGINAL` will give you a link to the original image that we have in our collection. You'd want to use this to make custom sized images, say.
For questions about the reliability, pricing, versioning, privacy, and security of the service see [the readme file for the judge-pics repository][jps].
## Contributing
1. Find the image and ensure it follows our quality guidelines (below).
2. Add the image file to the ``orig`` directory.
3. Edit `seals.json` to include the relevant fields for your new file.
## Quality Guidelines
1. Convert your original file to ``png`` or ``svg``, as appropriate. If
you have the ``ps`` file, include that as well.
2. If you use transparency or the file has it, make sure the file looks
OK on a background other than white. If it looks bizarre on an orange
or blue background, fix it by adding a white layer on the bottom.
3. Trim any extraneous margins and if the seal is circular, make the
corners transparent.
4. If the item was previously a ``jpeg`` or ``gif``, it's good to clean
up the splotchiness created by the ``jpeg`` compression. You'll see
it if you zoom in.
## Usage
We know of no instances where courts have requested a take down of their
seal, however usage of government seals has caused a
[few](https://www.publicknowledge.org/news-blog/blogs/nsa-spying-fine-trademark-infringement-crosse)
[stirs](http://www.nytimes.com/2010/08/03/us/03fbi.html) in the past.
Don't attempt to represent the government or its agents.
## Testing
Testing can run with the following command.
python -m unittest -v test
Tests are also run on every push to Github at
https://github.com/freelawproject/seal-rookery
For more information on testing checkout the Github workflows directory.
## New Releases
Deploying can be handled in two ways.
1. Update the version info in setup.py.
2. Commit to github with a tag in format v*.*.* (ex. v1.0.0)
or
1. Update the version info in setup.py.
2. Install the requirements in requirements-dev.txt
3. Set up a config file at ~/.pypirc containing the upload locations and
authentication credentials.
4. Generate a distribution:
python setup.py sdist
5. Upload the distribution:
twine upload dist/* -r pypi
## Copyright
Two things. First, if you are creating original work, please consider
signing and emailing a contributor license to us so that we may protect
the work later, if needed. We do this because we have a lot of
experience with IP litigation, and this is a good way to protect a
project.
Second, if you're just curious about the copyright of this repository,
see the License file for details. The short version of this is you can
pretty much use it however you desire.
## Credit Where Due
This project inspired by the initial [visualization
work](https://d57dd304fefca1aa423fea1b4dc59f23c06dd95e.googledrive.com/host/0B2GQktu-wcTiWm82NGt5MTZreHM/) of @nowherenearithaca.
[jps]: https://github.com/freelawproject/judge-pics/
Raw data
{
"_id": null,
"home_page": "https://github.com/freelawproject/seal-rookery",
"name": "seal-rookery",
"maintainer": "Free Law Project",
"docs_url": null,
"requires_python": null,
"maintainer_email": "info@free.law",
"keywords": "legal, seals",
"author": "Free Law Project",
"author_email": "info@free.law",
"download_url": "https://files.pythonhosted.org/packages/43/8a/69bdf7bc461ac51efdef7cab167f298d0866369e45d632debc450bcfc387/seal_rookery-2.2.5.tar.gz",
"platform": null,
"description": "# Welcome to the Court Seal Rookery\n\nThis is a collection of court seals that works in tandem with the Free Law Project court seals service. You can use this system to integrate picture of court seals directly into your applications.\n\nOriginal files can be found in the `orig` directory and an index file can be found at `seals.json`.\n\n## Using this Project\n\nThis system is exceedingly simple. To use this it, install the judge pics package from pypi:\n\n pip install seal-rookery\n\nAnd then use that package to get the URL of a court's seal:\n\n >>> from seal_rookery.search import seal, ImageSizes\n >>> seal(\"ca9\", ImageSizes.SMALL)\n 'https://seals.free.law/v2/128/ca9.png'\n\nNow that you have the URL of the court's seal in a useful size, just embed it in your application. Perhaps:\n\n```html\n<img src=\"https://seals.free.law/v2/128/ca9.png\"\n height=128 />\n```\n\nOne thing we don't currently do is provide a consistent width for the photos. This is because our sources are not consistent, and we opted to set the height consistently instead of the width. You can work around this by using the `width` attribute of the `img` tag instead of the `height` (in which case the browser will scale it for you), or by just ignoring the `width` attribute and letting the photo have slightly varying widths on your page.\n\nYou can request images in one of the following heights:\n\n```python\nclass ImageSizes(Enum):\n SMALL = 128\n MEDIUM = 256\n LARGE = 512\n XLARGE = 1024\n ORIGINAL = \"orig\"\n```\n\nSelecting `ImageSizes.ORIGINAL` will give you a link to the original image that we have in our collection. You'd want to use this to make custom sized images, say.\n\nFor questions about the reliability, pricing, versioning, privacy, and security of the service see [the readme file for the judge-pics repository][jps].\n\n\n## Contributing\n\n1. Find the image and ensure it follows our quality guidelines (below).\n\n2. Add the image file to the ``orig`` directory.\n\n3. Edit `seals.json` to include the relevant fields for your new file.\n\n\n## Quality Guidelines\n\n1. Convert your original file to ``png`` or ``svg``, as appropriate. If\n you have the ``ps`` file, include that as well.\n\n2. If you use transparency or the file has it, make sure the file looks\n OK on a background other than white. If it looks bizarre on an orange\n or blue background, fix it by adding a white layer on the bottom.\n\n3. Trim any extraneous margins and if the seal is circular, make the\n corners transparent.\n\n4. If the item was previously a ``jpeg`` or ``gif``, it's good to clean\n up the splotchiness created by the ``jpeg`` compression. You'll see\n it if you zoom in.\n\n\n## Usage\n\nWe know of no instances where courts have requested a take down of their\nseal, however usage of government seals has caused a\n[few](https://www.publicknowledge.org/news-blog/blogs/nsa-spying-fine-trademark-infringement-crosse)\n[stirs](http://www.nytimes.com/2010/08/03/us/03fbi.html) in the past.\nDon't attempt to represent the government or its agents.\n\n## Testing\n\nTesting can run with the following command.\n\n python -m unittest -v test\n\nTests are also run on every push to Github at\nhttps://github.com/freelawproject/seal-rookery\n\nFor more information on testing checkout the Github workflows directory.\n\n\n## New Releases\n\nDeploying can be handled in two ways.\n\n1. Update the version info in setup.py.\n\n2. Commit to github with a tag in format v*.*.* (ex. v1.0.0)\n\nor\n\n1. Update the version info in setup.py.\n\n2. Install the requirements in requirements-dev.txt\n\n3. Set up a config file at ~/.pypirc containing the upload locations and\n authentication credentials.\n\n4. Generate a distribution:\n\n\n python setup.py sdist\n\n5. Upload the distribution:\n\n\n twine upload dist/* -r pypi\n\n\n## Copyright\n\nTwo things. First, if you are creating original work, please consider\nsigning and emailing a contributor license to us so that we may protect\nthe work later, if needed. We do this because we have a lot of\nexperience with IP litigation, and this is a good way to protect a\nproject.\n\nSecond, if you're just curious about the copyright of this repository,\nsee the License file for details. The short version of this is you can\npretty much use it however you desire.\n\n## Credit Where Due\n\nThis project inspired by the initial [visualization\nwork](https://d57dd304fefca1aa423fea1b4dc59f23c06dd95e.googledrive.com/host/0B2GQktu-wcTiWm82NGt5MTZreHM/) of @nowherenearithaca.\n\n[jps]: https://github.com/freelawproject/judge-pics/\n",
"bugtrack_url": null,
"license": null,
"summary": "A collection of court seals that can be used in any project.",
"version": "2.2.5",
"project_urls": {
"Download": "https://github.com/freelawproject/seal-rookery/archive/2.2.5.tar.gz",
"Homepage": "https://github.com/freelawproject/seal-rookery"
},
"split_keywords": [
"legal",
" seals"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5dab22bdd51edc75ffbaa7e9e7b9d03ba5397ee18dc1e8338217dd14c3d957ec",
"md5": "b64f5a7b49c9f153c5317a525a352bcd",
"sha256": "a1bcca9c20540058ae2477b5d40e374037958e771437b1fca5338682bb8a6034"
},
"downloads": -1,
"filename": "seal_rookery-2.2.5-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "b64f5a7b49c9f153c5317a525a352bcd",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 15803429,
"upload_time": "2024-07-19T02:17:29",
"upload_time_iso_8601": "2024-07-19T02:17:29.054165Z",
"url": "https://files.pythonhosted.org/packages/5d/ab/22bdd51edc75ffbaa7e9e7b9d03ba5397ee18dc1e8338217dd14c3d957ec/seal_rookery-2.2.5-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "438a69bdf7bc461ac51efdef7cab167f298d0866369e45d632debc450bcfc387",
"md5": "729f042b082af870cd043a8e5c350c06",
"sha256": "16c8d68875f2105ff44354573be6ef098e631af97e9ac00fcd06d6614e6db17e"
},
"downloads": -1,
"filename": "seal_rookery-2.2.5.tar.gz",
"has_sig": false,
"md5_digest": "729f042b082af870cd043a8e5c350c06",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 15797349,
"upload_time": "2024-07-19T02:17:31",
"upload_time_iso_8601": "2024-07-19T02:17:31.850353Z",
"url": "https://files.pythonhosted.org/packages/43/8a/69bdf7bc461ac51efdef7cab167f298d0866369e45d632debc450bcfc387/seal_rookery-2.2.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-19 02:17:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "freelawproject",
"github_project": "seal-rookery",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "seal-rookery"
}
JSON
